5 releases
0.2.2 | Nov 7, 2022 |
---|---|
0.2.1 | Sep 13, 2021 |
0.2.0 | Sep 11, 2021 |
0.1.1 | Sep 6, 2021 |
0.1.0 | Aug 28, 2021 |
#202 in Video
39KB
889 lines
Interface with your Blackmagic camera over Bluetooth in Rust!
This library allows you to easily communicate with your Blackmagic camera over Bluetooth.
- Implements the full camera spec for easy access to commands with static type checking
Command::Video(Video::Iso(640)))
- Uses btleplug for Bluetooth to work across platforms.
- Consumes
PROTOCOL.json
for code generation so it's easy to add more functions to the library
Usage
You can test the library easy by opening examples/control.rs
, replacing the CAMERA_NAME const with your cameras bluetooth name and then running cargo run --example control
//Create a new camera with the device name
let mut camera = BluetoothCamera::new(CAMERA_NAME).await.unwrap();
//Connect with a set timeout
camera.connect(Duration::from_secs(10)).await.unwrap();
//Change the ISO to 320
camera.write(255, Operation::AssignValue, Command::Video(Video::Iso(640))).await.unwrap();
How does it work?
The library consumes the PROTOCOL.json file which documents the camera protocol in a machine readable format. From there it generates the commands as rust enums during the build stage (see /build). This allows us to have statically typed addressing of camera features without manually writing the code, rather relying on the conversion from the camera protocol manual. The library takes care of packaging down the commands into the camera protocol.
Contributing
Just open a PR LUL
License
All under MIT
Dependencies
~4–34MB
~515K SLoC