Firmwareuppdatering

Uppdateringar ger nya funktioner, stöd för fler mätare, buggrättningar och säkerhetsrättningar. Varje version har en ändringslogg.

Uppdateringsfiler publiceras på https://fw.ziggymeter.com.

WARNING

Nedgradering är inte möjlig. Enheten accepterar bara firmware som är nyare än den som körs. Om nedgradering vore tillåten skulle man kunna installera om en version med kända sårbarheter och kringgå säkerhetsrättningar — en rollback-attack.

Kontrollera aktuell version

Var	Hur
Webbgränssnitt	System → Software Version
Zigbee	Attributet file version. Namnet varierar mellan koordinatorer; oftast ser du bara byggnumret, t.ex. 320 för version 1.0.320-release.
API	GET /api/v1/system/version
Seriell konsol	Skrivs ut vid uppstart

Versionsnumrering

Tre tal åtskilda av punkter, följda av ett suffix — till exempel 1.2.320-release:

Del	Exempel	Betydelse
Major	1	Ökas vid ändringar som bryter kompatibiliteten: ändrat beteende, borttagna funktioner, inkompatibel konfiguration.
Minor	2	Ökas vid bakåtkompatibla förbättringar — nya funktioner som inte kräver något av dig.
Build	320	Ökas för varje enskild utgåva. Identifierar exakt det bygget och är den version som rapporteras till en Zigbee-koordinator.
Suffix	-release	Typen av bygge. Publicerad firmware är alltid -release.

Uppdateringsfiler

Filerna följer en fast namngivning, så du ser direkt vad en fil är till för:

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

Del	Betydelse
XXXX	Tillverkarkod
YYYY	Produktkod
00320	Byggnummer, också filversionen för Zigbee
20250324T195250	Tidsstämpel för bygget, ÅÅÅÅMMDDTttmmss
ZiggyMeter	Produktnamn
1.2.320-release	Firmwareversion, inklusive suffixet för byggtyp
.ota	Filändelse för uppdateringar

Uppdateringsfilerna är krypterade och digitalt signerade. En fil som ändrats med så lite som en byte klarar inte signaturkontrollen, och enheten avvisar den.

Vilken metod ska du använda

Metod	Hastighet	Passar bäst för
Webbgränssnitt (Wi-Fi)	Snabbast	Nästan alla
Zigbee OTA	Mycket långsam	Batteriinstallationer utan Wi-Fi
REST API	Snabb	Automatisering, många enheter, fjärrunderhåll

INFO

En misslyckad uppdatering kan inte göra enheten permanent obrukbar. Om processen avbryts — strömavbrott, tappad anslutning — återställ strömmen och försök igen med valfri metod.

Innan du börjar

• Ge enheten stabil strömförsörjning under hela processen. USB-C rekommenderas.
• Kontrollera att du uppdaterar till en nyare version.

WARNING

Enheten startar om efter en lyckad uppdatering och är en kort stund inte nåbar. Själva filöverföringen avbryter inte den normala driften.

Webbgränssnitt

Den snabbaste och rekommenderade vägen.

1. Anslut ZiggyMeter till ditt Wi-Fi-nätverk.
2. Öppna webbgränssnittet och gå till System → Upgrade.
3. Välj CHECK FOR UPDATES för att söka efter nyare firmware på nätet.
4. Om en uppdatering finns, välj UPGRADE FROM WEB.
5. Eller välj UPGRADE FROM FILE för att ladda upp en fil du själv har laddat ned — det är vägen att gå när du är ansluten till enhetens egen åtkomstpunkt.
6. Vänta på överföringen och omstarten.
7. Kontrollera den nya versionen under System → Software Version.

TIP

När du söker efter uppdateringar är det bara din webbläsare som behöver internet. ZiggyMeter själv behöver inte nå internet — precis vad man vill ha för en enhet i ett isolerat nätverk.

Zigbee OTA

Zigbee överför filen i många små delar över en smalbandig radiolänk, så det tar lång tid — räkna med timmar snarare än minuter.

1. Kontrollera att ZiggyMeter är parkopplad och har god länkkvalitet.
2. Placera den nära koordinatorn eller en stark router.
3. Leta upp enheten i koordinatorns programvara och starta en OTA-firmwareuppdatering.
4. Håll enheten strömförsörjd och inom räckhåll tills den är klar.
5. Kontrollera versionen efteråt.

Om överföringen stannar upp är det oftast en bättre radiolänk som löser det — närmare placering, fler routrar i meshnätet, mindre störningar.

Både Zigbee2MQTT och Home Assistant kan ställas in så att de hittar firmware för ZiggyMeter automatiskt:

Zigbee2MQTT OTAFjärr-OTA-index för automatiska uppdateringar.Home Assistant ZHA OTAInställning av zigpy-leverantör.

REST API

Använd det här för att automatisera utrullningar eller hantera enheter på distans.

1. Kontrollera att enheten går att nå över nätverket.
2. Hämta en token och skicka sedan .ota-filen med POST till /api/v1/system/ota.
3. Vänta tills enheten har verifierat och installerat den.
4. Fråga efter versionen igen för att bekräfta.

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

Begränsa uppladdningshastigheten. Enheten kan inte ta emot filen i full hastighet och rapporterar ett fel om du skickar för snabbt. --limit-rate i exemplet ovan är inte valfritt.

128k är ett testat värde: en avbild på 2,4 MB överförs på ungefär 20 sekunder. Om enheten rapporterar ett fel, gå ned — en svagare Wi-Fi-länk eller en upptagen enhet kan behöva mindre.

Om uppdateringen avvisas

Meddelande	Orsak
Old firmware version	Filen har samma eller en äldre version. Nedgraderingar avvisas.
Not firmware upgrade / Invalid firmware file	Filen är inte en .ota för ZiggyMeter, eller är avsedd för en annan produkt.
Corrupted upgrade data	Filen klarade inte signatur- eller dekrypteringskontrollen — ladda ned den igen.
Flash write error	Problem med lagringen. Försök igen; om det kvarstår, kontakta support.