EaSun Grid Load · uživatelský návod · firmware V900

Jednoduchý průvodce nastavením EaSun Grid Load

Kompletní návod k prvnímu spuštění na ESP32 (V900): nejdřív WiFi a ID API, po restartu volba Jednoduchý nebo Expert, v Jednoduchém AI topení (Sledovat / Pomáhat / Řídit), volitelně Gemini a doporučené MQTT. Teploty a PWM doladíte v Expertu — bez chaosu dlouhého průvodce z V800.

1. Přehled V900 — co se děje po zapnutí

Bez WiFi a ověřeného ID API zařízení neotevře aplikaci. Všechno ostatní (MQTT, teploty, AI, PWM, Spot…) je až po restartu podle volby Jednoduchý / Expert, s výchozími limity tam, kde to jde.

Tato stránka je uživatelský návod firmware V900 (ESP32-Grid-Load-Vypocet900). Podrobné kapitoly zůstávají na easun.eu/navod — v zařízení jsou jen krátké texty a odkazy (méně flash = spolehlivější OTA).

Fáze 0 (po resetu)Po restartu
Zámek webu Ano — jen WiFi + ID API Ne — plná app (zúžená / plná dle režimu UI)
Povinné SSID/heslo + jméno/e-mail + ID API (ověřeno) Volba Jednoduchý / Expert
Ostatní Zakázáno (žádné MQTT/teploty/SSR v bootstrapu) Jednoduchý = AI + Gemini + MQTT (lze přeskočit); Expert = hub na stávající stránky
SPIFFS stav /SETUP_BOOT.ea = 0→1→2 /UiMode.ea + volitelně /SETUP_APP.ea

Osm pravidel, která V900 dodržuje

  1. Fáze 0 = zámek: po resetu jen WiFi (AP EASUN) + ověřené ID API. Bez toho žádná Home / MQTT / AI.
  2. Restart po ID API → plná app. Teprve pak brána Jednoduchý × Expert.
  3. Brána = způsob ovládání (menu), ne AI režim. Lze kdykoli přepnout v patičce.
  4. Jednoduchý Setup = AI + MQTT: úvod → Sledovat/Pomáhat/Řídit → Gemini? → MQTT (doporučeno, lze přeskočit) → hotovo. Bez karty „Bez AI“.
  5. Sledovat = doporučený start: AI neřídí PWM; ověření dat a návrhu. Stejný výpočet pak použije Pomáhat a Řídit.
  6. Expert = plná aplikace + hub checklist. Žádný povinný lineární wizard.
  7. V Jednoduchém Setupu není: teploty/Distr, PWM, SSR, FVE·AI, ECO, Spot, original/Optimalizace. MQTT je doporučený krok (lze přeskočit).
  8. Dlouhé návody = odkaz na easun.eu (kapitoly 11, 11a, 21…), ne celé texty do flash.
Přepínač Jednoduchý / Expert nemění výpočty topení — jen šířku menu. AI režim (Sledovat / Pomáhat / Řídit) volíte zvlášť v Setupu.

2. Proč ke změně mezi V800 a V900 došlo

Firmware V800 přinesl laickou bránu Jednoduchý/Expert a průvodce Setup, ale zároveň nechal v zařízení starý dlouhý onboarding (až kolem 20 kroků): WiFi → ID API → MQTT → teploměry → režim → kalibrace SSR. To se v praxi ukázalo jako příliš těžké — pro majitele domu i pro paměť čipu.

Co V800 míchal dohromady

  1. První připojení — WiFi a licence (ID API), bez kterých nic dál nejde.
  2. Instalační detaily — MQTT topics, mapování čidel, min. PWM SSR — důležité, ale ne nutně v první minutě po zapnutí.
  3. Laické ovládání — volba Jednoduchý/Expert a AI karty — často uprostřed nebo za dalším zámkem bez horního menu.
Výsledek V800: hodně textů ve flash (PROGMEM), uživatel rozhoduje o MQTT a AI dřív, než má smysl, OTA a volná RAM trpí, a stejná logika je zdvojená (starý průvodce + nový Setup).

Srovnání V800 → V900

V800 (co nechceme opakovat)V900 (současný tok)
Průvodce až 20 kroků (SETUP_KROK.ea) Bootstrap jen 2 povinné kroky → restart (SETUP_BOOT 0|1|2)
MQTT + teploty + SSR min PWM v zámku webu Po restartu / v Expertu; SSR kalibrace není v bootstrapu
Brána UI před / během dlouhého nastavení Brána až po WiFi+API (zařízení už běží online)
Jednoduchý Setup 0…6 (AI, topení, teploty, baterie, měnič…) AI + MQTT: úvod → režim → Gemini → MQTT → hotovo (/setup/setup4)
Zámek bez horního menu do „dokončení Setupu“ Po bootstrapu plné menu; Setup je položka v Jednoduchém topnav
Dlouhé kapitoly ve flashi zařízení Krátké věty + odkazy na easun.eu/navod
Složitý start (často tlak na ASSIST / mnoho otázek) Safe default: Sledovat, Gemini vyp, Distr jen FVE, PWM Domácí

Proč to dává smysl majiteli domu

Technicky V900 staví na boot_setup.h (zámek), ui_mode.h (brána), setup_ai.h (AI + MQTT, kroky 0…4). Dlouhý onboarding z V800 ve V900 není.

3. Celkový tok

Reset / factory AP EASUN · WiFi ID API ověření Restart Brána Jednoduchý×Expert Min. kroky / hub Provoz

Stavy ve SPIFFS (pro servis)

SouborHodnotyVýznam
/SETUP_BOOT.ea 0 | 1 | 2 0 = chybí WiFi · 1 = WiFi OK, chybí ID API · 2 = bootstrap hotov (plný boot)
/UiMode.ea simple | expert Režim UI; prázdné = po bootu 2 vynutit /ui-mode
/SETUP_APP.ea 0N / done Jen Jednoduchý soft-wizard (volitelné dokončení). Expert hub checklist bez locku.
Starý dlouhý řetězec kroků 3…19 z V800 ve V900 není. Zámek řídí jen /SETUP_BOOT.ea (0 / 1 / 2).

4. Fáze 0 — po resetu (zámek)

Web je zamčený. Topnav ukazuje jen Bootstrap. Ostatní URL → redirect na aktuální krok.

AWiFi (AP EASUN → domácí síť)

Bez sítě nejde ověřit ID API ani OTA. Klasický tok: síť EASUN, IP 192.168.4.1.

Nutné: SSID, heslo, jméno, příjmení, funkční e-mail (pro evidenci klíče).
Uloží: stávající WiFi soubory + kontaktní údaje.
Pak: SETUP_BOOT=1, restart do STA, IP z DHCP.
BID API klíč

Bez ověřeného klíče není autorizace / remote / podpora. Uživatel nesmí přeskočit.

Nutné: klíč + úspěšná odpověď serveru (okeasun jako dnes).
Uloží: klíč do SPIFFS, SETUP_BOOT=2.
Pak: jediný restart do plné aplikace → Fáze 1.
Box „Smazat vše / factory“ v bootstrapu necháme (záchrana při špatném klíči / WiFi) — ale bez dalších konfiguračních stránek.

5. Fáze 1 — po restartu: brána režimu

První stránka plné app (pokud chybí /UiMode.ea): dvě karty. To není AI režim — jen způsob ovládání.

Jednoduchý

  • Úzké menu: Home · Setup · Provoz · Teplota · WiFi
  • Setup = AI + doporučené MQTT (teploty/PWM = Expert)
  • MQTT = Setup krok 3 (nebo /mqtt); teploty / PWM = Expert
  • Odkazy do manuálu

Expert

  • Plné menu jako dnes
  • Hub checklist → stávající stránky
  • Žádný povinný lineární wizard
  • Přepínač zpět na Jednoduchý v patičce

Přesné znění brány i Setupu: sekce 1 · Finální UI texty.

6. Jednoduchý — AI + MQTT (kroky 0…4)

Po bráně Setup: vysvětlení AI → volba lokálního režimu → volitelně Gemini → MQTT (doporučeno, lze přeskočit) → hotovo. Teploty, PWM, Spot = Expert / stávající menu. Manuál: easun.eu/navod.

0 Co je AI 1 Režim 2 Gemini? 3 MQTT 4 Hotovo
0Jak AI pomáhá s topením?

Žádné nastavení — jen pochopení + odkazy.

Text na ESP: AI v zařízení navrhuje nebo řídí výkon topení (PWM). Limity teploty a baterie vždy platí — AI je neobejde. Začněte režimem Sledovat: AI topení ještě neřídí, jen kontrolujete data a návrh.
Odkazy (target easun):
1Jak má AI pracovat?

Jediná povinná volba. Uloží stejné systemMode jako /system-modes.

Karta (laik)InterníText na kartěNávod
Sledovat
★ doporučený start · výchozí
ai_shadow_free Proč začít: AI topení neřídí — jen počítá návrh. Ověříte MQTT a limity bez rizika. Stejný výpočet pak použije Pomáhat a Řídit. 11a · 20b
Pomáhat ai_assist_free Mix AI + klasika. Až když Sledovat ukázalo čerstvá data a smysluplný návrh (porovnání na stránce AI živě). 11a · 20c
Řídit ai_auto_free AI řídí výkon topení. Při výpadku dat se vrátí klasika. Až po ověření Sledovat a Pomáhat. 11a · 20d
Bez AI / Optimalizace v Jednoduchém nenabízet vůbec — jen Expert /system-modes.

Co ze Sledovat přechází do Pomáhat / Řídit

SHADOW neučí nový model a neukládá „naučené váhy“. Stejný AI výpočet běží už ve Sledovat — jen se nepoužije na výstup PWM. Přínos je ověření a srovnání, ne export datasetu do dalšího módu.
Co Sledovat ukáže / sebereJak to využijete dál
Živá data: solarW, loadW, grid, SOC, teploty, LUX (mqttFresh / luxFresh) ASSIST i AUTO potřebují stejné vstupy. Když ve Sledovat bliká „stale“, v Řídit by AI padala do fallbacku.
Srovnání na /ai-live: AI návrh % vs. skutečné PWM (klasika) Rozhodnutí „smím pustit AI?“ — pokud návrh dny sedí s realitou / přebytkem, jděte na Pomáhat (mix), pak Řídit.
Volitelný AI RUN log → server (11c) Denní archivy, přetoky, chyby dat, Spot Gate — podpora / doporučení. Na ESP se z toho automaticky nic „nenačte“; člověk doladí mix na /batt.
Hard limity (Min/Max °C, SOC, Spot Gate, Distr %) Platí ve všech módech. Sledovat ověří, že limity nejsou špatně nastavené, než AI dostane vliv.

Detail: 11a · laikům kap. 20b→20c→20d · přehled návodu.

2Cloudové AI Gemini?

Volitelné. Denní plán a vysvětlení. Čísla výkonu vždy počítá aplikace.

Karty:
  • Ne — jen lokální AI (výchozí) — stačí AI v ESP. Gemini nezapínat. → aiCloudEnabled=0
  • Ano — zprovoznit Gemini — beta · API klíč Google → cloud + geminiApiKey (jako /system-modes)
Odkaz: 21 · Beta cloudové AI · přehled.
Bez klíče = nechat vypnuto. Test klíče volitelný (jako dnes u Google).
3MQTT — data pro měření

Doporučené. Bez MQTT nechodí FVE / spotřeba / síť / baterie. Lze přeskočit.

Na ESP (/setup3):
  • Adresa brokeru (IP / hostname) — typicky Solar Assistant v LAN
  • Zapnout / vypnout MQTT v aplikaci (EasunData33: 0 = zapnout, 101 = vypnout)
  • Témata: Solar W/V/A, Load W, Grid W/V, Battery W/V/SOC
Odkaz: 05 · MQTT. Přeskočení → na Hotovo info: měření zatím nepojede; doladění na /mqtt.
4Hotovo

Shrnutí · SETUP_APP=done.

AI: {Sledovat|Pomáhat|Řídit} · Gemini: {vypnuto|zapnuto} · MQTT: {nastaveno|nenastaveno}.
Tip: Den ve Sledovat, pak Pomáhat. Teploty: /teplota.
Bez MQTT: varování, že měření nepojede + odkaz na /mqtt / zpět na krok 3.
Odkazy: Celý návod · 05 MQTT · 11 Režimy · Domů.
Záměrně pryč z Jednoduchého: typ topení/PWM, Min/Max teploty, Distr, SSR, FVE·AI, ECO, Spot, AI log. MQTT je v Setupu (krok 3) — jemné doladění témat i později na /mqtt / Expert.

7. Expert — hub, ne další wizard

Po bráně Expert: checklist. Bez locku. Badge OK / chybí podle existence klíčových .ea.

EHub /expert
Odkazy: MQTT · Teploty · Baterie · PWM · Režimy · FVE·AI · ECO · Spot/Provoz · Web/TSSR · Záloha.
Stejné stránky jako dnes — hub jen naviguje. Žádné nové save handlery.
Expert = dnešní app + úvodní brána + hub. Nemění výpočty PWM.

8. Co se nastaví bez otázky (defaults)

Po úspěšném ID API (nebo při prvním zápisu defaults) — aby laik nemusel „vyplnit vše“.

OblastDefault V900Kde změnit později
AI režim Dokud uživatel nezvolí v Setup: ai_shadow_free (Sledovat) — bezpečný start s AI Jednoduchý Setup krok 1 (jen 3 AI karty) / Expert /system-modes (včetně Bez AI)
Gemini cloud Vypnuto, dokud krok 2 neřekne Ano + klíč Setup krok 2 / /system-modes
PWM rychlost Domácí (firmware default) Expert /pwm
Distr / max síť Jen FVE (bezpečnější) dokud krok 2 neřekne jinak Setup / /teplota / /provoz
Min SOC (baterie) Rozumný práh (např. 20 %) nebo „bez limitu“ dle produktu /batt
SSR min PWM Stávající firmware default — bez kalibrace v bootstrapu Expert /pwm / teplota
FVE·AI / ECO / Spot Vypnuto / stávající safe defaults Expert / /provoz

9. Doladění po Setupu — teploty, PWM, MQTT

V Jednoduchém Setupu je MQTT doporučený krok 3 (lze přeskočit). Teploty a PWM Setup neřeší — aplikace běží s bezpečnými výchozími limity. Doladění „drátů“:

ÚkolKdePoznámka
MQTT broker a témata Setup /setup3 · /mqtt · Expert hub Bez živých W a SOC AI i Spot „lžou“. Přeskočeno? Měření nepojede, dokud nedoplníte.
Teploty Min/Max, Distr /teplota Default: Distr jen FVE (0). Síť povolíte až když víte, co děláte.
Rychlost topení (PWM) /pwm Default Domácí. Test ručního PWM je tu také.
Spot / limity sítě /provoz Průvodce Spot — volitelné, kdy smíte topit ze sítě.
Záloha / soft reset menu Záloha / /reset ZIP záloha · soft reset (smaže provoz, WiFi + ID API zůstanou) · factory wipe.
Tip: Den až dva ve Sledovat, sledujte Home / AI živě. Teprve pak Pomáhat. Detailní kapitoly: MQTT · 11a AI · Spot.

Proč méně textu v zařízení

Dlouhé návody nejsou ve flash ESP — šetří to místo pro OTA a zrychluje stránky. Krátké vysvětlení je na obrazovce; podrobnosti na easun.eu/navod (odkazy target=easun).

10. Interaktivní náhled obrazovek

Přepínač fází: Bootstrap (zámek) → Brána → Jednoduchý → Expert. Klikáním projdete stejný tok jako na zařízení.

Připojení k WiFi

Bez domácí sítě nejde ověřit klíč ani pokračovat.

ID API klíč

Povinné. Bez ověření aplikace nepustí dál.

Server musí vrátit okeasun.

Bootstrap hotov

WiFi OK · ID API ověřeno.
Zařízení se restartuje do aplikace.

Jak chcete nastavovat?

Lze kdykoli změnit v patičce. Nemění výpočty topení — jen vzhled menu.

Jak AI pomáhá s topením?

AI navrhuje nebo řídí PWM. Limity teploty a baterie vždy platí.

Začněte Sledovat: AI topení ještě neřídí — kontrolujete data a návrh.
📖 Návod · 11 · 11a

Jak má AI pracovat?

Jediná povinná volba. Bez AI nenabízíme.

📖 11a · SHADOW / ASSIST / AUTO

Cloudové AI Gemini?

Volitelné. Denní plán a vysvětlení. Čísla výkonu vždy z aplikace.

📖 21 · Beta cloudové AI

MQTT — data pro měření

Bez MQTT nechodí FVE / spotřeba / baterie. Lze přeskočit.

📖 05 · MQTT · Přeskočit = měření nepojede

Hotovo

AI: Sledovat · Gemini: vypnuto · MQTT: nastaveno.
Tip: Den ve Sledovat, pak Pomáhat. Teploty = Expert.

📖 Celý návod · 05 MQTT · 11 Režimy

Co náhled ukazuje

  • Bootstrap — červený zámek, jen WiFi → ID API → restart.
  • Brána — 2 karty po restartu.
  • Jednoduchý — AI + MQTT (úvod → režim → Gemini → MQTT → hotovo).
  • Expert — hub, plné menu.
Zámek Jednoduchý Expert

11. Mapa: krok → stránka a soubory

Pro vyhledávače i servis: co kam patří. Stejná pole jako v Expertu / vzdálené správě.

FázeUIKlíčové .ea / handlery
0A WiFi AP / /wifi WiFi creds + kontakt · SETUP_BOOT=1
0B ID API /boot-api (nebo tenké /key) klíč · ověření · SETUP_BOOT=2 · restart
1 Brána /ui-mode /UiMode.ea = simple|expert
S0 Úvod AI /setup jen text + odkazy návodu (default / 11 / 11a)
S1 Režim AI /setup1 systemMode = ai_shadow_free | ai_assist_free | ai_auto_free (ne original)
S2 Gemini /setup2 aiCloudEnabled + geminiApiKey (jako /system-modes)
S3 MQTT /setup3 broker + topics · lze přeskočit · /setup3-save
S4 Hotovo /setup4 SETUP_APP=done · varování bez MQTT
Expert hub /expert jen odkazy — žádná nová data

12. Časté otázky

Proč V900 už nemá dlouhý průvodce jako V800?

V800 míchal WiFi, MQTT, teploty, SSR kalibraci a AI do jednoho dlouhého zámku. Zabíral flash, uživatele zahltil a aktualizace (OTA) trpěly. V900 po resetu vyžaduje jen WiFi a ID API; zbytek je po restartu v Jednoduchém (AI + MQTT) nebo Expertu. Podrobněji v sekci Proč změna V800→V900.

Musím hned nastavit MQTT a teploty?

MQTT je v Jednoduchém Setupu doporučený krok 3 (/setup3) — lze přeskočit, ale bez brokeru měření FVE/baterie nepojede. Teploty a PWM najdete v Expertu (viz Doladění).

Jaký AI režim zvolit na začátku?

Sledovat — AI topení neřídí, jen počítá návrh. Ověříte MQTT a limity bez rizika změny výkonu. Až den až dva sedí, přepněte na Pomáhat a později Řídit. Návod: 11a SHADOW / ASSIST / AUTO.

Je Jednoduchý a Expert jiné topení?

Ne. Jde jen o šířku menu a způsob nastavení. Stejná data ve SPIFFS a stejné výpočty PWM. Přepnout lze kdykoli v patičce odkazem na /ui-mode.

Kde je „Bez AI“ / původní režim?

V Jednoduchém Setupu se nenabízí — záměr V900. Najdete ho v Expertu na /system-modes (original / Optimalizace).

Co když nemám broker MQTT?

Bootstrap i AI Setup dokončíte. Na kroku MQTT zvolte Přeskočit — na Hotovo uvidíte info, že měření zatím nepojede. Broker doplníte později na /mqtt nebo v Expertu. Bez živých dat AI a Spot nemají smysluplné vstupy — Sledovat to ukáže (stale / fallback).

Kde je oficiální katalog návodů?

easun.eu/navod/default.asp — kapitoly WiFi, ID API, MQTT, AI režimy, Spot a další.