Bild-in-Bild für den Jetson Nano 2GB (BELABOX-Image, JetPack 4.6.4 / L4T 32.7.4): mehrere Kameras zu einem Bild mischen und über SRT/SRTLA senden. Eigenständiges Projekt, die Jetson-Ausgabe von IRL4YOU PIP.
Webseite: irl4you.de · Schwesterprojekt: IRL4YOU BOX · Fehler und Wünsche: Issues
Version 1.0: Läuft auf dem Jetson Nano 2GB mit BELABOX-Image (JetPack 4.6.4). Die Versionsnummer steht in
VERSION, die Änderungen in CHANGELOG.md. Geprüft sind Dauerbetrieb (eine Stunde und eine ganze Nacht), Neuinstallation auf einem rohen BELABOX-Image und das Einspielen von Updates über die Oberfläche. Das 4-GB-Modell ist nicht getestet.
- Bild-in-Bild mit bis zu vier Kameras (ein Hauptbild, bis zu drei kleine Bilder), gemischt in der Video-Hardware des Jetson (Decoder, Bildwandler, Compositor, H.265-Encoder). Die CPU bleibt dabei frei: im Dauertest über eine Stunde mit mehreren Kameras und laufender Sendung im Mittel 34 % frei, nie unter 15 %.
- Alle Kameras immer bereit: Tausch von Haupt- und kleinem Bild ohne Unterbrechung, Verzögerung je Kamera bis 750 ms. Fällt die Hauptkamera aus (Kabel gezogen, Akku leer), übernimmt nach etwa 2 Sekunden die erste vorhandene Kamera der kleinen Bilder das Hauptbild, bei der Rückkehr nach 3 Sekunden wieder die eigentliche Hauptkamera. Eine ausgefallene kleine Kamera verschwindet aus dem Bild. Die Sendung läuft in jedem Fall weiter; nur wenn gar keine Kamera mehr liefert, bleibt das Hauptbild schwarz.
- Senden über SRT und SRTLA (Bündelung mehrerer Leitungen, zum Beispiel LAN, WLAN und Handy-Hotspot) mit angepasstem
belacoderundsrtla_send(Bitratenregler, Wegewahl, Kennzahlen). - Kameras:
- USB-Kamera (zum Beispiel DJI Osmo Action 4 im USB-Modus, Webcam oder HDMI-USB-Grabber): 1080p mit 30 Bildern je Sekunde und 8000 kbit/s, gemessen genau 30,0 fps. MJPEG der Kamera wird in der Video-Hardware dekodiert und neu kodiert. Getestet mit HDMI-USB-Grabbern: Elgato Cam Link 4K (unkomprimiertes 1080p, die HDMI-Quelle muss 1080p ausgeben). Andere UVC-Grabber gehen wahrscheinlich, sind aber nicht getestet.
- Testbild (ohne Kamera): bewegtes Bild mit Zeitanzeige und Stereo-Testton (links tief, rechts hoch), zum Prüfen der ganzen Kette bis zum Server. Auswahl in der Karte „USB-Kameras“ unter „Quelle“.
- DJI-Kameras per Bluetooth (Kopplung, Steuerung, Akkustand), bewährter Stick: ASUS USB-BT500.
- RTMP-Kameras (zum Beispiel Handy-Apps oder Action-Cams), die an die Box senden.
- Weboberfläche (Port 8780, 14 Sprachen): Live, Vorschau, Status, Bildaufbau (Positionen, Rahmen, Beschnitt, Facecam), Verbindungen (WLAN, Bluetooth, Upload-Leitungen), SRTLA-Einstellungen, Streamer.bot-Deck, Chat und Systemwarnungen im Twitch-Chat, öffentliche Statistik für OBS und Homepage, Einstellungen sichern, Protokolle.
- Update über die Oberfläche (Karte Software-Update, mit Fortschritt) und Fernzugriff über Tailscale.
- Kein Verpixeln (Köpfe, Kennzeichen) und kein HDMI-Eingang: Der Jetson Nano hat keinen. Kameras kommen über USB (Webcam oder HDMI-USB-Grabber), RTMP oder DJI-Bluetooth.
- Keine abgerundeten Ecken bei den kleinen Bildern: Der Compositor der Video-Hardware (
nvcompositor) kennt keine Rundung, die Einstellung ist in der Oberfläche ausgeblendet. Rahmen, Beschnitt, Deckkraft und alle sechs Positionen gibt es. - Höchstens vier Kameras gleichzeitig im Bild (ein Hauptbild, drei kleine).
- Kamerawechsel bei „Eine Kamera“: Wählst du dort eine andere Kamera als Hauptbild, startet die Sendekette neu (ein paar Sekunden ohne Bild), weil der Hardware-Decoder den Strom nicht wechseln kann. Beim Bild-in-Bild tauschen nur die Rollen, ohne Unterbrechung.
- H.264 direkt aus der USB-Kamera ist mit dem Kernel 4.9 nicht nutzbar; die Box nimmt MJPEG, dekodiert und kodiert es in der Video-Hardware neu (1080p, 30 Bilder pro Sekunde, wählbare Bitrate).
- Bluetooth-Sticks: Bewährt ist der ASUS USB-BT500 (Realtek RTL8761B). Nachbauten des CSR8510 verbinden sich mit DJI-Kameras oft nicht zuverlässig. Bei Überstrom einen USB-Hub mit eigenem Netzteil nehmen.
- Das 4-GB-Modell ist nicht getestet. Gesperrt ist es nicht: Die Installation prüft das Modell nicht. Wer ein 4-GB-Modell hat, kann das Paket gern ausprobieren und sich bei Fehlern über ein Issue melden, am besten mit der Protokolldatei (siehe „Fehler melden“).
Voraussetzung: Jetson Nano 2GB mit BELABOX-Image, Internet und ein Terminal (SSH). Nicht während einer Übertragung.
cd /tmp && rm -rf irl4you-jetson-2gb-pip-main irl4you-jetson-2gb-pip.tar.gz && wget -q -O irl4you-jetson-2gb-pip.tar.gz https://github.com/IRL4YOU/irl4you-jetson-2gb-pip/archive/refs/heads/main.tar.gz && tar xzf irl4you-jetson-2gb-pip.tar.gz && cd irl4you-jetson-2gb-pip-main && sudo sh install/setup.shDas Skript
- aktualisiert das Grundsystem (Fortschrittsbalken, Paketliste im Protokoll
~/install-ausgabe.txt), - installiert die fehlenden Werkzeuge (
gstreamer1.0-tools,git,curl) und richtet die Weboberfläche als Dienstpipboxein (Autostart, Port 8780), - meldet am Ende „Alles fehlerfrei installiert“ oder die Hinweise. Bringt das Update einen neuen Kernel mit, sagt es, dass neu gestartet werden soll.
Ohne Systemupdate: sudo sh install/setup.sh --ohne-systemupdate. Rückweg: sudo sh install/install.sh uninstall.
| Pfad | Inhalt |
|---|---|
install/setup.sh |
Komplett-Einrichtung (Systemupdate, dann install.sh) |
install/install.sh |
Pakete, Benutzer, Dateien und Dienst einrichten, uninstall |
install/pipbox.service |
systemd-Dienst der Weboberfläche |
pipbox/ |
Weboberfläche und Dienste (Python 3.6, nur Standardbibliothek): Sendekette, Weichen, Kameradienste |
belacoder/, srtla/ |
Patches für belacoder und srtla_send, die bei der Einrichtung auf dem Gerät gebaut werden |
Die Oberfläche erreichst du danach unter http://<Adresse des Jetson>:8780.
Wenn etwas nicht geht, hilft die Protokolldatei der Box am meisten:
- In der Oberfläche die Karte Protokolle öffnen und Protokolle herunterladen drücken. Die Box sammelt etwa eine halbe Minute lang (Journal der Dienste, Zustand der Sendekette, Kameras, Netzwerk, Jetson-Werte wie Video-Hardware und Takte, die Berichte unerwarteter Enden von belacoder) und liefert eine Textdatei
irl4you-protokolle-<Datum>.txt. - Die Datei ist bereinigt: Passwörter, Stream-ID, Serveradressen, WLAN-Namen, IP- und MAC-Adressen, Kamera-Schlüssel, Tailscale-Namen und Zugangsschlüssel sind durch Platzhalter ersetzt (gleiche Werte haben gleiche Nummern). Eigene Bezeichnungen (Name des Servers, Name einer Kamera) bleiben lesbar; bitte vor dem Weitergeben kurz durchsehen.
- Die Datei an ein Issue auf GitHub anhängen, mit Uhrzeit des Problems (die Zeiten in der Datei sind UTC) und einem Satz, was zu sehen war.
Dieses Paket baut auf der Arbeit anderer auf. Danke an:
- IRL4YOU BOX (MIT): Die Weboberfläche stammt aus diesem Projekt und wurde für den Jetson Nano 2GB und Python 3.6 angepasst.
- Moblin von Erik Moqvist (MIT): Ablauf und Nachrichtenformat der DJI-Kopplung per Bluetooth. Gegenprobe mit dimadesu/dji-remote (MIT).
- Bittersweet1987 (MIT, mit Erlaubnis des Urhebers): Sitzungsablauf, Befehle und Oberfläche der DJI-Kameras.
- bleak von Henrik Blidh (MIT): Bluetooth-Bibliothek.
- BELABOX (
belacoderGPL-3.0,srtla_sendAGPL-3.0): Sendekette und Bündelung. Dieses Repository enthält nur die eigenen Änderungen als Patch-Dateien.
Die genauen Lizenztexte und Quellen stehen in NOTICE.md. Unabhängiges Zusatzprojekt, kein Produkt von BELABOX, NVIDIA oder DJI.
MIT, siehe LICENSE.