Tisk · doporučeno A4 na výšku

11c. Vzdálená analýza AI (api.easun.eu)

Kapitola 11c · https://api.easun.eu/ · lokální kopie: C:\inetpub\wwwroot\Easun-Analyza · odesílání z /system-modes

Easun Analyza Logu je webová služba (veřejně api.easun.eu, nebo vlastní instalace Analýzy), která přijímá provozní data z EaSun Aplikace, skládá denní archivy, kreslí grafy, dává doporučení a umožňuje vzdálenou správu (živý stav, Off / Standby / On / Restart, změna parametrů).

Oficiální návod přímo na serveru: guide.php · AI režimy: 11a, 11 · AI doc: AI_Rezimy_Dokumentace.html

Mapa webu api.easun.eu

Stránka	URL	Účel
Domů	`index.php`	Úvod: Analýza, Účet / Přihlášení, odkazy easun.eu / powmr.eu
Analýza	`analyze.php`	Kalendář denních archivů, grafy, kontroly, doporučení, řádky logu
AI push	`api_ai_run_log.php`	Veřejný ingest endpoint (ESP POST); GET = nápověda / sonda
Základní návod	`guide.php`	Kompletní návod služby (účet, admin, soukromí, typické chyby)
Přihlášení / Registrace	`login.php` · `register.php`	Účet majitele zařízení
Účet	`account.php`	Karty „Moje zařízení“ → odkaz Nastavení; přidání přes ID API
Přidat zařízení	`account_add_device.php`	Přiřazení jen přes ID API klíč (+ volitelný popisek)
Nastavení zařízení	`device_admin.php`	Off / Standby / On / Restart, živé stavy, Stav provozu (= /diag), historie událostí
Parametry a soukromí	`device_admin_settings.php`	Limity jako v aplikaci ESP + veřejná/soukromá analýza

Jazyky UI: CZ / EN / DE / PL (přepínač v horní liště).

Celkový provoz — diagram

flowchart TB subgraph ESP["EaSun Aplikace (ESP32)"] SM["/system-modes
AI režim + host serveru"] AI["SHADOW / ASSIST / AUTO"] LOG["AI20 / AIERR / EVT + cfg"] SYNC["Settings snapshot
+ pull příkazů"] EVT["Eventy: WDT, start, TSSR…"] HOME["Home: box POHOTOVOST"] end subgraph API["api.easun.eu / Easun-Analyza"] ING["api_ai_run_log.php"] DSS["api_device_settings_sync.php"] DEV["api_device_events.php"] DB[(MySQL easun)] AN["analyze.php
kalendář + grafy"] ADM["device_admin.php"] ACC["account.php"] end SM --> AI AI --> LOG LOG -->|POST lines| ING ING --> DB DB --> AN SYNC -->|POST snapshot / pull / cmd_ack| DSS DSS --> DB DB --> ADM EVT -->|POST| DEV DEV --> DB ACC --> ADM ADM -->|fronta Off/Standby/On/Restart| DSS DSS -->|ESP stáhne příkaz| SYNC SYNC --> HOME

Bez zapnutého odesílání AI provozu na server ESP administraci „neosloví“ (neposílá heartbeat / nestahuje příkazy).

1) AI push — jak data vznikají

Na ESP: Režimy → /system-modes.
Zapněte Odesílat AI provoz na server.
Host: jen IP nebo doména (např. api.easun.eu) — ne celá URL. Firmware skládá http://{host}/api_ai_run_log.php (SPIFFS /aiRunLogRemoteUrl.ea, /aiRunLogRemoteEnabled.ea).
Aktivujte SHADOW / ASSIST / AUTO (bez AI režimu nemá push smysl).
Otestujte spojení (probe) — odpověď obsahuje EASUN_AI_RUN_INGEST_OK / verzi ingestu.

AI logy se neukládají do SPIFFS na ESP — jen POST na server. Při chybě spojení FW může server dočasně označit jako nedostupný; znovu otestujte na Režimech.

Co ESP posílá na `api_ai_run_log.php`

Pole POST	Význam
`device_ip`, `session_date`	IP + den archivu (YYYYMMDD)
`lines`	Dávka řádků AI20 / AIERR / EVT / # meta
`WiFiMac`, `mode`, `fw`	Identita a FW
`api_key`	ID API (vazba na účet)
`cfg`	Snapshot nastavení (# cfg řádky) pro „Kontrola nastavení“

AI20 (strukturovaný provozní řádek) typicky nese mimo jiné:

řízení: mode, src, navrh, final (PWM), fallbackPwm, action
čerstvost: mqttFresh, luxFresh, lux
výkony: solar, solarRaw, load, grid
baterie: soc, batV, případně batW/A/kWh…
teploty: t1, t2, t3, tempMax
Spot: spot, gate, band
TSSR / SSR: tssr, tssrPeer, tssrRelay, ssr1/2/3

sequenceDiagram participant ESP as EaSun ESP participant ING as api_ai_run_log.php participant DB as MySQL participant AN as analyze.php ESP->>ING: GET ?probe=1 ING-->>ESP: EASUN_AI_RUN_INGEST_OK loop Při AI provozu (dávky) ESP->>ING: POST lines + cfg + MAC + api_key ING->>DB: merge archiv (zařízení + den) ING-->>ESP: OK added=… skipped=… end Note over AN,DB: Uživatel otevře den v kalendáři AN->>DB: upload_id + entries DB-->>AN: souhrn, grafy, doporučení

2) Denní archivy a Analýza (`analyze.php`)

Jeden archiv = jedno zařízení + jeden den.
Během dne se řádky slučují; duplicity se přeskočí.
Kalendář měsíců → výběr dne / IP → detail.
Grafy se mohou obnovovat bez reloadu přes api_analyze_charts.php?upload_id=….

Sekce detailu archivu

Blok	Co uvidíte
Souhrn	Ø PWM, Ø solar / load, max grid, počet řádků…
Vizuální analýza	Laické hodnocení + barevné stavy
Grafy	Výkony, PWM, teploty, LUX; výběr úseku OD–DO myší
Kontroly stavu	AI, síť, lux, PWM, teploty, provozní události (AUTO_FALLBACK…)
Aktivní AI režim	SHADOW / ASSIST / AUTO — řídí, míchá, nebo jen navrhuje
Kontrola nastavení	Z `cfg`: limity FVE, baterie, Distr, Spot…
Teploměry	t1–t3, tempMax, chyby (-999…)
Doporučení	Co změnit a kde v aplikaci (`/batt`, Spot, MQTT…)
TSSR OD–DO	Úseky, kdy priorita SSR blokovala topení
Řádky logu	Tabulka čas / PWM / solar / load / grid / lux / TSSR / akce

Barevné čtení: zelená = OK · oranžová = zkontrolovat · červená = chyba / silně podezřelý provoz.

3) Účet a přiřazení zařízení

Registrace → přihlášení.
Přidat zařízení: povinný ID API klíč (stejný jako v EaSun při prvním nastavení) + volitelný název (např. „Sklep“).
Server ověří klíč a vazbu na MAC. Zařízení už musí alespoň jednou poslat data.
IP ani MAC do formuláře nezadávejte. Jedno zařízení = jeden účet.

Bez přiřazení vidíte jen veřejné archivy. Po přiřazení je analýza výchozí soukromá — majitel ji vidí vždy; veřejnost zapnete v Parametrech.

flowchart LR A[Registrace / login] --> B[account_add_device.php] B --> C{ID API + data už na serveru?} C -->|ano| D[Zařízení na Účtu] C -->|ne| E[Hláška: klíč / ještě neposlalo data] D --> F[Nastavení → device_admin] D --> G[analyze.php — i soukromé dny]

4) Vzdálená správa (`device_admin.php`)

Vždy: Účet → Moje zařízení → Nastavení u konkrétní karty (ne „naslepo“ z obecného odkazu — dříve šlo omylem restartovat jiné zařízení).

Funkce	Popis
Off	Nouzové vypnutí topení (PWM/SSR) + pohotovost
Standby	Pohotovost přes restart; topení vypnuto do On
On	Obnoví provoz (zruší pohotovost)
Restart	Vzdálený soft restart ESP
Živé stavy (~4 s)	Topení + TSSR, solár/zátěž, teploty Min>akt<Max, AIERR tipy
Stav provozu	Stejný přehled jako `/diag` na ESP (WiFi, MQTT, PWM, AI, Spot, heap…)
Historie událostí	WDT, start, TSSR… v DB serveru (ne SPIFFS), po dnech

sequenceDiagram participant U as Majitel (prohlížeč) participant ADM as device_admin.php participant DSS as settings_sync.php participant ESP as EaSun ESP U->>ADM: Off / Standby / On / Restart ADM->>DSS: fronta příkazu (pending) Note over ESP: periodicky ~20–30 s
nebo při kontaktu ESP->>DSS: action=cmd_pull DSS-->>ESP: pending cmd ESP->>ESP: provede příkaz ESP->>DSS: action=cmd_ack + status JSON DSS-->>ADM: „Zařízení příkaz přijalo“ Note over ESP: Home: box POHOTOVOST
+ Obnovit provoz / Odeslat stav

Veřejný web nemůže přímo volat LAN IP ESP — vše jde přes stejný server, ze kterého si ESP stahuje příkazy a nastavení (api_device_settings_sync.php).

Parametry a soukromí (`device_admin_settings.php`)

Záložky jako v aplikaci: Teploty/SSR, Baterie, Web/TSSR, MQTT, PWM, Spot, Režimy, FVE·AI…
Po Uložit do zařízení: změna čeká na serveru → ESP si ji vyzvedne (obvykle 20–30 s).
Veřejná analýza — volitelně zpřístupní archivy nepřihlášeným.

5) Ostatní API endpointy (technicky)

Endpoint	Směr	Účel
`/api_ai_run_log.php`	ESP → server	AI provozní log + cfg; GET `?probe=1`
`/api_device_settings_sync.php`	obousměrně	Snapshot nastavení; `action=pull`; `cmd_pull` / `cmd_ack` / `status`
`/api_device_events.php`	ESP → server	Historie událostí (sev, type, msg…)
`/api_analyze_charts.php`	prohlížeč → server	JSON grafů pro analyze.php (auth / soukromí)

Cesty ve FW jsou napevno (AI_RUN_LOG_REMOTE_PATH, DEVICE_SETTINGS_SYNC_PATH, DEVICE_EVENTS_PATH) — měníte jen host.

6) Vztah k SHADOW / ASSIST / AUTO

SHADOW — ideální start: AI nerídí, logy jdou na server → srovnání návrhu vs. realita.
ASSIST / AUTO — analýza ukáže mix/boost, Spot Gate, pády do fallbacku.
Lokálně vždy /ai-live; server dává denní kontext a trendy.

7) Typické výsledky a chyby

Symptom na analýze / adminu	Co zkontrolovat
Lux data nejsou čerstvá	TX LUX, PMK, ESP-NOW — AI hůře reaguje na mraky
Vyšší odběr ze sítě	Distr, cezMin/Max, agresivita AI, PWM limity
Teplota -999	Nezapojené čidlo (v živých stavech se často skryje)
PWM často 0	Max teplota, Spot Gate, TSSR priorita, Min FVE…
TSSR / „Netopí · TSSR…“	Primár topí — viz 13c / 6a
AIERR / AUTO_FALLBACK	MQTT stale, bez LUX, limity — 11a
Admin „nebere“ příkaz	Zapnutý AI log server, WiFi, počkat 20–30 s
Nejde přidat zařízení	Špatný ID API, klíč nespárovaný, ještě neposlalo data

8) Doporučený postup nasazení

ESP: odesílání AI provozu na api.easun.eu (nebo vlastní Analýzu) + AI režim.
Ověřit ID API klíč v aplikaci.
Účet na api.easun.eu → přidat zařízení klíčem.
Účet → Nastavení: živé stavy + Stav provozu; limity v Parametrech.
Analýza: denní archivy (přihlášení = i soukromé).
Veřejnost analýzy povolte jen pokud ji chcete sdílet.

Vlastní instalace: zdroj v C:\inetpub\wwwroot\Easun-Analyza (PHP + MySQL dle config.php). Stejné endpointy jako na api.easun.eu — do ESP stačí zadat IP/host vašeho PC nebo VPS.

Poznámka k api.easun.eu: endpoint http://api.easun.eu/api/ v průvodci slouží k autorizaci ID API (licence), zatímco Analýza Logu běží jako samostatná webová aplikace na kořeni (index / analyze / api_ai_run_log.php…). Do hostu AI logu zadávejte api.easun.eu bez cesty /api/.

Související kapitoly

11a. SHADOW / ASSIST / AUTO
11. Režimy — zapnutí AI logu
07. /batt — AI surplus parametry
04. ID API — klíč pro účet Analýzy
15 — /diag (= Stav provozu v adminu)
16. Odesílání dat — URL1/URL2 a HA (jiná cesta než AI push)
guide.php na api.easun.eu