FW 0.12.11

Poznámky k vydání Spectoda Firmware v0.12.11

Vydáno: 2. listopadu 2025
Verze: 0.12.11

🚀 Hlavní funkce

• Synchronizace NetworkStorageData s App Controllerem: Přidává synchronizaci storage mezi zařízeními a aplikací.
• Rozšíření Berry API:
  • spectoda.tx() / spectoda.rx() pro nízkoúrovňový transport.
  • ble.enable(...), espnow.enable(...), kompletní ESP-NOW configuration API a espnow.datarate(...).
  • API pro senzor APDS9960.
  • Podpora "plugins" a Controller "scripts" v konfiguraci.
• Světelné protokoly: ART-NET a sACN nyní umí přijímat z více universes.
• Kompatibilita connectorů: Volba CONNECTOR_LEGACY_JS_RUNTIME pro legacy integrace.
• Přidána možnost přepisovat PCB/Product kódy.

🔧 Technická vylepšení a refaktorizace

• Zaveden fw_platform_code; přidány networksnapshot_unix_timestamp a controllerstore_fingerprint.
• Přejmenování a úklid: fw_compilation_timestamp → fw_compilation_unix_time, clock_ms → clockms_t, IDENTIFIER(0) → IDENTIFIER_UNDEFINED.
• Interní změny v Berry: standardizovaná jména (EVT/PLG), vyčištěné C/C++ handlery, sjednocené utils helpery jako utils::berry::getBytesBufferAndSize() a vylepšení DMX Berry.
• synchronization_t přesunut do samostatného headeru; vylepšené error cesty v BLE/ESP-NOW členech.
• Build a tooling: opravené WASM a DMX buildy; nové možnosti pro vyloučení APDS9930 a Pixel Port R/W; lepší release build konfigurace.

📈 Výkon a stabilita

• Rychlejší network OTA díky vyšší datové rychlosti.
• Delší startup okno Ethernetu pro vyšší spolehlivost.
• Vypnuté Berry debug info a strict module pro lepší výkon v produkci.
• Navýšená maximální velikost IO portu z 1200 na 2048.
• Opravené časování signálu WS2805 pro omezení blikání a glitchů.
• Zpevněný mechanismus FW floodingu.

🐛 Opravy chyb

• Device context: opravená inicializace event-state v registerDeviceContext.
• Clock writes: povolené častější FW clock update.
• Serial: spolehlivé odesílání synchronizačních packetů a opravy problémů s velkými payloady.
• Persistence: opraven edge case, kdy mohl early reboot přeskočit zápis Network Signature/Key.
• Opraven crash animace LoadingBar.
• Protokoly: žádný crash na ArtNet bez validní Berry VM.
• Berry runtime: opravená memory corruption, memory leak v render stacku, crash při vytváření empty mapped bytes a další chyby v C++ a VM glue.
• ESP-NOW: úpravy synchronizace a opravy NetworkData sync.
• Error handling: lepší zpracování FLAG_EVENT_HISTORY_BC_REQUEST; potlačen hlučný log “BLE max connection reached”.

🧩 Poznámky ke kompatibilitě a migraci

• Potenciálně významné změny:
  • Výchozí config segment ID se změnilo z ID255 na ID0; zkontroluj skripty a konfigurace závislé na defaultech.
  • FLAG_EVENT_HISTORY_BC_REQUEST je vypnutý, což mění chování history broadcastu.
• Interní přejmenování v Berry jsou pro uživatelské skripty většinou nezlomová, ale vlastní native pluginy sahající do interních struktur je potřeba upravit.

🧪 Build a developer poznámky

• Nové build exclusions: ESPNOWRADIO a APDS9930.
• Aplikované opravy WASM buildu; opravený DMX WASM build.

🔗 Kompletní přehled změn

https://github.com/Spectoda/firmware/compare/v0.12.10...v0.12.11