dragonflight/sdk/aja/README.md
Zac Gaetano fffff1c016 feat(cluster): install capture-card drivers/SDKs from the admin screen
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>
2026-05-31 18:14:59 -04:00

1.3 KiB

AJA NTV2 driver

Drop the AJA NTV2 driver source/SDK archive for Linux into this directory.

Required file

File Notes
ntv2sdk*linux*.zip or libajantv2*.tar.gz The NTV2 SDK / open-source libajantv2 source tree containing driver/linux/ with the kernel-module Makefile and load_ajantv2 / unload_ajantv2 scripts.

Example names: ntv2sdklinux_17.0.1.zip, libajantv2-17.0.1.tar.gz

The installer reads the newest matching archive.

Where to get it

AJA → Support → Software & firmware → NTV2 SDK (Linux), or the public aja-video/libajantv2 source release. Download the Linux SDK zip / source tarball and copy it here unmodified.

What the install script does

  1. Ensures linux-headers-$(uname -r), build-essential are present.
  2. Extracts the archive into a scratch build dir.
  3. Builds the ajantv2 kernel module from driver/linux (make).
  4. Installs the module under /lib/modules/$(uname -r)/extra, runs depmod, modprobe ajantv2 (falls back to the SDK's load_ajantv2 script).
  5. Verifies the ajantv2 module is loaded.

A reboot is not normally required; the module loads immediately after build. The script reports if a reboot is needed (e.g. an old in-tree module is wedged).