Dokument vytvořen: 30. 7. 2026. Oficiální weby produktu: easun.eupowmr.eu.

Obsah

  1. Shrnutí
  2. Identifikace verzí
  3. Co mají obě verze společné
  4. api.easun.eu — autorizace a klasický cloud
  5. Easun Analyza — vzdálená administrace
  6. Nové funkce ve verzi 620
  7. Změněné chování
  8. Odstraněné / zastaralé
  9. Nastavení na zařízení ESP (620)
  10. Endpointy mezi ESP a serverem
  11. Praktický verdikt upgrade 601 → 620
  12. 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.h03.hspotove_ceny.hpajo.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_syncforms-mapgRemoteStandby 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_ipWiFiMac, volitelně api_keyfw, u logu také session_datemodecfglines.
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)

  1. Na ESP: /system-modes → zapnout „Odesílat AI provoz na server“ + host (např. api.easun.eu).
  2. ESP periodicky POSTuje AI20 (max 1× / 30 s), okamžitě AIERR/EVT a při startu/sync snapshot # cfg (AI, limity, Spot, baterie…).
  3. Server ukládá archivy podle zařízení (IP) + den do MySQL (deviceslog_uploadslog_entries).
  4. Stránka Analýza na api.easun.eu zobrazí grafy, varování a doporučení.
  5. Ze # cfg / sync se plní device_settings — podklad pro vzdálenou správu.
  6. 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.
  7. 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=1 očekává EASUN_AI_RUN_INGEST_OK. Legacy soubory /ai_run.log a /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-mapGET /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 — solarAmaxsolarAThrottlePct, 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 (tssrtssrPeertssrRelay).
  • Info stránky — /ai-run-log popisuje remote odesílání; /ai-shadow-log už 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.htmlspotove-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

  1. Otevřít na zařízení stránku /system-modes.
  2. Zapnout Odesílat AI provoz na server.
  3. Zadat adresu serveru Analyza — IP nebo doménu, např. api.easun.eu (ne localhost, ne celá URL s cestou).
  4. Aktivovat AI režim SHADOW, ASSIST nebo AUTO.
  5. 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 620Easun 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-modes host Analyza (pro produkci typicky api.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 administraci
  • provoz_pruvodce — průvodce provozu Spot / Distr. / limity

Rozšířené ve 620

  • ESP32-Grid-Load-Vypocet620 — AI remote log, sync, TSSR, /web bez restartu, SPIFFS cleanup
  • vypocet01 — napojení AI logu, remote standby v PWM smyčce
  • spotove_ceny — solarAmax / throttle

Server (Easun-Analyza na api.easun.eu)

  • index.php / ui— Domů, menu, Přihlášení, Registrace
  • api_ai_run_log — ingest AI logu z ESP
  • api_device_settings_sync— sync nastavení a příkazy
  • analyze— 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

Download EaSun 620

 

14 zobrazení

Diskuze

Zatím žádný příspěvek. Buďte první, kdo se k článku vyjádří.

Přidat příspěvek

Příspěvek se zobrazí po schválení.