Aktualizace firmwaru

Aktualizace přinášejí nové funkce, širší podporu elektroměrů, opravy chyb a bezpečnostní opravy. Ke každému vydání existuje seznam změn.

Aktualizační soubory se zveřejňují na https://fw.ziggymeter.com.

WARNING

Návrat ke starší verzi není možný. Zařízení přijímá pouze firmware novější, než jaký právě běží. Kdyby byl návrat povolen, dala by se znovu nainstalovat verze se známými zranitelnostmi a obejít tak bezpečnostní opravy — útok typu rollback.

Zjistěte aktuální verzi

Kde	Jak
Webové rozhraní	System → Software Version
Zigbee	Atribut file version. Název se u koordinátorů liší; obvykle vidíte jen číslo sestavení, např. 320 pro verzi 1.0.320-release.
API	GET /api/v1/system/version
Sériová konzole	Vypisuje se při startu

Číslování verzí

Tři čísla oddělená tečkami, za nimi přípona — například 1.2.320-release:

Část	Příklad	Význam
Major	1	Zvyšuje se při změnách, které narušují kompatibilitu: změněné chování, odstraněné funkce, nekompatibilní konfigurace.
Minor	2	Zvyšuje se při zpětně kompatibilních vylepšeních — nových funkcích, které od vás nic nevyžadují.
Build	320	Zvyšuje se s každým jednotlivým vydáním. Jednoznačně identifikuje konkrétní sestavení a je to verze hlášená koordinátoru Zigbee.
Přípona	-release	Typ sestavení. Zveřejněný firmware má vždy -release.

Aktualizační soubory

Soubory mají pevnou konvenci pojmenování, takže na první pohled poznáte, k čemu slouží:

XXXX-YYYY-00320-20250324T195250-ZiggyMeter-1.2.320-release.ota

Část	Význam
XXXX	Kód výrobce
YYYY	Kód produktu
00320	Číslo sestavení, zároveň verze souboru pro Zigbee
20250324T195250	Časové razítko sestavení, RRRRMMDDThhmmss
ZiggyMeter	Název produktu
1.2.320-release	Verze firmwaru včetně přípony typu sestavení
.ota	Přípona aktualizačního souboru

Aktualizační soubory jsou šifrované a digitálně podepsané. Soubor změněný byť o jeden bajt neprojde ověřením podpisu a zařízení ho odmítne.

Kterou metodu použít

Metoda	Rychlost	Nejvhodnější pro
Webové rozhraní (Wi-Fi)	Nejrychlejší	Téměř všechny
Zigbee OTA	Velmi pomalá	Bateriové instalace bez Wi-Fi
REST API	Rychlá	Automatizaci, flotily zařízení, vzdálenou údržbu

INFO

Nepovedená aktualizace nemůže zařízení trvale zničit. Pokud se proces přeruší — výpadek napájení, přerušené spojení —, obnovte napájení a zkuste to znovu libovolnou metodou.

Než začnete

• Zajistěte zařízení po celou dobu stabilní napájení. Doporučeno je USB-C.
• Ověřte, že přecházíte na novější verzi.

WARNING

Po úspěšné aktualizaci se zařízení restartuje a na chvíli je nedostupné. Samotný přenos souboru běžný provoz nepřerušuje.

Webové rozhraní

Nejrychlejší a doporučená cesta.

1. Připojte ZiggyMeter ke své síti Wi-Fi.
2. Otevřete webové rozhraní a přejděte na System → Upgrade.
3. Zvolte CHECK FOR UPDATES a vyhledejte novější firmware online.
4. Je-li aktualizace k dispozici, zvolte UPGRADE FROM WEB.
5. Nebo zvolte UPGRADE FROM FILE a nahrajte soubor, který jste si stáhli sami — to je cesta pro připojení přes vlastní přístupový bod zařízení.
6. Počkejte na přenos a restart.
7. Novou verzi ověřte v System → Software Version.

TIP

Při kontrole aktualizací potřebuje přístup k internetu jen váš prohlížeč. Samotný ZiggyMeter se do internetu dostat nemusí — přesně to u zařízení v izolované síti chcete.

Zigbee OTA

Zigbee přenáší soubor po mnoha malých částech přes úzkopásmové rádiové spojení, takže to trvá dlouho — počítejte spíš s hodinami než s minutami.

1. Ujistěte se, že je ZiggyMeter spárovaný a má dobrou kvalitu spojení.
2. Umístěte ho blízko koordinátoru nebo silného směrovače.
3. V softwaru koordinátoru najděte zařízení a spusťte aktualizaci firmwaru OTA.
4. Nechte zařízení napájené a v dosahu až do dokončení.
5. Potom ověřte verzi.

Pokud se přenos zastaví, obvykle pomůže zlepšení rádiového spojení — bližší umístění, víc směrovačů v síti, méně rušení.

Zigbee2MQTT i Home Assistant lze nastavit tak, aby firmware ZiggyMeter vyhledávaly automaticky:

Zigbee2MQTT OTAVzdálený index OTA pro automatické aktualizace.Home Assistant ZHA OTANastavení poskytovatele zigpy.

REST API

Tuto cestu použijte k automatizaci nasazení nebo ke vzdálené správě zařízení.

1. Ujistěte se, že je zařízení v síti dostupné.
2. Získejte token a pak odešlete soubor .ota metodou POST na /api/v1/system/ota.
3. Počkejte, až ho zařízení ověří a nainstaluje.
4. Pro potvrzení se znovu dotažte na verzi.

curl -X POST \
  https://<host>/api/v1/system/ota \
  -H "Authorization: Bearer <token>" \
  --data-binary "@XXXX-YYYY-00320-20250324T195250-ZiggyMeter-1.2.320-release.ota" \
  --limit-rate 128k

WARNING

Omezte rychlost odesílání. Zařízení nedokáže soubor přijmout plnou rychlostí a při příliš rychlém odesílání ohlásí chybu. --limit-rate v příkladu výše není volitelný.

128k je ověřená funkční hodnota: obraz o velikosti 2,4 MB se přenese zhruba za 20 sekund. Pokud zařízení hlásí chybu, jděte níž — slabší spojení Wi-Fi nebo vytížené zařízení může potřebovat méně.

Když je aktualizace odmítnuta

Hlášení	Příčina
Old firmware version	Soubor má stejnou nebo starší verzi. Návrat ke starší verzi se odmítá.
Not firmware upgrade / Invalid firmware file	Soubor není .ota pro ZiggyMeter, nebo je určen pro jiný produkt.
Corrupted upgrade data	Soubor neprošel kontrolou podpisu nebo dešifrováním — stáhněte ho znovu.
Flash write error	Problém s pamětí. Zkuste to znovu; pokud potíž přetrvává, kontaktujte podporu.