Laiteohjelmiston päivitys

Päivitykset tuovat uusia ominaisuuksia, laajemman mittarituen sekä virhe- ja tietoturvakorjauksia. Jokaisesta julkaisusta on muutosloki.

Päivitystiedostot julkaistaan osoitteessa https://fw.ziggymeter.com.

WARNING

Vanhempaan versioon ei voi palata. Laite hyväksyy vain uudemman laiteohjelmiston kuin se, jota se suorittaa. Paluun salliminen tekisi mahdolliseksi asentaa uudelleen version, jossa on tunnettuja haavoittuvuuksia, ja ohittaa tietoturvakorjaukset — kyseessä olisi rollback-hyökkäys.

Nykyisen version tarkistaminen

Mistä	Miten
Verkkokäyttöliittymä	System → Software version
Zigbee	Määrite file version. Nimitys vaihtelee koordinaattoreittain; yleensä näet vain koontinumeron, esimerkiksi 320 versiolle 1.0.320-release.
Rajapinta	GET /api/v1/system/version
Sarjakonsoli	Tulostetaan käynnistyksen yhteydessä

Versionumerointi

Kolme pisteillä eroteltua lukua ja niiden perässä pääte — esimerkiksi 1.2.320-release:

Osa	Esimerkki	Merkitys
Pääversio	1	Kasvaa muutoksissa, jotka rikkovat yhteensopivuuden: muuttunut toiminta, poistetut ominaisuudet, yhteensopimaton asetustiedosto.
Aliversio	2	Kasvaa taaksepäin yhteensopivissa parannuksissa — uusissa ominaisuuksissa, jotka eivät vaadi sinulta mitään.
Koontiversio	320	Kasvaa jokaisessa julkaisussa. Yksilöi täsmällisen koonnin ja on se versio, joka ilmoitetaan Zigbee-koordinaattorille.
Pääte	-release	Koonnin tyyppi. Julkaistu laiteohjelmisto on aina -release.

Päivitystiedostot

Tiedostot noudattavat kiinteää nimeämiskäytäntöä, joten näet yhdellä silmäyksellä, mihin tiedosto on tarkoitettu:

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

Osa	Merkitys
XXXX	Valmistajan tunnus
YYYY	Tuotetunnus
00320	Koontinumero, myös Zigbeen tiedostoversio
20250324T195250	Koonnin aikaleima, VVVVKKPPThhmmss
ZiggyMeter	Tuotteen nimi
1.2.320-release	Laiteohjelmiston versio koontityypin päätteineen
.ota	Päivitystiedoston tunniste

Päivitystiedostot on salattu ja digitaalisesti allekirjoitettu. Yhdenkin tavun verran muutettu tiedosto ei läpäise allekirjoituksen tarkistusta, ja laite hylkää sen.

Minkä tavan valitsen

Tapa	Nopeus	Sopii parhaiten
Verkkokäyttöliittymä (Wi-Fi)	Nopein	Lähes kaikille
Zigbee OTA	Hyvin hidas	Paristoasennuksiin, joissa ei ole Wi-Fiä
REST API	Nopea	Automaatioon, laitejoukkoihin ja etähuoltoon

INFO

Epäonnistunut päivitys ei voi rikkoa laitetta pysyvästi. Jos prosessi keskeytyy — sähkökatko, katkennut yhteys — palauta virta ja yritä uudelleen millä tahansa tavalla.

Ennen aloitusta

• Varmista laitteelle vakaa virransyöttö koko prosessin ajaksi. USB-C on suositeltava.
• Varmista, että olet siirtymässä uudempaan versioon.

WARNING

Laite käynnistyy uudelleen onnistuneen päivityksen jälkeen ja on hetken tavoittamattomissa. Itse tiedoston siirto ei keskeytä normaalia toimintaa.

Verkkokäyttöliittymä

Nopein ja suositeltu tapa.

1. Yhdistä ZiggyMeter Wi-Fi-verkkoosi.
2. Avaa verkkokäyttöliittymä ja siirry kohtaan System → Upgrade.
3. Valitse CHECK FOR UPDATES etsiäksesi uudempaa laiteohjelmistoa verkosta.
4. Jos päivitys on saatavilla, valitse UPGRADE FROM WEB.
5. Tai valitse UPGRADE FROM FILE lähettääksesi itse lataamasi tiedoston — tätä reittiä käytetään, kun olet yhteydessä laitteen omaan tukiasemaan.
6. Odota siirtoa ja uudelleenkäynnistystä.
7. Varmista uusi versio kohdasta System → Software version.

TIP

Päivityksiä tarkistettaessa internetyhteyttä tarvitsee vain selaimesi. ZiggyMeterin itsensä ei tarvitse päästä internetiin — juuri sitä haluat eristetyssä verkossa olevalta laitteelta.

Zigbee OTA

Zigbee siirtää tiedoston monina pieninä paloina kapeakaistaisen radioyhteyden yli, joten tämä kestää kauan — varaudu tunteihin, ei minuutteihin.

1. Varmista, että ZiggyMeter on liitetty verkkoon ja yhteyden laatu on hyvä.
2. Sijoita se lähelle koordinaattoria tai vahvaa reititintä.
3. Etsi laite koordinaattoriohjelmistostasi ja käynnistä OTA-laiteohjelmistopäivitys.
4. Pidä laite virroitettuna ja kantamalla, kunnes päivitys valmistuu.
5. Tarkista versio jälkeenpäin.

Jos siirto pysähtyy, radioyhteyden parantaminen — lähemmäs siirtäminen, lisää mesh-reitittimiä, vähemmän häiriöitä — on yleensä ratkaisu.

Sekä Zigbee2MQTT että Home Assistant voidaan määrittää löytämään ZiggyMeterin laiteohjelmisto automaattisesti:

Zigbee2MQTT OTAEtä-OTA-hakemisto automaattisia päivityksiä varten.Home Assistant ZHA OTAzigpy-lähteen määritys.

REST API

Käytä tätä päivitysten automatisointiin tai laitteiden etähallintaan.

1. Varmista, että laite on tavoitettavissa verkossa.
2. Hae token ja lähetä .ota-tiedosto POST-pyynnöllä osoitteeseen /api/v1/system/ota.
3. Odota, että laite tarkistaa ja asentaa sen.
4. Kysy versio uudelleen varmistukseksi.

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

Rajoita lähetysnopeutta. Laite ei pysty vastaanottamaan tiedostoa täydellä nopeudella ja ilmoittaa virheen, jos työnnät sitä liian nopeasti. Esimerkin --limit-rate ei ole valinnainen.

128k on testattu toimiva arvo: 2,4 Mt:n levykuva siirtyy noin 20 sekunnissa. Jos laitteesi ilmoittaa virheen, laske arvoa — heikompi Wi-Fi-yhteys tai kuormittunut laite voi vaatia vähemmän.

Jos päivitys hylätään

Ilmoitus	Syy
Old firmware version	Tiedosto on sama tai vanhempi versio. Paluuta vanhempaan ei sallita.
Not firmware upgrade / Invalid firmware file	Tiedosto ei ole ZiggyMeterin .ota tai se on toiselle tuotteelle.
Corrupted upgrade data	Tiedosto ei läpäissyt allekirjoituksen tarkistusta tai purkua — lataa se uudelleen.
Flash write error	Muistiongelma. Yritä uudelleen; jos vika toistuu, ota yhteyttä tukeen.