Blackmagic DeckLink SDI Setup
| Version | 16.0 |
|---|
To setup Blackmagic cards to work with Bitstreams download Blackmagic's Desktop Video from their support site on to the system.
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:
-
Extract the contents from the Blackmagic_Desktop_Video_Linux_16.0.tar.gz file
tar -xvf Blackmagic_Desktop_Video_Linux_16.0*.tar.gz -
If upgrading the drivers:
- Stop Bitstreams docker containers
- Stop the Blackmagic desktop video deamon:
sudo systemctl status DesktopVideoHelper - unload the drivers:
sudo rmmod blackmagic && sudo rmmod blackmagic_io - uninstall the previous Desktop Video:
sudo apt remove desktopvideo
-
Install Dependanices
sudo apt updatesudo apt install build-essential dkms linux-headers-$(uname -r)
- x86_64 / amd64
- ARM
-
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 -
Install the
desktopvideosoftware using the commands below:cp ./desktopvideo_16.0*_amd64.deb /tmpsudo apt install /tmp/desktopvideo_16.0*_amd64.deb
-
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/aarch64 -
Install the
desktopvideosoftware using the commands below:cp ./desktopvideo_16.0*_arm64.deb /tmpsudo apt install /tmp/desktopvideo_16.0*_arm64.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:
-
Check the
dmesglogs 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 -
Check
modinfoforblackmagicandblackmagic-iokernal modules:-
sudo modinfo blackmagicfilename: /lib/modules/6.17.0-19-generic/updates/dkms/blackmagic.ko.zstlicense: Proprietaryversion: 16.0a14description: Blackmagic Design blackmagic driversrcversion: 083F1D296C09C660F662A72alias: 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: blackmagicretpoline: Yvermagic: 6.17.0-19-generic SMP preempt mod_unload modversionssig_id: PKCS#7signer: kr Secure Boot Module Signature keysig_key: 19:65:7B:48:BF:47:B9:DE:19:9B:66:B3:62:5C:D7:E3:54:75:A1:E7sig_hashalgo: sha512signature: 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:7Fparm: blackmagic_flags:ulong -
sudo modinfo blackmagic-iofilename: /lib/modules/6.17.0-19-generic/updates/dkms/blackmagic-io.ko.zstlicense: Proprietaryversion: 16.0a14description: Blackmagic Design BlackmagicIO driversrcversion: F253E840B2A82DDD1C4BA33alias: 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_ioretpoline: Yvermagic: 6.17.0-19-generic SMP preempt mod_unload modversionssig_id: PKCS#7signer: kr Secure Boot Module Signature keysig_key: 19:65:7B:48:BF:47:B9:DE:19:9B:66:B3:62:5C:D7:E3:54:75:A1:E7sig_hashalgo: sha512signature: 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:AFparm: 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