Dokument popisuje, k čemu slouží webová analýza provozu EaSun, jak se používá, co posílá firmware na ESP32 nebo ESP32S3, jak se data ukládají a jak se z nich sestavuje denní přehled.

Související odkazy: Domů · Analýza · Základní návod · AI push endpoint

Obsah

  1. K čemu analýza slouží
  2. Jak se analýza používá
  3. Vazba na aplikaci / firmware ESP32
  4. Co ESP32 posílá na server
  5. Jak server data zpracovává
  6. Databáze a typy dat
  7. Pomocná telemetrie (MAC / easun)
  8. Co uživatel vidí ve výsledku
  9. Grafy a zoom OD / DO
  10. Kontrola, že odesílání běží

1) K čemu analýza slouží

EaSun Analyza je webová aplikace pro majitele a servis zařízení EaSun.
Vyhodnocuje, jak zařízení využívá přebytky solární výroby (přetoky FVE) pro ohřev vody / topení řízené AI.

Hlavní cíle:

  • ověřit, že přebytek FVE se mění v užitečné teplo, místo zbytečného odběru ze sítě;
  • ukázat průběh dne: solar, spotřeba domu (load), síť (grid/cez), intenzita topení (PWM);
  • odhalit problémy: nečerstvá data, chyby teploměrů, fallback AI, limity sítě, lux apod.;
  • navrhnout konkrétní úpravy v aplikaci EaSun (kde hledat a co změnit);
  • uchovat denní archivy podle zařízení a dne pro srovnání (např. slunečný vs. zatažený den).

Analýza není náhrada za ovládání zařízení.
Je to nezávislý přehled provozu mimo samotné ESP — data se shromažďují na serveru a vyhodnocují zpětně.

2) Jak se analýza používá

2.1 Nastavení na zařízení (jednou)

  1. Na zařízení EaSun otevřete stránku Režimy systému (cesta /system-modes).
  2. Zapněte volbu typu Odesílat AI provoz na server.
  3. Zadejte adresu serveru, kde běží tato analýza (IP nebo doména počítače / služby).
  4. Aktivujte AI režim SHADOW, ASSIST nebo AUTO.

Po zapnutí zařízení samo odesílá provozní záznamy.
Manuální nahrávání ani stahování logů v této verzi není potřeba.

2.2 Práce ve webu analýzy

  1. Otevřete Analýza.
  2. Vlevo vyberte denní archiv (zařízení + den, např. IP a datum YYYYMMDD).
  3. Vpravo se zobrazí souhrn, stav logování, grafy, kontroly, nastavení (cfg), doporučení a řádky logu.
  4. Podle tipů upravte limity v aplikaci EaSun a další den porovnejte nový archiv.

2.3 Co znamená jeden archiv

  • Jeden archiv = jedno zařízení (IP) + jeden kalendářní den.
  • Během dne se nové řádky přidávají; duplicitní řádky se přeskočí.
  • Starší dny se nemažou — zůstávají pro historii.

3) Vazba na aplikaci / firmware ESP32

Firmware na ESP32 (EaSun) řídí topení podle soláru, spotřeby, sítě, teplot a režimu AI.
Paralelně může odesílat provozní AI RUN log na server analýzy.
Oficiální weby a API prostředí EaSun: https://www.easun.eu, https://api.easun.eu/, https://www.powmr.eu.

Endpoint na serveru:

POST /api_ai_run_log
Content-Type: application/x-www-form-urlencoded

GET na stejné URL zobrazí krátkou nápovědu. GET s ?probe=1 vrátí plain text potvrzení (sonda z ESP, zda je server dostupný), např.:

EASUN_AI_RUN_INGEST_OK
EASUN_INGEST_V=8

Odpověď na úspěšný POST je plain text, např.:

OK added=12 skipped=3 merged=1 upload_id=5 total=48 v=8

Při chybě: ERR … a HTTP 400.

4) Co ESP32 posílá na server

Pole formuláře (POST):

Pole Povinné Význam
device_ip ano IPv4 adresa zařízení v LAN (identita archivu spolu s dnem)
session_date doporučeno Den ve formátu YYYYMMDD. Pokud chybí, použije se dnešek na serveru.
lines ano Text logu: řádky AI20, AIERR, EVT, případně meta řádky začínající #
WiFiMac ne MAC Wi?Fi (např. 1C:DB:D4:77:D0:F4) — uloží se do devices, vazba na telemetrii
mode ne Režim AI: SHADOW / ASSIST / AUTO / …
fw ne Verze firmware
api_key ne Klíč / identifikátor z konfigurace zařízení
cfg ne Snapshot nastavení — řádky # cfg klíč=hodnota …
user_code ne Kód uživatele; jinak se odvodí (např. device-192-168-1-108)

4.1 Typy řádků v lines

  • AI20 — hlavní provozní vzorek pro grafy a výpočty. Obvykle: HH:MM:SS|AI20 … s hodnotami solar, load, grid, PWM, lux, teploty, akce.
  • AIERR / EVT — chybové a událostní řádky (ukládají se do raw logu, slouží ke stavu logování a diagnostice).
  • # meta — např. # AI RUN …, # device IP=… MAC=…, # state …, # cfg ….

Příklad zjednodušeného bloku:

# AI RUN continue 20260728 19:40:01
# device IP=192.168.1.108 MAC=1C:DB:D4:77:D0:F4 mode=AUTO FW=S3.0616
# cfg solarWMin=200 cezMin=-50 cezMax=200 …
19:40:05|AI20 source=… solar=820 load=410 grid=35 pwm=42 …
19:40:20|AI20 …
19:41:02|AIERR …

5) Jak server data zpracovává

  1. Příjem — api_ai_run_log.php zavolá ingestAiRunLogPost().
  2. Normalizace — oddělí AI20, AIERR/EVT a meta/cfg; doplní čas u řádků bez timestampu.
  3. Parsování — parseLogContent() vytáhne session (IP, MAC, FW, mode, den) a z AI20 sestaví strukturované záznamy (PWM, solar, load, grid, lux, teploty, …).
  4. Uživatel a zařízení — findOrCreateUser(), upsert do devices (IP + MAC + FW).
  5. Merge do denního archivu — saveImportedLog() najde nebo vytvoří log_uploads pro device_id + session_date. Nové řádky zapisuje do log_entries (duplicity přes hash řádku se přeskočí).
  6. Souhrn — spočítá průměry / maxima / varování do summary_json.
  7. Zobrazení — stránka analyze.php načte archiv, spočítá diagnostiku, doporučení, grafy a (pomocně) telemetrii podle MAC.

Identita archivu je záměrně vázaná na IP zařízení + den (ne na měnící se user_code podle MAC/API), aby nevznikaly duplicitní archivy téhož dne.

6) Databáze a typy dat

Databáze MySQL.

6.1 Hlavní data analýzy (z AI logu)

Tabulka Účel
users Uživatelé / kódy (odvozené nebo zadané)
devices Zařízení: IP, MAC, FW, last_seen
log_uploads Denní archiv: raw log, cfg, souhrn, počty importů
log_entries Jednotlivé AI20 vzorky (čas, PWM, solar, load, grid, lux, teploty, akce)

Hlavní zdroj grafů, souhrnů a doporučení je AI log (log_uploads / log_entries).

6.2 Pomocná telemetrie (mimo AI RUN)

  • Centrální tabulka — historická měření s polem WiFiMac (výkony, teploty t1/t2/t3, vlhkost, PWM, …).
    Související veřejný přehled / API prostředí: https://api.easun.eu/.
  • Tabulky pojmenované podle MAC, např. MAC 1C:DB:D4:xx:xx:xx → tabulka 1c_db_d4_xx_xx_xx (solarW, loadW, cezW, pwm, lux, …).

Tato data nejsou hlavní.
Slouží k pomocným výpočtům, teplotám a k doplnění chybějících úseků času OD / DO, pokud AI log má mezery (např. delší než cca 10 minut).

7) Pomocná telemetrie (MAC / easun) — pravidla

  1. Z archivu se vezme MAC z devices.
  2. Načtou se měření za stejný den z MAC tabulky (nebo fallback).
  3. Grafy a čísla v souhrnu vycházejí z AI logu.
  4. Pokud AI log v nějakém intervalu chybí, body z telemetrie se mohou doplnit do grafu jen do těchto mezer OD/DO.
  5. Pokud AI log nemá žádné řádky, telemetrie se použije jen jako nouzový fallback a uživatel je na to upozorněn.

8) Co uživatel vidí ve výsledku

  • Souhrn archivu — uživatel, IP/MAC, den, průměry PWM/solar/load, max grid, varování, tipy.
  • Stav logování — jestli AI log během dne reálně přicházel.
  • Pomocná telemetrie — orientační srovnání a info o doplnění mezer.
  • Vizuální analýza — laický popis dne + grafy výkonů a PWM.
  • Kontroly stavu — zelená / oranžová / červená (OK / varování / chyba).
  • Kontrola nastavení — vyhodnocení cfg z ESP (limity sítě, baterie, Spot, dist, …).
  • Teploměry — t1/t2/t3 a podezřelé hodnoty.
  • Doporučení — co změnit a kde to v aplikaci EaSun hledat (včetně odkazu do LAN zařízení, pokud je IP známá).
  • Hlavička a cfg — surový text z logu.
  • Řádky logu — tabulka AI20 vzorků.

Význam barev stavových karet:

  • Zelená (ok) — stav vypadá v pořádku.
  • Oranžová (warning) — stojí za kontrolu.
  • Červená (error) — chyba nebo silně podezřelý provoz.

9) Grafy a zoom OD / DO

  • Graf výkonů: Load (modrá area), Grid (červená area), Solar (žlutá čára).
  • Graf PWM: intenzita topení v %.
  • Pozadí grafu sleduje světlý / tmavý režim stránky; barvy řad zůstávají pevné.
  • Zoom myší: tažením přes graf vyberete časový rozsah OD–DO a zvětšíte detail. Pravý klik nebo tlačítko „Resetovat zoom OD/DO“ vrátí celý den.

10) Kontrola, že odesílání z ESP běží

  1. Na ESP ověřte, že je zapnuté odesílání AI provozu a správná adresa serveru.
  2. Ze zařízení / prohlížeče vyzkoušejte sondu.
  3. V analýze musí přibývat denní archiv pro IP zařízení a dnešní datum.
  4. Počet řádků v archivu má během dne růst; u „Stav logování“ by nemělo být dlouhé ticho bez nových AI20 vzorků (pokud má AI aktivně řídit).
  5. MAC v devices by se měla shodovat s WiFiMac zařízení — pak funguje pomocná telemetrie a doplňování mezer.

Shrnutí toku dat

ESP32 (EaSun firmware)
  ?  AI řízení topení + měření
  ?
  ?? POST api_ai_run_log.php  (AI20 / AIERR / EVT / cfg / WiFiMac / …)
  ?     → devices, log_uploads, log_entries   ← HLAVNÍ DATA ANALÝZY
  ?
  ?? (jiný kanál / starší ukládání) telemetrie
        → tabulka easun (WiFiMac) a/nebo tabulka podle MAC
              ← jen POMOCNÁ DATA (mezery OD/DO, teploty, orientace)

Web analyze.php
  ← načte denní archiv AI logu
  ← spočítá souhrn, diagnostiku, doporučení, grafy
  ← volitelně doplní mezery z telemetrie podle MAC

12 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í.