Files
ninlight-w600/src/light/nl_control.h
T
Michael SauerandClaude Opus 5 00d5a4c532 feat: Default-Transition, Weckschalter und farbfreier Ausschaltfade
Zwei neue Einstellungen, beide wie fade_in/fade_out ueber
POST /api/v1/device/state les- und schreibbar und sofort wirksam:

- transition_default (Voreinstellung 300 ms) fuellt die Transition fuer
  Farb-, Weiss- und Helligkeitswechsel bei eingeschalteter Lampe, wenn der
  Aufruf kein eigenes "transition" mitbringt. Beim Ein- und Ausschalten
  behalten fade_in/fade_out weiterhin Vorrang.
- wake_on_change (Voreinstellung aus) schaltet die Lampe bei einer Farb-,
  Weiss- oder Helligkeitsaenderung ein, wenn sie aus war. Ein
  ausdrueckliches "on": false im selben Aufruf gewinnt immer.

Beide Felder haengen am Ende von nl_settings_t, damit bestehende Lampen
ueber die Laengentoleranz von read_rec() ihre echten Voreinstellungen
bekommen statt Nullen. nl_ctrl_set_fades() heisst jetzt
nl_ctrl_set_options().

Dazu ein Treiberfehler, der erst an der migrierten GU10 RGB auffiel: der
WY-Zweig von nl_sm2135eh_set() schrieb nur Header und WY-Daten, nie die
RGB-Datenregister. Der Chip behielt also die zuletzt gesetzte Farbe, und
bei einem direkten Wechsel Farbe -> Weiss (ohne Zwischenschritt ueber
dunkel) schaelte sie sich beim Ausblenden wieder frei. Der Header sendet
jetzt die - in Weiss immer nullwertigen - RGB-Daten mit.

Die Bruno-Collection zeigt Transition jetzt zusammen mit einem Farb- und
einem Weisswechsel im selben Aufruf und hat einen Request fuer die
beiden neuen Einstellungen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 02:56:56 +02:00

57 lines
1.9 KiB
C

#ifndef NL_CONTROL_H
#define NL_CONTROL_H
#include <stdbool.h>
#include <stdint.h>
#include "board/nl_board.h"
#include "light/nl_light_types.h"
#define NL_MAX_TRANSITION_MS 60000u
#define NL_MAX_FADE_MS 10000u
#define NL_PERSIST_DELAY_MS 3000u
typedef struct {
bool has_on;
bool on;
bool has_brightness;
uint8_t brightness;
bool has_color;
uint8_t r, g, b;
bool has_ct;
uint16_t ct;
bool has_transition;
uint32_t transition_ms;
} nl_light_change_t;
typedef enum {
NL_CTRL_OK = 0,
NL_CTRL_ERR_NO_RGB,
NL_CTRL_ERR_COLOR_AND_CT,
NL_CTRL_ERR_BRIGHTNESS,
NL_CTRL_ERR_TRANSITION
} nl_ctrl_err_t;
/* The engine must be initialised before. Not thread safe: callers serialise access.
*
* transition_ms: default transition applied to a color/brightness/CT change while the lamp
* stays on and the caller did not send its own "transition" (fade_in/fade_out still take
* precedence when the lamp is switching on or off).
* wake_on_change: if true, a color/CT/brightness change arriving while the lamp is off
* switches it on (using fade_in), unless the same call also says "on": false. */
void nl_ctrl_init(const nl_board_t *board, uint16_t fade_in_ms, uint16_t fade_out_ms,
uint16_t transition_ms, bool wake_on_change);
void nl_ctrl_set_options(uint16_t fade_in_ms, uint16_t fade_out_ms, uint16_t transition_ms,
bool wake_on_change);
void nl_ctrl_boot(const nl_light_state_t *initial);
nl_ctrl_err_t nl_ctrl_apply(const nl_light_change_t *c, uint32_t now_ms);
void nl_ctrl_get(nl_light_state_t *out);
/* True once NL_PERSIST_DELAY_MS after the last change; out receives the state to store. */
bool nl_ctrl_persist_due(uint32_t now_ms, nl_light_state_t *out);
/* Clears the dirty flag only if nothing changed since `written` was taken. */
void nl_ctrl_persisted(const nl_light_state_t *written);
#endif