fix cutoff gen port

docs/04-modules/control.md

@@ -111,6 +111,19 @@ def apply_overrides(plan, overrides) -> Setpoints:
 
 **Princip:** držet mapování plán → Deye **jednoduché**; detail a zdůvodnění v [`operating-modes.md`](operating-modes.md) (sekce *Keep it simple*).
 
+### BA81: GEN port cut-off (mikroinvertory na GEN) přes reg 179
+
+U instalací typu **BA81** (AC coupling / mikroinvertory na GEN portu) může solver uložit do plánu flag
+`planning_interval.deye_gen_cutoff_enabled` (true/false). Pokud je na střídači zapnutý feature flag
+`asset_inverter.deye_gen_microinverter_cutoff_enabled = true`, exporter provede **masked read-modify-write**
+registru **179**:
+
+- `deye_gen_cutoff_enabled = true` → reg **179** bits **0–1** = **2** (`10b`, disable = cut-off **ON**)
+- `deye_gen_cutoff_enabled = false` → reg **179** bits **0–1** = **3** (`11b`, enable = cut-off **OFF**)
+
+Zápisy se ukládají do `ems.modbus_command` a ověřují v `verify_modbus_commands` (porovnává se pouze maska
+bits 0–1). Detail registrů: [`modbus-registers.md`](modbus-registers.md) (reg 179).
+
 ### Fyzický režim (`get_deye_mode` v `exporter_monolith.py`)
 
 | Fyzický režim | Podmínka z `ControlSetpoints` |

docs/04-modules/modbus-command-journal.md

@@ -25,6 +25,8 @@ Indexy: podle `(site_id, status, created_at)` a částečný index pro `pending`
 1. Po `mismatch` se odešle **Discord** alert (`notify_modbus_mismatch`), pokud je nastaven `DISCORD_WEBHOOK_URL`.
 2. **Retry** zápisu max. **3×** (počítáno přes `attempt_count` po zápisech).
 3. **Reg 178** (grid peak shaving switch): journal ukládá **celé 16bit** `value_to_write` (32 nebo 48). Při ověření se za **shodu** považuje shoda **bitů 4–5** maskou **`0x0030`** s očekáváním; `value_verified` = přečtená surová hodnota. Při nesouladu masky se **jednou** znovu přečte reg. 178 (druhé FC3) kvůli glitchům na RS485 — pokud druhé čtení maskou sedí, stav je **`verified`**.
+4. **Reg 179** (control board special 1, BA81 GEN cut-off): exporter zapisuje masked RMW (zachová ostatní bity).
+   Při ověření se za shodu považuje jen maska **bits 0–1** (`0x0003`) vůči očekávání (2 = cutoff ON, 3 = cutoff OFF).
 4. **TOU výkon W (154–159):** firmware často vrátí **max. výkon z reg. 108/109 × 51.2 V** místo přesně zapsaného W; verify to akceptuje jako **shodu** (skutečný výkon je stejně omezen proudy 108/109).
 5. **Pojistka 62–64**: pokud by se řádek registru **62, 63 nebo 64** omylem dostal do striktní větve po jednom registru, verify to zachytí a zpracuje **jako toleranční celek 62–64** (stejně jako primární clock větev) — bez přepnutí do SELF_SUSTAIN jen kvůli tomu.
 6. Po třech neúspěšných cyklech ověření:
@@ -46,6 +48,9 @@ Implementace: `services/control_exporter.py` — `verify_modbus_commands`, `_ver
 
 `write_inverter_setpoints` přidá do journalu podle potřeby **62–64** (čas — po čtení z invertoru jen při driftu / 24h intervalu; viz `modbus-registers.md`) a **time pointy 148–177** (bloky 3–6 typicky jednou denně; viz `modbus-registers.md`), dále **108**, **109**, **141**, **142**, **178**, **143**. Každý řádek daného exportního běhu má **`deye_physical_mode`** (**PASSIVE** / **SELL** / **CHARGE**). **Reg 191** EMS nezapisuje (SolarmanApp). Převod výkonu: `battery_watts_to_amps` v `modbus-registers.md`.
 
+Pokud je zapnutý feature `asset_inverter.deye_gen_microinverter_cutoff_enabled = true`, exporter navíc zapisuje
+**reg 179** (masked RMW) podle `planning_interval.deye_gen_cutoff_enabled` (BA81 GEN port cut-off).
+
 **Dávky:** `execute_modbus_commands` slučuje souvislé adresy do jednoho **`write_registers`** (FC **0x10**). `verify_modbus_commands` čte zpět po souvislých blocích (`read_holding_registers`, FC 0x03). Detail režimů: `modbus-registers.md`.
 
 ## APScheduler
@@ -67,6 +72,9 @@ Vrátí počty `checked` / `verified` / `mismatch` a seznam dotčených příkaz
 
 Tabulka pro budoucí logování **cut-off** přepínačů (mikroinvertory / GEN při záporné prodejní ceně). Záznam při **změně** stavu: `asset_code`, `new_state`, `previous_state`, `reason`, `sell_price_czk`, `triggered_by`. Zatím jen schéma; logika napojení v `control_exporter` je v TODO.
 
+Poznámka: **GEN port cut-off na BA81** se aktuálně provádí přímo přes Deye **reg 179** a loguje se v `ems.modbus_command`.
+`cutoff_switch_log` je oddělená tabulka pro budoucí obecnější “cut-off” akce (nezávisle na konkrétním Modbus registru).
+
 ## Konfigurace
 
 - `.env`: `DISCORD_WEBHOOK_URL` — prázdné = notifikace vypnuté (jen log).