ℹ️ Blackmagic
ℹ️

Blackmagic


 


Supported Models

Model

Control protocol

  • URSA Cine 12K LF
  • Cinema Camera 6K
  • URSA Broadcast G2
  • Micro Studio Camera 4K G2
  • Studio Camera 4K Plus
  • Studio Camera 4K Pro
  • Studio Camera 6K Pro
  • Studio Camera 4K Plus G2
  • Studio Camera 4K Pro G2
  • PYXIS 6K


  • IP control: Camera Control REST API over ethernet
  • Blackmagic SDI Camera Control Protocol

Older SDI cameras:

  • Micro Studio 4K
  • Ursa Mini 12K
  • Ursa Mini pro 12K
  • etc.
  • Blackmagic SDI Camera Control Protocol
  • Pocket Cinema Cameras
  • Blackmagic SDI Camera Control Protocol using a Blackmagic Micro Converter SDI to HDMI 3G or 12G
⚠️

Firmware UPDATE!

Please be aware it is highly recommended that the camera and cyanview equipment is updated to the latest software version.

  • In 2024, Blackmagic introduced IP control via the REST API. Older firmware versions will not support this feature.
  • While the SDI return video control remains unchanged, new gain commands were added to the Ursa cameras in 2024. We have adjusted our system to ensure compatibility with both newer and older cameras. If gain control does not function correctly, it is likely an indication that an update is required.

TALLY not available on IP Control

As of 2025, tally functionality is absent from the REST API, making it impossible to control tally over IP. If tally is a mandatory requirement, the only option is to use SDI Camera Control. This issue was reported to Blackmagic in February 2024.




Supported Control

Exposure


  • Iris

Manual and AUTO iris

  • Gain

Gain in dB or ISO

  • Shutter

Manual, AUTO, ECS

White balance


  • Color Temperature


  • R/G/B gains


  • AWB (single shot auto-white)
  • ATW (continuous)


Primary corrections


  • R/G/B/Master black level
  • R/G/B/Master gamma (in BT.709)
  • Saturation
  • Detail
  • Denoise


Advanced corrections


  • R/G/B/Master flare
  • Knee slope and point
  • User matrix
  • Multi-matrix (selection of 12, 16, 24 or 32 vectors)


  • Color space: BT.709 or BT.2020


  • OETF


Lens



  • Iris
  • Focus
  • Zoom (AtomOne MiniZoom only)


Other controls


  • Flip: upside-down or mirror


  • Video format
  • Genlock




Workflow 

Camera control via IP  

In local, the RCP connects directly to your cameras.


Control through a micro converter

💡

Typically used if you:

  • have direct IP link to the cameras (even if you have an ATEM)
  • wants to use your camera remotely

⚠️

Only works with Blackmagic URSA G2 and Blackmagic Microstudio G2 in their latest software version. Requires your RCP to be updated to at least 24.1.3. For other models, it will be through SDI/ATEM.


Camera control via SDI

There are 2 Workflows for controlling Blackmagic cameras over SDI 

💡

For info, most modern Blackmagic cameras are now IP controllable

Method 1: 

The RCP connects to a CI0-BM (it's a specific CI0 with 3 ports: 2 serials and 1 SDI out+loop).

Method 2: 

The RCP connects to a RIO over LAN, WAN or 4G. The RIO then connects to the CY-BM to then control the camera over SDI. 

⚠️

In SDI/ATEM, the control is unidirectional, so if you do a white balance on camera body, it will not be reflected on the RCP (neither in the Blackmagic software).

In IP, this is bidirectional and we receive async values.


Camera control via ATEM

The RCP connects to the ATEM via IP. Then the ATEM connects to every Blackmagic camera over SDI.

💡

Typically used if you have already an ATEM with SDI in/out wired and no ethernet to the cameras. Works with any Blackmagic camera that has SDI in/out.

💡

Works with any Blackmagic camera that has SDI in and SDI out. But also works with HDMI camera like the Blackmagic Pocket Cinema using an ATEM HDMI.

💡

Works with any ATEM (mini, constellation, etc.)




Configuration 

Camera control via IP setup

Camera setup: 

Plug the camera to your laptop through USB (or IP if already configured).

Open the software Blackmagic Camera Setup, select your camera

Configure the camera's IP address​. Ensure it is a valid IP​ (can be DHCP​ or static​).

💡

This example, the camera is set to a static IP 10.192.88.228 Subnet /16 (255.255.0.0)

Enable the remote control: Web media manager (HTTP)


RCP/RIO Setup

Access the RCP Web User Interface

  • In the Camera section click on +​ to add a new camera

  • In General​ add a camera number​ and name​. This is anything related to your workflow. 

  • Select brand: Blackmagic
  • Select model: IP
  • Enter the IP of the camera. This example used 10.192.88.228

  • If configured correctly, the status will go green


Camera control via SDI

  • In the Camera section click on +​ to add a new camera

  • In General​ add a camera number​ and name​. This is anything related to your workflow. 

  • Select brand: Blackmagic
  • Select model: SDI
  • If using a CI0-BM​, select the CI0 port 3
  • If using RSBM​ with a RIO​, select the port on which the RSBM is plugged

  • If configured correctly, the status will go green

💡

By default we use the cam ID 1, if you want to use another ID, refer to the bus setup here


Camera control via ATEM

You first need to add your ATEM in your configuration, see this guide.

You should have this block configured and green:

Then you can add your cameras:

  • In the Camera section click on +​ to add a new camera

  • In General​ add a camera number​ and name​. This is anything related to your workflow. 

  • Select brand: Blackmagic
  • Select model: Atem
  • Then select in the interface drop-down list your ATEM​ and camera ID

In this example, the ATEM has an IP 10.192.1.3 and camera ID 1:

  • If configured correctly, the status will go green



Troubleshooting

When I zoom in, the focus and/or iris changes

We control the lens through the camera. And the protocol is bidirectional (which is not the case of the SDI), so we receive updated infos from the cameras.

This issue usually happens on microstudio G2. The supported lenses are not parafocal, and the camera is somehow compensating. Zooming will cause

  • Focus value change
  • Iris value change

Some cameras (like Dreamchip mini Zoom) have non parafocal lenses, compensate also, but the value they send are not the "RAW" ones. Blackmagic compensate and the values are the RAW ones, compensated.

This makes it unusable with focus handles for example as the control is absolute:

  • you can change the focus (as the control is absolute and the handle is absolute)
  • you can't zoom (as the control is in speed/relative and the camera expect position), but if you change zoom from RCP it works.
  • now if you move focus again the real value and the handle value are not the same anymore, then touch the focus you will see a glitch.

But this is not an issue if you change zoom/focus using the RCP as you will:

  • change zoom using encoder (absolute position)
  • you will see the focus changing
  • if you change the focus now, it will be done with the updated value, no glitch

You can check by yourself it's a "camera issue" (my camera IP is 10.192.1.1):

$ curl http://10.192.1.1/control/api/v1/lens/focus

{
"normalised": 0.5400898456573486
}%

$ curl -X PUT http://10.192.1.1/control/api/v1/lens/zoom \
-H "Content-Type: application/json" \
-d '{"focalLength": 35}'

$ curl http://10.192.1.1/control/api/v1/lens/focus

{
"normalised": 0.4116251468658447
}%

We did some API call directly on the camera and we see:

  • we check focus value and its 0.54
  • we change the zoom to 35
  • we read back the focus and now its 0.41

My camera stays RED - IP Setup 

⚠️

Check that your camera is not in 8.7, this version is not working

  • Ensure your RCP is at least in 23.1.3
  • Ensure your Camera is at least in 8.5 (but not in 8.7)
  • Ensure you can ping the camera from your laptop
  • Ensure you enabled the Web media manager (HTTP), browse http://10.192.88.228/control/documentation.html (replace the IP with your camera IP)
  • Sometime at startup the IP is not properly setup in the camera:
    • try to power cycle the camera
    • try to unplug/replug the USB-C Ethernet dongle
    • try to navigate to the IP setup menu, edit a value (but don't change anything, just validate it), then power cycle

Once you can ping the camera and browse the webpage, you're ready to configure it in Cyanview.


Camera is green but I have no control of anything - SDI Setup

If the camera is green, it means that the RCP/RIO/RSBM are properly communicating.

Check wiring:

  • SDI should be in the middle SDI on your RSBM/CI0-BM
  • and in SDI input on your camera

Each camera has an ID, usually it's 1 and if you configure your camera without a "bus", that what we use. So double check the config of your camera and RIO to ensure ID's are matching.

Iris values are not matching - SDI Setup

We control the lens through the camera protocol and it's unidirectional (no read back values).

So we need to cover a wide range, but don't know what the actual lens supports and the camerca can't tell us the actual range. So you could totally have 1.8 on your RCP and 4 on your lens.

But except from these extremums, if your lens goes from 4 to 22, then values should be "close" , but not perfect (maybe we can set 5.8 and your lens only support 6)

My camera stays RED - SDI Setup

The camera protocol is unidirectionnal, so there is no real check link.

But if the camera is RED, it means that the link between RIO/RSBM, or RCP/CI0-BM is broken.

Check wiring and that's probably the SDI board that's dead.