T2. AI pipeline (technicky)

Technický návod · vypocet01.h / vypocet02.h

Pořadí výpočtu

  1. Klasický (refaktorovaný) výpočet spotřeby → fallback PWM.
  2. Pokud aiFreeEnabled a mód 1/2/3: sestavení AI input (MQTT, LUX, teploty, SOC, Spot…).
  3. Validace: NaN, záporné výkony, stale data.
  4. Lokální AI návrh target_pwm.
  5. aiResolveFinalPwm(mode, …):
    • SHADOW → vrať čistý fallback (AI jen log)
    • ASSIST → lineární mix podle aiAssistMixPercent
    • AUTO → AI target; při !mqttFresh && !luxFresh fallback
  6. Safety: clamp, max delta/cyklus, SOC, teplota, Spot Gate, Distr Max %.
  7. Volitelný AI RUN remote log (cca 1×/30 s, urgent ihned).

Čerstvost dat

  • AI_MQTT_DATA_MAX_AGE_MS — výchozí 30000; kontroluje solarW, loadW, cezW.
  • Chybějící first-update (0) = nečerstvé (konzervativní).
  • LUX: stáří dle ESPNOW_LUX_MAX_AGE_MS, agregát z vysílačů.

Soubory logů

  • Legacy /ai_shadow.log, /ai_run.log — mazat, nezapisovat nové (komentář ve firmwaru).
  • Endpointy /ai-run-log, /ai-shadow-log — stahování / prohlížení.
  • Remote: host v aiRunLogRemoteUrl (IP/doména, ne celá URL).
AI nikdy nesmí obejít hard bezpečnostní podmínky — viz komentáře v vypocet02.h sekce 9.