Dokument vytvořen: 30. 7. 2026. Oficiální weby produktu: easun.eu, powmr.eu.
Obsah
- Shrnutí
- Identifikace verzí
- Co mají obě verze společné
- api.easun.eu — autorizace a klasický cloud
- Easun Analyza — vzdálená administrace
- Nové funkce ve verzi 620
- Změněné chování
- Odstraněné / zastaralé
- Nastavení na zařízení ESP (620)
- Endpointy mezi ESP a serverem
- Praktický verdikt upgrade 601 → 620
- Klíčové soubory
1. Shrnutí
Vypocet601 (FW S3.0603 / 32.0603) je plně funkční lokální řízení FVE / topení s AI režimy SHADOW, ASSIST a AUTO, MQTT, HTTP exportem dat a licenční autorizací na http://api.easun.eu
Nemá AI provozní log ani vzdálenou správu nastavení přes Easun Analyza.
Vypocet620 (FW S3.0626 / 32.0626) na 601 staví a přidává cloudovou / admin vrstvu:
AI provozní log se odesílá POST-em na server Analyza (/api_ai_run_log), synchronizaci nastavení (/api_device_settings_sync), vzdálené příkazy (standby / emergency / restart) a mapu formulářů (/api/forms-map, /api/config-values).
AI log se už neukládá do SPIFFS.
Katalog funkci.....
Web api.easun.eu dnes slouží jako Easun Analyza Logu:
Domů, Analýza, AI push, Základní návod, Přihlášení, Registrace.
Pro plné využití této administrace je potřeba firmware 620 (nebo novější odvozený z této linie).
Verze 601 na Analyza admin napojit nelze — pouze klasická autorizace ID API a volitelný HTTP/MQTT export.
2. Identifikace verzí
| Položka | Vypocet601 | Vypocet620 |
|---|---|---|
| Hlavní soubor | ESP32-Grid-Load-Vypocet601 |
ESP32-Grid-Load-Vypocet620 |
| Verze FW (ESP32-S3) | S3.0603 |
S3.0626 |
| Verze FW (ESP32) | 32.0603 |
32.0626 |
| Přibližná velikost .ino | ~14 600 řádků | ~17 300 řádků |
| AI run log | neexistuje | remote POST (ne SPIFFS) |
| Vzdálená admin Analyza | ne | ano (sync + příkazy + forms-map) |
| Partition SPIFFS | 64 KB | 64 KB (stejné; AI log sem už nejde) |
3. Co mají obě verze společné
- Řízení PWM / SSR z přebytků FVE, teplotní limity, distributor režimy.
- AI režimy na
/system-modes: SHADOW, ASSIST, AUTO + auto-optimalizace baterie. - MQTT (solar / load / grid / battery) a HTTP export na uživatelem zadané URL (
/web). - Licenční ověření ID API na
http://api.easun.eu/(IdApi + MAC + jméno/e-mail). - Průvodce prvním nastavením (
nastaveni.h), ESP-NOW teploty, Spot ceny, LCD/OLED. - Společné companion soubory:
vypocet01.h–03.h,spotove_ceny.h,pajo.h, weather/solar, teploty.
4. api.easun.eu — autorizace a klasický cloud (obě verze)
V obou firmwrech je pevně nastaveno:
AdresaAutorizace = "api.easun.eu";
Při startu / provozu ESP ověřuje platnost klíče (odpověď obsahující „okeasun“). Identita: soubory SPIFFS /key, /keymac a údaje uživatele (EasunData*).
Bez platné autorizace je provoz omezen (ApiChybaOvereni).
Katalog funkci.....
Odděleně od Analyza může uživatel na stránce /web nastavit:
- API KEY (
zeasun1) — klíč pro HTTP odesílání dat, - URL adresa1 / adresa2 — vlastní endpointy (historicky např. easun.asp / energy2),
- Čas — interval odesílání,
- URL TSSR — priorita primárního / sekundárního zařízení.
Tyto HTTP exporty nejsou totéž jako AI push do Easun Analyza. Jsou to volitelné zálohy provozních hodnot (výkony, teploty, PWM…).
Vztah k dnešní úvodní stránce Analyza
Domovská stránka https://api.easun.eu/index.php popisuje Analyza jako přehled provozu z přebytků FVE, denní archivy, grafy a vzdálenou správu.
Menu obsahuje: Domů, Analýza, AI push, Základní návod, Přihlášení, Registrace.
To odpovídá stacku PHP aplikace Easun-Analyza, která přijímá data z ESP (zejména verze 620).
5. Easun Analyza — vzdálená administrace (hlavní rozdíl)
5.1 Verze 601
Žádná vazba na AI push / device settings / remote příkazy. V kódu 601 nejsou symboly aiRunLog*, api_device_settings_sync, forms-map, gRemoteStandby ani tssrEnabled.
Co 601 umí vůči api.easun.eu:
- licenční autorizace
/api/, - volitelný HTTP/MQTT export na uživatelem zadané URL,
- lokální webové nastavení na samotném ESP.
Co 601 neumí vůči Analyza:
- odesílat AI20 / AIERR / EVT / # cfg do
api_ai_run_log, - plnit denní archivy pro stránku Analýza,
- synchronizovat nastavení z webu Analyza zpět do ESP,
- přijímat vzdálené příkazy standby / emergency_off / resume / restart,
- poskytovat kanonickou mapu formulářů pro vzdálený editor.
5.2 Verze 620
Hostitel Analyza není v AI logu natvrdo jako api.easun.eu. Uživatel na ESP zadá IP nebo doménu (např. api.easun.eu nebo LAN IP PC), firmware doplní pevnou cestu:
/api_ai_run_log— příjem AI provozního logu,/api_device_settings_sync— sync nastavení a remote příkazy.
Identita v POST/GET z ESP: device_ip, WiFiMac, volitelně api_key, fw, u logu také session_date, mode, cfg, lines.
Samostatné pole user_code firmware neposílá — účet v Analyza vzniká registrací a zařízení se mapuje podle IP / MAC / vazby uživatele v databázi.
5.3 Tok dat: ESP 620 ↔ api.easun.eu (Analyza)
- Na ESP:
/system-modes→ zapnout „Odesílat AI provoz na server“ + host (např.api.easun.eu). - ESP periodicky POSTuje AI20 (max 1× / 30 s), okamžitě AIERR/EVT a při startu/sync snapshot
# cfg(AI, limity, Spot, baterie…). - Server ukládá archivy podle zařízení (IP) + den do MySQL (
devices,log_uploads,log_entries). - Stránka Analýza na
api.easun.euzobrazí grafy, varování a doporučení. - Ze
# cfg/ sync se plnídevice_settings— podklad pro vzdálenou správu. - Analyza může poslat pending změny / příkazy; ESP je stáhne přes
api_device_settings_sync.php, aplikuje do RAM/SPIFFS a potvrdí ACK. - Remote standby vypne topení na ESP (
gRemoteStandby, soubor/remoteStandby— přežije restart).
6. Nové funkce ve verzi 620
- AI run log → remote only — fronta v RAM (max 24 řádků), batch max 6, probe
?probe=1očekáváEASUN_AI_RUN_INGEST_OK. Legacy soubory/ai_run.loga/ai_shadowse jen maže. - UI na /system-modes — Ano/Ne odesílání + host IP/doména, stav dostupnosti serveru.
- Device settings sync — push snapshotu nastavení, pull pending JSON, ACK.
- Remote příkazy — standby, emergency_off, resume, restart.
- forms_map.h + API —
GET /api/forms-map,GET /api/config-values(mapa sekcí teplota / batt / web / mqtt / pwm / spot / modes / ai_fve; verze mapy 3). - provoz_pruvodce.h — průvodce
/provoz,/provoz1…/provoz5. - TSSR vylepšení — přepínač
tssrEnabled(sledovat bez mazání URL), normalizace základní URL, aplikace do RAM bez restartu. - /web bez restartu — po uložení hodnoty ihned v RAM; SPIFFS zápis paralelně.
- Ochrana proudu FVE —
solarAmax,solarAThrottlePct, omezení PWM. - SPIFFS ochrana místa —
spiffsEnsureFreeForSettings(), mazání temp ZIP a legacy AI logů (důležité při 64 KB partition). - HTTP export rozšířen o metadata TSSR (
tssr,tssrPeer,tssrRelay). - Info stránky —
/ai-run-logpopisuje remote odesílání;/ai-shadow-loguž neposkytuje SPIFFS soubor.
7. Změněné chování (601 → 620)
| Oblast | 601 | 620 |
|---|---|---|
| Uložení /web | SPIFFS → typicky restart | SPIFFS + RAM ihned, bez restartu (POST i GET) |
| TSSR | Poll pokud URL ≠ null | URL + samostatný přepínač sledování; šetrnější interval pollu |
| /system-modes | Režimy AI / optimalizace | Stejné režimy + blok „AI log na server“ |
| Úložiště AI logu | — | Jen remote; SPIFFS záměrně ne |
| /ai-fve-pv | Odhad výkonu U×I | + max proud FVE (solarA) |
| Home TSSR karta | Při aktivní prioritě | + stav „TSSR vypnuto“ s odkazem na /web |
| GET /tssr | Závislé na sestavení Home | Export kódu i bez návštěvy Home (refreshTssrExportCode) |
8. Odstraněné / zastaralé
- Lokální AI run / shadow log ve SPIFFS (v 620 jen legacy mazání).
- Povinný restart po každém uložení
/web. - Vývojové HTML v rootu 601 (
ai-rozvoj.html,spotove-ceny.html) — v 620 nahrazeno strukturou návodů / odkazy na easun.eu. - Část dlouhých PROGMEM „návod“ textů na stránkách — často nahrazena odkazy.
MQTT ani klasický HTTP export ani ID API autorizace nebyly zrušeny.
9. Nastavení na zařízení ESP (pro napojení na api.easun.eu) — jen 620
- Otevřít na zařízení stránku
/system-modes. - Zapnout Odesílat AI provoz na server.
- Zadat adresu serveru Analyza — IP nebo doménu, např.
api.easun.eu(nelocalhost, ne celá URL s cestou). - Aktivovat AI režim SHADOW, ASSIST nebo AUTO.
- Na webu api.easun.eu použít Registraci / Přihlášení pro účet a sekci Analýza / AI push pro kontrolu příjmu dat.
Bez běžícího a dostupného hostitele Analyza se data neukládají do cloudového archivu (řádky zůstávají dočasně ve frontě RAM; při dlouhodobém výpadku probe označí server jako nedostupný a odesílání se opakuje později).
10. Endpointy mezi ESP a serverem
10.1 Společné (601 i 620)
| Směr | URL / cesta | Účel |
|---|---|---|
ESP → api.easun.eu |
http://api.easun.eu |
Licenční autorizace IdApi + MAC |
| ESP → uživatelská URL | zeasun2 / zeasun4 z /web |
Volitelný HTTP export provozních hodnot |
10.2 Jen 620 ↔ Easun Analyza (host = IP/doména z /system-modes)
| Směr | Cesta na hostiteli | Účel |
|---|---|---|
| ESP → server | /api_ai_run_log.php |
AI20 / AIERR / EVT / # cfg; denní archivy |
| ESP ↔ server | /api_device_settings_sync.php |
Push/pull nastavení, ACK, remote příkazy |
| Server / LAN → ESP | /api/forms-map |
Mapa formulářů a polí (contract pro admin UI) |
| Server / LAN → ESP | /api/config-values |
Aktuální hodnoty nastavení z RAM |
10.3 Stránky na api.easun.eu (uživatel)
- Domů — přehled služby Analyza
- Analýza — kalendář archivů, grafy, doporučení (data z AI push)
- AI push — dokumentace / stav příjmu (
api_ai_run_log.php) - Základní návod — jak zapnout odesílání na ESP
- Registrace / Přihlášení — účet pro správu vlastních zařízení
11. Praktický verdikt: upgrade 601 → 620
- Zůstaňte na 601, pokud stačí lokální řízení, MQTT a klasická autorizace ID API — bez cloudové AI analýzy a bez vzdálené změny nastavení z webu.
- Přejděte na 620, pokud chcete využívat api.easun.eu jako Easun Analyza: denní AI archivy, grafy, doporučení, sync nastavení a remote standby.
- Po flashi 620 nastavte na
/system-modeshost Analyza (pro produkci typickyapi.easun.eu) a ověřte zelený stav spojení. - Klasické funkce EaSun (
/api/autorizace + HTTP/MQTT export) zůstávají; hlavní skok 620 je AI log + obousměrná správa nastavení.
12. Klíčové soubory
Jen ve 620
forms_map— mapa sekcí a polí pro vzdálenou administraciprovoz_pruvodce— průvodce provozu Spot / Distr. / limity
Rozšířené ve 620
ESP32-Grid-Load-Vypocet620— AI remote log, sync, TSSR, /web bez restartu, SPIFFS cleanupvypocet01— napojení AI logu, remote standby v PWM smyčcespotove_ceny— solarAmax / throttle
Server (Easun-Analyza na api.easun.eu)
index.php/ui— Domů, menu, Přihlášení, Registraceapi_ai_run_log— ingest AI logu z ESPapi_device_settings_sync— sync nastavení a příkazyanalyze— analýza denních archivůdevice_admin_settings— vzdálená správa nastavení zařízeníforms_map— kanonická mapa polí (soulad s ESP/api/forms-map)
Soubor: porovnani-601-vs-620-api-easun.html · vazba na https://api.easun.eu/index.php
14 zobrazení
Diskuze
Zatím žádný příspěvek. Buďte první, kdo se k článku vyjádří.