diff --git a/README.md b/README.md index 307988c..05ee16f 100644 --- a/README.md +++ b/README.md @@ -69,6 +69,21 @@ on real hardware, and the comments in `control.py` say which. ## Compatibility +**Check the serial number, not the model name.** Characters 6-8 of the serial are +the platform tag: + +| tag | platform | verdict | +|---|---|---| +| `ESU EMU ESA BPS BPU EMJ IJL` | 105 — ES/EM/BP, AA55-era meter bus | **supported** | +| `SPB SPN` | 745 — SBP **G2** (`GW…-SBP-20`) | no | +| `ESN ESC` | 745 — ES **G2** (`GW…-ES-20`) | no | +| `ETU EHU BTU …` | 205/745/753 — ET/EH/BT hybrids | no | +| `SDT DST MSU NSU …` | PV-only inverters — no battery to control | no | + +A "-20" or "G2" suffix means a different platform with a different meter +protocol. The tags come from the `goodwe` library's `PLATFORM_105_MODELS`, which +is also what Home Assistant's own integration uses to pick a protocol. + - GoodWe **ES / BP family** inverters (AA55 / RS485 meter-bus generation) - The protocol is **reverse-engineered**. There is no vendor contract, and a firmware change on GoodWe's side could break every installation at once. Say diff --git a/docs/GoodWe-RS485-Field-Guide.pdf b/docs/GoodWe-RS485-Field-Guide.pdf index a4e1155..42f4264 100644 Binary files a/docs/GoodWe-RS485-Field-Guide.pdf and b/docs/GoodWe-RS485-Field-Guide.pdf differ diff --git a/docs/build_guide.py b/docs/build_guide.py index 1a8e93a..82f80a8 100644 --- a/docs/build_guide.py +++ b/docs/build_guide.py @@ -146,6 +146,26 @@ figcaption { font-size:9pt; color:#5b6169; margin-top:1.2mm; }

Step 0 — Before you travel

+ +
+

Compatibility gate — 60 seconds, do this first

+

Read the inverter's serial number (label, app, or portal) and take + characters 6–8. That three-letter tag is the platform.

+ + + + + + + + + +
TagPlatformVerdict
ESU EMU ESA BPS
BPU EMJ IJL
Platform 105 — ES / EM / BP, AA55-era meter busSUPPORTED
SPB SPNSBP G2 (GW…-SBP-20) — platform 745NO
ESN ESCES G2 (GW…-ES-20) — platform 745NO
ETU EHU BTU …ET / EH / BT hybrids — platform 205/745/753NO
SDT DST MSU NSU …PV-only inverters — no battery to controlNO
+

Reference unit: 95000BPS225W0290BPS → supported. + A “-20” or “G2” suffix in the model name means a different platform with a different meter + protocol. If the tag is not on the supported list, stop — do not quote the job.

+
+

Confirm with the client

diff --git a/docs/field-guide.html b/docs/field-guide.html index a42d071..ddbb264 100644 --- a/docs/field-guide.html +++ b/docs/field-guide.html @@ -111,6 +111,26 @@ figcaption { font-size:9pt; color:#5b6169; margin-top:1.2mm; }

Step 0 — Before you travel

+ +
+

Compatibility gate — 60 seconds, do this first

+

Read the inverter's serial number (label, app, or portal) and take + characters 6–8. That three-letter tag is the platform.

+ + + + + + + + + +
TagPlatformVerdict
ESU EMU ESA BPS
BPU EMJ IJL
Platform 105 — ES / EM / BP, AA55-era meter busSUPPORTED
SPB SPNSBP G2 (GW…-SBP-20) — platform 745NO
ESN ESCES G2 (GW…-ES-20) — platform 745NO
ETU EHU BTU …ET / EH / BT hybrids — platform 205/745/753NO
SDT DST MSU NSU …PV-only inverters — no battery to controlNO
+

Reference unit: 95000BPS225W0290BPS → supported. + A “-20” or “G2” suffix in the model name means a different platform with a different meter + protocol. If the tag is not on the supported list, stop — do not quote the job.

+
+

Confirm with the client