IRL4YOU BELABOX NETZWERK-OVERLAY 1.2.0
============================================

Freigegebener und geprüfter Umfang dieser Version:

- Orange Pi 5 Plus (Version 1.2.0 mit Kreis- und Balkenansicht geprüft)
- Radxa ROCK 5B Plus (Version 1.0 und 1.1.0 vollständig geprüft;
  Version 1.2.0 verwendet denselben RK3588-Encoderpfad)
- lokaler RTMP-Eingang: rtmp://127.0.0.1/publish/live mit 1080p30 oder 1080p60
- HDMI-Eingang des jeweiligen Boards mit Bild und HDMI-Ton
- USB/UVC-Kamera mit 1080p30 und USB-Ton; praktisch geprüft mit DJI Action 5 Pro
- Kreis- oder kompakte Balkenansicht mit bis zu acht aktiven Verbindungen
- H.265-Ausgabe über den Hardware-Encoder der Box
- während des Betriebs angeschlossene, entfernte oder nicht verbundene
  konfigurierte Netzwerkschnittstellen werden automatisch ein- oder ausgeblendet
- sichtbare Kreise werden ohne Leerstellen als geschlossene Gruppe zentriert

Kreise und Balken zeigen wahlweise den prozentualen Anteil jeder eingebundenen
Verbindung, deren tatsächlich gemessene Kilobit pro Sekunde am aktuellen
Upload oder nur den farbigen Kreis samt Anzeigenamen ohne Zahlenwert. Im
Kilobit-Modus steht zur besseren Lesbarkeit nur die Zahl im Kreis. Im
Statusmodus verschwinden nur die Zahlen der einzelnen Verbindungen. Der
Gesamt-Kreis kann unabhängig davon seine Werte zeigen, ohne Werte erscheinen
oder über @show_total=nein vollständig ausgeschaltet werden.
Eine dezente dunkle Innenfläche mit 40 Prozent Deckkraft hält die Zahlen auch
vor hellen oder unruhigen Videobildern lesbar.
Der Gesamt-Kreis zeigt die gemessene Gesamtbandbreite und die RTT des
SRT-Ausgangs. Die Anzeige ist kein Geschwindigkeitstest und zeigt nicht die
maximale Kapazität der Leitungen.

INSTALLATION
------------

1. Paket vollständig auf die BELABOX kopieren.
2. Als root in den Paketordner wechseln.
3. Ausführen: bash ./INSTALLIEREN.sh
4. Die BELABOX-Seite neu laden und eine dieser Pipelines auswählen:
   - custom/irl4you_rtmp_network_overlay_1080p30
   - custom/irl4you_rtmp_network_overlay_1080p60
   - custom/irl4you_hdmi_network_overlay
   - custom/irl4you_usb_network_overlay_1080p30
5. Stream starten.

Die Installation prüft Gerät, Architektur, Prüfsummen und benötigte
GStreamer-Module. Sie stellt bei Bedarf das originale BELABOX-Paket
belacoder-pipelines-rk3588 wieder her und korrigiert die Hardwarekennung auf
rk3588. Die originalen BELABOX-Pipelines werden dabei nicht überschrieben.
Die benötigten GStreamer-Laufzeitpakete werden bei Bedarf automatisch über die
Paketverwaltung ergänzt. Der vorherige Stand wird unter
/opt/irl4you/network-overlay/backups gesichert. Die BELABOX-Oberfläche wird
zum Abschluss neu gestartet; ein laufender Stream sollte deshalb vor der
Installation beendet werden.

Bei der ersten Installation wird die ursprüngliche BELABOX-Sicherung dauerhaft
als Ausgangspunkt für eine spätere vollständige Deinstallation vorgemerkt.

EINGÄNGE
--------

RTMP:
- Quelle sendet an rtmp://127.0.0.1/publish/live
- passende 30- oder 60-FPS-Pipeline auswählen

HDMI:
- Kamera oder HDMI-Quelle mit dem HDMI-Eingang des Boards verbinden
- custom/irl4you_hdmi_network_overlay auswählen
- HDMI als Audioquelle verwenden

USB/UVC-Kamera:
- datenfähiges USB-Kabel verwenden und an der Kamera den Webcam-/UVC-Modus wählen
- custom/irl4you_usb_network_overlay_1080p30 auswählen
- die von der BELABOX erkannte USB-Audioquelle der Kamera verwenden
- praktisch geprüft wurde dieser Weg mit einer DJI Action 5 Pro; andere
  UVC-Kameras und Actioncams müssen mit ihrem jeweiligen USB-Modus getestet werden

KONFIGURATION
-------------

Datei: /etc/irl4you-net-overlay.conf

Beispiel:

eth0=LAN 1|#EB007A
eth1=LAN 2|#F01100
wlan0=WLAN|#2F7AF2
eth2=USB-LAN|#F3B33D
@layout=balken
@show_temperature=ja
@show_total=ja
@show_total_values=ja
@total_label=Gesamt
@total_color=#B8C2D1
@text_color=#EDF2FA
@inner_opacity=40
@interface_value=prozent
@position=unten_rechts
@update_ms=2000

Nach einer Änderung den Stream einmal stoppen und neu starten. Die
Aktualisierungszeit darf zwischen 500 und 10000 Millisekunden liegen.
Mit @layout=kreise oder @layout=balken wird die gewünschte Darstellung gewählt.
Die Balkenansicht zeigt bei @show_temperature=ja zusätzlich die lokal gelesene
Temperatur der Box.
Bei @interface_value sind die Werte prozent, kbit und status erlaubt. Der Wert
status blendet die Zahl im Verbindungskreis aus; Kreis und Anzeigename bleiben.
Mit @show_total_values=ja bleiben Gesamt-Upload und Millisekunden auch im
Statusmodus sichtbar. Mit nein bleibt nur der beschriftete Gesamt-Kreis.
Die gemeinsame Schriftfarbe wird mit @text_color gesetzt. @inner_opacity steuert
die dunkle Kreis-Innenfläche in Prozent von 0 bis 100; empfohlen sind 40.
Als Position sind oben_links, oben_rechts, unten_links und unten_rechts erlaubt.
Bei einer rechten Position bleibt der rechte Rand fest; zusätzliche sichtbare
Kreise erweitern die Gruppe nach links. Bis zu vier Anzeigen stehen in einer
Reihe. Bei weiteren aktiven Schnittstellen werden automatisch zusätzliche
kompakte Reihen gebildet; alle bis zu acht konfigurierten Verbindungen können
dadurch gleichzeitig sichtbar sein.

ZURÜCKSETZEN
-------------

Als root im Paketordner ausführen: bash ./ZURUECKSETZEN.sh

Dadurch wird die letzte automatische Sicherung wiederhergestellt. Auch der
Zustand unmittelbar vor dem Zurücksetzen wird noch einmal gesichert.

DEINSTALLIEREN
--------------

Als root ausführen:
bash /opt/irl4you/network-overlay/release-1.2.0/DEINSTALLIEREN.sh

Dadurch wird der ursprüngliche BELABOX-Stand vor der ersten IRL4YOU-Installation
wiederhergestellt. Die Zusatz-Pipelines und die Overlay-Konfiguration werden nur
dann entfernt, wenn sie vor der ersten Installation nicht vorhanden waren. Der
Zustand unmittelbar vor der Deinstallation und alle bisherigen Sicherungen
bleiben erhalten.

PRÜFSTATUS
----------

Auf dem Orange Pi 5 Plus wurden Neuinstallation, RTMP 1080p30/60, HDMI mit
HDMI-Ton, DJI-USB 1080p30, Bild, Ton, dynamische Schnittstellenwechsel, Neustart
und ein zehnminütiger 1080p60-Dauertest erfolgreich geprüft. Auf dem ROCK 5B
Plus wurden zusätzlich Wiederherstellung, Fehlkonfiguration und drei
kontrollierte Stream-Neustarts geprüft.

Bei Routern, die per USB als Netzwerkschnittstelle angebunden sind, kann die
USB-LAN-Verbindung nach einem Neustart der Box zunächst fehlen. In diesem Fall
das USB-Kabel einmal trennen und wieder anschließen. Sobald Linux die
Schnittstelle bereitstellt, nimmt das Overlay sie automatisch wieder auf.
Einzelheiten stehen in TESTBERICHT.txt.

LIZENZ UND QUELLCODE
--------------------

Der geänderte belacoder basiert auf dem BELABOX-Projekt und steht wie das
Original unter GNU GPL Version 3 oder neuer. Lizenztext, geänderter Quellcode,
Camlink-Hilfsquelle und ein reproduzierbares Build-Skript liegen im Paket.
Beim Aufruf als root ergänzt das Build-Skript auf einem frischen BELABOX-Image
fehlende Compiler- und GStreamer-Entwicklungspakete automatisch. Ohne
Root-Rechte nennt es stattdessen den vollständigen Installationsbefehl.
