Aktualizace

Software v zařízení lze aktualizovat.

Aktualizace obvykle přinášejí:

• nové funkce
• opravy chyb
• opravy bezpečnostních problémů

WARNING

Přeinstalace na starší verzi firmwaru (downgrade) není z bezpečnostních důvodů podporována. Povolení downgrade by umožnilo instalaci verze se známými zranitelnostmi (tzv. „rollback attack“), čímž by se obešly bezpečnostní opravy přidané v novějších verzích. Pro ochranu zařízení a vaší sítě přijímá ZiggyMeter pouze aktualizace na novější verze.

Jak zkontrolovat verzi softwaru

Webové rozhraní ZiggyMeter

Přejděte na Systém → Verze softwaru

Zigbee

Zkontrolujte verzi souboru (File version). Přesné pojmenování závisí na vašem softwaru Zigbee. Obvykle uvidíte pouze číslo sestavení, např. pro verzi 1.0.320 je verze souboru Zigbee 320.

API

Použijte koncový bod /api/v1/system/version

Schéma verzování

Verze firmwaru se skládá ze 3 částí oddělených tečkou:

• Hlavní (Major): zvyšuje se u velkých změn, které mohou narušit kompatibilitu, například změna chování, odstranění funkcí nebo nekompatibilní změny konfigurace.
• Vedlejší (Minor): zvyšuje se u zpětně kompatibilních vylepšení (nové funkce a vylepšení, která nevyžadují změny na vaší straně).
• Číslo sestavení (Build number): zvyšuje se u jednotlivých verzí firmwaru (opravy chyb, malé změny a interní revize). Jednoznačně identifikuje konkrétní sestavení firmwaru. Je to také verze hlášená koordinátoru Zigbee.

Příklad: 1.2.320, kde hlavní verze: 1, vedlejší verze: 2, číslo sestavení: 320.

Soubory s aktualizací firmwaru

Soubory pro aktualizaci firmwaru se řídí pevným pravidlem pojmenování. To usnadňuje identifikaci, ke kterému zařízení soubor patří a jakou přesnou verzi obsahuje.

Příklad názvu souboru:

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

Pravidla pojmenování

• XXXX — kód výrobce
• YYYY — kód produktu
• 00320 — číslo sestavení a verze Zigbee
• 20250324T195250 — časové razítko sestavení ve formátu RRRRMMDDThhmmss
• ZiggyMeter — název produktu
• 1.2.320 — verze firmwaru (viz Schéma verzování výše)
• .ota — přípona souboru aktualizace

Integrita a bezpečnost souborů

Aktualizační soubory jsou šifrovány a digitálně podepsány. Pokud je soubor pozměněn (i o jediný bajt), ověření podpisu selže a zařízení aktualizaci odmítne.

Umístění aktualizačních souborů

Soubory s aktualizacemi jsou k dispozici na: https://fw.ziggymeter.com.

Postup aktualizace

ZiggyMeter lze aktualizovat několika způsoby. Nejlepší volba závisí na tom, jak je vaše zařízení připojeno:

• Webové rozhraní (Wi‑Fi) — obvykle nejrychlejší a doporučená metoda.
• Zigbee OTA — dobře funguje u bateriových/mesh sestav, ale je velmi pomalá ve srovnání s Wi‑Fi.
• API — užitečné pro automatizaci nebo vzdálenou údržbu, pokud spravujete zařízení programově.

INFO

ZiggyMeter je navržen tak, aby neúspěšná aktualizace nemohla zařízení trvale poškodit; pokud je proces přerušen (například výpadkem napájení nebo ztrátou připojení), obnovte napájení/připojení a zkuste aktualizaci znovu pomocí webového rozhraní, Zigbee OTA nebo API.

Před aktualizací

• Ujistěte se, že zařízení má po celou dobu procesu stabilní napájení (doporučeno USB‑C).
• Ověřte, že aktualizujete na novější verzi (downgrade je odmítnut).

WARNING

Po úspěšné aktualizaci se zařízení restartuje. Během restartu bude konektivita dočasně nedostupná.

Přenos souboru s aktualizací nepřerušuje běžný provoz.

Aktualizace pomocí webového rozhraní (Wi‑Fi)

TIP

Toto je nejrychlejší, nejjednodušší a doporučená metoda.

1. Připojte ZiggyMeter ke své Wi‑Fi síti.
2. Otevřete webové rozhraní ZiggyMeter ve svém prohlížeči.
3. Přejděte na Systém → Aktualizace.
4. Klikněte na ZKONTROLOVAT AKTUALIZACE pro vyhledání nejnovější verze firmwaru online.
5. Pokud je aktualizace k dispozici, klikněte na AKTUALIZOVAT Z WEBU pro zahájení instalace.
6. Alternativně můžete ručně nahrát stažený soubor kliknutím na AKTUALIZOVAT ZE SOUBORU (užitečné při použití přístupového bodu ZiggyMeter).
7. Počkejte na nahrání souboru do zařízení.
8. Po restartu zařízení potvrďte aktualizovanou verzi na stránce s informacemi o Systému.

Aktualizace pomocí Zigbee (OTA)

Aktualizace přes Zigbee přenášejí soubor v mnoha malých částech přes nízkoenergetické rádiové spojení. To je důvod, proč to může trvat dlouho.

1. Ujistěte se, že je ZiggyMeter spárován s vaší sítí Zigbee a má dobrou kvalitu spojení (LQI).
2. Umístěte zařízení blízko koordinátoru nebo silného routeru, abyste zvýšili spolehlivost.
3. Ve svém softwaru koordinátoru Zigbee vyhledejte zařízení ZiggyMeter a spusťte OTA aktualizaci firmwaru.
4. Udržujte zařízení pod napětím a v dosahu, dokud se aktualizace nedokončí.
5. Po aktualizaci ověřte verzi firmwaru.

Pokud proces uvízne, obvykle pomůže zlepšení kvality rádiového spojení (umístění blíže, více routerů mesh, méně rušení).

INFO

Podrobné pokyny pro konfiguraci prostředí Zigbee pro automatické aktualizace naleznete v příručkách pro integraci.

Aktualizace pomocí API

Metodu API použijte, pokud chcete aktualizace automatizovat (například CI/CD pro nasazování firmwaru) nebo spravovat zařízení vzdáleně.

1. Ujistěte se, že je zařízení dostupné v síti.
2. Zavolejte koncový bod pro aktualizaci firmwaru popsaný v dokumentaci API a nahrajte soubor .ota.
3. Počkejte, až zařízení ověří a nainstaluje firmware.
4. Znovu dotazem na verzi zařízení potvrďte aktualizaci.

Viz POST /api/v1/system/ota pro formáty koncového bodu a požadavků.