Skip to main content
Version: v3.1.0

Blackmagic DeckLink SDI Setup

Version16.0

To setup Blackmagic cards to work with Bitstreams download Blackmagic's Desktop Video from their support site on to the system.

note

The Blackmagic Decklink drivers need to be installed on the host system, not the docker containers that Bitstreams services run on.

Installing/Upgrading​

Once the Blackmagic_Desktop_Video_Linux_16.0.tar.gz is moved to the system, follow the steps below to install the Blackmagic Drivers and Software:

  1. Extract the contents from the Blackmagic_Desktop_Video_Linux_16.0.tar.gz file

    tar -xvf Blackmagic_Desktop_Video_Linux_16.0*.tar.gz
  2. If upgrading the drivers:

    1. Stop Bitstreams docker containers
    2. Stop the Blackmagic desktop video deamon: sudo systemctl status DesktopVideoHelper
    3. unload the drivers: sudo rmmod blackmagic && sudo rmmod blackmagic_io
    4. uninstall the previous Desktop Video: sudo apt remove desktopvideo
  3. Install Dependanices

    sudo apt update
    sudo apt install build-essential dkms linux-headers-$(uname -r)
  1. Go into the Blackmagic_Desktop_Video_Linux directory/folder and navigate to the correct distribution and architecture

    cd Blackmagic_Desktop_Video_Linux_16.0*/deb/x86_64
  2. Install the desktopvideo software using the commands below:

    cp ./desktopvideo_16.0*_amd64.deb /tmp
    sudo apt install /tmp/desktopvideo_16.0*_amd64.deb

The installation will also verify if the correct firmware has been installed on the card. If an updated is required, a message maybe displayed.

********************************************************************************
Software Update Required!

Your blackmagic devices need a software update. Please do this by running the
"DesktopVideoUpdateTool" command
********************************************************************************

Updating Firmware​

Once the drivers and software is installed, the firmware of the card can be updated (if needed). To check if the firmware upgrade is required run the DesktopVideoUpdateTool like so

DesktopVideoUpdateTool -a -l
Available Devices:
* DeckLink Duo 2 (G5d1ac330)
Firmware is out of date

If it shows the firmware is out of date, update the firmware using the -u flag

DesktopVideoUpdateTool -a -u

Once the update is done, the system needs to be rebooted.

Verifying Driver Installation​

Once the system is rebooted, use the commands below to verify the installation:

  1. Check the dmesg logs to confirm the system detects the DeckLink card

    ~$ sudo dmesg | grep -i blackmagic
    [ 3.287468] blackmagic_io: module license 'Proprietary' taints kernel.
    [ 3.292612] blackmagic-io 0000:01:00.0: enabling device (0000 -> 0002)
    [ 3.298827] BlackmagicIO: DeckLink Duo 2 Mini (1) as blackmagic!io0 [0000:01:00.0]
    [ 3.298832] BlackmagicIO: Initialised serial driver for blackmagic!io0
    [ 3.304530] BlackmagicIO: DeckLink Duo 2 Mini (3) as blackmagic!io1 [0000:01:00.0]
    [ 3.304536] BlackmagicIO: Initialised serial driver for blackmagic!io1
    [ 3.310815] BlackmagicIO: DeckLink Duo 2 Mini (2) as blackmagic!io2 [0000:01:00.0]
    [ 3.310819] BlackmagicIO: Initialised serial driver for blackmagic!io2
    [ 3.316322] BlackmagicIO: DeckLink Duo 2 Mini (4) as blackmagic!io3 [0000:01:00.0]
    [ 3.316325] BlackmagicIO: Initialised serial driver for blackmagic!io3
  2. Check modinfo for blackmagic and blackmagic-io kernal modules:

    1. sudo modinfo blackmagic

      filename: /lib/modules/6.17.0-19-generic/updates/dkms/blackmagic.ko.zst
      license: Proprietary
      version: 16.0a14
      description: Blackmagic Design blackmagic driver
      author: Blackmagic Design Inc. <[email protected]>
      srcversion: 083F1D296C09C660F662A72
      alias: pci:v0000BDBDd0000A12Asv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A129sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A127sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A126sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A124sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A123sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A12Fsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A121sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A120sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A11Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A11Dsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A11Csv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A11Bsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A11Asv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A119sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A118sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A117sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A116sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A115sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A114sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A113sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A10Fsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A10Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A10Csv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A10Bsv*sd*bc*sc*i*
      depends:
      name: blackmagic
      retpoline: Y
      vermagic: 6.17.0-19-generic SMP preempt mod_unload modversions
      sig_id: PKCS#7
      signer: kr Secure Boot Module Signature key
      sig_key: 19:65:7B:48:BF:47:B9:DE:19:9B:66:B3:62:5C:D7:E3:54:75:A1:E7
      sig_hashalgo: sha512
      signature: 8E:B3:22:87:43:DF:D0:32:48:2E:EE:C8:31:BF:D1:71:A8:0F:94:68:
      13:79:59:CD:35:99:A6:FB:EB:95:C5:79:43:FA:0A:52:7A:80:B8:4C:
      C3:9C:E6:DB:9A:7F:B1:9A:4C:6E:A0:10:C9:2D:5C:07:CA:0E:B8:36:
      89:37:A3:55:38:14:DD:CE:97:B5:A2:30:82:70:6E:82:0D:41:54:71:
      50:59:B9:E9:31:C0:3D:A1:11:32:75:43:04:29:28:E3:77:8C:F9:44:
      6B:35:90:C9:11:70:A3:39:20:15:6F:64:BB:91:3E:5E:98:67:60:3C:
      0E:D7:9E:1E:17:5C:02:8F:A6:49:8D:9E:0D:E4:B3:3A:79:EE:2E:88:
      A9:65:97:A7:E0:82:28:AB:6A:43:99:0B:7B:D7:0C:47:6A:7B:3E:FF:
      8A:B7:FF:9F:0E:1F:06:BA:97:13:E8:94:29:01:95:BC:E1:1D:22:92:
      90:A2:81:12:DC:45:ED:EE:E1:A6:C3:FD:77:56:66:01:0B:BA:D5:8C:
      E7:39:F0:F8:48:92:D2:24:E6:4E:1F:0C:A9:48:6F:B7:4A:D9:4F:15:
      1B:1E:E7:18:36:69:30:6D:F4:F5:C9:6E:53:E1:E4:DC:A9:AD:B4:FA:
      9F:7C:91:7D:6C:6F:FF:29:C3:1E:AF:B0:9F:51:2C:7F
      parm: blackmagic_flags:ulong
    2. sudo modinfo blackmagic-io

      filename: /lib/modules/6.17.0-19-generic/updates/dkms/blackmagic-io.ko.zst
      license: Proprietary
      version: 16.0a14
      description: Blackmagic Design BlackmagicIO driver
      author: Blackmagic Design Inc. <[email protected]>
      srcversion: F253E840B2A82DDD1C4BA33
      alias: pci:v0000BDBDd0000A163sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A162sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A160sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A15Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A15Dsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A15Csv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A159sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A158sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A155sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A154sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A150sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A14Fsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A14Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A15Fsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A14Bsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A148sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A147sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A144sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A143sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A142sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A141sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A140sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Fsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Dsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Csv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Bsv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A13Asv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A139sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A138sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A137sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A136sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A132sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A130sv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A12Esv*sd*bc*sc*i*
      alias: pci:v0000BDBDd0000A12Dsv*sd*bc*sc*i*
      depends:
      name: blackmagic_io
      retpoline: Y
      vermagic: 6.17.0-19-generic SMP preempt mod_unload modversions
      sig_id: PKCS#7
      signer: kr Secure Boot Module Signature key
      sig_key: 19:65:7B:48:BF:47:B9:DE:19:9B:66:B3:62:5C:D7:E3:54:75:A1:E7
      sig_hashalgo: sha512
      signature: 84:EC:7A:FB:A2:E3:F4:78:1B:A3:42:73:68:AF:E4:E6:17:FA:7F:8B:
      31:09:0D:15:E3:A7:28:89:52:A2:3F:22:26:39:F9:CD:0D:E5:77:6B:
      06:1E:A1:01:D3:A9:22:B3:7A:EF:53:0E:47:97:16:22:91:02:C8:88:
      CD:7C:CD:E3:7A:7E:82:08:1E:6B:FC:89:2C:C6:C8:DE:26:00:90:41:
      DF:14:78:DF:D9:37:A7:55:0C:B0:D4:8B:83:67:77:6C:34:51:AD:C2:
      61:DF:D7:31:00:AD:CE:D4:44:E4:64:13:92:00:45:E4:0D:69:E7:C1:
      96:E4:27:26:62:31:BD:A9:D1:FE:1C:96:48:8B:6B:C2:6F:C7:A9:91:
      CB:CA:12:A7:57:1D:41:E4:4E:69:48:76:C3:A6:57:FD:9B:E8:9B:6E:
      49:B6:1A:12:17:77:4E:0D:1A:9D:D7:9A:CE:65:5D:8D:00:23:EE:CA:
      E2:A0:C0:76:88:3C:40:8F:A0:15:46:FA:9F:07:48:F0:2D:7A:BB:92:
      7F:AC:1F:63:73:A0:0D:80:1D:5D:7E:82:E8:79:B5:7C:F6:4B:CF:FA:
      58:5A:CF:A4:87:7D:D4:F1:E4:D6:AA:EE:79:C2:E7:49:53:F3:08:D8:
      AA:9B:0A:8D:62:92:DB:A3:3A:8D:A2:E4:E5:83:2E:AF
      parm: irq:The default irq type: msix, msi, legacy (charp)
      parm: tty:Serial TTY driver is enabled (bool)

If the outputs to the commands look similar to what is shown above, the Blackmagic drivers have been installed successfully.

Supported Cards​

The following Blackmagic Cards have been validated with Bitstreams and are tested with each Bitstreams release. Other cards may work with the current release but they may no longer work with future release. Use at your discretion.

  • Blackmagic Decklink Duo 2
  • Blackmagic Decklink Quad 2
  • Blackmagic Decklink 8K Pro
    • For resolutions 4kp60 10-bit and higher are not supported on the T1M or the Quadra Mini Server
  • Blackmagic IP 100G
    • Supports upto 8x ST-2110 streams