Version: v2.4.1

Blackmagic DeckLink SDI Setup

To setup Blackmagic cards to work with Bitstreams download Blackmagic's Desktop Video 14.2 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 Blackmagic Driver

Once the Blackmagic_Desktop_Video_Linux_14.2.tar is moved to the system, follow the steps below to install the Blackmagic Drivers and Software:

Extract the contents from the Blackmagic_Desktop_Video_Linux_14.2.tar file
```
tar -xvf Blackmagic_Desktop_Video_Linux_14.2.tar
```

note

The steps below show the installation for Ubuntu operating system with x86_64 architecture. Please make sure to check your Operating System and System Architecture before installing Blackmagic software. Blackmagic has support for aarch64 and arm64 along with support for RedHat and other Linux distributions.

Go into the Blackmagic_Desktop_Video_Linux_14.2 directory/folder and navigate to the correct distribution and architecture
```
cd Blackmagic_Desktop_Video_Linux_14.2/
cd deb/x86_64
```

Install the mediaexpress, desktopvideo and desktopvideo-gui software using the commands below:

sudo dpkg -i mediaexpress_3.8.1a4_amd64.deb
sudo dpkg -i desktopvideo_14.2a1_amd64.deb
sudo dpkg -i desktopvideo-gui_14.2a1_amd64.deb

After the commands are run, reboot the system.

Verifying Driver Installation

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

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

~$ sudo dmegs | grep balckmagic
[    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

Check modinfo for blackmagic and blackmagic-io kernal modules:

sudo modinfo blackmagic

filename:       /lib/modules/5.19.0-50-generic/updates/dkms/blackmagic.ko
license:        Proprietary
version:        14.2a1
description:    Blackmagic Design blackmagic driver
author:         Blackmagic Design Inc. <[email protected]>
srcversion:     1984422FF9C9E8BF1008947
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:v0000BDBDd0000A117sv*sd*bc*sc*i*
alias:          pci:v0000BDBDd0000A114sv*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:
retpoline:      Y
name:           blackmagic
vermagic:       5.19.0-50-generic SMP preempt mod_unload modversions
sig_id:         PKCS#7
signer:         ubuntu-mf Secure Boot Module Signature key
sig_key:        41:1E:6F:12:C4:9B:FF:95:A8:8C:16:9A:6A:C2:9B:BE:6B:55:E0:08
sig_hashalgo:   sha512
signature:      38:28:78:A5:D1:0A:10:FE:FF:03:F6:03:91:3D:2C:16:B8:54:5C:81:
                5A:D2:D4:71:D4:B4:BC:53:71:9A:9D:2B:87:2D:44:79:29:85:0A:C7:
                77:27:42:A8:73:4E:93:F6:C8:AC:E4:D9:07:84:60:29:02:E7:AB:2D:
                4B:E2:00:58:ED:87:01:33:68:C4:A2:3C:B7:C5:9F:0C:2B:08:DC:07:
                3A:2F:4F:BD:2A:89:65:4F:4E:A1:EC:7C:87:AF:FD:5A:6E:3E:70:80:
                51:79:EC:3B:40:C4:2F:EF:6A:79:59:17:75:2D:65:28:53:C1:77:A2:
                1F:58:6E:6D:F5:DD:CC:D6:89:F5:6B:76:25:69:C8:07:25:D5:E4:0E:
                E4:3A:BA:A8:40:C4:68:86:54:C2:75:93:3F:60:18:43:41:BC:D5:26:
                F3:17:51:DE:4F:26:45:B5:06:35:20:3B:D4:BC:76:96:1A:7F:D5:B2:
                89:D0:D8:F9:EA:E5:8A:94:C0:65:63:39:4D:75:D4:B6:96:FD:E4:CC:
                37:E9:0C:70:23:E4:5F:FD:E5:39:17:A6:CE:6E:C7:B3:3D:61:C8:0B:
                29:1F:9E:05:98:91:39:69:F1:94:F0:80:23:7C:09:83:27:B2:62:0D:
                FA:B1:62:13:B9:0A:C1:D7:42:37:82:64:07:84:77:0E
parm:           blackmagic_flags:ulong

sudo modinfo blackmagic-io

filename:       /lib/modules/5.19.0-50-generic/updates/dkms/blackmagic-io.ko
license:        Proprietary
version:        14.2a1
description:    Blackmagic Design BlackmagicIO driver
author:         Blackmagic Design Inc. <[email protected]>
srcversion:     D28EB3A14936F946AE6AB34
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:
retpoline:      Y
name:           blackmagic_io
vermagic:       5.19.0-50-generic SMP preempt mod_unload modversions
sig_id:         PKCS#7
signer:         ubuntu-mf Secure Boot Module Signature key
sig_key:        41:1E:6F:12:C4:9B:FF:95:A8:8C:16:9A:6A:C2:9B:BE:6B:55:E0:08
sig_hashalgo:   sha512
signature:      6B:83:2E:73:AD:FE:75:76:98:90:36:A8:52:26:99:CE:3A:1A:08:DB:
                5A:E6:3E:1B:45:2D:9A:18:2E:07:1E:67:B5:2E:73:2C:5A:08:73:D3:
                12:34:BE:CA:04:5B:79:76:53:3D:4C:FF:2A:AF:E7:2B:A1:8E:80:EA:
                0F:67:99:A6:38:65:9A:D3:03:A9:F2:B2:22:B8:81:8B:1A:62:91:B9:
                20:40:27:24:61:E4:39:6F:8D:6F:E8:04:D0:A7:F6:D3:F7:44:CD:C8:
                45:68:B3:05:E8:DC:E1:BA:38:B8:B9:15:70:AB:41:DC:18:83:7D:92:
                81:0E:9D:5E:08:37:AC:8E:3A:DE:8C:A5:BB:F1:5D:FC:5A:DE:EE:48:
                7F:1E:83:F2:08:CB:FE:FE:25:46:05:69:8A:BC:C4:65:5D:70:E8:BA:
                94:86:4B:44:64:AF:6C:A9:2E:07:05:85:FF:72:8E:E7:DA:78:E3:BF:
                49:EC:42:FA:5B:ED:56:6F:53:12:FE:19:5C:B6:7A:F8:9B:D6:5C:56:
                A0:F8:75:43:05:8E:34:48:AD:07:96:5B:84:09:50:22:DE:AC:DB:17:
                B6:38:E9:D2:84:D3:01:2F:20:C7:D2:BC:C4:61:D5:79:E7:0D:B1:7A:
                E6:42:39:D6:A3:64:C1:73:81:FA:9C:8F:72:1F:D1:3F
parm:           irq:The default irq type: 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.

Updating Firmware of the DeckLink Card

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 again.

After the system is rebooted, Bitstreams can be installed.

Bitstreams Installation

Bitstreams Installation Guide

Installing Blackmagic Driver​

Verifying Driver Installation​

Updating Firmware of the DeckLink Card​

Bitstreams Installation​

Bitstreams Installation

Installing Blackmagic Driver

Verifying Driver Installation

Updating Firmware of the DeckLink Card

Bitstreams Installation