Zac Gaetano
fffff1c016
Per-node "Capture Drivers / SDKs" panel installs Blackmagic / AJA / Deltacast / NDI drivers without SSH. node-agent gains NODE_TOKEN-gated /driver/install + /driver/status (spawns a one-shot privileged ubuntu container that bind- mounts host kernel paths + the repo and runs deploy/install-driver.sh); mam-api adds admin-gated /cluster/:id/install-driver + /driver-status. Driver files live in-repo under sdk/<vendor>/ (private repo); binaries are admin-supplied per each sdk/<vendor>/README.md. Vendor allowlist throughout. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# Blackmagic Desktop Video (DeckLink) driver
|
|
|
|
Drop the **Blackmagic Desktop Video** Debian package for **Ubuntu 22.04 (x86_64)**
|
|
into this directory.
|
|
|
|
## Required file
|
|
|
|
| File | Notes |
|
|
|------|-------|
|
|
| `desktopvideo_*_amd64.deb` | The `desktopvideo` package from the Desktop Video installer archive. Provides the `blackmagic` kernel module (built via DKMS) and the `DesktopVideoHelper` daemon. |
|
|
|
|
Example name: `desktopvideo_14.4.1a4_amd64.deb`
|
|
|
|
The installer reads the **newest** matching `desktopvideo_*_amd64.deb` if more
|
|
than one is present.
|
|
|
|
## Where to get it
|
|
|
|
Blackmagic Design → Support → *Desktop Video* (Linux). Download the
|
|
"Desktop Video x.y.z Linux" tarball, extract it, and copy the
|
|
`deb/<arch>/desktopvideo_*_amd64.deb` file here.
|
|
|
|
> Optional: `desktopvideo-gui_*_amd64.deb` is **not** required for headless
|
|
> capture and is not installed.
|
|
|
|
## What the install script does
|
|
|
|
1. Ensures `linux-headers-$(uname -r)` is present (needed for the DKMS build).
|
|
2. `apt-get install -y ./desktopvideo_*_amd64.deb` (pulls DKMS deps).
|
|
3. Triggers the DKMS build, `depmod`, `modprobe blackmagic`.
|
|
4. Restarts the `DesktopVideoHelper` daemon.
|
|
5. Verifies `/dev/blackmagic` appears.
|
|
|
|
A **reboot is usually not required** but a DKMS rebuild against a freshly
|
|
installed kernel may need one — the script reports this.
|