Add read-only SAJ eManager C1 Pro driver

CHANGELOG.md

@@ -2,6 +2,43 @@
 
 ## [Unreleased]
 
+### saj-emanager 0.1.1
+
+Emitted power uses the same signs as the other drivers. Generation is
+negative. Battery power is positive when charging and negative when
+discharging. Grid power is positive on import and negative on export.
+
+The H2 wire is discharge-positive on the battery, so `0x8491` is negated
+once at the boundary. The H2 grid word is already import-positive, so
+`0x8496` and the phase watts are not. Inverter, load and generator words
+have no stated sign and stay on `*_vendor` metrics, off the DER streams.
+Still unverified on an eManager.
+
+### saj-emanager 0.1.0
+
+Read-only telemetry for a SAJ eManager C1 Pro in front of one or more CHS2/CH2
+hybrids. Modbus TCP only, port 502. The register sheet marks RTU as not supported.
+
+- PV, grid and battery come from the aggregate block at `0x848A`. Battery
+  telemetry is emitted only when capacity, SoC or battery power says a pack
+  is there. A failed or short read is left out; it is not reported as 0 W.
+- Phase voltage and frequency are divided by `DeviceNum` only when the scaled
+  value cannot be one phase and the quotient can. The register sheet does not
+  say those registers are summed. Eniris does, and only for voltage and
+  frequency. Power is never divided.
+- Emitted signs match the rest of the catalog. Generation is negative.
+  Battery power is positive when charging and negative when discharging
+  (the H2 wire is discharge-positive, so `0x8491` is negated). Grid power is
+  positive on import and negative on export (the H2 wire already is, so
+  `0x8496` is not negated). Word order is high word first. The eManager
+  sheet states none of this. All three are unverified.
+- `0x8400`–`0x8405` are documented, including the ±11000 setpoint scaling and
+  the SEC-C map that reuses the same addresses, and are not written.
+- Not run on hardware. The first site to check is Castellum Örebro.
+
+FTW's bundled copy does not move with this commit. Bump the pin and run
+`scripts/sync-bundled-drivers.sh`.
+
 ### zap 3.1.3
 
 `read_pv` and `read_battery` read again on Zap firmware 7.x. Data model v2 calls

SUPPORT_STATUS.md

@@ -120,6 +120,8 @@ Catalog source is not proof that a target can install or run a driver.
 | pixii_pv | 0.3.3 | blixt-l1 | not_assessed | — | not_recorded | not_assessed |
 | remne_p1ib | 0.1.0 | ftw-core | not_assessed | — | not_recorded | not_assessed |
 | remne_p1ib | 0.1.0 | blixt-l1 | not_assessed | — | not_recorded | not_assessed |
+| saj-emanager | 0.1.1 | ftw-core | not_assessed | — | not_recorded | not_assessed |
+| saj-emanager | 0.1.1 | blixt-l1 | not_assessed | — | not_recorded | not_assessed |
 | saj | 1.2.0 | ftw-core | not_assessed | — | not_recorded | not_assessed |
 | saj | 1.2.0 | blixt-l1 | not_assessed | — | not_recorded | not_assessed |
 | schneider_meter | 1.0.5 | ftw-core | not_assessed | — | not_recorded | not_assessed |

devices.yaml

@@ -1098,6 +1098,17 @@ manufacturers:
             control: false
         firmware_versions: ""
         notes: "Same H2-Protocol map as the three-phase hybrid. Ampere.StoragePro / EKD-Solar is a rebadged HS2. Telemetry only."
+      - name: "eManager C1 Pro"
+        variants: [eManager C1 Pro]
+        regions: []
+        protocols:
+          - protocol: modbus
+            driver: "saj-emanager"
+            version: "0.1.1"
+            ders: [pv, battery, meter]
+            control: false
+        firmware_versions: ""
+        notes: "Site controller in front of 1..N CHS2/CH2 C&I hybrids. Modbus TCP only, port 502; the register sheet marks RTU as not supported. Telemetry only, decoded from the community eManager/SEC-C workbook. Not tested on hardware. First check is Castellum Örebro (3x CHS2 50 kW). Control 0x8400-0x8405 is documented and not written."
   - name: "SMA"
     model_families:
       - name: "SMA Home Manager 2.0"