1) Co tento web umí

Server analýzy (api.easun.eu nebo váš vlastní) přijímá provozní data ze zařízení EaSun a nabízí tři hlavní věci:

• Analýza — denní archivy, grafy, kontroly a doporučení k přetokům FVE a topení.
• Účet — registrace, seznam zařízení a přiřazení přes ID API klíč.
• Administrace — u konkrétního zařízení: ovládání (Off / Standby / On / Restart), živé stavy a Stav provozu (jako /diag na ESP); limity a soukromí na Parametrech.

Bez přiřazeného zařízení vidíte jen veřejné archivy. Po přiřazení je vaše analýza výchozí soukromá.

2) K čemu slouží analýza

Analýza ukazuje, jak se v praxi chová využití přebytků FVE (přetoků) pro ohřev / topení. Nemusíte číst surová data ze zařízení — přehled, varování a doporučení jsou na jednom místě.

• Jestli se solární přebytek mění v teplo, nebo se zbytečně bere energie ze sítě.
• Jestli AI řízení (SHADOW / ASSIST / AUTO) běží stabilně, nebo často padá do fallbacku.
• Jestli nejsou vadná čidla (teploty, LUX) nebo špatně nastavené limity.
• Co v aplikaci EaSun upravit, aby provoz dával větší smysl.

3) Jak data ze zařízení na server dorazí

1. Na zařízení otevřete Režimy systému (/system-modes).
2. Zapněte Odesílat AI provoz na server a zadejte adresu tohoto serveru (např. api.easun.eu nebo IP PC s lokální Analýzou).
3. Aktivujte AI režim SHADOW, ASSIST nebo AUTO (nebo optimalizaci podle potřeby).
4. Zařízení samo posílá provozní záznamy, chyby, snapshot nastavení a stav provozu — nic ručně nenahráváte.

Stejný server slouží i pro stažení nastavení z administrace a vzdálené příkazy (pohotovost, restart). Bez zapnutého odesílání na AI log server administrace zařízení „neosloví“.

4) Účet a přiřazení zařízení (ID API klíč)

Aby nikdo cizí nepřidal vaše zařízení jen podle IP, přiřazení vyžaduje unikátní ID API klíč — stejný kód, který jste vložili v aplikaci při prvním nastavení (menu Del → ID API / průvodce).

1. Zaregistrujte se a přihlaste se.
2. Otevřete Přidat zařízení a zadejte:
   • ID API klíč (povinné)
   • Název / popisek (volitelné, např. „Skleník“)
3. Server ověří klíč a vazbu na MAC. Zařízení už musí aspoň jednou poslat data na analýzu.
4. Jedno zařízení může mít jen jeden účet. IP ani MAC se do formuláře nezadávají.

Stránka Účet

• Moje zařízení — seznam karet (název, IP, MAC, FW…). Na mobilu je přehledný bez vodorovného scrollování.
• Nastavení u každé karty — otevře administraci tohoto zařízení (ovládání, stavy, parametry).
• Vzdálená správa v odkazech — jen informační box. Nic neovládá a neotevírá správu „naslepo“ (dříve šlo omylem otevřít první zařízení a spustit Restart).

Pokud klíč není platný, není spárovaný se zařízením, nebo zařízení ještě neodeslalo data, přidání se nepovede — uvidíte srozumitelnou hlášku.

5) Administrace zařízení (ovládání a živé stavy)

Vždy otevřete administraci přes Účet → Moje zařízení → Nastavení u vybraného zařízení. Stránka je chráněná přihlášením a zobrazí jen vaše zařízení.

Ovládání (device_admin.php)

• Výběr zařízení — pokud jich máte víc (nebo přepínač nahoře).
• Off / Standby / On / Restart — vzdálené ovládání (kapitola 6). Každý příkaz vyžaduje potvrzení.
• Poslední stavy z logu — obnovují se samy (cca každé 4 s) bez reloadu stránky:
  • Topení (včetně TSSR priority) a Solár / zátěž
  • Teploty s limity ve tvaru Min > aktuální < Max °C
  • Čidlo s dlouhodobým -999 = nezapojené — v přehledu se nezobrazuje jako chyba
  • Nové kritické události z logu (AIERR…) se ukážou krátce (~1 min)
• Stav provozu (jako /diag na zařízení) — stejný přehled jako stránka /diag na ESP: WiFi, MQTT, PWM/SSR, AI, Spot, teploty, paměť, stabilita (auto-restart), důvod posledního startu, alerty (včetně TSSR).
  • Zařízení posílá kompletní stav cca každou minutu (heartbeat) a ihned při změně TSSR.
  • TSSR priorita se v tomto bloku aktualizuje i ze živého logu — nemusíte čekat na další heartbeat.
  • Stránka si data bere ze serveru každých ~4 s (bez ručního obnovení).
• Historie událostí — watchdog, start, TSSR… ukládá se do databáze serveru (ne do SPIFFS). Prohlížení po dnech v administraci; zařízení posílá všechny úrovně (info/warn/error), když je zapnutý AI log server.
• Stav zařízení — Provoz / Pohotovost, poslední kontakt („právě teď“ / „před X s“) a čekající příkaz.
• Potvrzení příkazu — po Restartu / Off / On výrazné „Zařízení příkaz přijalo“.
• Písmo — A / A+ / A++ vpravo nahoře (uloží se v prohlížeči).
• Parametry a soukromí → — limity a veřejná analýza.

Parametry a soukromí (device_admin_settings.php)

• Veřejná analýza — po přiřazení je výchozí soukromá; zapnutím ji uvidí i nepřihlášení.
• Záložky nastavení — Teploty/SSR, Baterie, Web/TSSR, MQTT, PWM, Spot, Režimy, FVE·AI… (stejné formuláře jako v aplikaci na ESP).

Po Uložit do zařízení:

1. Změna se uloží na server jako „čeká na stažení“.
2. Zařízení si ji samo vyzvedne (obvykle do cca 20–30 s), pokud běží AI log server.
3. Po aplikaci uvidíte hlášku, že zařízení nastavení stáhlo a aplikovalo.

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

6) Vzdálené ovládání zařízení

Příkazy z administrace se zařadí do fronty. ESP si je stáhne samo a potvrdí stav zpět na server. Na stránce ovládání uvidíte nejdřív „čeká se na zařízení“, po potvrzení výrazné Zařízení příkaz přijalo (např. po Restartu).

• Off (nouzové vypnutí) — vypne topení (PWM/SSR) a přepne do pohotovosti.
• Standby — pohotovost: topení zůstane vypnuté, zařízení čeká na pokyn. Stav se ukládá i přes fyzický restart, dokud nepošlete On.
• On — obnoví normální provoz (zruší pohotovost).
• Restart — vzdálený restart ESP.

Ovládání spouštějte jen u zařízení, které máte vybrané v administraci (vidíte název / IP). Z stránky Účet se příkazy nespouští.

Ovládání přímo v aplikaci na ESP

Když je zařízení v pohotovosti, na Home stránce ESP uvidíte oranžový box POHOTOVOST. Pokud máte autorizovaný přístup k aplikaci, můžete tam:

• Obnovit provoz — stejný efekt jako On z administrace; stav se pošle na server.
• Odeslat stav — jen synchronizace stavu do administrace (včetně přehledu jako /diag).

Zelená hláška typu „PROVOZ obnoven“ na ESP je jen dočasný tip — samotný provoz zůstává uložený.

7) Soukromí analýzy

• Nepřiřazené zařízení — archivy mohou být ve veřejné Analýze.
• Po přiřazení k účtu — analýza je výchozí soukromá (kalendář i detail skryté pro ostatní).
• Majitel (přihlášený) vidí své archivy vždy.
• Veřejná analýza — zapnete v Parametry a soukromí; pak ji uvidí i nepřihlášení.

8) Jak se skládají denní archivy

• Jeden archiv = jedno zařízení + jeden den.
• Během dne se nové řádky přidávají; duplicity se přeskočí.
• Starší dny zůstávají — můžete srovnávat např. slunečný a zatažený den.
• Přehled: Analýza — kalendář a grafy.

9) Co se v analýze sleduje

• Průměr PWM — intenzita topení.
• Průměr solar / load — FVE a spotřeba domu.
• Max grid — nejvyšší odběr ze sítě.
• Kontroly stavu — AI, síť, lux, PWM, teploty.
• Kontrola nastavení — limity FVE, baterie, distributor, Spot…
• Teploměry — t1, t2, t3, tempMax.
• Doporučení — co změnit a kde to v aplikaci hledat.

10) Jak číst výsledky

• Zelená — v pořádku.
• Oranžová — stojí za kontrolu.
• Červená — pravděpodobná chyba nebo silně podezřelý provoz.

11) Typické výsledky

• Bez zjevných problémů — PWM se mění se solárem, odběr ze sítě není podezřelý.
• Lux data nejsou čerstvá — AI hůře reaguje na mraky.
• Vyšší odběr ze sítě — topení nebo dům bere víc ze sítě při přebytku FVE.
• Neplatná teplota -999 °C — typicky nezapojené čidlo. V administraci (živé stavy) se takové měření skryje; v denní Analýze může stále být zmínka v kontrolách, pokud to ovlivňuje provoz.
• PWM často na nule — topení se nerozbíhá, nebo je blokované (teplota, Spot Gate, TSSR priorita…).
• TSSR priorita — druhé EaSun má prioritu SSR; v logu uvidíte „Netopí · TSSR…“ a ve Stav provozu alert.
• AIERR — důležitá provozní událost (fallback, teplota, MQTT, Spot Gate…).

12) Nejčastější chyby a doporučení

• Chyba teplotního čidla — zapojení a hodnoty t1/t2/t3 na stránce teplot. Trvalé -999 u jednoho kanálu obvykle znamená, že teploměr není připojený.
• Vysoký odběr ze sítě — Distributor, cezMin/cezMax, agresivita AI, limity PWM.
• Topení se nerozbíhá při slunci — solarWMin, pvEst, LUX, baterie/teploty.
• Baterie omezuje topení — Min SOC, aktuální SOC, batV.
• Max proud FVE (solarAmax) — na /ai-fve-pv plynule brzdí PWM a drží hranici (nesráží odběr na nulu). Vyžaduje správné MQTT téma solarA.
• Administrace „nebere“ příkaz — zapněte odesílání AI logu na server, WiFi, počkejte 20–30 s.
• Nejde přidat zařízení — špatný ID API klíč, klíč ještě není spárovaný, nebo zařízení ještě neposlalo data.
• Omylem restart / Off — spouštějte jen z administrace vybraného zařízení (Účet → Nastavení u karty), ne z obecného odkazu.

13) Kde co nastavit

Na webu analýzy

• Účet / seznam zařízení — account.php (karty, mobilní layout)
• Přidat zařízení (ID API) — account_add_device.php
• Vzdálené ovládání, živé stavy, Stav provozu — z karty zařízení → Nastavení → device_admin.php
• Parametry zařízení a veřejná analýza — device_admin_settings.php
• Denní archivy — analyze.php

V aplikaci na ESP (lokální síť)

• AI režim / odesílání provozu — /system-modes
• ID API klíč — Del / ID API (první nastavení)
• Teploty a LUX — /teplota
• Síť a distributor — /provoz
• FVE odhad / max proud — /ai-fve-pv (solarAmax drží limit proudu)
• Diagnostika provozu — /diag (stejný přehled jako Stav provozu v administraci)
• Spot — /spot
• Živý AI stav — /ai-live

Odkazy na ESP fungují, když jste ve stejné lokální síti jako zařízení.

13b) Beta — cloudový denní plán (Gemini)

Endpoint api_ai_cloud_plan.php skládá denní plán přes Gemini Flash-Lite. Nemenění PWM — jen JSON plán/text. Gemini API klíč posílá zařízení (SPIFFS), server ho neukládá v env ani config.

• Auth: EaSun api_key (jako ostatní API). Localhost test: LOCALTEST.
• Dry-run bez Google: geminiApiKey=TEST.
• spot.available=false je OK (neutrální Spot pole).
• Náklady: costPrecomputed z aplikace (Wh × OTE) → echo v costEstimate; bez čísla = qualitative_only.
• Log: cache/ai_cloud/plan.log (klíč maskovaný; Spot jen min/max/avg).

ESP: Premium text + soft bias + odhad Kč na /ai-live (PWM nemění cloud přímo). G4 A/B CSV: api_ai_g4_csv.php (device_ip, from/to).

14) Doporučený postup

1. Na ESP zapněte odesílání AI provozu na tento server a zvolte AI režim.
2. Ověřte ID API klíč (autorizace v aplikaci).
3. Založte účet a přidejte zařízení klíčem + popiskem.
4. Na Účtu otevřete u zařízení Nastavení — sledujte živé stavy a Stav provozu; limity a soukromí v Parametrech a soukromí.
5. V Analýze sledujte denní archivy (přihlášení = vidíte i soukromé).
6. Veřejnost analýzy povolte jen pokud ji chcete sdílet.

Analýza Účet Moje zařízení Parametry Domů