Thomas Junginger
3 days ago
commit
81fb4d6094
@ -0,0 +1,333 @@ |
|||||||
|
# Raspberry Pi NDI Gateway |
||||||
|
|
||||||
|
**Work in Progress – erste öffentliche Veröffentlichung** |
||||||
|
|
||||||
|
Ein Installationsskript für einen Raspberry Pi 4 (ARM64) mit Raspberry Pi OS / Debian 13 „Trixie“. Das Projekt richtet einen headless NDI-Gateway mit GStreamer ein: |
||||||
|
|
||||||
|
- USB-HDMI-Capture → NDI |
||||||
|
- NDI → HDMI über DRM/KMS |
||||||
|
- optionales Capture-Audio → NDI |
||||||
|
|
||||||
|
Der aktuelle Stand ist ausdrücklich **nicht** als vollständig getestete oder produktionsreife Lösung zu verstehen. Siehe [Bekannte Einschränkungen](#bekannte-einschränkungen). |
||||||
|
|
||||||
|
## Funktionsumfang des aktuellen Skripts |
||||||
|
|
||||||
|
| Bereich | Implementierter Stand | |
||||||
|
|---|---| |
||||||
|
| Betriebssystem | Debian 13 / Raspberry Pi OS Trixie, ARM64 | |
||||||
|
| GStreamer | Debian-/Raspberry-Pi-OS-Systempakete | |
||||||
|
| NDI-Plugin | `gst-plugin-ndi` aus `gst-plugins-rs`, standardmäßig Tag `0.14.5` | |
||||||
|
| NDI-Runtime | Vorhandene NDI-6-Runtime wird gesucht; andernfalls wird ein SDK-Archiv benötigt | |
||||||
|
| Capture-Video | Automatische oder manuelle V4L2-Geräteauswahl | |
||||||
|
| Capture-Formate | MJPEG und YUYV, sofern vom Gerät angeboten | |
||||||
|
| Capture-Audio | Optional; automatische oder manuelle ALSA-Geräteauswahl | |
||||||
|
| NDI-Empfang | NDI-Quelle per Name oder direkter IP:Port-Adresse | |
||||||
|
| HDMI-Video | Direkte Ausgabe über `kmssink` / DRM-KMS, ohne Desktop | |
||||||
|
| HDMI-Audio | **Noch nicht implementiert**; empfangenes NDI-Audio wird aktuell verworfen | |
||||||
|
| Dienste | `ndi-capture.service` und `ndi-display.service` | |
||||||
|
| Diagnose | `/opt/ndi-pi/bin/ndi-pi-diagnose` | |
||||||
|
|
||||||
|
## Architektur |
||||||
|
|
||||||
|
### Capture: USB-Capture → NDI |
||||||
|
|
||||||
|
```text |
||||||
|
USB-HDMI-Capture |
||||||
|
├── V4L2-Video |
||||||
|
│ ├── MJPEG → jpegdec ───────────┐ |
||||||
|
│ └── YUYV → videoconvert ───────┤ |
||||||
|
│ ▼ |
||||||
|
│ kurze Queue |
||||||
|
│ │ |
||||||
|
└── USB-Audio → ALSA → convert/resample |
||||||
|
│ |
||||||
|
▼ |
||||||
|
ndisinkcombiner |
||||||
|
│ |
||||||
|
ndisink |
||||||
|
│ |
||||||
|
NDI OUT |
||||||
|
``` |
||||||
|
|
||||||
|
Wenn kein passendes Capture-Audiogerät gefunden wird oder `ENABLE_AUDIO=false` gesetzt ist, wird eine Video-only-Pipeline gestartet. Die Audiozuordnung erfolgt anhand des USB-Gerätepfads; wenn keine eindeutige Übereinstimmung gefunden wird, kann derzeit ersatzweise das erste gefundene USB-Audiogerät gewählt werden. |
||||||
|
|
||||||
|
### Display: NDI → HDMI |
||||||
|
|
||||||
|
```text |
||||||
|
NDI IN |
||||||
|
│ |
||||||
|
ndisrc |
||||||
|
│ |
||||||
|
ndisrcdemux |
||||||
|
│ |
||||||
|
├── Video → queue → videoscale → kmssink → HDMI |
||||||
|
│ |
||||||
|
└── Audio → queue → fakesink (wird verworfen) |
||||||
|
``` |
||||||
|
|
||||||
|
Die Videoausgabe verwendet DRM/KMS und benötigt daher keine Desktop-Umgebung wie X11 oder Wayland. Wenn die Live-Pipeline beendet wird, versucht der Dienst einen schwarzen Standby-Bildschirm mit Statusanzeige zu starten und die NDI-Verbindung erneut aufzubauen. |
||||||
|
|
||||||
|
## Voraussetzungen |
||||||
|
|
||||||
|
- Raspberry Pi 4 mit 64-Bit-ARM-System |
||||||
|
- Raspberry Pi OS / Debian 13 „Trixie“ |
||||||
|
- Netzwerkverbindung; Ethernet wird empfohlen |
||||||
|
- USB-HDMI-Capture-Gerät mit Linux-V4L2-Unterstützung |
||||||
|
- HDMI-Display am Pi für die lokale Ausgabe |
||||||
|
- NDI-kompatible Gegenstelle im Netzwerk |
||||||
|
- Root-/sudo-Rechte für die Installation |
||||||
|
|
||||||
|
Das Skript prüft Architektur und Debian-Codename. Andere Raspberry-Pi-Modelle, Betriebssystemversionen oder 32-Bit-Systeme sind nicht als unterstützt anzusehen. |
||||||
|
|
||||||
|
## Installation |
||||||
|
|
||||||
|
1. Repository auf dem Raspberry Pi klonen. |
||||||
|
2. Ein offizielles NDI-SDK-Archiv lokal bereitstellen oder eine Download-URL angeben. |
||||||
|
3. Installationsskript mit Root-Rechten ausführen. |
||||||
|
|
||||||
|
Beispiel mit lokal heruntergeladenem SDK-Archiv: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo NDI_SDK_TARBALL=/pfad/zum/ndi-sdk.tar.gz ./install-trixie-ndi-pi-v18.sh |
||||||
|
``` |
||||||
|
|
||||||
|
Alternativ kann die URL über die Umgebungsvariable übergeben werden: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo NDI_SDK_URL="https://<NDI-SDK-Download-URL>" ./install-trixie-ndi-pi-v18.sh |
||||||
|
``` |
||||||
|
|
||||||
|
`<NDI-SDK-Download-URL>` ist durch die aktuelle Download-URL des NDI-Herstellers zu ersetzen. Die URL ist absichtlich nicht im Skript fest hinterlegt. |
||||||
|
|
||||||
|
Wenn die NDI-6-Runtime bereits an einem der vom Skript geprüften Orte installiert ist, wird kein SDK-Archiv benötigt: |
||||||
|
|
||||||
|
- `/usr/local/lib` |
||||||
|
- `/usr/lib/aarch64-linux-gnu` |
||||||
|
|
||||||
|
Das Skript installiert Systemabhängigkeiten, baut das NDI-GStreamer-Plugin und legt Konfiguration, Hilfsskripte und systemd-Units an. Es aktiviert und startet anschließend beide Dienste. |
||||||
|
|
||||||
|
> **Hinweis:** Das Installationsskript sollte vor dem Einsatz geprüft werden. Es verändert Systempakete, installiert Bibliotheken und schreibt Dateien unter `/opt/ndi-pi`, `/etc` und `/etc/systemd/system`. |
||||||
|
|
||||||
|
## Warum GStreamer aus den Distributionspaketen kommt |
||||||
|
|
||||||
|
GStreamer selbst wird nicht aus einem Git-Repository gebaut. Das Skript installiert die GStreamer-Komponenten aus den Debian-/Raspberry-Pi-OS-Paketen. Das zusätzliche NDI-Plugin wird separat aus `gst-plugins-rs` gebaut. |
||||||
|
|
||||||
|
Standardmäßig verwendet das Skript den Tag `0.14.5`: |
||||||
|
|
||||||
|
```text |
||||||
|
Debian / Raspberry Pi OS GStreamer |
||||||
|
│ |
||||||
|
└── gst-plugin-ndi (gst-plugins-rs 0.14.5) |
||||||
|
│ |
||||||
|
└── NDI 6 Runtime |
||||||
|
``` |
||||||
|
|
||||||
|
Der Plugin-Tag kann über `NDI_GST_TAG` überschrieben werden: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo NDI_GST_TAG=0.14.5 NDI_SDK_TARBALL=/pfad/zum/ndi-sdk.tar.gz ./install-trixie-ndi-pi-v18.sh |
||||||
|
``` |
||||||
|
|
||||||
|
## Konfiguration |
||||||
|
|
||||||
|
Die zentrale Konfigurationsdatei lautet: |
||||||
|
|
||||||
|
```text |
||||||
|
/etc/ndi-pi.conf |
||||||
|
``` |
||||||
|
|
||||||
|
Eine neue Installation legt sie mit folgenden wesentlichen Standardwerten an: |
||||||
|
|
||||||
|
```ini |
||||||
|
PI_NAME=<HOSTNAME> |
||||||
|
NDI_CAPTURE_NAME=<HOSTNAME>-Capture |
||||||
|
NDI_DISPLAY_SOURCE=PC01-Capture |
||||||
|
NDI_DISPLAY_ADDRESS=auto |
||||||
|
NDI_USE_DIRECT_ADDRESS=true |
||||||
|
|
||||||
|
CAPTURE_DEVICE=auto |
||||||
|
CAPTURE_WIDTH=1920 |
||||||
|
CAPTURE_HEIGHT=1080 |
||||||
|
CAPTURE_FPS=30 |
||||||
|
CAPTURE_FORMAT=MJPEG |
||||||
|
CAPTURE_AUTO_FALLBACK=true |
||||||
|
CAPTURE_QUEUE_BUFFERS=2 |
||||||
|
|
||||||
|
ENABLE_AUDIO=true |
||||||
|
CAPTURE_AUDIO_DEVICE=auto |
||||||
|
CAPTURE_AUDIO_RATE=48000 |
||||||
|
CAPTURE_AUDIO_CHANNELS=2 |
||||||
|
|
||||||
|
ENABLE_HDMI_AUDIO=false |
||||||
|
HDMI_AUDIO_DEVICE=auto |
||||||
|
KMS_DRIVER=vc4 |
||||||
|
KMS_CONNECTOR_ID=auto |
||||||
|
|
||||||
|
NDI_MAX_QUEUE=0 |
||||||
|
DISPLAY_WIDTH=1920 |
||||||
|
DISPLAY_HEIGHT=1080 |
||||||
|
DISPLAY_FPS=60 |
||||||
|
``` |
||||||
|
|
||||||
|
`<HOSTNAME>` steht hier nur als Platzhalter für den vom Installer ermittelten Hostnamen. Die tatsächliche Datei enthält konkrete Werte. |
||||||
|
|
||||||
|
### Wichtige Einstellungen |
||||||
|
|
||||||
|
| Einstellung | Bedeutung | |
||||||
|
|---|---| |
||||||
|
| `NDI_CAPTURE_NAME` | Name der vom Pi gesendeten NDI-Quelle | |
||||||
|
| `NDI_DISPLAY_SOURCE` | Name der NDI-Quelle, die der Pi empfangen soll | |
||||||
|
| `NDI_DISPLAY_ADDRESS` | `auto` für mDNS-Auflösung oder feste Adresse im Format `IP:Port` | |
||||||
|
| `NDI_USE_DIRECT_ADDRESS` | Bei `true` wird die aufgelöste bzw. konfigurierte IP:Port-Adresse für `ndisrc` verwendet | |
||||||
|
| `CAPTURE_DEVICE` | `auto` oder ein konkreter V4L2-Gerätepfad | |
||||||
|
| `CAPTURE_WIDTH`, `CAPTURE_HEIGHT`, `CAPTURE_FPS` | Bevorzugter Capture-Modus | |
||||||
|
| `CAPTURE_FORMAT` | `MJPEG`, `YUYV` oder `auto` | |
||||||
|
| `CAPTURE_AUTO_FALLBACK` | Erlaubt die Suche nach einem anderen unterstützten Modus | |
||||||
|
| `CAPTURE_QUEUE_BUFFERS` | Anzahl der Videobuffer in der Capture-Queue | |
||||||
|
| `ENABLE_AUDIO` | Aktiviert/deaktiviert Capture-Audio → NDI | |
||||||
|
| `CAPTURE_AUDIO_DEVICE` | `auto` oder ALSA-Gerät, z. B. `plughw:2,0` | |
||||||
|
| `KMS_DRIVER` | DRM/KMS-Treiber, Standard `vc4` | |
||||||
|
| `KMS_CONNECTOR_ID` | `auto` oder eine feste DRM-Connector-ID | |
||||||
|
| `DISPLAY_WIDTH`, `DISPLAY_HEIGHT`, `DISPLAY_FPS` | Auflösung und Framerate des Standby-Bildes | |
||||||
|
| `NDI_MAX_QUEUE` | NDI-Empfangsqueue; Standardwert `0` | |
||||||
|
|
||||||
|
`ENABLE_HDMI_AUDIO` und `HDMI_AUDIO_DEVICE` sind derzeit vorbereitete Konfigurationswerte, werden von der aktuellen Display-Pipeline aber **noch nicht umgesetzt**. Sie einzuschalten aktiviert daher keine HDMI-Audioausgabe. |
||||||
|
|
||||||
|
Bestehende Konfigurationen werden vom Installer ergänzt, ohne vorhandene Werte generell zu überschreiben. Bei älteren Konfigurationsdateien sollten die benötigten Capture-Werte kontrolliert und gegebenenfalls ergänzt werden. |
||||||
|
|
||||||
|
## Capture-Geräteauswahl und Videoformate |
||||||
|
|
||||||
|
Mit: |
||||||
|
|
||||||
|
```ini |
||||||
|
CAPTURE_DEVICE=auto |
||||||
|
``` |
||||||
|
|
||||||
|
untersucht das Skript `/dev/video*` und berücksichtigt Geräte mit V4L2-Video-Capture-Funktion und einem unterstützten Modus. |
||||||
|
|
||||||
|
Für eine feste Installation kann ein konkreter Pfad eingetragen werden, vorzugsweise ein stabiler Symlink: |
||||||
|
|
||||||
|
```ini |
||||||
|
CAPTURE_DEVICE=/dev/v4l/by-id/<GERAETEPFAD> |
||||||
|
``` |
||||||
|
|
||||||
|
Die Modusauswahl berücksichtigt die tatsächlich vom Gerät gemeldeten Formate. Die gewünschte Kombination aus Auflösung und Framerate wird zuerst versucht. Wenn `CAPTURE_AUTO_FALLBACK=true` gesetzt ist, folgt eine festgelegte Fallback-Liste. |
||||||
|
|
||||||
|
**Wichtig zur Formatpriorität:** Bei `CAPTURE_FORMAT=auto` ist die aktuelle Fallback-Reihenfolge YUYV vor MJPEG. Auch die Gerätebewertung bevorzugt YUYV. Das unterscheidet sich von einer MJPEG-first-Strategie. Bei einer neuen Installation steht `CAPTURE_FORMAT=MJPEG` als Standard in der Konfiguration; damit wird die Auswahl auf MJPEG beschränkt, sofern ein passender Modus vorhanden ist und ein Fallback nicht durch die Formatvorgabe ausgeschlossen wird. |
||||||
|
|
||||||
|
MJPEG wird mit `jpegdec` dekodiert. Der aktuelle Code verwendet bewusst nicht `v4l2jpegdec`. YUYV wird über `videoconvert` in UYVY konvertiert, bevor es an den NDI-Sink geht. |
||||||
|
|
||||||
|
## Audio |
||||||
|
|
||||||
|
### Capture-Audio → NDI |
||||||
|
|
||||||
|
Bei `ENABLE_AUDIO=true` versucht das Skript, ein ALSA-Gerät zu finden, das zum ausgewählten USB-Capture-Gerät gehört. Alternativ kann ein ALSA-Gerät fest vorgegeben werden: |
||||||
|
|
||||||
|
```ini |
||||||
|
CAPTURE_AUDIO_DEVICE=plughw:2,0 |
||||||
|
``` |
||||||
|
|
||||||
|
Die automatische Zuordnung ist heuristisch und sollte mit der konkreten Capture-Hardware überprüft werden. Wird kein Gerät gefunden, startet die Capture-Pipeline als Video-only. |
||||||
|
|
||||||
|
### NDI-Audio → HDMI |
||||||
|
|
||||||
|
Diese Richtung ist im aktuellen Skript **noch nicht implementiert**. Der Audio-Pad von `ndisrcdemux` wird derzeit an `fakesink` angeschlossen und damit verworfen. Es gibt aktuell keine ALSA-Wiedergabepipeline für den NDI-Ton. |
||||||
|
|
||||||
|
## NDI-Discovery und Netzwerk |
||||||
|
|
||||||
|
Der Display-Dienst verwendet standardmäßig: |
||||||
|
|
||||||
|
```ini |
||||||
|
NDI_DISPLAY_SOURCE=PC01-Capture |
||||||
|
NDI_DISPLAY_ADDRESS=auto |
||||||
|
NDI_USE_DIRECT_ADDRESS=true |
||||||
|
``` |
||||||
|
|
||||||
|
Bei `auto` versucht das Skript, den NDI-Dienst über Avahi/mDNS (`_ndi._tcp`) aufzulösen und die ermittelte IP-Adresse samt Port an `ndisrc` zu übergeben. Eine feste Adresse kann so angegeben werden: |
||||||
|
|
||||||
|
```ini |
||||||
|
NDI_DISPLAY_ADDRESS=192.168.1.50:5961 |
||||||
|
``` |
||||||
|
|
||||||
|
Der tatsächliche Port ist abhängig von der NDI-Quelle und muss passend ermittelt werden. Wenn keine direkte Adresse verfügbar ist, verwendet der initiale Start `ndi-name` als Fallback. Die Wiederverbindungslogik ist derzeit noch eingeschränkt; siehe [Bekannte Einschränkungen](#bekannte-einschränkungen). |
||||||
|
|
||||||
|
Für Discovery über VLAN- oder Subnetzgrenzen hinweg kann eine gesonderte NDI-Discovery-Server-Konfiguration erforderlich sein. Das wird vom Installationsskript nicht eingerichtet. |
||||||
|
|
||||||
|
## systemd-Dienste und Logs |
||||||
|
|
||||||
|
Es werden zwei getrennte Dienste angelegt: |
||||||
|
|
||||||
|
```text |
||||||
|
ndi-capture.service |
||||||
|
ndi-display.service |
||||||
|
``` |
||||||
|
|
||||||
|
Status prüfen: |
||||||
|
|
||||||
|
```bash |
||||||
|
systemctl status ndi-capture |
||||||
|
systemctl status ndi-display |
||||||
|
``` |
||||||
|
|
||||||
|
Logs verfolgen: |
||||||
|
|
||||||
|
```bash |
||||||
|
journalctl -u ndi-capture -f |
||||||
|
journalctl -u ndi-display -f |
||||||
|
``` |
||||||
|
|
||||||
|
Beide Dienste verwenden `Restart=always` und aktuell `RestartSec=1`. |
||||||
|
|
||||||
|
Nach einer Änderung an `/etc/ndi-pi.conf`: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo systemctl restart ndi-capture ndi-display |
||||||
|
``` |
||||||
|
|
||||||
|
## Diagnose |
||||||
|
|
||||||
|
Das Diagnoseprogramm liegt unter: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo /opt/ndi-pi/bin/ndi-pi-diagnose |
||||||
|
``` |
||||||
|
|
||||||
|
Es sammelt unter anderem: |
||||||
|
|
||||||
|
- Kernel- und Betriebssysteminformationen |
||||||
|
- GStreamer-Version und ausgewählte Plugin-Informationen |
||||||
|
- V4L2-Geräte und gemeldete Capture-Formate |
||||||
|
- ALSA-Aufnahme- und Wiedergabegeräte |
||||||
|
- DRM-Geräte und Connector-Status |
||||||
|
- NDI-Konfiguration und NDI/mDNS-Discovery |
||||||
|
- systemd-Status und letzte Service-Logs |
||||||
|
|
||||||
|
Für Fehlerberichte ist die vollständige Ausgabe hilfreich. Zugangsdaten oder andere private Netzwerkinformationen sollten vor dem Veröffentlichen entfernt werden. |
||||||
|
|
||||||
|
## Bekannte Einschränkungen |
||||||
|
|
||||||
|
Der folgende Abschnitt beschreibt bewusst den Stand des aktuellen Skripts und ist Teil der WIP-Kennzeichnung. |
||||||
|
|
||||||
|
1. **NDI-Audio wird am HDMI-Ausgang nicht wiedergegeben.** Der Empfangs-Audiozweig endet aktuell in `fakesink`. |
||||||
|
2. **Automatische USB-Audiozuordnung ist nicht garantiert.** Wenn die Zuordnung zum Video-Gerät nicht gelingt, kann ein anderes erstes USB-Audiogerät als Fallback ausgewählt werden. |
||||||
|
3. **Wiederverbindung nach NDI-Ausfall ist eingeschränkt.** Die Standby-Schleife prüft eine direkte IP:Port-Adresse. Wenn nur der Namens-Fallback aktiv ist oder mDNS die Quelle nicht auflösen kann, wird die Quelle nicht in allen Fällen erneut gefunden. |
||||||
|
4. **Signalbehandlung des Display-Helfers muss weiter getestet werden.** Das aktuelle Trap räumt den Standby-Prozess auf; das Verhalten beim Beenden durch systemd sollte auf dem Zielgerät überprüft werden. |
||||||
|
5. **Ältere Konfigurationsdateien benötigen Prüfung.** Die Migration ergänzt einige Schlüssel, aber nicht alle möglichen Capture-Parameter. Fehlende Werte wie `CAPTURE_WIDTH` oder `CAPTURE_FPS` können bei älteren Konfigurationen problematisch sein. |
||||||
|
6. **NDI-Runtime-Pfad in systemd:** Der Installer erkennt die Runtime auch unter `/usr/lib/aarch64-linux-gnu`; die erzeugten systemd-Units setzen aktuell jedoch fest `NDI_RUNTIME_DIR_V6=/usr/local/lib`. Bei einer Runtime-Installation im Multiarch-Verzeichnis muss das geprüft werden. |
||||||
|
7. **Keine vollständige Hardware-/Laufzeitvalidierung durch Syntaxprüfung:** Ein erfolgreicher Bash-Syntaxcheck bestätigt weder GStreamer-Pipeline-Negotiation noch NDI-Discovery, DRM/KMS-Ausgabe oder das Verhalten einer konkreten Capture-Karte. |
||||||
|
|
||||||
|
Weitere bekannte Entwicklungsaufgaben sind eine umfassendere Plugin-Prüfung, robustere Installer-Rollback-Strategien und eine Prüfung des SDK-Archivs anhand eines verifizierten Hashes bzw. einer Signatur. |
||||||
|
|
||||||
|
## Sicherheit und Lizenzhinweise |
||||||
|
|
||||||
|
Das NDI SDK bzw. die NDI-Runtime wird vom NDI-Hersteller bereitgestellt und unterliegt dessen Lizenz- und Distributionsbedingungen. Das SDK-Archiv und die Runtime-Bibliotheken sollten nicht ohne Prüfung dieser Bedingungen in ein öffentliches Repository eingecheckt oder weiterverteilt werden. |
||||||
|
|
||||||
|
Das Repository enthält das Installationsskript und die Projektdateien; Nutzer müssen die NDI-Runtime entsprechend den geltenden Herstellerbedingungen selbst beziehen bzw. bereitstellen. |
||||||
|
|
||||||
|
Das Installationsskript entpackt ein bereitgestelltes SDK-Archiv mit Root-Rechten. Verwende nur ein vertrauenswürdiges Archiv aus einer offiziellen Quelle. Eine automatisierte Hash-/Signaturprüfung des Archivs ist im aktuellen Skript noch nicht implementiert. |
||||||
|
|
||||||
|
## Projektstatus |
||||||
|
|
||||||
|
Dieses Projekt wird aktiv entwickelt. Hardwarekombinationen, Capture-Modi, NDI-Versionen und HDMI-Ausgabeverhalten können sich unterscheiden. Rückmeldungen mit Diagnoseausgabe, Pi-Modell, OS-Version und genauer Capture-Hardware sind willkommen. |
||||||
|
|
||||||
|
**Vor einem produktiven Einsatz sind Tests mit der eigenen Hardware und Netzwerkinfrastruktur erforderlich.** |
||||||
@ -0,0 +1,903 @@ |
|||||||
|
#!/usr/bin/env bash |
||||||
|
# NDI Pi Gateway installer for Raspberry Pi OS Trixie / Debian 13 ARM64. |
||||||
|
# V17: Adds configurable capture buffering and aspect-preserving HDMI canvas fitting. Integrates validated direct NDI BGRx/BGRA-to-KMS display path without videoconvert. |
||||||
|
# Restores the manually verified NDI -> ndisrcdemux -> BGRA -> KMS live pipeline. |
||||||
|
# Standby has explicit HDMI caps and status text; service startup tries live first |
||||||
|
# and only grabs KMS for standby when the live pipeline is unavailable. |
||||||
|
# Capture mode selection and NDI latency settings are unchanged; only capture queue buffering is tuned. |
||||||
|
# Updated: installed NDI 6.x runtimes are detected without requiring the SDK archive. |
||||||
|
set -Eeuo pipefail |
||||||
|
|
||||||
|
# Raspberry Pi 4 / Raspberry Pi OS Trixie 64-bit |
||||||
|
# NDI Gateway: |
||||||
|
# USB capture + USB audio -> NDI |
||||||
|
# NDI video -> HDMI/DRM |
||||||
|
# NDI audio -> HDMI ALSA |
||||||
|
# |
||||||
|
# NDI receive design: |
||||||
|
# - Prefer a direct NDI sender address (IP:port) when configured/resolved. |
||||||
|
# - NDI source discovery is still used to find the service and its actual port. |
||||||
|
# - ndi-name remains a fallback when a direct address cannot be resolved. |
||||||
|
# |
||||||
|
# Design: |
||||||
|
# - GStreamer itself comes from Debian/Raspberry Pi OS. |
||||||
|
# - The NDI GStreamer plugin is built from the gst-plugins-rs 0.14 branch/tag, |
||||||
|
# because Debian Trixie provides GStreamer 1.26 while the NDI plugin is not |
||||||
|
# provided as a matching Debian package. |
||||||
|
# - NDI SDK is downloaded from the official NDI developer distribution. |
||||||
|
# |
||||||
|
# Environment overrides: |
||||||
|
# NDI_SDK_URL Override the NDI SDK archive URL. |
||||||
|
# NDI_SDK_TARBALL Use a local SDK archive instead of downloading one. |
||||||
|
# NDI_GST_TAG Plugin tag, default 0.14.5. |
||||||
|
# |
||||||
|
# Existing /etc/ndi-pi.conf is preserved and migrated by adding missing keys. |
||||||
|
# |
||||||
|
# The script is intentionally conservative: it never assumes /dev/video0, |
||||||
|
# never assumes an UGREEN device, and treats audio as optional. |
||||||
|
|
||||||
|
set -Eeuo pipefail |
||||||
|
|
||||||
|
INSTALL_DIR=/opt/ndi-pi |
||||||
|
SRC_DIR="${INSTALL_DIR}/src" |
||||||
|
PLUGIN_DIR="/usr/lib/aarch64-linux-gnu/gstreamer-1.0" |
||||||
|
CONF="/etc/ndi-pi.conf" |
||||||
|
|
||||||
|
# NDI 6.x is the current SDK line. The exact archive URL may change, so the |
||||||
|
# default is intentionally empty: the installer asks for NDI_SDK_URL or a |
||||||
|
# locally supplied archive. This avoids hard-coding a vendor download URL. |
||||||
|
SDK_URL="${NDI_SDK_URL:-}" |
||||||
|
SDK_TARBALL="${NDI_SDK_TARBALL:-${INSTALL_DIR}/ndi-sdk.tar.gz}" |
||||||
|
|
||||||
|
PLUGIN_TAG="${NDI_GST_TAG:-0.14.5}" |
||||||
|
PLUGIN_REPO="https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git" |
||||||
|
|
||||||
|
log() { echo "[ndi-pi] $*"; } |
||||||
|
warn() { echo "[ndi-pi] WARNING: $*" >&2; } |
||||||
|
die() { echo "[ndi-pi] ERROR: $*" >&2; exit 1; } |
||||||
|
|
||||||
|
[[ $EUID -eq 0 ]] || die "Bitte mit sudo/root ausführen." |
||||||
|
[[ "$(dpkg --print-architecture)" == "arm64" ]] || die "Dieses Skript ist für ARM64." |
||||||
|
|
||||||
|
. /etc/os-release |
||||||
|
[[ "${VERSION_CODENAME:-}" == "trixie" ]] || die "Dieses Skript erwartet Debian/Raspberry Pi OS Trixie." |
||||||
|
|
||||||
|
mkdir -p "$INSTALL_DIR" "$SRC_DIR" "$PLUGIN_DIR" |
||||||
|
|
||||||
|
log "Installiere System-GStreamer, ALSA, V4L2, DRM und Build-Abhängigkeiten..." |
||||||
|
apt-get update |
||||||
|
# gstreamer1.0-plugins-good provides gst-device-monitor-1.0 on Debian Trixie. |
||||||
|
DEBIAN_FRONTEND=noninteractive apt-get install -y \ |
||||||
|
ca-certificates curl wget git build-essential pkg-config \ |
||||||
|
rustc cargo \ |
||||||
|
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \ |
||||||
|
gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good \ |
||||||
|
gstreamer1.0-plugins-good gstreamer1.0-plugins-bad \ |
||||||
|
gstreamer1.0-libav gstreamer1.0-alsa \ |
||||||
|
alsa-utils alsa-ucm-conf \ |
||||||
|
v4l-utils libdrm-tests libdrm-dev libudev-dev libglib2.0-dev \ |
||||||
|
avahi-daemon avahi-utils libavahi-client3 libavahi-common3 |
||||||
|
|
||||||
|
systemctl enable --now avahi-daemon || true |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# NDI SDK / already-installed NDI runtime |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# The SDK archive is NOT required when libndi.so.6 is already installed. |
||||||
|
# This is important for manual NDI SDK installations on Raspberry Pi. |
||||||
|
# |
||||||
|
# Accepted examples: |
||||||
|
# /usr/local/lib/libndi.so.6 |
||||||
|
# /usr/local/lib/libndi.so.6.3.2 |
||||||
|
# /usr/lib/aarch64-linux-gnu/libndi.so.6* |
||||||
|
# |
||||||
|
# If libndi.so.6 is a regular file while a versioned libndi.so.6.x.y exists, |
||||||
|
# normalize it to a symlink. This also removes the ldconfig warning: |
||||||
|
# "libndi.so.6 is not a symbolic link" |
||||||
|
|
||||||
|
NDI_LIB_DIR_INSTALLED="" |
||||||
|
NDI_LIB_INSTALLED="" |
||||||
|
|
||||||
|
find_installed_ndi() { |
||||||
|
local candidate |
||||||
|
for candidate in \ |
||||||
|
/usr/local/lib/libndi.so.6.* \ |
||||||
|
/usr/local/lib/libndi.so.6 \ |
||||||
|
/usr/lib/aarch64-linux-gnu/libndi.so.6.* \ |
||||||
|
/usr/lib/aarch64-linux-gnu/libndi.so.6 |
||||||
|
do |
||||||
|
if [[ -f "$candidate" ]]; then |
||||||
|
NDI_LIB_INSTALLED="$candidate" |
||||||
|
NDI_LIB_DIR_INSTALLED="$(dirname "$candidate")" |
||||||
|
return 0 |
||||||
|
fi |
||||||
|
done |
||||||
|
return 1 |
||||||
|
} |
||||||
|
|
||||||
|
normalize_installed_ndi() { |
||||||
|
local libdir="$1" |
||||||
|
local major="$2" |
||||||
|
local major_link="${libdir}/libndi.so.${major}" |
||||||
|
local unversioned="${libdir}/libndi.so" |
||||||
|
local versioned="" |
||||||
|
|
||||||
|
# Prefer the most specific versioned file, e.g. libndi.so.6.3.2. |
||||||
|
versioned="$(find "$libdir" -maxdepth 1 -type f \ |
||||||
|
-name "libndi.so.${major}.*" -print | sort -V | tail -n 1)" |
||||||
|
|
||||||
|
if [[ -n "$versioned" ]]; then |
||||||
|
if [[ -e "$major_link" && ! -L "$major_link" ]]; then |
||||||
|
log "Korrigiere ${major_link}: reguläre Datei -> Sicherung + Symlink" |
||||||
|
mv -f "$major_link" "${major_link}.manual-backup.$(date +%Y%m%d-%H%M%S)" |
||||||
|
fi |
||||||
|
ln -sfn "$versioned" "$major_link" |
||||||
|
elif [[ -f "$major_link" && ! -L "$major_link" ]]; then |
||||||
|
# A standalone libndi.so.6 is still usable. Do not overwrite it. |
||||||
|
warn "${major_link} ist eine reguläre Datei; kein versioniertes Ziel gefunden." |
||||||
|
fi |
||||||
|
|
||||||
|
# Only replace the unversioned link when it is absent/broken or already a link. |
||||||
|
if [[ -L "$unversioned" || ! -e "$unversioned" ]]; then |
||||||
|
ln -sfn "$major_link" "$unversioned" |
||||||
|
fi |
||||||
|
|
||||||
|
echo "$libdir" > /etc/ld.so.conf.d/ndi.conf |
||||||
|
ldconfig |
||||||
|
} |
||||||
|
|
||||||
|
if find_installed_ndi; then |
||||||
|
log "Bereits installiertes NDI Runtime gefunden: $NDI_LIB_INSTALLED" |
||||||
|
|
||||||
|
# Extract the SONAME major from libndi.so.6 / libndi.so.6.x.y. |
||||||
|
NDI_MAJOR="$(basename "$NDI_LIB_INSTALLED" | sed -n 's/^libndi\.so\.\([0-9][0-9]*\).*$/\1/p')" |
||||||
|
[[ "$NDI_MAJOR" == "6" ]] || die "Gefundene NDI Bibliothek ist nicht NDI 6.x: $NDI_LIB_INSTALLED" |
||||||
|
|
||||||
|
normalize_installed_ndi "$NDI_LIB_DIR_INSTALLED" "$NDI_MAJOR" |
||||||
|
|
||||||
|
# NDI_RUNTIME_DIR_V6 must point to the directory containing libndi.so.6. |
||||||
|
NDI_RUNTIME_DIR_V6="$NDI_LIB_DIR_INSTALLED" |
||||||
|
export NDI_RUNTIME_DIR_V6 |
||||||
|
log "NDI_RUNTIME_DIR_V6=${NDI_RUNTIME_DIR_V6}" |
||||||
|
else |
||||||
|
if [[ ! -s "$SDK_TARBALL" ]]; then |
||||||
|
if [[ -z "$SDK_URL" ]]; then |
||||||
|
die "Kein NDI 6.x Runtime und kein SDK-Archiv gefunden. |
||||||
|
Wenn NDI bereits manuell installiert ist, muss libndi.so.6 unter |
||||||
|
/usr/local/lib oder /usr/lib/aarch64-linux-gnu vorhanden sein. |
||||||
|
Alternativ: |
||||||
|
NDI_SDK_URL=<Download-URL> ./install.sh |
||||||
|
oder |
||||||
|
NDI_SDK_TARBALL=/pfad/zum/SDK.tar.gz ./install.sh" |
||||||
|
fi |
||||||
|
log "Lade NDI SDK von der angegebenen NDI-URL..." |
||||||
|
curl -fL --retry 3 --connect-timeout 15 -o "$SDK_TARBALL" "$SDK_URL" |
||||||
|
fi |
||||||
|
|
||||||
|
TMP_SDK="$(mktemp -d)" |
||||||
|
trap 'rm -rf "$TMP_SDK"' EXIT |
||||||
|
tar -xzf "$SDK_TARBALL" -C "$TMP_SDK" |
||||||
|
|
||||||
|
SDK_ROOT="$(find "$TMP_SDK" -maxdepth 4 -type d -name 'NDI SDK for Linux' -print -quit)" |
||||||
|
[[ -n "$SDK_ROOT" ]] || die "NDI SDK Verzeichnis nicht gefunden." |
||||||
|
|
||||||
|
NDI_LIB_DIR="$SDK_ROOT/lib/aarch64-rpi4-linux-gnueabi" |
||||||
|
if [[ ! -d "$NDI_LIB_DIR" ]]; then |
||||||
|
NDI_LIB_DIR="$(find "$SDK_ROOT/lib" -maxdepth 2 -type d \( -name '*aarch64*rpi4*' -o -name '*aarch64*' \) -print -quit)" |
||||||
|
fi |
||||||
|
[[ -n "${NDI_LIB_DIR:-}" && -d "$NDI_LIB_DIR" ]] || die "Keine passende NDI ARM64/RPi4 Bibliothek im SDK gefunden." |
||||||
|
|
||||||
|
NDI_LIB="$(find "$NDI_LIB_DIR" -maxdepth 1 -type f -name 'libndi.so.*' -print | sort -V | tail -n 1)" |
||||||
|
[[ -n "$NDI_LIB" ]] || die "libndi.so.* nicht im SDK gefunden." |
||||||
|
|
||||||
|
install -m 0755 "$NDI_LIB" /usr/local/lib/"$(basename "$NDI_LIB")" |
||||||
|
NDI_BASENAME="$(basename "$NDI_LIB")" |
||||||
|
NDI_MAJOR="$(printf '%s\n' "$NDI_BASENAME" | sed -n 's/.*\.so\.\([0-9][0-9]*\).*/\1/p')" |
||||||
|
[[ -n "$NDI_MAJOR" ]] || NDI_MAJOR=6 |
||||||
|
ln -sfn "/usr/local/lib/$NDI_BASENAME" "/usr/local/lib/libndi.so.${NDI_MAJOR}" |
||||||
|
ln -sfn "/usr/local/lib/libndi.so.${NDI_MAJOR}" /usr/local/lib/libndi.so |
||||||
|
echo /usr/local/lib > /etc/ld.so.conf.d/ndi.conf |
||||||
|
ldconfig |
||||||
|
|
||||||
|
NDI_RUNTIME_DIR_V6=/usr/local/lib |
||||||
|
export NDI_RUNTIME_DIR_V6 |
||||||
|
fi |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# Build the NDI GStreamer plugin |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
cd "$SRC_DIR" |
||||||
|
if [[ ! -d gst-plugins-rs ]]; then |
||||||
|
git clone --depth 1 --branch "$PLUGIN_TAG" "$PLUGIN_REPO" gst-plugins-rs |
||||||
|
fi |
||||||
|
|
||||||
|
cd gst-plugins-rs |
||||||
|
git fetch --depth 1 origin "refs/tags/${PLUGIN_TAG}:refs/tags/${PLUGIN_TAG}" || true |
||||||
|
git checkout -q "$PLUGIN_TAG" |
||||||
|
|
||||||
|
if [[ -x /root/.cargo/bin/rustc ]]; then |
||||||
|
export PATH="/root/.cargo/bin:$PATH" |
||||||
|
fi |
||||||
|
|
||||||
|
log "Baue gst-plugin-ndi ${PLUGIN_TAG} gegen das installierte GStreamer..." |
||||||
|
cargo build -p gst-plugin-ndi --release |
||||||
|
|
||||||
|
PLUGIN_SO="$(find target -type f -name 'libgstndi.so' -not -path '*/deps/*' -print -quit)" |
||||||
|
[[ -n "$PLUGIN_SO" ]] || die "libgstndi.so wurde nicht erzeugt." |
||||||
|
install -m 0755 "$PLUGIN_SO" "$PLUGIN_DIR/libgstndi.so" |
||||||
|
rm -f /root/.cache/gstreamer-1.0/registry.*.bin 2>/dev/null || true |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# Configuration |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
HOSTNAME_DEFAULT="$(hostname -s | tr '[:lower:]' '[:upper:]')" |
||||||
|
if [[ ! -f "$CONF" ]]; then |
||||||
|
cat > "$CONF" <<EOF |
||||||
|
# Raspberry Pi NDI Gateway |
||||||
|
|
||||||
|
PI_NAME=${HOSTNAME_DEFAULT} |
||||||
|
NDI_CAPTURE_NAME=${HOSTNAME_DEFAULT}-Capture |
||||||
|
NDI_DISPLAY_SOURCE=PC01-Capture |
||||||
|
# auto = resolve NDI service via mDNS and connect directly to IP:port. |
||||||
|
# You can also set a fixed address, e.g. 192.168.180.171:5961. |
||||||
|
NDI_DISPLAY_ADDRESS=auto |
||||||
|
|
||||||
|
# auto = any suitable V4L2 capture device, not vendor-specific. |
||||||
|
CAPTURE_DEVICE=auto |
||||||
|
|
||||||
|
# Preferred capture mode. auto selection only uses modes actually advertised |
||||||
|
# by the capture card. |
||||||
|
CAPTURE_WIDTH=1920 |
||||||
|
CAPTURE_HEIGHT=1080 |
||||||
|
CAPTURE_FPS=30 |
||||||
|
CAPTURE_FORMAT=MJPEG |
||||||
|
CAPTURE_AUTO_FALLBACK=true |
||||||
|
|
||||||
|
# Capture queue after jpegdec; 2 buffers are about 33 ms at 60 fps. |
||||||
|
# leaky=downstream discards stale frames if decoding briefly falls behind. |
||||||
|
CAPTURE_QUEUE_BUFFERS=2 |
||||||
|
|
||||||
|
# Audio from the selected USB capture device. |
||||||
|
ENABLE_AUDIO=true |
||||||
|
CAPTURE_AUDIO_DEVICE=auto |
||||||
|
CAPTURE_AUDIO_RATE=48000 |
||||||
|
CAPTURE_AUDIO_CHANNELS=2 |
||||||
|
|
||||||
|
# NDI -> HDMI audio. If no HDMI ALSA device is present, video continues. |
||||||
|
ENABLE_HDMI_AUDIO=false |
||||||
|
KMS_DRIVER=vc4 |
||||||
|
KMS_CONNECTOR_ID=auto |
||||||
|
HDMI_AUDIO_DEVICE=auto |
||||||
|
|
||||||
|
# NDI receive queue. 0 = minimal latency (validated setting, do not raise |
||||||
|
# without a documented reason - see NDI-Pi-Gateway-Dokumentation.md, §7). |
||||||
|
NDI_MAX_QUEUE=0 |
||||||
|
|
||||||
|
# Direct NDI receive: when true, resolve the advertised NDI service via mDNS |
||||||
|
# and feed its actual IP:port to ndisrc url-address. |
||||||
|
NDI_USE_DIRECT_ADDRESS=true |
||||||
|
EOF |
||||||
|
fi |
||||||
|
chmod 0644 "$CONF" |
||||||
|
|
||||||
|
# Migrate an existing configuration without overwriting user settings. |
||||||
|
ensure_conf_key() { |
||||||
|
local key="$1" value="$2" |
||||||
|
if ! grep -qE "^[[:space:]]*${key}=" "$CONF"; then |
||||||
|
printf '\n%s=%s\n' "$key" "$value" >> "$CONF" |
||||||
|
log "Konfiguration ergänzt: ${key}=${value}" |
||||||
|
fi |
||||||
|
} |
||||||
|
ensure_conf_key NDI_DISPLAY_ADDRESS auto |
||||||
|
ensure_conf_key NDI_USE_DIRECT_ADDRESS true |
||||||
|
ensure_conf_key KMS_DRIVER vc4 |
||||||
|
ensure_conf_key KMS_CONNECTOR_ID auto |
||||||
|
ensure_conf_key ENABLE_HDMI_AUDIO false |
||||||
|
if grep -qE '^NDI_MAX_QUEUE=(4|10)$' "$CONF"; then |
||||||
|
sed -i -E 's/^NDI_MAX_QUEUE=(4|10)$/NDI_MAX_QUEUE=0/' "$CONF" |
||||||
|
log "Fehlerhaften Zwischenstand NDI_MAX_QUEUE=4/10 auf 0 zurückgesetzt (validierte Latenz-Einstellung)." |
||||||
|
fi |
||||||
|
ensure_conf_key NDI_MAX_QUEUE 0 |
||||||
|
ensure_conf_key CAPTURE_QUEUE_BUFFERS 2 |
||||||
|
ensure_conf_key DISPLAY_WIDTH 1920 |
||||||
|
ensure_conf_key DISPLAY_HEIGHT 1080 |
||||||
|
ensure_conf_key DISPLAY_FPS 60 |
||||||
|
ensure_conf_key NDI_USE_DIRECT_ADDRESS true |
||||||
|
|
||||||
|
install -d -m 0755 "$INSTALL_DIR/bin" |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# Capture helper |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
cat > "$INSTALL_DIR/bin/ndi-capture.sh" <<'EOF' |
||||||
|
#!/usr/bin/env bash |
||||||
|
set -Eeuo pipefail |
||||||
|
source /etc/ndi-pi.conf |
||||||
|
|
||||||
|
log() { echo "[ndi-capture] $*"; } |
||||||
|
warn() { echo "[ndi-capture] WARNING: $*" >&2; } |
||||||
|
|
||||||
|
is_video_capture() { |
||||||
|
local d="$1" caps |
||||||
|
caps="$(v4l2-ctl -d "$d" --all 2>/dev/null || true)" |
||||||
|
grep -qiE 'Video Capture' <<<"$caps" |
||||||
|
} |
||||||
|
|
||||||
|
fmt_caps() { |
||||||
|
v4l2-ctl -d "$1" --list-formats-ext 2>/dev/null || true |
||||||
|
} |
||||||
|
|
||||||
|
supports_mode() { |
||||||
|
local d="$1" fmt="$2" w="$3" h="$4" fps="$5" |
||||||
|
local caps block |
||||||
|
caps="$(fmt_caps "$d")" |
||||||
|
[[ -n "$caps" ]] || return 1 |
||||||
|
|
||||||
|
# Extract the complete format block. Trixie's v4l2-ctl output can use |
||||||
|
# either [N]: 'MJPG' or a Pixel Format heading depending on the driver. |
||||||
|
block="$(awk -v wanted="$fmt" ' |
||||||
|
function isfmt(line) { |
||||||
|
if (wanted == "MJPEG") return line ~ /MJPG|MJPEG|Motion-JPEG/ |
||||||
|
return line ~ /YUYV|YUY2|YUV 4:2:2/ |
||||||
|
} |
||||||
|
isfmt($0) { if (found) exit; found=1; print; next } |
||||||
|
found { |
||||||
|
if ($0 ~ /^[[:space:]]*\[[0-9]+\]:/ || $0 ~ /^[[:space:]]*Pixel Format:/) exit |
||||||
|
print |
||||||
|
} |
||||||
|
' <<<"$caps")" |
||||||
|
|
||||||
|
[[ -n "$block" ]] || return 1 |
||||||
|
grep -qE "${w}[[:space:]]*[x×][[:space:]]*${h}" <<<"$block" || return 1 |
||||||
|
|
||||||
|
awk -v wanted="$fps" ' |
||||||
|
{ |
||||||
|
line=$0 |
||||||
|
while (match(line, /([0-9]+([.][0-9]+)?)[[:space:]]*([/][[:space:]]*[0-9]+)?[[:space:]]*fps/)) { |
||||||
|
val=substr(line, RSTART, RLENGTH) |
||||||
|
gsub(/fps/, "", val); gsub(/[[:space:]]/, "", val) |
||||||
|
if (index(val, "/")) { |
||||||
|
split(val,a,"/") |
||||||
|
if (a[2] != 0 && (a[1]/a[2]) >= wanted-0.01 && (a[1]/a[2]) <= wanted+0.01) ok=1 |
||||||
|
} else if ((val+0) >= wanted-0.01 && (val+0) <= wanted+0.01) { |
||||||
|
ok=1 |
||||||
|
} |
||||||
|
line=substr(line, RSTART+RLENGTH) |
||||||
|
} |
||||||
|
} |
||||||
|
END { exit(ok ? 0 : 1) } |
||||||
|
' <<<"$block" |
||||||
|
} |
||||||
|
|
||||||
|
|
||||||
|
mode_score() { |
||||||
|
local fmt="$1" w="$2" h="$3" fps="$4" |
||||||
|
local score=0 |
||||||
|
[[ "$fmt" == "YUYV" ]] && score=$((score + 1000000)) |
||||||
|
score=$((score + w*h)) |
||||||
|
score=$((score + fps*10000)) |
||||||
|
echo "$score" |
||||||
|
} |
||||||
|
|
||||||
|
select_mode() { |
||||||
|
local d="$1" |
||||||
|
local wanted_fmt="${CAPTURE_FORMAT:-auto}" |
||||||
|
local desired_w="${CAPTURE_WIDTH:-1920}" |
||||||
|
local desired_h="${CAPTURE_HEIGHT:-1080}" |
||||||
|
local desired_fps="${CAPTURE_FPS:-60}" |
||||||
|
local candidates=( |
||||||
|
"YUYV|1920|1080|60" |
||||||
|
"YUYV|1920|1080|50" |
||||||
|
"YUYV|1920|1080|30" |
||||||
|
"YUYV|1280|720|60" |
||||||
|
"YUYV|1280|720|50" |
||||||
|
"YUYV|1280|720|30" |
||||||
|
"YUYV|720|480|60" |
||||||
|
"YUYV|720|480|30" |
||||||
|
"MJPEG|1920|1080|60" |
||||||
|
"MJPEG|1920|1080|50" |
||||||
|
"MJPEG|1920|1080|30" |
||||||
|
"MJPEG|1280|720|60" |
||||||
|
"MJPEG|1280|720|50" |
||||||
|
"MJPEG|1280|720|30" |
||||||
|
) |
||||||
|
|
||||||
|
# First try the user's exact preferred resolution/fps. |
||||||
|
local c fmt w h fps |
||||||
|
for c in "${candidates[@]}"; do |
||||||
|
IFS='|' read -r fmt w h fps <<<"$c" |
||||||
|
[[ "$wanted_fmt" != "auto" && "$fmt" != "$wanted_fmt" ]] && continue |
||||||
|
if supports_mode "$d" "$fmt" "$desired_w" "$desired_h" "$desired_fps"; then |
||||||
|
echo "$fmt|$desired_w|$desired_h|$desired_fps" |
||||||
|
return 0 |
||||||
|
fi |
||||||
|
done |
||||||
|
|
||||||
|
[[ "${CAPTURE_AUTO_FALLBACK:-true}" == "true" ]] || return 1 |
||||||
|
|
||||||
|
# Then use the ordered practical fallback list above. |
||||||
|
for c in "${candidates[@]}"; do |
||||||
|
IFS='|' read -r fmt w h fps <<<"$c" |
||||||
|
[[ "$wanted_fmt" != "auto" && "$fmt" != "$wanted_fmt" ]] && continue |
||||||
|
if supports_mode "$d" "$fmt" "$w" "$h" "$fps"; then |
||||||
|
echo "$fmt|$w|$h|$fps" |
||||||
|
return 0 |
||||||
|
fi |
||||||
|
done |
||||||
|
return 1 |
||||||
|
} |
||||||
|
|
||||||
|
usb_key() { |
||||||
|
local p="$1" x base |
||||||
|
p="$(readlink -f "$p" 2>/dev/null || true)" |
||||||
|
[[ -n "$p" ]] || return 1 |
||||||
|
IFS='/' read -ra parts <<<"${p#/}" |
||||||
|
for x in "${parts[@]}"; do |
||||||
|
if [[ "$x" =~ ^[0-9]+-[0-9]+([.][0-9]+)*$ ]]; then |
||||||
|
base="$x" |
||||||
|
fi |
||||||
|
done |
||||||
|
[[ -n "${base:-}" ]] && echo "$base" |
||||||
|
} |
||||||
|
|
||||||
|
score_device() { |
||||||
|
local d="$1" mode="$2" score=0 bus fmt w h fps |
||||||
|
IFS='|' read -r fmt w h fps <<<"$mode" |
||||||
|
|
||||||
|
# Keep the generic USB preference, but score the ACTUAL mode selected by |
||||||
|
# select_mode(). In auto mode YUYV is intentionally preferred over MJPEG. |
||||||
|
bus="$(udevadm info -q property -n "$d" 2>/dev/null | awk -F= '$1=="ID_BUS"{print $2; exit}')" |
||||||
|
[[ "$bus" == "usb" ]] && score=$((score + 5000000)) |
||||||
|
[[ "$fmt" == "YUYV" ]] && score=$((score + 1000000)) |
||||||
|
[[ "$fmt" == "MJPEG" ]] && score=$((score + 500000)) |
||||||
|
[[ "$w" == "$CAPTURE_WIDTH" ]] && [[ "$h" == "$CAPTURE_HEIGHT" ]] && score=$((score + 100000)) |
||||||
|
[[ "$fps" == "$CAPTURE_FPS" ]] && score=$((score + 10000)) |
||||||
|
score=$((score + w*h)) |
||||||
|
score=$((score + fps*100)) |
||||||
|
echo "$score" |
||||||
|
} |
||||||
|
|
||||||
|
pick_capture() { |
||||||
|
if [[ "${CAPTURE_DEVICE:-auto}" != "auto" ]]; then |
||||||
|
echo "$CAPTURE_DEVICE" |
||||||
|
return |
||||||
|
fi |
||||||
|
|
||||||
|
local best="" best_score=-1 d caps mode score |
||||||
|
shopt -s nullglob |
||||||
|
for d in /dev/video*; do |
||||||
|
[[ -e "$d" ]] || continue |
||||||
|
is_video_capture "$d" || continue |
||||||
|
caps="$(fmt_caps "$d")" |
||||||
|
mode="$(select_mode "$d" 2>/dev/null || true)" |
||||||
|
[[ -n "$mode" ]] || continue |
||||||
|
score="$(score_device "$d" "$mode")" |
||||||
|
[[ "$score" -gt "$best_score" ]] && { best="$d"; best_score="$score"; } |
||||||
|
done |
||||||
|
shopt -u nullglob |
||||||
|
[[ -n "$best" ]] && echo "$best" |
||||||
|
} |
||||||
|
|
||||||
|
find_audio_capture() { |
||||||
|
[[ "${ENABLE_AUDIO:-true}" == "true" ]] || return 1 |
||||||
|
[[ "${CAPTURE_AUDIO_DEVICE:-auto}" != "auto" ]] && { echo "$CAPTURE_AUDIO_DEVICE"; return 0; } |
||||||
|
|
||||||
|
local vkey card idx path skey best="" fallback="" |
||||||
|
vkey="$(usb_key "$(udevadm info -q path -n "$DEV" 2>/dev/null || true)")" || true |
||||||
|
|
||||||
|
# Prefer a USB sound card on the same USB device as the selected video node. |
||||||
|
while read -r idx _; do |
||||||
|
[[ "$idx" =~ ^[0-9]+$ ]] || continue |
||||||
|
path="$(readlink -f "/sys/class/sound/card${idx}/device" 2>/dev/null || true)" |
||||||
|
[[ -n "$path" ]] || continue |
||||||
|
skey="$(usb_key "$path" 2>/dev/null || true)" |
||||||
|
if [[ -n "$vkey" && -n "$skey" && "$vkey" == "$skey" ]]; then |
||||||
|
best="plughw:${idx},0" |
||||||
|
break |
||||||
|
fi |
||||||
|
if [[ -n "$skey" && -z "$fallback" ]]; then |
||||||
|
fallback="plughw:${idx},0" |
||||||
|
fi |
||||||
|
done < <(grep -E '^[[:space:]]*[0-9]+[[:space:]]+\[' /proc/asound/cards 2>/dev/null | sed -E 's/^[[:space:]]*([0-9]+).*/\1/') |
||||||
|
|
||||||
|
[[ -n "$best" ]] && { echo "$best"; return 0; } |
||||||
|
[[ -n "$fallback" ]] && { echo "$fallback"; return 0; } |
||||||
|
return 1 |
||||||
|
} |
||||||
|
|
||||||
|
DEV="$(pick_capture)" || { |
||||||
|
warn "Kein geeignetes V4L2-Capture-Gerät gefunden; systemd startet später erneut." |
||||||
|
for d in /dev/video*; do |
||||||
|
[[ -e "$d" ]] || continue |
||||||
|
warn "V4L2-Info für $d:" |
||||||
|
v4l2-ctl -d "$d" --all 2>&1 | sed 's/^/[ndi-capture] /' || true |
||||||
|
v4l2-ctl -d "$d" --list-formats-ext 2>&1 | sed 's/^/[ndi-capture] /' || true |
||||||
|
done |
||||||
|
exit 1 |
||||||
|
} |
||||||
|
|
||||||
|
MODE="$(select_mode "$DEV")" || { |
||||||
|
warn "Kein unterstützter Capture-Modus auf $DEV." |
||||||
|
fmt_caps "$DEV" | sed 's/^/[ndi-capture] /' >&2 || true |
||||||
|
exit 1 |
||||||
|
} |
||||||
|
IFS='|' read -r FMT WIDTH HEIGHT FPS <<<"$MODE" |
||||||
|
|
||||||
|
AUDIO_DEV="$(find_audio_capture || true)" |
||||||
|
|
||||||
|
# MJPEG wird mit dem normalen Software-Decoder jpegdec dekodiert. |
||||||
|
# v4l2jpegdec wird bewusst NICHT verwendet: die Testreihe zeigte dort |
||||||
|
# wiederholt "slow copy into buffer" und sichtbare Micro-Ruckler. |
||||||
|
log "Capture: $DEV, $FMT ${WIDTH}x${HEIGHT}@${FPS}" |
||||||
|
[[ -n "$AUDIO_DEV" ]] && log "Capture-Audio: $AUDIO_DEV" || warn "Kein passendes USB-Audio gefunden; Video-only." |
||||||
|
|
||||||
|
if [[ "$FMT" == "MJPEG" ]]; then |
||||||
|
VIDEO_CAPS="image/jpeg,width=${WIDTH},height=${HEIGHT},framerate=${FPS}/1" |
||||||
|
else |
||||||
|
VIDEO_CAPS="video/x-raw,format=YUY2,width=${WIDTH},height=${HEIGHT},framerate=${FPS}/1" |
||||||
|
fi |
||||||
|
|
||||||
|
# MJPEG: v4l2src(io-mode=2) -> jpegdec -> konfigurierbare kurze Queue -> ndisink. |
||||||
|
# Die Queue puffert kurze Decoder-/Scheduling-Schwankungen; leaky downstream |
||||||
|
# verhindert, dass bei Überlastung zunehmend alte Frames ausgegeben werden. |
||||||
|
CAPTURE_QUEUE_BUFFERS="${CAPTURE_QUEUE_BUFFERS:-2}" |
||||||
|
if ! [[ "$CAPTURE_QUEUE_BUFFERS" =~ ^[1-9][0-9]*$ ]]; then |
||||||
|
warn "CAPTURE_QUEUE_BUFFERS muss eine positive ganze Zahl sein; verwende 2." |
||||||
|
CAPTURE_QUEUE_BUFFERS=2 |
||||||
|
fi |
||||||
|
CAPTURE_QUEUE=(queue "max-size-buffers=${CAPTURE_QUEUE_BUFFERS}" max-size-time=0 max-size-bytes=0 leaky=downstream) |
||||||
|
# UYVY ist nur beim YUYV-Fallback nötig, weil ndisink YUY2/YUYV nicht direkt annimmt. |
||||||
|
if [[ -n "$AUDIO_DEV" ]]; then |
||||||
|
if [[ "$FMT" == "MJPEG" ]]; then |
||||||
|
exec gst-launch-1.0 -e \ |
||||||
|
ndisinkcombiner name=combiner ! \ |
||||||
|
ndisink ndi-name="${NDI_CAPTURE_NAME}" sync=false qos=true \ |
||||||
|
v4l2src device="$DEV" io-mode=2 ! \ |
||||||
|
"$VIDEO_CAPS" ! \ |
||||||
|
jpegdec ! "${CAPTURE_QUEUE[@]}" ! combiner.video \ |
||||||
|
alsasrc device="$AUDIO_DEV" do-timestamp=true ! \ |
||||||
|
queue max-size-time=100000000 max-size-buffers=0 max-size-bytes=0 ! \ |
||||||
|
audioconvert ! audioresample ! \ |
||||||
|
audio/x-raw,format=F32LE,rate="${CAPTURE_AUDIO_RATE:-48000}",channels="${CAPTURE_AUDIO_CHANNELS:-2}" ! \ |
||||||
|
combiner.audio |
||||||
|
else |
||||||
|
exec gst-launch-1.0 -e \ |
||||||
|
ndisinkcombiner name=combiner ! \ |
||||||
|
ndisink ndi-name="${NDI_CAPTURE_NAME}" sync=false qos=true \ |
||||||
|
v4l2src device="$DEV" io-mode=2 ! \ |
||||||
|
"$VIDEO_CAPS" ! \ |
||||||
|
videoconvert ! video/x-raw,format=UYVY ! "${CAPTURE_QUEUE[@]}" ! combiner.video \ |
||||||
|
alsasrc device="$AUDIO_DEV" do-timestamp=true ! \ |
||||||
|
queue max-size-time=100000000 max-size-buffers=0 max-size-bytes=0 ! \ |
||||||
|
audioconvert ! audioresample ! \ |
||||||
|
audio/x-raw,format=F32LE,rate="${CAPTURE_AUDIO_RATE:-48000}",channels="${CAPTURE_AUDIO_CHANNELS:-2}" ! \ |
||||||
|
combiner.audio |
||||||
|
fi |
||||||
|
else |
||||||
|
if [[ "$FMT" == "MJPEG" ]]; then |
||||||
|
exec gst-launch-1.0 -e \ |
||||||
|
v4l2src device="$DEV" io-mode=2 ! \ |
||||||
|
"$VIDEO_CAPS" ! \ |
||||||
|
jpegdec ! \ |
||||||
|
"${CAPTURE_QUEUE[@]}" ! \ |
||||||
|
ndisink ndi-name="${NDI_CAPTURE_NAME}" sync=false qos=true |
||||||
|
else |
||||||
|
exec gst-launch-1.0 -e \ |
||||||
|
v4l2src device="$DEV" io-mode=2 ! \ |
||||||
|
"$VIDEO_CAPS" ! \ |
||||||
|
videoconvert ! video/x-raw,format=UYVY ! \ |
||||||
|
"${CAPTURE_QUEUE[@]}" ! \ |
||||||
|
ndisink ndi-name="${NDI_CAPTURE_NAME}" sync=false qos=true |
||||||
|
fi |
||||||
|
fi |
||||||
|
EOF |
||||||
|
chmod 0755 "$INSTALL_DIR/bin/ndi-capture.sh" |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# Display helper |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
cat > "$INSTALL_DIR/bin/ndi-display.sh" <<'EOF' |
||||||
|
#!/usr/bin/env bash |
||||||
|
set -Eeuo pipefail |
||||||
|
source /etc/ndi-pi.conf |
||||||
|
|
||||||
|
log(){ echo "[ndi-display] $*"; } |
||||||
|
warn(){ echo "[ndi-display] WARN: $*" >&2; } |
||||||
|
|
||||||
|
find_kms_connector() { |
||||||
|
local driver="${KMS_DRIVER:-vc4}" wanted="${KMS_CONNECTOR_ID:-auto}" line |
||||||
|
if [[ "$wanted" != "auto" && "$wanted" =~ ^[0-9]+$ ]]; then echo "$wanted"; return 0; fi |
||||||
|
command -v modetest >/dev/null 2>&1 || return 1 |
||||||
|
line="$(modetest -M "$driver" -c 2>/dev/null | awk '$3 == "connected" {print $1; exit}')" |
||||||
|
[[ "$line" =~ ^[0-9]+$ ]] || return 1 |
||||||
|
echo "$line" |
||||||
|
} |
||||||
|
|
||||||
|
KMS_CONNECTOR="$(find_kms_connector || true)" |
||||||
|
if [[ -z "$KMS_CONNECTOR" ]]; then |
||||||
|
warn "Kein verbundener ${KMS_DRIVER:-vc4}-HDMI-Connector gefunden." |
||||||
|
exit 1 |
||||||
|
fi |
||||||
|
log "DRM/KMS: driver=${KMS_DRIVER:-vc4}, connector-id=${KMS_CONNECTOR}" |
||||||
|
|
||||||
|
resolve_ndi_address() { |
||||||
|
local source="$1" |
||||||
|
command -v avahi-browse >/dev/null 2>&1 || return 1 |
||||||
|
timeout 8 avahi-browse -rtp _ndi._tcp 2>/dev/null | |
||||||
|
awk -F';' -v wanted="$source" '$1 == "=" && $4 == wanted && $8 ~ /^[0-9]+([.][0-9]+){3}$/ && $9 ~ /^[0-9]+$/ {print $8 ":" $9; exit}' | head -n 1 |
||||||
|
} |
||||||
|
|
||||||
|
NDI_ADDRESS="${NDI_DISPLAY_ADDRESS:-auto}" |
||||||
|
if [[ "${NDI_USE_DIRECT_ADDRESS:-true}" == "true" && ( -z "$NDI_ADDRESS" || "$NDI_ADDRESS" == "auto" ) ]]; then |
||||||
|
NDI_ADDRESS="$(resolve_ndi_address "$NDI_DISPLAY_SOURCE" || true)" |
||||||
|
[[ -n "$NDI_ADDRESS" ]] && log "NDI-Service aufgelöst: ${NDI_DISPLAY_SOURCE} -> ${NDI_ADDRESS}" || true |
||||||
|
elif [[ "${NDI_USE_DIRECT_ADDRESS:-true}" == "true" && -n "$NDI_ADDRESS" && "$NDI_ADDRESS" != "auto" ]]; then |
||||||
|
log "Verwende konfigurierte NDI-Adresse: ${NDI_ADDRESS}" |
||||||
|
fi |
||||||
|
|
||||||
|
if [[ "${NDI_USE_DIRECT_ADDRESS:-true}" == "true" && -n "$NDI_ADDRESS" && "$NDI_ADDRESS" != "auto" ]]; then |
||||||
|
log "Verwende ndisrc url-address=${NDI_ADDRESS}" |
||||||
|
NDI_SRC_ARGS=(ndisrc "url-address=${NDI_ADDRESS}" "color-format=bgrx-bgra" "max-queue-length=${NDI_MAX_QUEUE:-0}" "connect-timeout=10000" "timeout=5000") |
||||||
|
else |
||||||
|
log "Verwende ndisrc ndi-name=${NDI_DISPLAY_SOURCE} (Fallback)" |
||||||
|
NDI_SRC_ARGS=(ndisrc "ndi-name=${NDI_DISPLAY_SOURCE}" "color-format=bgrx-bgra" "max-queue-length=${NDI_MAX_QUEUE:-0}" "connect-timeout=10000" "timeout=5000") |
||||||
|
fi |
||||||
|
|
||||||
|
WIDTH="${DISPLAY_WIDTH:-1920}" |
||||||
|
HEIGHT="${DISPLAY_HEIGHT:-1080}" |
||||||
|
FPS="${DISPLAY_FPS:-60}" |
||||||
|
STANDBY_PID="" |
||||||
|
|
||||||
|
# Keep the standby self-contained and explicitly sized. Without a capsfilter, |
||||||
|
# videotestsrc negotiates its own small default size and kmssink can display that |
||||||
|
# image only in the middle of the HDMI output. The explicit caps below make the |
||||||
|
# standby a real fullscreen framebuffer at the configured HDMI mode. |
||||||
|
HOST_SHORT="$(hostname -s 2>/dev/null || hostname)" |
||||||
|
HOST_SHORT="${HOST_SHORT^^}" |
||||||
|
LOCAL_IP="$(hostname -I 2>/dev/null | awk '{print $1}')" |
||||||
|
LOCAL_IP="${LOCAL_IP:-unknown}" |
||||||
|
STANDBY_TEXT="NO SIGNAL ${HOST_SHORT} IP:${LOCAL_IP} HDMI:${WIDTH}x${HEIGHT}@${FPS} NDI:${NDI_DISPLAY_SOURCE}" |
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
stop_standby() { |
||||||
|
if [[ -n "${STANDBY_PID:-}" ]]; then |
||||||
|
kill "$STANDBY_PID" 2>/dev/null || true |
||||||
|
wait "$STANDBY_PID" 2>/dev/null || true |
||||||
|
STANDBY_PID="" |
||||||
|
fi |
||||||
|
} |
||||||
|
|
||||||
|
start_standby() { |
||||||
|
stop_standby |
||||||
|
log "Aktiviere schwarzen HDMI-Standby (Fullscreen ${WIDTH}x${HEIGHT}@${FPS})." |
||||||
|
|
||||||
|
env NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-launch-1.0 -q \ |
||||||
|
videotestsrc pattern=black is-live=true ! \ |
||||||
|
"video/x-raw,format=BGRA,width=${WIDTH},height=${HEIGHT},framerate=${FPS}/1" ! \ |
||||||
|
textoverlay text="${STANDBY_TEXT}" \ |
||||||
|
halignment=center valignment=center \ |
||||||
|
font-desc="Sans Bold, 32" \ |
||||||
|
shaded-background=true \ |
||||||
|
! video/x-raw,format=BGRA ! \ |
||||||
|
kmssink driver-name="${KMS_DRIVER:-vc4}" connector-id="$KMS_CONNECTOR" sync=false \ |
||||||
|
>/tmp/ndi-display-standby.log 2>&1 & |
||||||
|
STANDBY_PID=$! |
||||||
|
|
||||||
|
sleep 0.8 |
||||||
|
if ! kill -0 "$STANDBY_PID" 2>/dev/null; then |
||||||
|
warn "HDMI-Standby konnte nicht gestartet werden. Ausgabe:" |
||||||
|
sed 's/^/[ndi-standby] /' /tmp/ndi-display-standby.log >&2 || true |
||||||
|
STANDBY_PID="" |
||||||
|
return 1 |
||||||
|
fi |
||||||
|
|
||||||
|
log "HDMI-Standby ist fullscreen aktiv (PID=${STANDBY_PID})." |
||||||
|
} |
||||||
|
|
||||||
|
cleanup() { |
||||||
|
stop_standby |
||||||
|
} |
||||||
|
trap cleanup EXIT INT TERM |
||||||
|
|
||||||
|
# Important for service restarts: do not first grab the DRM connector with a |
||||||
|
# standby kmssink and then immediately release it for the live kmssink. When the |
||||||
|
# NDI source is available, go directly to the verified live path. Only if that |
||||||
|
# path exits do we acquire KMS for the standby screen. |
||||||
|
while true; do |
||||||
|
log "Starte NDI-Livepipeline für ${NDI_DISPLAY_SOURCE}." |
||||||
|
|
||||||
|
set +e |
||||||
|
env NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-launch-1.0 -e \ |
||||||
|
"${NDI_SRC_ARGS[@]}" ! \ |
||||||
|
ndisrcdemux name=d \ |
||||||
|
d.video ! \ |
||||||
|
queue max-size-buffers=2 max-size-time=0 max-size-bytes=0 leaky=downstream ! \ |
||||||
|
videoscale add-borders=true ! \ |
||||||
|
"video/x-raw,width=${WIDTH},height=${HEIGHT},pixel-aspect-ratio=1/1" ! \ |
||||||
|
kmssink driver-name="${KMS_DRIVER:-vc4}" connector-id="$KMS_CONNECTOR" sync=false \ |
||||||
|
d.audio ! queue ! fakesink sync=false |
||||||
|
rc=$? |
||||||
|
set -e |
||||||
|
|
||||||
|
warn "NDI-Livepipeline beendet (rc=$rc). Rückkehr zu schwarzem Standby." |
||||||
|
start_standby || true |
||||||
|
|
||||||
|
# Keep the fullscreen standby active while the source is unavailable. Do not |
||||||
|
# repeatedly tear down/recreate kmssink: that was the visible flicker reported |
||||||
|
# during service restarts/source outages. Retry only after the NDI service can |
||||||
|
# be resolved/reached again. |
||||||
|
while true; do |
||||||
|
sleep 2 |
||||||
|
candidate="$NDI_ADDRESS" |
||||||
|
if [[ "${NDI_USE_DIRECT_ADDRESS:-true}" == "true" && ( -z "$candidate" || "$candidate" == "auto" ) ]]; then |
||||||
|
candidate="$(resolve_ndi_address "$NDI_DISPLAY_SOURCE" || true)" |
||||||
|
fi |
||||||
|
|
||||||
|
if [[ -n "$candidate" && "$candidate" != "auto" && "$candidate" == *:* ]]; then |
||||||
|
host="${candidate%:*}" |
||||||
|
port="${candidate##*:}" |
||||||
|
if [[ "$port" =~ ^[0-9]+$ ]] && timeout 1 bash -c "</dev/tcp/$host/$port" 2>/dev/null; then |
||||||
|
log "NDI-Service wieder erreichbar (${candidate}); beende Standby und versuche Live erneut." |
||||||
|
NDI_ADDRESS="$candidate" |
||||||
|
if [[ "${NDI_USE_DIRECT_ADDRESS:-true}" == "true" ]]; then |
||||||
|
NDI_SRC_ARGS=(ndisrc "url-address=${NDI_ADDRESS}" "color-format=bgrx-bgra" "max-queue-length=${NDI_MAX_QUEUE:-0}" "connect-timeout=10000" "timeout=5000") |
||||||
|
fi |
||||||
|
stop_standby |
||||||
|
break |
||||||
|
fi |
||||||
|
fi |
||||||
|
done |
||||||
|
done |
||||||
|
EOF |
||||||
|
chmod 0755 "$INSTALL_DIR/bin/ndi-display.sh" |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# Diagnostic tool |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
cat > "$INSTALL_DIR/bin/ndi-pi-diagnose" <<'EOF' |
||||||
|
#!/usr/bin/env bash |
||||||
|
set -u |
||||||
|
source /etc/ndi-pi.conf 2>/dev/null || true |
||||||
|
|
||||||
|
echo "=== NDI Pi Diagnose ===" |
||||||
|
echo "Kernel: $(uname -a)" |
||||||
|
echo "OS: $(. /etc/os-release; echo "${PRETTY_NAME:-unknown}")" |
||||||
|
echo |
||||||
|
echo "--- GStreamer ---" |
||||||
|
gst-launch-1.0 --version || true |
||||||
|
gst-inspect-1.0 ndisink ndisinkcombiner ndisrc ndisrcdemux kmssink 2>&1 | grep -E '^(Factory Details| Rank| Long-name| Description| Version| Author|Pad Templates| SINK| SRC| AUDIO| VIDEO)' || true |
||||||
|
echo |
||||||
|
echo "--- V4L2 ---" |
||||||
|
v4l2-ctl --list-devices || true |
||||||
|
for d in /dev/video*; do |
||||||
|
[[ -e "$d" ]] || continue |
||||||
|
echo "### $d" |
||||||
|
v4l2-ctl -d "$d" --all 2>/dev/null | grep -E 'Card type|Driver name|Bus info|Capabilities' || true |
||||||
|
v4l2-ctl -d "$d" --list-formats-ext 2>/dev/null | head -80 || true |
||||||
|
done |
||||||
|
echo |
||||||
|
echo "--- ALSA capture ---" |
||||||
|
arecord -l || true |
||||||
|
echo |
||||||
|
echo "--- ALSA playback ---" |
||||||
|
aplay -l || true |
||||||
|
echo |
||||||
|
echo "--- DRM ---" |
||||||
|
ls -l /dev/dri 2>/dev/null || true |
||||||
|
cat /sys/class/drm/*/status 2>/dev/null || true |
||||||
|
echo |
||||||
|
echo "--- NDI configuration ---" |
||||||
|
grep -E '^(NDI_DISPLAY_SOURCE|NDI_DISPLAY_ADDRESS|NDI_USE_DIRECT_ADDRESS|KMS_DRIVER|KMS_CONNECTOR_ID|ENABLE_HDMI_AUDIO|NDI_MAX_QUEUE)=' /etc/ndi-pi.conf 2>/dev/null || true |
||||||
|
echo |
||||||
|
echo "--- NDI discovery ---" |
||||||
|
if command -v gst-device-monitor-1.0 >/dev/null 2>&1; then |
||||||
|
NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-device-monitor-1.0 -f Source/Network:application/x-ndi 2>&1 | head -120 || true |
||||||
|
else |
||||||
|
echo "gst-device-monitor-1.0 nicht verfügbar" |
||||||
|
fi |
||||||
|
echo |
||||||
|
echo "--- NDI mDNS services ---" |
||||||
|
avahi-browse -rtp _ndi._tcp 2>&1 | head -80 || true |
||||||
|
echo |
||||||
|
echo "--- Services ---" |
||||||
|
systemctl --no-pager --full status ndi-capture.service ndi-display.service || true |
||||||
|
echo |
||||||
|
echo "--- ndi-capture.service journal (letzte 80 Zeilen) ---" |
||||||
|
journalctl -u ndi-capture.service -n 80 --no-pager || true |
||||||
|
echo |
||||||
|
echo "--- ndi-display.service journal (letzte 80 Zeilen) ---" |
||||||
|
journalctl -u ndi-display.service -n 80 --no-pager || true |
||||||
|
EOF |
||||||
|
chmod 0755 "$INSTALL_DIR/bin/ndi-pi-diagnose" |
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
# systemd |
||||||
|
# --------------------------------------------------------------------------- |
||||||
|
cat > /etc/systemd/system/ndi-capture.service <<'EOF' |
||||||
|
[Unit] |
||||||
|
Description=NDI Pi Gateway - USB Capture + Audio to NDI |
||||||
|
After=network-online.target sound.target |
||||||
|
Wants=network-online.target sound.target |
||||||
|
ConditionPathExists=/etc/ndi-pi.conf |
||||||
|
|
||||||
|
[Service] |
||||||
|
Type=simple |
||||||
|
Environment=NDI_RUNTIME_DIR_V6=/usr/local/lib |
||||||
|
ExecStart=/opt/ndi-pi/bin/ndi-capture.sh |
||||||
|
Restart=always |
||||||
|
RestartSec=1 |
||||||
|
Nice=-5 |
||||||
|
LimitNOFILE=65536 |
||||||
|
|
||||||
|
[Install] |
||||||
|
WantedBy=multi-user.target |
||||||
|
EOF |
||||||
|
|
||||||
|
cat > /etc/systemd/system/ndi-display.service <<'EOF' |
||||||
|
[Unit] |
||||||
|
Description=NDI Pi Gateway - NDI Video + Audio to HDMI/DRM |
||||||
|
After=network-online.target sound.target |
||||||
|
Wants=network-online.target sound.target |
||||||
|
ConditionPathExists=/etc/ndi-pi.conf |
||||||
|
|
||||||
|
[Service] |
||||||
|
Type=simple |
||||||
|
Environment=NDI_RUNTIME_DIR_V6=/usr/local/lib |
||||||
|
ExecStart=/opt/ndi-pi/bin/ndi-display.sh |
||||||
|
Restart=always |
||||||
|
RestartSec=1 |
||||||
|
Nice=-5 |
||||||
|
LimitNOFILE=65536 |
||||||
|
|
||||||
|
[Install] |
||||||
|
WantedBy=multi-user.target |
||||||
|
EOF |
||||||
|
|
||||||
|
systemctl daemon-reload |
||||||
|
systemctl enable ndi-capture.service ndi-display.service |
||||||
|
|
||||||
|
log "Prüfe NDI-GStreamer-Plugin..." |
||||||
|
NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-inspect-1.0 ndisink >/dev/null |
||||||
|
NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-inspect-1.0 ndisrc >/dev/null |
||||||
|
|
||||||
|
log "NDI Runtime:" |
||||||
|
ldconfig -p | grep -E 'libndi\.so\.6(\.|$)' || true |
||||||
|
ls -l "${NDI_RUNTIME_DIR_V6:-/usr/local/lib}"/libndi.so* 2>/dev/null || true |
||||||
|
|
||||||
|
systemctl restart ndi-capture.service |
||||||
|
systemctl restart ndi-display.service |
||||||
|
|
||||||
|
echo |
||||||
|
log "Installation abgeschlossen." |
||||||
|
echo |
||||||
|
echo "Konfiguration: $CONF" |
||||||
|
echo " sudo nano $CONF" |
||||||
|
echo |
||||||
|
echo "NDI Display:" |
||||||
|
echo " NDI_DISPLAY_SOURCE=${NDI_DISPLAY_SOURCE:-}" |
||||||
|
echo " NDI_DISPLAY_ADDRESS=${NDI_DISPLAY_ADDRESS:-auto}" |
||||||
|
echo " NDI_USE_DIRECT_ADDRESS=${NDI_USE_DIRECT_ADDRESS:-true}" |
||||||
|
echo |
||||||
|
echo "Diagnose:" |
||||||
|
echo " sudo /opt/ndi-pi/bin/ndi-pi-diagnose" |
||||||
|
echo |
||||||
|
echo "Nach Änderungen:" |
||||||
|
echo " sudo systemctl restart ndi-capture ndi-display" |
||||||
|
echo |
||||||
|
echo "Logs:" |
||||||
|
echo " journalctl -u ndi-capture -f" |
||||||
|
echo " journalctl -u ndi-display -f" |
||||||
|
echo |
||||||
|
echo "NDI-Quellen:" |
||||||
|
if command -v gst-device-monitor-1.0 >/dev/null 2>&1; then |
||||||
|
NDI_RUNTIME_DIR_V6="${NDI_RUNTIME_DIR_V6:-/usr/local/lib}" \ |
||||||
|
gst-device-monitor-1.0 -f Source/Network:application/x-ndi || true |
||||||
|
else |
||||||
|
log "gst-device-monitor-1.0 nicht verfügbar; NDI-Quellen werden nicht aufgelistet." |
||||||
|
fi |
||||||
Loading…
Reference in new issue