# Firmware installieren Dieses Paket enthält Recovery, App, Updateclient und dessen Layoutdateien. Für den HTTP-Client genügt Python 3.10 oder neuer mit Standardbibliothek. Die folgenden Befehle werden im entpackten Paketordner ausgeführt. Ein Quellcheckout und ein Firmwarebuild sind dafür nicht nötig. ## Passendes Gerät und Recovery Die Images sind für den CH32V208GBU6-Prototyp mit 200-mΩ-Shunt, festem PGA ×4 und R27/R28 = 100 kΩ/(10 kΩ parallel 3,3 kΩ) gebaut. Ein Board mit anderem Spannungsteiler braucht eine angepasste Skalierung. Die App der Art 4 braucht Layout ABI 3 und residente Recovery-Dienste der Hauptversion 1. Auch eine ältere ABI-3-Recovery ohne diese Dienste muss vor der App ersetzt werden. Die Recovery kann sich nicht über HTTP selbst aktualisieren. 1. `SHA256SUMS` prüfen, beispielsweise unter Linux mit `sha256sum -c SHA256SUMS`. Dateinamen und CRCs stehen zusätzlich in `manifest.json`. 2. Für Erstinstallation oder Recoverywechsel das Board ohne PoE-Versorgung per isoliertem USB-ISP programmieren: BOOT0-Brücke setzen, ausschließlich die beigelegte `*-recovery.bin` an Adresse 0 oder die entsprechende `.hex` mit `wchisp` schreiben und verifizieren. Optionbytes und Factorybereiche bleiben erhalten. 3. BOOT0-Brücke und USB entfernen, dann über PoE starten. Für das neue Recovery-/App-Paar steht die reale Geräteabnahme noch aus; dieses Paket ist ein Entwicklungsrelease. Ohne gültige App bleibt die Recovery aktiv. Eine gültige App startet normalerweise nach zwei Sekunden; ihr Webmenü **Diagnostics → Firmware update** schaltet wieder in die Recovery. Ein Recoverywechsel kann die vorhandene App ungültig machen; die folgende Installation spielt die passende App ein. Es gibt kein A/B-Rollback. ## App über Ethernet installieren Das Gerät verwendet DHCP und den mDNS-Namen `poe-rgb-.local`. Die aktuelle IPv4-Adresse lässt sich am DHCP-Server ablesen. Ohne DHCP verwendet es nach ungefähr zwölf Sekunden `192.168.1.15`. Die Recovery unterstützt IPv4. `192.0.2.10` in den Beispielen durch die tatsächliche Geräteadresse ersetzen: ```sh python3 scripts/firmware_update.py --host 192.0.2.10 info ``` Bei `mode: recovery` muss das Ergebnis `abi: 3` und `services: 1` melden. Der Client prüft diese Kompatibilität vor dem Upload. Die Appdatei ist im Manifest unter `app.file` angegeben. Den Namen in den zweiten Befehl übernehmen: ```sh python3 -c "import json; print(json.load(open('manifest.json'))['app']['file'])" python3 scripts/firmware_update.py --host 192.0.2.10 upload APPDATEI.pbu --run ``` Der Client prüft die Paket-CRCs, fordert bei laufender App die Recovery an, überträgt die App, liest das vollständige App-Image zurück und startet mit `--run` die neue App. Danach muss `info` `mode: app`, die Releaseversion und `app_crc` aus `manifest.json` melden. Ein fehlgeschlagener Befehl wird nicht automatisch wiederholt. Alternativ die Firmwareseite der App oder die Webseite der Recovery öffnen und die beigelegte `.pbu` auswählen. Die Recovery prüft Header, Readback und CRC vor der Startfreigabe. ## Dokumentation und Home Assistant Die [Release-Notes](release-notes.md) nennen Änderungen und offene Abnahmen. Beigelegt sind [HTTP-API](docs/http-api-v1.md), [OpenAPI](docs/http-api-v1.openapi.json), [IPv6](docs/ipv6.md), [BLE](docs/hue-ble.md), [MQTT](docs/mdns-mqtt.md), [WLED](docs/wled-json.md), [Art-Net/sACN](docs/artnet-sacn.md), [Persistenz](docs/mvp-firmware-persistenz.md) und [Watchdog](docs/watchdog.md). Für Home Assistant kann der beigelegte Ordner `custom_components/poe_led` direkt in dessen Konfigurationsverzeichnis kopiert werden; siehe [Installationsanleitung](docs/home-assistant-http.md). Die Integrationsversion ist unabhängig von der Firmwareversion. `python3 scripts/package_home_assistant.py` erzeugt daraus alternativ ein separates Installations-ZIP. Die [SDK-Hinweise](firmware/bringup/SDK-NOTICE.md) und die gepinnten Herstellerdatei-Hashes sind ebenfalls enthalten. Historische Messdaten und Firmwarequellen sind nicht Teil dieses Binärpakets; entsprechende Verweise sind als Pfade im Quellrepository gekennzeichnet.