docs(sacn): Sender fuer die Abnahme, README und Bruno-Anfrage

README.md

@@ -65,12 +65,39 @@ Verfügbare Befehle in der Konsole: `help`.
   gespeicherten Zugangsdaten). Im Fallback-AP (Router war > 5 min weg, Lampe hat aber bereits
   Zugangsdaten) ist der Token-Header wie bei jedem anderen Endpunkt erforderlich.
   Nach Erfolg schließt der AP nach 60 s. Ohne Verbindung für 5 min öffnet die Lampe den AP zusätzlich (Fallback).
-- REST auf Port 3333, Präfix `/api/v1`: `GET|POST device/state`, `GET system/info`, `GET|PUT system/settings` und `PUT system/command` (beide mit Header `Authorization: <token>`, Default-Token `aabbccddeeff0011223344`).
+- REST auf Port 3333, Präfix `/api/v1`: `GET|POST device/state`, `GET system/info`, `GET|PUT system/settings` (kennt u.a. den Typ `sacn`, siehe unten) und `PUT system/command` (beide mit Header `Authorization: <token>`, Default-Token `aabbccddeeff0011223344`).
 - Beispiel: `curl -X POST http://ninlight-681f.local:3333/api/v1/device/state -d '{"on":true,"brightness":40,"color_temp":2700}'`
 - Suchen: `dns-sd -B _ninlight._tcp` (macOS), Details `dns-sd -L ninlight-681f _ninlight._tcp`.
 - Bruno: `bruno/ninlight.yml` importieren, Environment „EVK (mDNS)" bzw. „Onboarding-AP" wählen.
 - Konsole: `net` zeigt Modus, SSID, IP, RSSI und den letzten Onboarding-Fehler.
 
+### sACN / E1.31
+
+Die Lampe empfängt sACN (E1.31) auf UDP-Port 5568 — per Multicast auf
+`239.255.<universe_hi>.<universe_lo>` und per Unicast direkt an ihre IP. Nach einem
+Update ist der Empfang aktiv: Universe 1, Startslot 1.
+
+Slots ab `start_slot`: **Dimmer, R, G, B, CW, WW** (Boards ohne RGB: **Dimmer, CW, WW**).
+Wieviele es sind, steht als `slots` in `GET system/settings`.
+
+Während Pakete fließen, hat sACN Vorrang; die Werte gehen ohne Fade direkt an die
+Kanäle, und der per API gesetzte Zustand bleibt unangetastet. 2,5 s nach dem letzten
+Paket endet die Übernahme — je nach `on_timeout` fällt die Lampe auf den per API
+gesetzten Zustand zurück (`release`, Vorgabe) oder behält die letzten Werte (`hold`).
+Ein Befehl an `device/state` holt die Kontrolle in beiden Fällen sofort zurück.
+
+Umstellen:
+
+    curl -X PUT http://<lampe>:3333/api/v1/system/settings \
+         -H 'Authorization: <token>' \
+         -d '{"type":"sacn","universe":12,"start_slot":7,"on_timeout":"hold"}'
+
+Der Port ist offen und nicht authentifiziert — so sieht das Protokoll es vor. Wer im
+WLAN sitzt, kann die Lampe damit leuchten lassen, aber nichts einstellen und nichts
+speichern. Zum Abschalten: `{"type":"sacn","enabled":false}`.
+
+Zum Ausprobieren liegt ein Sender bei: `tools/sacn_send.py --values 255,255,0,0,0,0 --seconds 5`.
+
 ## Firmware-Update
 
 Der Build erzeugt pro Gerät zwei Images: