#camera-control #bluetooth-le #bluetooth #camera #control #blackmagic #cinema

blackmagic-camera-control

Interface with your Blackmagic camera over Bluetooth Low Energy in Rust

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

MIT and maybe GPL-2.0

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