PWM opravy a optimalizace provozu

1. Přehled změn v aplikaci

Stav dokumentace: 2026-08-08 · cíl: stabilní PWM, čitelné důvody, rychlá simulace.

2. Pipeline PWM — pořadí výpočtu

Klíčové zjištění auditu: hard limity applySolarAmaxPwmLimit a applyCezWMaxPwmLimit běží až po AI mixu. Soft cez uvnitř AI (÷80) není ekvivalent hard cutu.

3. Vyhlazování z /pwm — pwm_smoothing

UI /pwm · SPIFFS /pwm_smoothing.ea · alias userPwmSmoothingFactor

Řešení

• Audit potvrdil: hodnota se ukládá a zobrazuje, ale nevstupuje do výpočtu rampy.
• Rampu řídí pwm_speed (%/s), pwm_delay (ms) a slow_mode.
• UI: pole muted + text „zatím se v rampě nepoužívá“; zůstává v DOM kvůli forms / SPIFFS.

Volitelné napojení na cap kroku nebylo potřeba — méně rizikový diff.

4. Distr. Ano-Min-Max (distributor = 2)

RegulacePwmPodleDistributoraFunkce() · warning distr2Active

Problém před opravou

Při distributor1==2 neběžel Prebytek/deficit; Dist.2 sám zvedal PWM i při vysokém FVE — na /solar-sim to vypadalo jako „matoucí“ chování oproti Distr=0.

Řešení

• LogikaSolarPrebytek běží i při Dist.2 (bez blokace distributor1 != 2).
• Při FVE přebytku Dist.2 nesmí zvyšovat PWM — jen cut (−), hold (==) nebo hold+FVE.
• Bez přebytku Dist.2 smí síťové + (záměr Ano-Min-Max).
• UI + JSON varování při aktivním Dist.2 (temp5>0 + dN==2 + SSR).
• Dist.1 (temp55), Spot Gate a rampa beze změny.

5. Baterie — BATT_CHARGE_CUT

RegulacePwmPodleBaterieFunkce() · sim battOn / W / V / MaxW

Chování (5 bodů)

1. Vstup: batteryV > 10, batteryMaxWatt ≠ 0, batteryW < batteryMaxWatt.
2. Skip (neubírá): spareOk = solarSurplusOkNow() || FVE > loadNet+30.
3. Cut: ~0.35× speed (slow) / ~0.5 %/s (fast), strop 1.5 %/s.
4. Vypnuto: MaxW=0 nebo V≤10 → cut=0.
5. Viditelnost: reason BATT_CHARGE_CUT má prioritu před SURPLUS_RAMP.

Sim: checkbox „Přepsat baterii“ (default OFF) pro test bez reálné baterie.

6. AI ASSIST / AUTO vs fallback

aiResolveFinalPwm() · JSON: fallbackPwm, aiSuggestedPwm, finalPwm, aiMode, assistMixPercent, usedFallback, mqttFresh, luxFresh

Řešení

• Live telemetrie na /api/solar-sim a řádek UI (fb → návrh → final, mix, fresh).
• Hard Amax/ČEZ vždy po AI — žádná díra v pořadí.
• Sync aiLiveFinalPwm po hard limitech ≈ VypocetProcenta.
• Heuristika AI beze změny — jen bezpečnostní obal a pozorovatelnost.

Očekávané chování režimů

• OFF / Original: final = klasika; usedFallback=true.
• SHADOW: final = fallback (AI jen loguje).
• ASSIST: mix 10–50 % fallback↔AI → safety → step → Spot Gate.
• AUTO: AI návrh při mqttFresh∨luxFresh, jinak fallback.
• Spot Gate: bez silného surplus AI nesmí zvednout nad fallback.

7. Simulace /solar-sim — funkční změny

Stránka slouží k bezpečnému ladění bez ovlivnění reálného distributora po rebootu (sim ON / heat out / ruční PWM po startu vždy OFF).

• Layout: sekce ŘÍZENÍ / TOPENÍ / SOLAR / DISTRIBUTOR / BATERIE / LIVE / LOG; dvě kolony, log dole.
• FVE W / V: override vypnutý → hodnoty z MQTT (mqttSolarW, mqttSolarV).
• Distributor Min/Max W: editace na sim + /teplota; Max = CEZ_MAX_CUT; doporučení Max 800–1500, Min 100–200.
• PWM rychlost: stejné globály jako /pwm (preset, %/s, ms, slow) — FVE→0 se slow ON = pomalý drop.
• ECO: nastavení z /eco platí i v sim.
• Ruční PWM: SIM_PWM_MANUAL; hard Amax/ČEZ stále platí; reboot vypne manual.
• Vypnutí sim: hard reset PWM na 0 + hold ~8 s, ať realita hned nevytáhne sim 100 %.

8. Paměť a rychlost při simulaci

Zpomalení při zapnutí/vypnutí sim a během posouvání sliderů nebylo v samotném PWM výpočtu, ale v častých zápisech SPIFFS, velkých String dumpů logu a hustém pollu UI.

Úzká místa (před)

• Každý /api/solar-sim-set → force zápis /solar-sim.cfg.
• Náhled logu každou 1 s → plný CSV dump + flush SPIFFS.
• Ring log 100×148 B BSS + časté řádky + UI poll 1 s.

Úpravy (po)

9. Ověření — checklist

Distr.2

• Stejné FVE/load/cez, Distr=2 vs 0 — podobná SURPLUS_RAMP
• Při surplus + Dist.2: hold+FVE, ne síťové +
• Skok cez na Max → Dist − i CEZ_MAX_CUT

Baterie

• battOn, V=52, MaxW=2000, battW=500, FVE těsně nad load → BATT_CHARGE_CUT
• FVE ≫ load (+30 W) → spare OK, reason není BATT
• MaxW=0 / battOff → bez cut

AI (Distr=0, batt OFF) — Original → ASSIST → AUTO

1. Velký surplus — ASSIST final mezi fb a AI; AUTO ≈ AI při fresh
2. FVE 0 + slow OFF → cut k 0; ASSIST/AUTO nesmí držet vysoké PWM
3. cez ≥ Max → CEZ_MAX_CUT ve všech režimech
4. Proud u Amax → AMAX_* cut
5. Spot Gate NE → AI final ≤ fallback bez silného surplus
6. AUTO bez mqttFresh → usedFallback=true

Výkon sim

• Zap/vyp sim bez dlouhého „zmrznutí“ UI
• Rychlé posouvání FVE slideru s logem OFF — plynulé
• Log ON jen při ladění; náhled se obnovuje řidčeji

10. Soubory projektu

• ESP32-Grid-Load-Vypocet900.ino — UI /pwm, /solar-sim, API, cfg, log, poll
• vypocet01.h — OvladaniPwmSSR, Dist, batt, surplus, sim manual
• vypocet02.h — aiResolveFinalPwm, safety, Spot Gate
• spotove_ceny.h — applyCezWMaxPwmLimit, applySolarAmaxPwmLimit
• ai-rozvoj.html — popis AI režimů a roadmap
• znama-rizika-pwm-prompty.html — původní pracovní poznámky k rizikům