feat: add read-only EyeBond short-ASCII driver for Anern SPI-12000W

Poll MD/Q1/F/RB over FC4 and solicit bare 5AA5 MPPT frames for PV, with
schema-backed decoding and catalog support for this OFFG collector family.

Author: mikehardy

CHANGELOG.md

@@ -7,6 +7,19 @@ the GitHub release body should be rendered from the matching version section her
 
 ## [Unreleased]
 
+### Added
+
+- Added a read-only **EyeBond short-ASCII** driver (`eybond_short_ascii`) for
+  OFFG / URTU1920 collectors that speak FC4 `MD`/`Q1`/`F`/`RB` (not Modbus or
+  G-ASCII), with catalog support for **Anern SPI-12000W**. Exposes identity,
+  mode flags, ratings, BMS SoC / pack voltage / currents, a discharge-only BMS
+  DC load proxy, and MPPT PV via bare TCP `5AA5…02` → `aabb0200` (same elicit
+  path SmartValue/cloud uses). Writes stay rejected; Q1 load% is coarse and
+  instantaneous grid-import watts are not on the proven read surface. An `RB`
+  response with pack-voltage raw 0 and SoC 0 is treated as a lost BMS link,
+  even when trailing fields are nonzero, so stale SoC and current values are
+  not replaced by false zeros.
+
 ### Fixed
 
 - Collector framed/AT transports now discriminate bare MPPT `aabb` frames from EyeBond FC4 on the callback socket, complete AABB waiters without corrupting negotiated forward mode, and project last-PV snapshots into `collector_info` for drivers that solicit `5AA5…02`.

catalog/inverter_models/models/anern_spi_12000w.json

@@ -0,0 +1,52 @@
+{
+  "schema_version": 1,
+  "model_key": "anern_spi_12000w",
+  "manufacturer": "Anern",
+  "model": "SPI-12000W",
+  "aliases": ["URTU1920", "EyeBond OFFG short-ASCII"],
+  "lifecycle": "experimental",
+  "variants": [
+    {
+      "variant_key": "offg_family",
+      "label": "EyeBond FC4 short-ASCII read-only",
+      "device_descriptor_keys": [
+        "anern_spi_12000w",
+        "eybond_short_ascii_family"
+      ],
+      "known_firmware": [
+        "collector FW 8-50-18-3",
+        "ATVER 1.14",
+        "UART 9600 8N1",
+        "inverter MD S2-8127-260108-V7.3B"
+      ]
+    }
+  ],
+  "validation": {
+    "hardware": "captured",
+    "telemetry": "partial",
+    "controls": "none"
+  },
+  "coverage": {
+    "runtime_control_surface": "read_only",
+    "smartess_control_surface": "not_applicable",
+    "vendor_register_map": "partial",
+    "notes": [
+      "Read-only MD/Q1/F/RB over EyeBond FC4 short-ASCII; live PV is solicited with bare 5AA5 and merged from the aabb0200 reply.",
+      "MP/RH and writes remain deferred.",
+      "Wire Forward2Device uses devcode 0x02FF even when ValueCloud lists 0x19B4.",
+      "Battery-mode load watts: BMS DC proxy while discharging (Q1 load% often stuck at 0).",
+      "Grid/Mains Direct: mode and voltages proven; no instantaneous grid-import watts on the known read surface (SmartValue agrees).",
+      "RB pack-voltage raw 0 and SoC 0 (trailing fields may be nonzero) = BMS link lost: publish bms_link_ok=False only; omit SoC/V/I so DELTA holds last-good. True SoC 0% with non-zero pack voltage still publishes."
+    ]
+  },
+  "known_limitations": [
+    "Read-only first implementation; no write controls are exposed.",
+    "Q1 Load Percentage often reports 0% with real AC load (battery and grid); SmartValue shows the same.",
+    "No proven instantaneous grid-import power (W) while Mains Direct / bypass; external metering may be required.",
+    "aabb PV/LOAD fields are unavailable when the bounded 5AA5 solicitation receives no aabb0200 reply (typical at night).",
+    "When RB pack-voltage raw and SoC are both 0, trailing fields may still be nonzero; SoC/V/I are omitted (bms_link_ok off) rather than published as 0 — History may hold last-good until the link returns.",
+    "Do not treat APK bse_crtu_*/SON/SOFF paths as safe without hardware confirmation."
+  ],
+  "knowledge_summary": "Anern SPI-12000W behind an EyeBond I2000 collector speaks EyeBond FC4 short ASCII (MD/Q1/F/MP/RH/RB), plus a bare 5AA5 runtime query whose aabb0200 reply supplies live PV. Read-only runtime exposes SoC/BMS, mode flags, ratings, and a discharge-only BMS load proxy. BMS link loss (RB pack-voltage raw 0 and SoC 0, regardless of trailing fields) omits SoC zeros; true empty SoC with pack voltage still publishes 0%. Instantaneous grid-import watts are not available on the proven cloud/local surface when Mains Direct.",
+  "source_keys": ["support_archive_anern_spi12000_short_ascii_20260914"]
+}

catalog/inverter_models/sources/support_archive_anern_spi12000_short_ascii_20260914.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "source_key": "support_archive_anern_spi12000_short_ascii_20260914",
+  "kind": "support_archive",
+  "title": "Anern SPI-12000W EyeBond FC4 short-ASCII capture",
+  "reference": "private:maintainer_pack_anern_spi12000",
+  "captured_at": "2026-09-14",
+  "visibility": "private",
+  "summary_publishable": true,
+  "summary": "Private collector-to-cloud tee plus SmartValue v2.35.4 APK analysis and live HA↔SmartValue correlation (2026-09-14) show Anern SPI-12000W uses EyeBond FC4 short-ASCII MP/Q1/MD/F/RH/RB (CMD+device_addr+CR), with live PV elicited by bare 5AA5 and returned as aabb0200; wire_devcode 0x02FF collector 0xFF, UART 9600 8N1. ValueCloud lists devcode 6580 (0x19B4). Battery SoC/BMS and discharge load proxy proven; RB pack-voltage raw 0 and SoC 0 (trailing fields may be nonzero) is BMS link loss (omit SoC zeros, bms_link_ok off) not a true empty pack. Q1 load% often 0 with real load; Mains Direct has no instantaneous grid-import watts on the known read surface (SmartValue agrees). Writes (W/SON/SOFF) are excluded.",
+  "assertions": ["runtime_compatibility", "telemetry_validation"]
+}