# ninlight

Lokale Firmware für die alten Klyqa-Lampen mit WinnerMicro W600 (E27/E14/GU10 RGB+CW, E27/E14/GU10 CW, G95 Vintage) und das W600-EVK.

## Voraussetzungen

- **Docker Desktop** (primärer Build-Pfad, erste Ausführung baut das Image `ninlight-build`)
- **CMake ≥ 3.20**, Ninja, host C compiler (für Host-Tests)
- **uv** (für die serielle Konsole)
- ARM GNU Toolchain mit newlib: `brew install --cask gcc-arm-embedded` (nur Fallback für nativen Build)

## Bauen

Docker (empfohlen – kein lokaler ARM-Compiler nötig):

    tools/docker.sh cmake -S . -B build/evk -G Ninja -DCMAKE_TOOLCHAIN_FILE=cmake/arm-none-eabi.cmake -DNINLIGHT_DEVICE=evk
    tools/docker.sh cmake --build build/evk
    tools/docker.sh tools/build_all.sh              # alle 8 Geräte

Für die tägliche Entwicklung: nur das Gerät bauen, das du verwendest (z.B. `tools/docker.sh cmake --build build/evk`). Der emulierte Docker-Build ist langsam — `build_all.sh` ist nur für Releases gedacht.

Native Builds (mit lokal installierter ARM-Toolchain):

    cmake -S . -B build/evk -G Ninja -DCMAKE_TOOLCHAIN_FILE=cmake/arm-none-eabi.cmake -DNINLIGHT_DEVICE=evk
    cmake --build build/evk

**Geräte:** evk, e27_rgb, e14_rgb, gu10_rgb, e27_cw, e14_cw, gu10_cw, g95_cw.

**Lokale Einstellungen** (Token, später WLAN): `config.local.cmake.example` → `config.local.cmake`.

## Tests

Host-basierte Unit-Tests (laufen nativ auf dem Mac):

    tools/test_host.sh

## Flashen und Konsole

Verfügbare Ports anzeigen:

    build/host-tools/wm_tool -l

Firmware flashen (Standard: App-Image):

    tools/flash.sh <device> <port>

Das Skript druckt `Bitte bei "please manually reset the device" die Reset-Taste drücken.` — wenn wm_tool diese Nachricht zeigt, musst du die Reset-Taste am EVK drücken (Baud 460800). Für blank/erased Chips: `tools/flash.sh <device> <port> full` (flasht stattdessen das Vollbild mit secboot, auf Hardware noch ungetestet).

Serielle Konsole (115200 8N1, lokales Echo):

    tools/monitor.sh /dev/cu.<port>

Verfügbare Befehle in der Konsole: `help`.

## Netzwerk & REST

- WLAN fest einbauen: `NINLIGHT_WIFI_SSID` / `NINLIGHT_WIFI_PASSWORD` in `config.local.cmake` (gespeicherte Einstellungen haben Vorrang).
- Ohne WLAN-Daten (oder nach Werksreset) öffnet die Lampe den AP `ninlight-<mac4>` (Passwort `NINLIGHT_AP_PASSWORD`, Default `ninlight`) und pulsiert warmweiß. Onboarding:

      curl -X PUT http://192.168.4.1:3333/api/v1/system/settings \
           -d '{"type":"wifi","ssid":"MeinWLAN","password":"geheim123"}'
      curl http://192.168.4.1:3333/api/v1/system/info    # wifi.sta_ip / wifi.error

  Der Aufruf ohne `Authorization`-Header funktioniert nur im unkonfigurierten AP (noch keine
  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`).
- 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.

## Werksreset

Gerät 5× hintereinander einschalten, jeweils kürzer als 5 Sekunden.

## Hardwaretests

Manuelle Checkliste: `docs/hardware-checklist.md`.