15. Záloha, reset a diagnostika

Kapitola 15 · firmware V900 · Expert: menu Del (/reset) · Jednoduchý: Záloha (/reset#spiffs-backup) · Off (/restart)

Údržba zařízení: záloha a obnova nastavení (ZIP), dva typy smazání (factory vs. soft reset provozu), OTA firmware, vyčištění odpadu SPIFFS a diagnostika (logy, health, diag). Většina je na stránce /reset.

Před factory resetem, soft resetem, importem ZIP nebo OTA vždy stáhněte aktuální SPIFFS ZIP. Factory a import jsou nevratné vůči současnému stavu ve flash.

Kde to v aplikaci najdete

Režim UIMenu / odkazURL
Expert (plné menu) Del /reset — reset, záloha, OTA, logy
Jednoduchý Záloha /reset#spiffs-backup (stejná stránka, kotva na ZIP)
Oba Off /restart — soft restart, nemaže nastavení
Expert . /serial — úroveň Serial / WebSerial
/spiffs-backup → redirect na /reset#spiffs-backup

Smazání nastavení — dvě úrovně

Na /reset jsou dva oddělené boxy. Oba posílají POST na /action a vyžadují potvrzení v prohlížeči.

1) Factory — červený box

Tlačítko Resetovat nastavení (name=resetovat). Formátuje SPIFFS (včetně WiFi a ID API), vynuluje energii PZEM a restartuje.

  • Kdy: úplný návrat „jako z výroby“, zmatečná konfigurace, předání zařízení.
  • Potom: SoftAP EASUN → znovu první spuštění V900 (SETUP_BOOT 0 → 1 → 2).
Factory je nevratný bez předchozí ZIP zálohy.

2) Soft reset provozu — žlutý box (#reset-provoz)

Tlačítko Smazat provoz (WiFi a ID API zůstanou) (name=resetovat_provoz). V /easun.cfg ponechá jen vybrané klíče; zbytek smaže.

ZůstaneSmaže se (příklady)
WiFi SSID/heslo, kontakt (jméno/e-mail), ID API (key / keymac), ověření (ApiChybaOvereni), SETUP_BOOT=2, vzhled (OLED / barva / serial) MQTT, teploty / Distr, PWM, Spot, ECO, baterie limity, web/TSSR, AI režimy a Gemini, UiMode, SETUP_APP
  • Po akci se doplní safe defaults (Distr jen FVE, PWM Domácí, AI Sledovat…).
  • Zůstaňte na stránce /action ~25 s — červený box „Počkejte — probíhá restart“ (odpočet).
  • Zařízení se restartuje cca za 25 s (načte čistá data). Nechoďte hned na /ui-mode.
  • Po reconnectu WiFi otevřete IP → /ui-mode (Jednoduchý / Expert), pak Setup. Meta refresh zkusí ~28 s.
  • Kdy: vyčistit provozní nastavení bez ztráty sítě a licence.
Soft reset není factory — WiFi a ID API zůstávají, SoftAP EASUN se nespouští.

Úložiště SPIFFS

Hlavní nastavení je v jednom souboru /easun.cfg (AES šifrováno, vázané na čip). Event logy: elog_*.txt. Logické cesty *.ea mapuje firmware do klíčů v cfg — podrobně 1b. Obnova SPIFFS.

  • Na /reset vidíte počet souborů, počet klíčů v cfg a využité / volné bajty.
  • Seznam souborů: /reset?showfiles=1 — mazání po jednom (nebezpečné bez zálohy; easun.cfg nemažte).
  • Vyčistit odpad: /spiffs-purge — smaže weather/solar/csv/json/zip a legacy fyzické *.ea. easun.cfg a event logy zůstanou.
  • Když je SPIFFS plná, ukládání může selhat → smazat logy nebo purge.

Záloha a obnova SPIFFS (ZIP)

Sekce na /reset (kotva #spiffs-backup). Funguje i v SoftAP režimu.

ŠIFROVÁNÍ V ZIP je easun.cfg binárně AES — na PC nejde číst jako text. Obnova dává smysl na stejném ESP. Složení: kapitola 1b.

Stažení zálohy

  1. Otevřete /reset (nebo /reset#spiffs-backup) či přímo /spiffs-export.zip.
  2. Prohlížeč stáhne ZIP (typicky spiffs-backup.zip).
  3. Uložte na PC — ideálně s datem ve jméně složky.

Nahrání (obnova)

  1. Ve formuláři vyberte ZIP (pole backupzip).
  2. Odešlete — POST /spiffs-import.
  3. Po úspěchu se ESP restartuje (~2 s). Legacy se může zapsat SETUP_KROK=20; u V900 rozhoduje hlavně obsah cfg (SETUP_BOOT, WiFi, klíč).
  4. Ověřte WiFi SSID (může být z jiné sítě) a IP MQTT brokeru.
Import přepíše stávající SPIFFS. Před importem stáhněte aktuální ZIP.

Aktualizace firmware (.bin)

V900 Typické verze v patičce: S3.0900 (ESP32-S3) · 32.0900 (klasický ESP32). Ověřte vždy aktuální číslo na Home.

Sekce #firmware-update na /reset — OTA přes web (POST /firmware-update, progress bar).

  1. Zkompilujte / získejte .bin pro stejný typ desky.
  2. Vyberte soubor, potvrďte — sledujte progress.
  3. Neodpojujte napájení během uploadu.
  4. Po úspěchu se zařízení restartuje; ověřte verzi na Home.
  5. Při ESP-NOW spolupráci držte stejnou verzi na všech zařízeních ve stejném PMK (kap. 6a).
OTA obvykle nemění SPIFFS — po velké změně FW mějte ZIP zálohu. Špatný .bin (jiná deska) → často jen USB flash.

Event log / Watchdog

Na /reset (sekce Event log) uvidíte:

  • Watchdog: když firmware déle než 30 s neodpoví, ESP se samo restartuje.
  • Poslední start: důvod restartu (soft reset, panika, WDT…).
  • Historie:7 dnů event logů; při SPIFFS nad 70 % se maže od nejstarších.
OdkazCo uvidíteKdy použít
/logs Čitelná stránka event logů Proč se zařízení restartovalo, WiFi/MQTT…
/logs-raw Surový text logu Poslat podpoře
/logs-clear Smazání event logů (+ úklid junk) SPIFFS plná; po diagnostice
/ai-run-log Stav vzdáleného AI logu Odesílání na server analýzy — 11c
/ai-shadow-log Info k AI SHADOW logu Přesměruje na vzdálenou analýzu (ne lokální SPIFFS)

Restart zařízení

Menu Off/restart. Soft restart ESP — nemazá nastavení. Stránka hlásí restart a přesměruje na Home.

  • Kdy: po změně WiFi/MQTT, „zaseknutá“ stránka, po soft resetu (proběhne sám).
  • Není to: vypnutí topení — po bootu běží regulace dál.

Diagnostika pro podporu

/health — zdravotní zpráva

Plain-text: free heap, uptime, WiFi (stav, RSSI, IP, gateway, DNS, MAC), SPIFFS KB, chip, flash, testy internetu / DNS. Rychlá kontrola „jsem online?“ — zkopírujte text podpoře.

/diag — krátká diag po OTA

Textový výpis bez USB: board, verze FW, heap (free / min / maxAlloc), SPIFFS used/total/free, stav stránky teplot, uptime.

Tip: nejdřív otevřete /teplota, pak znovu /diag.

/serial — úroveň výpisů

Číslo 0–20 (/serial1.ea v cfg) řídí Serial / WebSerial. Po uložení typicky restart. Pro provoz nízká hodnota; vyšší = ladění (MQTT, AI, PWM…).

/rtc_diagnose

Diagnostika RTC (pokud je ve FW) — čas pro Spot / logy.

/resetpage a /defrag

  • /resetpage — vynuluje interní proměnné stránky (vývoj / pokročilé).
  • /defrag — úklid RAM po dlouhém běhu.

Doporučený postup údržby

  1. Pravidelně stáhněte SPIFFS ZIP (po větších změnách).
  2. Chyba ukládání / plná flash → /logs-clear nebo /spiffs-purge, zkontrolujte volné místo na /reset.
  3. Před OTA → ZIP + správný .bin pro desku.
  4. Podivné rebooty → /logs + důvod startu na /reset + /health.
  5. Jen „vyčistit provoz“ → soft reset (WiFi+ID zůstanou) → /ui-mode → Setup.
  6. Úplná továrna → ZIP → factory Resetovat nastavení → kap. 1.

Rychlá mapa URL

URLÚčel
/resetFactory + soft reset, záloha, OTA, logy, purge
/reset#reset-provozKotva na soft reset provozu
/reset#spiffs-backupKotva na ZIP (menu Záloha)
/reset#firmware-updateKotva na OTA
/reset?showfiles=1Seznam SPIFFS + smazání po jednom
/spiffs-export.zipStažení ZIP
/spiffs-importPOST obnova ze ZIP
/spiffs-purgeSmazat odpad (ne cfg / elog)
/spiffs-backupRedirect na sekci zálohy
/firmware-updatePOST OTA .bin
/actionPOST factory / soft reset / kWh…
/restartSoft restart
/logs, /logs-raw, /logs-clearEvent logy
/health, /diagMonitoring / podpora
/serialÚroveň Serial
/deletefile?filename=…Smazání jednoho SPIFFS souboru