Tisk · doporučeno A4 na výšku

1b. Obnova ze zálohy SPIFFS

Kapitola 1b · /spiffs-export.zip, /spiffs-import · menu Del → záloha · viz také 15

Nastavení EaSun Aplikace se ukládá do flash (SPIFFS). Záloha ZIP slouží k obnově po výměně flash / OTA problémům nebo klonování na stejný čip.

NOVÉ UKLÁDÁNÍ Místo desítek samostatných souborů *.ea je celé nastavení v jednom souboru /easun.cfg. Aplikace dál pracuje s logickými cestami typu „soubor .ea“, ale na disku je jen tento jeden šifrovaný konfigurační blob (+ případně denní event logy).

Šifrování easun.cfg

  • Na disku (i uvnitř ZIP) je soubor binární AES — při otevření v editoru nejde číst jako text (hesla WiFi, API klíč, MQTT… nejsou v plain textu).
  • Formát v1: krátká hlavička (magic) + náhodný IV + šifrovaný obsah (AES-128-CBC).
  • Klíč je odvozen z tajemství ve firmwaru a MAC čipu (efuse) — konfigurace je vázaná na toto konkrétní zařízení.
  • Starší plaintext easun.cfg (pokud ještě existuje) se při prvním uložení přepíše do šifrovaného tvaru.
Obnova ZIP funguje spolehlivě jen na stejném ESP (stejný čip / MAC) a se stejným typem firmwaru (stejný secret ve FW). Nahrání zálohy na jinou desku obvykle skončí tím, že se nastavení nenačte (dešifrování selže) — jako by konfigurace nebyla. Pro nové zařízení projděte průvodcem, nebo nastavení přeneste ručně / přes vzdálenou administraci na api.easun.eu.

Co je uvnitř zálohy (náznak)

ZIP obsahuje to, co je ve SPIFFS v okamžiku exportu — typicky:

Položka v ZIPVýznam (bez výpisu klíčů)
easun.cfg Jediný soubor nastavení (šifrovaný). Uvnitř (po dešifrování ve FW) jsou páry klíč=hodnota — např. oblasti: WiFi a setup, MQTT témata, teploty / SSR / Distr, baterie, Spot, AI režimy a limity, FVE·AI, PWM, Web / TSSR, ESP-NOW (PMK, TX, Now), OLED / barva UI, ID API… Konkrétní názvy klíčů FW neexportuje jako čitelný seznam v ZIP.
elog_….txt (pokud existují) Denní event logy (WDT, start…) — textové, nešifrované
případný odpad Dočasné / legacy soubory; na stránce Del lze SPIFFS vyčistit (cfg a logy zůstanou)
ZIP samotný není heslem ZIP chráněný (export z FW je nekomprimovaný store). Ochrana citlivých dat je v AES vrstvě uvnitř easun.cfg. Ručně upravený / zkomprimovaný ZIP import FW obvykle odmítne.

Export (stažení)

  1. Menu Del → /reset (kotva zálohy) nebo přímo /spiffs-export.zip (funguje i v AP režimu).
  2. Uložte soubor (typicky spiffs-backup.zip) na PC — ideálně s datem a poznámkou MAC / místnosti.
  3. Otevřením ZIP uvidíte hlavně easun.cfg jako „binární nesmysl“ — to je v pořádku.

Import (obnova)

  1. Na stejném zařízení: formulář na /reset → soubor backupzip → POST /spiffs-import.
  2. Po úspěchu FW nastaví dokončený průvodce a restartuje (~2 s).
  3. Spustí se plná aplikace s obnovenými daty — ověřte WiFi a MQTT.
Import přepíše stávající SPIFFS. Před importem si ideálně stáhněte aktuální ZIP. V průvodci po kroku 1 může být box Obnovení dat ze zálohy (fetch na /spiffs-import).

Související

← 1a. AP WiFi