TeltoCharge write-on-change: zápis jen při změně hodnoty (EEPROM wear)

Wallbox dostával zápisy 15/19/20 každý export tick (~8x/hod: control_export
:14,:29,:44,:59 + rolling replan */15 s exportem), protože drop-unchanged
stál na fn_modbus_last_verified_map — dokud verify čtení nedoběhlo/selhalo,
mapa byla prázdná a celá trojice se psala pořád dokola. write_ev_arrival_hold
navíc psal trojici nepodmíněně při každém píchnutí kabelu (docstring lhal).

- nová ems.fn_modbus_device_state_map (R__100): nejnovější řádek journalu
  per registr, hodnota jen pro written/verified; failed/mismatch => registr
  chybí => po výpadku se konfigurace obnoví jedním zápisem
- write_ev_setpoints + write_ev_arrival_hold filtrují přes tuto mapu:
  reg 15 jen při změně plánu, watchdog 19/20 jednou po startu/po výpadku
- verify job EV chargery ověřuje už dnes (fn_modbus_written_command_ids bez
  filtru asset_type); registry 15/19/20 jsou dle oficiálního protokolu R/W
- watchdog Telto sytí jakákoli validní komunikace vč. FC3 čtení telemetrie
  (60 s << 300 s) — periodické zápisy k udržení spojení nejsou potřeba,
  failsafe 8 A nastane jen při skutečném výpadku EMS
- testy: tests/test_ev_write_on_change.py (drop, setpoints, arrival hold)
- docs: modbus-registers-teltocharge.md (sekce Zápis už není "NEimplementováno",
  R/W tabulka, watchdog sémantika), modbus-command-journal.md (sekce EV
  wallbox), CLAUDE.md (fn_modbus_device_state_map)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/04-modules/modbus-registers-teltocharge.md

@@ -28,15 +28,43 @@ Mapování stavů v EMS (`TELTO_STATUS_MAP` v `telemetry_collector.py`):
 **Při selhání čtení se vzorek NEzapisuje** — fabrikovaný `available` by falešně
 ukončil session a EV výkon 0 by špinil bazál (pravidlo 15).
 
-## Zápis (budoucí řízení — zatím NEimplementováno)
+## Zápis (control exporter — `write_ev_setpoints`, `write_ev_arrival_hold`)
 
-| Reg | Význam | Hodnoty |
-|-----|--------|---------|
-| 15 | **Amps to use** (limit proudu) | 0 = stop, 6–32 A |
-| 16 | Start/Stop session | 0 nic · 1 stop · 2 start |
-| 19 | Communication timeout (watchdog) | 0–600 s (0 = vypnuto) |
-| 20 | Failsafe current | 0, 6–32 A |
+| Reg | R/W | Význam | Hodnoty | EMS zapisuje |
+|-----|-----|--------|---------|--------------|
+| 15 | R/W | **Amps to use** (limit proudu) | 0 = stop, 6–32 A | hodnota z plánu (`ev{1,2}_current_a`); příjezd EV → hold 0 A |
+| 16 | R/W | Start/Stop session | 0 nic · 1 stop · 2 start | ne |
+| 19 | R/W | Communication timeout (watchdog) | 0–600 s (0 = vypnuto), default 30 | `TELTO_WATCHDOG_TIMEOUT_S` = **300** |
+| 20 | R/W | Failsafe current | 0, 6–32 A, default 6 | `TELTO_WATCHDOG_FAILSAFE_A` = **8** |
 
-Až se zapne řízení: zapisovat reg 15 přes journal `modbus_command`
-(pravidlo 17) a nastavit watchdog (reg 19/20) — při výpadku EMS wallbox
-spadne na failsafe proud.
+Všechny čtyři registry jsou dle oficiálního protokolu (wiki *External control
+RS485* / protokol rev 0.5) **R/W** — verify job je čte zpět standardní FC 3
+větví (žádný write-only registr v této sadě).
+
+### Write-on-change — POVINNÉ (EEPROM wear)
+
+Export tick běží ~8×/hod (control_export `:14,:29,:44,:59` + rolling replan
+`*/15` s exportem). Zápis do wallboxu se proto provádí **jen při skutečné
+změně hodnoty**: `write_ev_setpoints` i `write_ev_arrival_hold` filtrují
+registry přes `_drop_registers_matching_last_verified` proti
+**`ems.fn_modbus_device_state_map`** (nejnovější řádek journalu per registr
+se stavem `written` **nebo** `verified`). Důsledky:
+
+- **reg 15** se zapíše jen při změně plánovaného proudu (0 ↔ 6–32 A) — to je
+  legitimní zápis;
+- **reg 19/20** se zapíší jednou po nasazení / po výpadku zařízení (nejnovější
+  řádek `failed`/`mismatch` ⇒ registr v mapě chybí ⇒ znovu se zapíše) a pak
+  už nikdy, dokud se hodnota nezmění;
+- čekání na verify **neblokuje** skip — `written` (TCP ack) stačí, mismatch
+  z verify stav mapy zneplatní a vynutí nový zápis.
+
+### Watchdog — sytí ho i čtení
+
+Protokol definuje timeout jako *„if no **valid communication** is present
+after a configurable time interval…"* — timer resetuje **jakákoli** validní
+Modbus komunikace s unit ID wallboxu, **včetně FC 3 čtení**. Telemetrie čte
+blok 0–40 každých **60 s**, takže watchdog 300 s je trvale sycen čtením a
+**periodické zápisy k udržení spojení nejsou potřeba**. Failsafe (omezení na
+8 A, reg 20 „max allowed current on comm timeout") nastane až po 5 min bez
+jakéhokoli pollingu = skutečný výpadek EMS; auto se pak přes noc dobije
+pomalu místo stání na 0 A.