EaSun Grid Load · uživatelský návod

Jednoduchý průvodce nastavením

Kompletní návod k prvnímu nastavení aplikace EaSun Grid Load na ESP32: připojení WiFi a MQTT, volba režimu Jednoduchý nebo Expert, nastavení AI topení, teplot, baterie a měniče. Stejná data, rozdílné ovládání.

Přehled
Fáze 1 · Připojení
Jednoduchý × Expert
Fáze 2 · Jednoduchý
Fáze 2 · Expert
Tři vrstvy řízení
PWM rychlost
Menu, záloha, reset
MQTT vypnout
Interaktivní náhled
Mapa URL a polí
Časté otázky

1. Přehled: dvě fáze místo chaosu

Po instalaci nebo úplném resetu zařízení projdete dvěma fázemi. Nejdřív se „zapojí dráty“ (síť, licence, data, čidla), potom nastavíte „jak má topit“ (AI, typ topení, teploty). Díky tomu laik neřeší MQTT topics a AI režimy ve stejný okamžik.

Fáze 1 · Připojení→ Brána /ui-mode→ Fáze 2 · Topení→ Home + menu

Fáze	Co nastavíte	Kde v aplikaci	Zámek
1 · Připojení	WiFi, kontakt, ID API, MQTT, teploměry, min. PWM SSR	Onboarding (`/nastaveni-krok*`)	Ano — dokud není hotovo (`SETUP_KROK` < 20)
Brána	Jednoduchý nebo Expert ovládání	`/ui-mode`	Ano — jen tato stránka (`UiModePending`)
2a · Jednoduchý	AI · typ topení · teploty · baterie · měnič · kontrola dat	`/setup` … `/setup6`	Bez horního menu (`AppSetupPending`)
2b · Expert	Checklist odkazů na plné formuláře	`/expert`	Bez horního menu do dokončení
3 · Provoz (volitelně)	Spot / Distr — kdy smíte topit ze sítě	`/provoz`	Ne

Důležité: režim řízení AI (Sledovat / Pomáhat / Řídit) patří do Fáze 2, ne do připojení. Soft reset provozu WiFi ponechá a vrátí vás na bránu /ui-mode.

2. Fáze 1 — Připojení (po resetu / první instalaci)

Dokud není dokončen onboarding, aplikace omezí web jen na nutné kroky. Hodnota SETUP_KROK v souboru /SETUP_KROK.ea (v konfiguraci) určuje, kde jste. Cílová hodnota 20 = plná aplikace odemčená.

Hodnoty SETUP_KROK

Hodnota	Význam
0	Úvod / před WiFi
1	Po uložení WiFi z přístupového bodu EASUN
2	Po ověření ID API
3–4	MQTT uloženo / ověřeno (živá data)
5	Teploměry dokončeny
6 / 19	SSR kalibrace · souhrn
20	Připojení hotovo → restart → brána režimu UI

Kroky připojení — co musí zůstat spolehlivé

1WiFi a kontakt

Nejdřív se připojíte k síti EASUN (AP zařízení), zadáte domácí WiFi, jméno a e-mail. Bez sítě neběží MQTT, remote správa ani aktualizace. Později upravíte kdykoli v menu WiFi (/wifi).

2ID API

Platný klíč aplikace ověří licenci, vzdálenou správu a zálohy. Stránka /nastaveni-krok2 → uložení přes /nastaveni-getkey.

3MQTT broker a témata

Bez živých wattů a SOC (stav baterie) AI i Spot „lžou“. Nastavíte broker, témata a ověříte příjem dat. Pokud broker nepoužíváte, lze MQTT později vypnout (viz MQTT vypnout).

4Teploměry

DS18B20 nebo bezdrátové ESP-NOW čidla, mapování na okruhy T1–T3, rozsah OD/DO. Bez čidel není bezpečné topit — softwarové limity Min/Max °C by neměly co měřit.

5Minimální PWM SSR (kalibrace)

Fyzické minimum 0–25 % (ssr_eff_min), aby relé / SSR vůbec „naběhlo“. Unikátní krok hardwaru — není to totéž jako „rychlost topení“ (PWM smoothing).

✓Dokončeno

SETUP_KROK = 20, restart. Následuje zámek jen na /ui-mode (volba Jednoduchý / Expert) — ne rovnou Home s plným menu.

Onboarding nesmí přeskočit: WiFi, ID API, ověřené MQTT (pokud ho používáte), mapování čidel a SSR min PWM. To jsou „dráty“. Chování topení řeší Fáze 2.

Výchozí limity po kalibraci SSR

Po dokončení kroku SSR aplikace typicky předvyplní provozní limity (lze později změnit):

Klíč / soubor	Výchozí	Význam
Max odběr ze sítě %	0	Nejdřív jen FVE přebytek (bezpečné)
Distr min / max W	200 / 300	Pásmo výkonu sítě
Min solární W	např. 300	Pod tímto výkonem FVE topení neběží
Min SOC baterie	90 nebo 0	90 pokud je MQTT téma SOC; jinak dle konfigurace

3. Brána: Jednoduchý nebo Expert

Než uvidíte menu formulářů, zvolíte režim rozhraní (uloženo jako simple nebo expert). Nejde o AI — jen o šířku menu a způsob nastavení. Přepnout lze později z patičky odkazem na /ui-mode.

Jednoduchý

Menu: Home · Setup · Provoz · Teplota · WiFi · Záloha · Akt · Off
Nastavení = průvodce kartami /setup…/setup6
AI: jen Sledovat / Pomáhat / Řídit
PWM = typ topení (Bojler…), ne čísla
FVE·AI / ECO jako Ano/Ne otázky

Pro majitele domu — „funguje a hotovo“.

Expert

Plné menu: Měření, MQTT, PWM, Spot, Režimy, FVE·AI, Eco, Del…
Hub /expert + klasické formuláře
AI včetně Původní / Optimalizace / log / cloud Gemini
PWM čísla + ruční test na /pwm
Stejné datové soubory jako Jednoduchý

Pro technika, servis a vzdálenou správu.

Jak vypadá brána

Jednoduchý Pár otázek lidsky. Doporučeno, pokud nechcete řešit MQTT topics a Distr. Expert Všechna nastavení a formuláře. Stejná data, větší kontrola.

	Jednoduchý	Expert
Vstup	Brána → průvodce krok za krokem	Brána → hub / plné menu
AI	3 karty	`/system-modes` + optimalizace + cloud
Topení / PWM	předvolba typu	`/pwm` čísla + ruční test
Teploty	Min/Max + „smím ze sítě?“	`/teplota` Distr / SSR…
Měnič	2–3 Ano/Ne	`/ai-fve-pv` + `/eco`
Remote admin	může přepsat hodnoty; UI jen zobrazí	1:1 se sekcemi formulářů

Po uložení volby: AppSetupPending — dokud nedokončíte Setup / Expert, není horní menu. Dokončení = /app-setup-done.

4. Fáze 2 — Jednoduchý průvodce (/setup)

Lišta kroků: Úvod · 1 · 2 · 3 · 4 · 5 · 6. Každý krok = jedna otázka, jedna doporučená volba, jedna věta „proč“. Distr / Spot (kdy smíte ze sítě) řeší samostatný průvodce /provoz.

Úvod→ 1 AI→ 2 Topení→ 3 Teploty→ 4 Baterie→ 5 Měnič→ 6 MQTT + Hotovo

ÚÚvod — Jednoduché nastavení

Vysvětlí postup. CTA Začít → /setup1.

1Jak má AI pracovat?

Bez zvoleného režimu AI nic neřídí / jen loguje. Laik nevybírá „Původní“ ani „Optimalizace“.

Volby: Sledovat · Pomáhat (doporučeno) · Řídit.
Uloží: stejný systémový režim jako stránka /system-modes (ai_shadow_free / ai_assist_free / ai_auto_free).
Pokročilé (Původní, Optimalizace, log, Gemini) jsou v Expertu na /system-modes.

2Co topíte?

Nastaví rychlost změny PWM a typický charakter zátěže — bez čísel.

Předvolby: Bojler / TUV · Elektrické radiátory · Podlahové · Bazén · Domácí · …
Uloží: pwm_speed, pwm_smoothing, pwm_delay, slow_mode — stejné hodnoty jako na /pwm a ve vzdálené správě (sekce PWM).

3Teploty: kdy topit a kdy přestat

Min = „ještě chci topit“, Max = „už je dost“. Bez limitu SSR blbne.

Na kanál (T1…): název, Min °C, Max °C.
Síť: „Jen přebytek FVE“ (max odběr 0 %) / „Smím i ze sítě až X %“.
Detail Distr a SSR min: stránka /teplota nebo jemnější úprava.

4Baterie — smím topit?

AI Pomáhat/Řídit potřebuje jasný práh SOC, jinak „mlčí“.

„Topit až od SOC %“ nebo „bez limitu SOC pro AI“.
Uloží pole z /batt (baterie1, případně mix % u ASSIST).

5Jaký máte měnič? (podmíněné)

Hybrid často hlásí solarW podle spotřeby; Anern ECO potřebuje impulz.

„solarW z MQTT sedí s panely?“ → Ne = FVE·AI odhad + strop W
„Měnič vyrábí podle odběru (ECO / load-follow)?“ → Ano = ECO impulz (LUX = automaticky)
„Chci chránit max. proud FVE?“ → Ano = solarAmax (+ brzdění od ~90 %)

Uloží přes stejné handlery jako /ai-fve-pv a /eco.

6Tečou data? Hotovo

Bez živých MQTT hodnot řízení neběží správně.

Badge živých dat (solarW, loadW, SOC…).
CTA Dokončit nastavení → /app-setup-done → Home + menu.
Doporučení: den Sledovat → Pomáhat → teprve potom Řídit.

Pojmenování AI režimů

Interní hodnota	V UI laika	Význam
`ai_shadow_free`	Sledovat	AI počítá návrh, topení řídí klasika. Bezpečné srovnání prvních dní.
`ai_assist_free`	Pomáhat	Mix AI + klasika. Doporučený start pro většinu domácností.
`ai_auto_free`	Řídit	AI řídí PWM; při chybě fallback. Až když Sledovat/Pomáhat sedí.
`original` / `optimization`	Expert · Pokročilé	Bez AI / priorita baterie — pro technika.

5. Fáze 2 — Expert hub (/expert)

Po volbě Expert dostanete seznam odkazů na stávající stránky (ne kartový průvodce). Dokud nedokončíte, bez horního menu. Po /app-setup-done plné expert menu.

Režimy — /system-modes
Teploty · Distr · SSR — /teplota
Baterie · SOC — /batt
MQTT — /mqtt
PWM test + rychlost — /pwm
FVE·AI — /ai-fve-pv
ECO Load-Following — /eco
Provoz Spot / Distr — /provoz
Spot config — /spot-config
Web / TSSR — /web

Expert = klasická aplikace + brána + hub. Nemění PWM výpočty — jen organizuje vstup.

6. Tři vrstvy řízení (proč to vypadá složitě)

V aplikaci jsou tři různé „režimy“, které se jmenují podobně, ale dělají něco jiného:

Vrstva	Kde nastavíte	Otázka laika
1. Řízení PWM AI Sledovat / Pomáhat / Řídit · Původní · Optimalizace	`/setup1` nebo `/system-modes`	„Má AI pomáhat s výkonem topení?“
2. Provozní profil Jen FVE / Levný Spot / Hybrid	`/provoz` … `/provoz5`	„Smím topit ze sítě, nebo jen z přebytku?“
3. Okruhy (Distr + teploty) D.Ne / D.Ano / D.MinMax · Min/Max °C	`/teplota`, část `/setup3`	„Která topná tělesa, od–do °C?“

AI nenahrazuje Distr ani Spot Gate — i režim Řídit (AUTO) je na ESP oříznutý bezpečností. Nejdřív rozhodněte „smím ze sítě?“ (/provoz), pak „jak chytře řídit PWM?“ (AI).

Distr lidsky

D.Ne — jen FVE přebytek
D.Ano — síť až když teplota klesne pod Min
D.MinMax — síť i bez FVE (v pásmu Min–Max W)

7. PWM — jak rychle smí topení měnit výkon

Na stránce /pwm je pod ručním testem blok „Jak rychle smí topení měnit výkon“ s předvolbami (Domácí / Bojler / Radiátor / Podlahové…). Pokročilá čísla jsou ve skrytém <details>.

Ukládá se přes /getpwmsettings do pwm_speed, pwm_smoothing, pwm_delay, slow_mode — stejné klíče jako ve vzdálené správě. V Jednoduchém režimu totéž nastavíte kartou „Co topíte?“ v /setup2.

Min. PWM SSR (kalibrace relé 0–25 %) je jiné nastavení než rychlost / vyhlazení PWM.

8. Menu, Záloha, Aktualizace a reset

Jednoduché menu

Odkaz	URL	Účel
Home · Setup · Provoz · Teplota · WiFi	`/` … `/wifi`	Běžný provoz
Záloha	`/reset#spiffs-backup`	ZIP export / import konfigurace
Akt	`/reset#firmware-update`	OTA nahrání firmware `.bin`
Off	`/restart`	Restart zařízení

Expert má navíc Del → celá stránka /reset včetně úplného wipe.

Dva typy smazání na /reset

	Úplný reset (červený)	Jen provoz (žlutý)
Co smaže	Celé SPIFFS (format) + PZEM kWh	Provozní klíče (MQTT, teploty, režimy, PWM, Spot, ECO…)
WiFi / kontakt / ID API	Pryč → AP `EASUN`	Zůstávají
Po akci	Restart → Fáze 1 od WiFi	Restart → jen `/ui-mode` (znovu zvolit režim a Setup)
Tlačítko	Resetovat nastavení	Smazat provoz a zvolit režim

Soft reset provozu nevrací zařízení do AP EASUN — SETUP_KROK zůstává ≥ 20. Ideální, když chcete znovu projít Jednoduchý/Expert průvodce bez přepisování WiFi.

9. MQTT vypnout (bez brokeru)

V nastavení MQTT lze zvolit MQTT vypnout (bez brokeru). Znamená to, že klient se opravdu nepřipojuje ani nepolluje (ani při obnově watchdogu). IP brokeru v poli se jen pamatuje pro pozdější zapnutí.

Po uložení + restartu: hláška „MQTT vypnuto“, ne „Přijímám MQTT…“.
Diagnostika /diag nehlásí MQTT chyby, když je MQTT vypnuté.
Bez MQTT (a bez HTTP brokeru) nepřijdou FVE / spotřeba z měniče — to je záměr.

AI a Spot potřebují živá data. Vypnutí MQTT dává smysl u instalací bez měniče na MQTT nebo při ladění hardwaru bez sítě brokeru.

10. Interaktivní náhled obrazovek

Maketa odpovídá aktuálnímu firmwaru: po /ui-mode bez horního menu, dokud nedokončíte Setup / Expert. Vyzkoušejte přepínače níže.

Brána = /ui-mode · Jednoduchý = /setup…/setup6 · Expert = /expert · dokončení = /app-setup-done

bez horního menu · zĂˇmek volby reĹľimu

Dokončení nastavení

Poslední krok: jak chcete dál ovládat zařízení. Nejde o AI — jen o šířku menu. Dokud neuložíte, nic jiného nepůjde otevřít.

bez horního menu · dokud nedokonÄŤĂte nastavenĂ · /setup

Jednoduché nastavení

Proč: pár otázek lidsky. Stejná data jako expertní formuláře.

Nejdřív jak má chytře řídit topení, pak typ topení, teploty, baterie a měnič.

Kroky 1–6. Horní menu se odemkne až po dokončení.

1 · Jak má AI pracovat?

Proč: zvolíte, jestli chytrá logika jen sleduje, pomáhá, nebo řídí výkon topení.

Už nastaveno — Řídit

Pokročilé — Původní / Optimalizace baterie, log, cloud.

2 · Co topíte?

Proč: rychlost změny výkonu (= /pwm, remote section=pwm).

Další: Bazén · Garáž · Rychlé reakce

3 · Teploty okruhu

Proč: Min = topit, Max = dost; síť = max odběr %.

Název (T1)

Min °C

Max °C

4 · Baterie

Proč: Min SOC — kdy smí topení na baterii.

5 · Měnič

Proč: FVE odhad U×I a ECO impulz — Ano/Ne.

6 · Tečou data? Hotovo

Proč: bez živých MQTT hodnot řízení neběží správně.

solarWživý

loadWživý

cezW / SOCvolitelné

Pomáhat · Bojler 45–55 °C · síť 40 % · FVE odhad · ECO

Doporučení: den Sledovat → Pomáhat → Řídit.

= /app-setup-done → Home + topnav (Home·Setup·Provoz·Teplota·WiFi·Záloha·Akt·Off)

bez horního menu · dokud nedokonÄŤĂte nastavenĂ · /expert

Expert — checklist

Projděte potřebná nastavení. Horní menu až po dokončení. Můžete znovu zvolit režim.

Režimy (AI / funkční)/system-modes Teploty · Distr · SSR/teplota Baterie · SOC/batt MQTT/mqtt PWM test + rychlost/pwm FVE·AI/ai-fve-pv ECO Load-Following/eco Provoz Spot / Distr/provoz Spot config/spot-config Web / TSSR/web

Po dokončení: plné expert topnav + tip „Přepnout na Jednoduchý“ · odkaz na /setup.

Home Setup Provoz Teplota WiFi Záloha Akt Off

Home / měření

Po /app-setup-done — plné zúžené menu.

dokud nedokonÄŤĂte nastavenĂ = 0 · UiMode = simple

Shoda s FW

/ui-mode — bez topnav; titulek „Dokončení nastavení“; CTA Uložit…
/setup — lišta Úvod·1…6 (ne 0–7); úvod ≠ Provoz/Distr
/expert — hub seznam URL (ne číslovaný checklist se statusy OK)
Dokud dokud nedokonÄŤĂte nastavenĂ: žádný topnav (simple i expert)
CTA dokončení: /app-setup-done → Home
Po odemčení simple: Home·Setup·Provoz·Teplota·WiFi·Záloha·Akt·Off

Jednoduchý Proč / zámek Hotovo

11. Mapa: krok průvodce → stránka a pole

Krok	Stránka / handler	Klíčová pole
Úvod	`/setup`	jen vysvětlení + Začít
1 AI	`/setup1` → `/system-modes`	`systemMode`, AI free flagy
2 Typ topení	`/pwm` (rychlost)	`pwm_speed`, `pwm_smoothing`, `pwm_delay`, `slow_mode`
3 Teploty	`/teplota` + část `/provoz`	Min/Max T, Distr, max odběr %, min FVE W
4 Baterie	`/batt`	`baterie1`, AI mix %
5a FVE odhad	`/ai-fve-pv`	odhad surplus, cap W, `solarAmax`
5b ECO	`/eco`	ECO impulz, kick %, max grid W
6 Hotovo	`/setup6`	live MQTT · `/app-setup-done`
Brána UI	`/ui-mode`	`UiMode` = simple \| expert

Pravidlo: průvodce nezavádí nová jména nastavení (výjimka UiMode). Zapisuje stejná data jako expertní stránky — vzdálená správa a lokální UI zůstanou v souladu.

12. Časté otázky

Musím projít Jednoduchý i Expert?

Ne. Zvolíte jeden režim na bráně. Kdykoli ho změníte v /ui-mode.

Proč po Dokončeno připojení nevidím Home?

Nejdřív musíte zvolit Jednoduchý/Expert (UiModePending), pak dokončit Setup / Expert checklist (AppSetupPending).

Kde je Původní / Optimalizace / Gemini?

V Expertu na /system-modes. V Jednoduchém setupu jsou jen tři karty AI (Sledovat / Pomáhat / Řídit), aby laik nerozhodoval o pěti režimech najednou.

Jak začít topení znovu bez ztráty WiFi?

Na /reset použijte žluté tlačítko Smazat provoz a zvolit režim. Po restartu jdete znovu na /ui-mode.

Mění průvodce výpočty PWM?

Ne. Mění jen způsob zadání stejných parametrů. Matematika řízení zůstává.