Tisk · doporučeno A4 na výšku

16. Odesílání dat a Home Assistant

Kapitola 16 · /web · /api/status · easun.eu/navod/

EaSun Aplikace umí data posílat ven (HTTP POST na váš server) a zároveň je nabízet ke stažení přes JSON API pro Home Assistant, skripty nebo monitoring. ESP samo do HA MQTT typicky nepublikuje — MQTT je vstup ze Solar Assistant.

Oficiální dokumentace měření a HA: popis-mereni.html · katalog návodů: easun.eu/navod/ · přehled funkcí: prehled-funkci.html

1. Stránka Web — odesílání na externí servery

Menu Web → /web → uložení /getweb (SPIFFS /zeasun1.ea … 5.ea).

Pole ve formulářiParametrÚčel
API KEYzeasun1Klíč pro cílový server; bez něj se export obvykle neposílá
URL adresa 1zeasun2Hlavní endpoint — širší sada údajů (energie + teploty + PWM…)
Čas (s)zeasun3Interval opakování (doporučení 5–20 s; výchozí často 10)
URL adresa 2zeasun4Lehčí endpoint — hlavně výroba / spotřeba / PWM / baterie / lux
URL TSSRzeasun5Jen IP primárního EaSun; firmware doplní http://…/tssr
Nevyplňujte URL, pokud cílový web neexistuje — zbytečné HTTP volání zpomalují aplikaci.

Co typicky odchází na URL1

POST pole mimo jiné: api_key, WiFiMac, solarW/A/V, loadW, cezW/V, batteryV/W/SOC, teploty t1–t3 (min/akt/max/stav), pwm, topne, kwh, okolní temp1/humi1.

Co typicky odchází na URL2

Kompaktnější sada: energie, PWM, baterie, lux. Některé instalace umí i zpětný GET (limity / data z DB) — záleží na cílovém serveru EaSun.

TSSR — priorita mezi zařízeními

Sekundární EaSun se ptá primárního na /tssr (plain text stav SSR). Pokud má primár zapnuté SSR, sekundár netopí — podrobně 13c. TSSR · nastavení IP na 13b. Web.

2. JSON API pro čtení (doporučeno pro HA)

GET /api/status

  • URL: http://<IP_ESP32>/api/status
  • Content-Type: application/json, cache no-store
  • Bez přihlášení — používejte jen v důvěryhodné LAN / VLAN

Vybraná pole (kompletní tabulka na popis-mereni.html):

KlíčJednotkaVýznam
solarW, loadW, cezWWFVE, spotřeba, síť
odberWatt, VypocetProcentaW / %Příkon topení, aktuální PWM
batterySOC, batteryW% / WBaterie
teplota1..3, ssrON1..3°C / 0|1Teploty a stav SSR
spotPrice, spotLevelKč/MWhSpot (pokud používáte)
aiFinalPwm, pwmWebManual—AI / ruční PWM
autoOptimizationEnabledboolRežim optimalizace baterie

Další užitečné endpointy

URLPoužití
/api/dataZjednodušená sada pro grafy (solar, load, odběr, heap…)
/api/pwm-manual, /api/pwm-manual-setStav / nastavení ručního PWM
/tssrTextový stav SSR pro koordinaci zařízení
/healthRychlá diagnostika běhu
/ai-live-dataJSON živého AI stavu

3. Home Assistant — jak data zpracovat

  1. Ověřte v prohlížeči: http://<IP_ESP>/api/status — musí přijít JSON.
  2. Do configuration.yaml přidejte integraci RESTful (více senzorů z jednoho GET), scan_interval např. 30 s (ne každou sekundu — ESP má i regulaci a MQTT).
  3. Mapujte value_json.solarW, loadW, cezW, VypocetProcenta, batterySOC, teplota1, ssrON1…
  4. SSR jako binary: Template binary sensor (ssrON1 == 1).
  5. Restart HA po kontrole YAML. Pro Energy dashboard entity s device_class: power (+ případně Riemann sum na Wh).
Hotová ukázka YAML je v oficiálním návodu ESP32 /api/status JSON API | Home Assistant měření. Stačí nahradit IP adresu ESP32.

Co HA typicky sleduje

  • Výroba FVE vs. spotřeba domu vs. síť (přebytek / deficit)
  • PWM a příkon topení — zda EaSun skutečně topí
  • SOC baterie a stavy SSR1–3
  • Teploty TUV / akumulace
  • Spot cena / Spot Gate (pokud používáte Spot)

4. Dva způsoby využití — srovnání

ZpůsobSměrKdy použít
/web URL1 / URL2 ESP → váš server (push) Vlastní PHP/MySQL archiv EaSun, vzdálený dashboard, logování mimo HA
/api/status HA / skript → ESP (pull) Home Assistant, Node-RED HTTP, monitoring v LAN
MQTT Solar Assistant SA → ESP (a SA často i → HA) Invertorová data; HA může brát stejná témata přímo z SA, EaSun navíc dává PWM/SSR/teploty

5. Tipy a chyby

← 15. Záloha, reset, diagnostika