feat: update-Entitaet fuer die Firmware und das Testgeruest

Aufgebaut wie ha-ninlight: die Abbilder liegen unter ninstrip_firmware im
Konfigurationsverzeichnis, Home Assistant liefert sie selbst unter einer
einmaligen Adresse aus, und zwar genau die Bytes, die vorher geprueft
wurden. Dazu firmware.py (Anhaenger, Versionsreihenfolge, WLAN-Pruefung,
Katalog), http.py, urls.py und shared.py.

Drei Unterschiede zu ninlight, alle aus der Firmware heraus:

* Verglichen wird device_type - die Platine -, nicht product. Letzteres ist
  bei allen Platinen 'ninstrip'; die Abbilder unterscheiden sich aber hart,
  die K1Y invertiert das Datensignal und die KL-RGBC3 nicht. Firmware ohne
  dieses Feld bekommt gar kein Angebot.
* Die WLAN-Pruefung sucht die SSID unverpackt: ein ESP32-Abbild ist nicht
  gzip-verpackt wie das des W600. An einem mit sdkconfig.local gebauten
  Abbild gegengeprueft - die SSID steht genau einmal NUL-gerahmt drin.
* Der Fehlerschluessel heisst device_url_too_long statt lamp_url_too_long.

Dazu das Testgeruest, das es hier bisher gar nicht gab: 204 Tests in
tests_unit/ (ohne HA-Instanz) und tests/ (mit), Abdeckung 97 %, dazu
scripts/check.sh als Ersatz fuer die fehlende CI. Die Nutzdaten in
tests_unit/samples.py sind an der Stehlampe abgefragt.

Beim Gegenpruefen per Mutation fiel auf, dass die Platinenpruefung
unmittelbar vor dem Senden ungeprueft war - der Test dazu ist jetzt da und
faellt, wenn man die Pruefung entfernt.
This commit is contained in:
Michael Sauer
2026-09-22 23:10:07 +02:00
parent d0a9487805
commit 2c77b2d325
44 changed files with 3600 additions and 43 deletions
+33
View File
@@ -0,0 +1,33 @@
"""Kuenstliche ninstrip-OTA-Abbilder: Nutzdaten + 512-Byte-NINL-Anhaenger.
Der Aufbau folgt ninstrip-firmware/tools/mkimage.py. Die Tests bauen sich ihre
Abbilder selbst, statt echte Firmware-Dateien mitzuschleppen.
Anders als bei ninlight liegen die Nutzdaten unverpackt vor: ein ESP32-Abbild
ist nicht gzip-verpackt, die einkompilierte SSID steht als Zeichenkette drin.
"""
from __future__ import annotations
import hashlib
CONTENT_WITH_SSID = b"\x00boot\x00ninIOT\x00ninstrip\x00"
CONTENT_WITHOUT_SSID = b"\x00boot\x00ninstrip\x00"
def build_image(
device_type: str = "ninstrip-k1y",
version: str = "0.1.0-47-g71a57",
*,
payload: bytes = CONTENT_WITH_SSID,
magic: bytes = b"NINL",
fmt: int = 1,
corrupt_hash: bool = False,
) -> bytes:
trailer = bytearray(b"\xff" * 512)
trailer[0:4] = magic
trailer[4] = fmt
trailer[5:21] = device_type.encode().ljust(16, b"\x00")
trailer[21:37] = version.encode().ljust(16, b"\x00")
trailer[37:69] = bytes(32) if corrupt_hash else hashlib.sha256(payload).digest()
return payload + bytes(trailer)