feat(saj): replace the untested stub with H2-Protocol battery telemetry

CHANGELOG.md

@@ -14,6 +14,8 @@ Driver versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html
 
 ### Changed
 
+- **`saj` 1.2.0** — replace the untested input-0x10xx stub with the SAJ H2-Protocol holding map used by evcc `saj-h2` and the community Home Assistant integration. Identity from `0x8F00`, live PV/battery/grid power from `0x40A5`/`0x40A6`/`0x40AD`, per-phase meter from `0x4031`, and battery SoC/voltage/current only when the `0xA000` BMS block reports a pack (`BatNum` and `BatOnline` both non-zero). A missed live-power read emits nothing rather than a fabricated zero-watt site; an AS2 string inverter or a PV-only H2 no longer appears as an empty battery the planner can dispatch into. Battery power is negated at the boundary (vendor discharge-positive). Control stays off until a named H2/HS2 proves held zero — the protocol's AppMode/passive registers are documented in the driver and not written.
+
 - **`easee_cloud` 1.3.0** — verify an active energy session before core can retain a confirmed battery level across restart. Keep that identity through pauses in the same driver process, but clear it on completion until a new active session proves its identity. An offline car may need its battery level confirmed after completion or restart; do not reuse another car's level. Match equivalent UTC timestamp formats from both session APIs. Failed or empty observations emit no telemetry. Invalid session payloads omit the identity while keeping fresh charger readings.
 
 - **easee_cloud** 1.2.0 — emit `request_active`: false only when the vehicle

SUPPORT_STATUS.md

@@ -118,8 +118,8 @@ Catalog source is not proof that a target can install or run a driver.
 | pixii | 2.1.3 | blixt-l1 | not_assessed | — | — | not_recorded | — | not_assessed | no |
 | pixii_pv | 0.3.0 | ftw-core | not_assessed | — | — | not_recorded | — | not_assessed | no |
 | pixii_pv | 0.3.0 | blixt-l1 | not_assessed | — | — | not_recorded | — | not_assessed | no |
-| saj | 1.1.1 | ftw-core | not_assessed | — | — | not_recorded | — | not_assessed | no |
-| saj | 1.1.1 | blixt-l1 | not_assessed | — | — | not_recorded | — | not_assessed | no |
+| saj | 1.2.0 | ftw-core | not_assessed | — | — | not_recorded | — | not_assessed | no |
+| saj | 1.2.0 | blixt-l1 | not_assessed | — | — | not_recorded | — | not_assessed | no |
 | schneider_meter | 1.0.5 | ftw-core | not_assessed | — | — | not_recorded | — | not_assessed | no |
 | schneider_meter | 1.0.5 | blixt-l1 | not_assessed | — | — | not_recorded | — | not_assessed | no |
 | schrack_ev | 1.0.3 | ftw-core | not_assessed | — | — | not_recorded | — | not_assessed | no |

devices.yaml

@@ -1056,33 +1056,33 @@ manufacturers:
         protocols:
           - protocol: modbus
             driver: "saj"
-            version: "1.1.1"
+            version: "1.2.0"
             ders: [pv, battery, meter]
             control: false
         firmware_versions: ""
-        notes: "Community driver, untested"
+        notes: "String sibling: the driver must not emit a battery. The BMS block is probed and then left alone if it reports no pack or never answers."
       - name: "H2 (Three-Phase Hybrid)"
         variants: [H2-10K, H2-12K, H2-15K, H2-20K, H2-25K, H2-5K, H2-6K, H2-8K]
         regions: []
         protocols:
           - protocol: modbus
             driver: "saj"
-            version: "1.1.1"
+            version: "1.2.0"
             ders: [pv, battery, meter]
             control: false
         firmware_versions: ""
-        notes: "Community driver, untested"
+        notes: "H2-Protocol holding map (evcc saj-h2 / community HA integration). Telemetry only; not yet verified on a named FTW site. Control stays off until a held-zero command is proven."
       - name: "HS2 (Single-Phase Hybrid)"
         variants: [HS2-3K, HS2-4K, HS2-5K, HS2-6K]
         regions: []
         protocols:
           - protocol: modbus
             driver: "saj"
-            version: "1.1.1"
+            version: "1.2.0"
             ders: [pv, battery, meter]
             control: false
         firmware_versions: ""
-        notes: "Community driver, untested"
+        notes: "Same H2-Protocol map as the three-phase hybrid. Ampere.StoragePro / EKD-Solar is a rebadged HS2. Telemetry only."
   - name: "SMA"
     model_families:
       - name: "SMA Home Manager 2.0"

drivers/INTEGRATION_OVERVIEW.md

@@ -44,7 +44,7 @@ NATS → Cloud      ← standardized data model
 | **Kostal** | Plenticore Plus/BI, PIKO MP Plus/IQ | Modbus | Stub |
 | **Fox ESS** | H1, H3, H3 PRO, AIO-H3, KH | Modbus | Stub |
 | **Sofar Solar** | HYD, ME, HYD-ES | Modbus | Stub |
-| **SAJ** | H2, HS2, AS2 | Modbus | Stub |
+| **SAJ** | H2, HS2, AS2 | Modbus | Telemetry |
 | **KSTAR** | KSE, BluE-S | Modbus | Stub |
 | **AlphaESS** | Smile, G2 | Modbus | Stub |
 | **Victron Energy** | MultiPlus-II, Quattro-II, SmartSolar, SmartShunt | Modbus + MQTT |  Stub |