feat(sacn): zweite Slot-Belegung "rgb" fuer pixelorientierte Werkzeuge

LedFx und Verwandte denken in RGB-Pixeln: Ihr e131-Geraet schreibt je Pixel genau drei Kanaele. Unsere Belegung beginnt mit einem Master-Dimmer, also landet deren erstes Pixel auf Dimmer, R, G - ein rotes Effektbild (255,0,0) hiesse bei uns "Dimmer 255, Rot 0, Gruen 0" und damit Dunkelheit. Von Hand eintragen liess sich eine Lampe schon, sie zeigte aber Unsinn. Der Dimmer bleibt fuer DMX-Pulte richtig, deshalb eine zweite Belegung statt einer anderen: layout = "dimmer" (Vorgabe, unveraendert) oder "rgb" (R,G,B, drei Slots auf jedem Board). Im rgb-Layout ist eine Lampe genau ein Pixel. Ein Board ohne Farbkanaele bekommt trotzdem ein Farbtripel. Genommen wird der groesste der drei Werte auf beide Weisskanaele: die Lampe folgt sichtbar der Helligkeit des Effekts, ohne dass ein Farbmodell in den DMX-Pfad kommt - genau das wird dort sonst bewusst vermieden. Die Obergrenze fuer start_slot haengt jetzt am Layout (512 - slots + 1). Ein Wechsel, der einen bisher zulaessigen start_slot unzulaessig macht, wird abgelehnt statt still verschoben: eine Lampe, die nach einer Einstellung woanders im Universe liegt als angegeben, findet niemand wieder. Das neue Settings-Feld beginnt bei Offset 216, dem sizeof davor, und ist durch eine eigene Pruefung zur Uebersetzungszeit und einen Migrationstest abgesichert - derselbe Fallstrick, der beim Schlussreview fuer sacn_enabled gefunden wurde.
2026-09-20 03:35:19 +02:00
parent 2c7ebac6d1
commit fbdf0c40ef
13 changed files with 311 additions and 32 deletions
@@ -35,7 +35,12 @@ typedef struct {
    uint16_t sacn_universe;   /* 1..63999 (Vorgabe 1) */
    uint16_t sacn_start_slot; /* 1..512 (Vorgabe 1) */
    uint8_t  sacn_hold;       /* 0 = nach dem Timeout zurueck zum HA-Zustand, 1 = halten */
-    uint8_t  _padding[1];     /* padding for 4-byte alignment of sizeof(nl_settings_t) */
+    uint8_t  _padding[1];     /* haelt sizeof auf einem Vielfachen von 4 */
+    uint8_t  sacn_layout;     /* Offset 216 - 0 = Dimmer voran, 1 = nur R,G,B (nl_dmx_layout_t).
+                               * Dieselbe Regel wie oben: neue Felder beginnen bei oder hinter
+                               * dem vorherigen sizeof (216), sonst ueberschreibt das Fuellbyte
+                               * eines aelteren Satzes sie. */
+    uint8_t  _padding2[3];    /* haelt sizeof auf einem Vielfachen von 4 */
 } nl_settings_t;

 void nl_settings_defaults(nl_settings_t *s);