feat(sacn): Override-Zweig in der Licht-Engine

src/light/nl_engine.c

@@ -1,5 +1,7 @@
 #include "light/nl_engine.h"
 
+#include <string.h>
+
 #include "light/nl_color.h"
 
 typedef struct {
@@ -19,6 +21,11 @@ static uint32_t s_blink_t;
 static bool s_pulse;
 static uint32_t s_pulse_t;
 
+static bool     s_ov;                    /* Override haelt die Ausgabe */
+static uint8_t  s_ov_ch[NL_CH_COUNT];    /* zuletzt gesetzte Override-Kanaele */
+static uint32_t s_ov_fade_dur;           /* > 0: Rueckblende laeuft */
+static uint32_t s_ov_fade_el;
+
 static nl_visual_t to_visual(const nl_light_state_t *s)
 {
     nl_visual_t v;
@@ -69,6 +76,18 @@ static void emit(void)
         v = s_cur;
     }
     nl_visual_to_channels(&v, s_cfg.ct_min, s_cfg.ct_max, ch);
+
+    /* Blink und Pulse sind Rueckmeldungen des Geraets an den Menschen (Werksreset,
+     * Onboarding) - die muessen auch waehrend einer laufenden Show sichtbar bleiben. */
+    if (!s_blink_left && !s_pulse) {
+        if (s_ov) {
+            memcpy(ch, s_ov_ch, sizeof ch);
+        } else if (s_ov_fade_dur) {
+            int i;
+            for (i = 0; i < NL_CH_COUNT; i++)
+                ch[i] = (uint8_t)lerp(s_ov_ch[i], ch[i], s_ov_fade_el, s_ov_fade_dur);
+        }
+    }
     s_cfg.output(ch, s_cfg.ctx);
 }
 
@@ -84,6 +103,8 @@ void nl_engine_init(const nl_engine_cfg_t *cfg)
     s_blink_t = 0;
     s_pulse = false;
     s_pulse_t = 0;
+    s_ov = false;
+    s_ov_fade_dur = s_ov_fade_el = 0;
     emit();
 }
 
@@ -123,6 +144,12 @@ void nl_engine_tick(uint32_t elapsed_ms)
 {
     uint32_t left = elapsed_ms;
 
+    if (s_ov_fade_dur) {
+        s_ov_fade_el += elapsed_ms;
+        if (s_ov_fade_el >= s_ov_fade_dur)
+            s_ov_fade_dur = s_ov_fade_el = 0;
+    }
+
     while (s_iseg < s_nseg) {
         seg_t *s = &s_seg[s_iseg];
         if (s->elapsed + left >= s->dur) {
@@ -180,3 +207,24 @@ void nl_engine_pulse(bool enable)
     s_pulse_t = 0;
     emit();
 }
+
+void nl_engine_override(const uint8_t ch[NL_CH_COUNT])
+{
+    memcpy(s_ov_ch, ch, sizeof s_ov_ch);
+    s_ov = true;
+    s_ov_fade_dur = s_ov_fade_el = 0;
+}
+
+void nl_engine_override_clear(uint32_t fade_ms)
+{
+    if (!s_ov)
+        return;
+    s_ov = false;
+    s_ov_fade_dur = fade_ms;
+    s_ov_fade_el = 0;
+}
+
+bool nl_engine_override_active(void)
+{
+    return s_ov;
+}

src/light/nl_engine.h

@@ -29,4 +29,13 @@ void nl_engine_current(nl_visual_t *out);
 void nl_engine_blink(uint8_t count);
 void nl_engine_pulse(bool enable);
 
+/* DMX-Override: die Kanalwerte gehen unveraendert an die Ausgabe, ohne Fade und ohne
+ * Farbmischung. Rangfolge in emit(): Blink > Pulse > Override > Fade-Engine. Der
+ * darunterliegende Zustand laeuft unberuehrt weiter. */
+void nl_engine_override(const uint8_t ch[NL_CH_COUNT]);
+/* Beendet den Override. fade_ms > 0 blendet im Kanalraum auf das zurueck, was die
+ * Fade-Engine gerade ausgeben wuerde; 0 schaltet sofort um. */
+void nl_engine_override_clear(uint32_t fade_ms);
+bool nl_engine_override_active(void);
+
 #endif