43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
|
# Capture-card SDK / driver file store
|
||
|
|
|
||
|
|
This directory holds the **proprietary, non-redistributable** vendor SDKs and
|
||
|
|
drivers used to enable SDI / NDI capture cards on cluster nodes.
|
||
|
|
|
||
|
|
> **INTERNAL ONLY.** These files are licensed by their respective vendors and
|
||
|
|
> must **not** be published, redistributed, or committed to any public mirror.
|
||
|
|
> This repository is private. Do not change that.
|
||
|
|
|
||
|
|
## Why these live in the repo
|
||
|
|
|
||
|
|
The cluster admin screen lets an operator install/update capture-card drivers on
|
||
|
|
a node from the web UI (no SSH). The node-agent spawns a one-shot privileged
|
||
|
|
container that bind-mounts this repository and runs
|
||
|
|
[`deploy/install-driver.sh <vendor>`](../deploy/install-driver.sh), which reads
|
||
|
|
the vendor files from `sdk/<vendor>/`. Because the install must work offline on
|
||
|
|
an isolated broadcast LAN, the binaries ship in-repo rather than being fetched at
|
||
|
|
install time.
|
||
|
|
|
||
|
|
## Layout
|
||
|
|
|
||
|
|
```
|
||
|
|
sdk/
|
||
|
|
README.md ← this file
|
||
|
|
blackmagic/ ← Blackmagic Desktop Video (DeckLink) .deb
|
||
|
|
aja/ ← AJA ntv2 driver source / installer
|
||
|
|
deltacast/ ← Deltacast VideoMaster installer
|
||
|
|
ndi/ ← NDI redistributable runtime libs
|
||
|
|
```
|
||
|
|
|
||
|
|
Each vendor directory has its own `README.md` listing **exactly** which files an
|
||
|
|
admin must drop in. A `.gitkeep` keeps the empty directory committed.
|
||
|
|
|
||
|
|
## Important
|
||
|
|
|
||
|
|
- **No binaries are committed by default.** The directory structure + READMEs
|
||
|
|
are the deliverable. An admin downloads the proprietary files from the vendor
|
||
|
|
(per their licence) and drops them in the matching `sdk/<vendor>/` directory.
|
||
|
|
- The install script **fails gracefully** with a clear message if the expected
|
||
|
|
file is absent — it never fabricates or downloads binaries.
|
||
|
|
- Target host OS for all install paths is **Ubuntu 22.04 LTS (jammy), x86_64**,
|
||
|
|
matching the cluster worker nodes.
|