You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add Elfin EW11/EW11A and Growatt WiLan-X2 to the gateway guide
The EW11A was missing despite being the adapter on the maintainer's own
MIN 10000TL-X -- the reference system most fixes in this integration are
verified against. An Elfin EW11 also produced the register readings
behind #326.
Checked the issue history before listing it rather than taking the
absence of complaints as evidence. One EW11A report (#309) showed every
entity reading zero, but the reporter hit the identical symptom after
fitting a Waveshare, so the gateway was not the cause. They resolved it
with a Growatt WiLan-X2, which is now listed too -- it exposes Modbus
directly and buffers about a month of data across a power cut, which no
generic serial server does.
That case also produced a diagnostic worth stating on its own: if the
symptom survives a gateway swap, the gateway is not the variable. Slow to
test, but decisive in a way that reading logs often is not.
Co-Authored-By: Claude <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/troubleshooting/rs485-gateways.md
+14Lines changed: 14 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,6 +40,18 @@ Firmware V1.523, reported in [#367](https://github.com/0xAHA/Growatt_ModbusTCP/i
40
40
41
41
Measured: zero short/misaligned reads, 89 sensors populated, two full register scans of 2300 registers across 17 ranges with no read errors, and **26 days of statistics from before the v1.3.7 guard existed with no corrupt values at all**. On this gateway there was never anything to catch.
42
42
43
+
### ✅ Elfin EW11 / EW11A — known good
44
+
45
+
Running on the maintainer's own MIN 10000TL-X without issue, and the reference setup most fixes in this integration are verified against. An Elfin EW11 also produced the register readings behind [#326](https://github.com/0xAHA/Growatt_ModbusTCP/issues/326).
46
+
47
+
Set the work mode so it performs **Modbus TCP to RTU** conversion rather than plain transparent passthrough — see the section above for why that is the one setting that decides whether a gateway can work at all.
48
+
49
+
One EW11A report ([#309](https://github.com/0xAHA/Growatt_ModbusTCP/issues/309)) showed all entities reading zero, but the same symptom followed the reporter onto a Waveshare adapter, so the gateway was not the cause. They resolved it with a Growatt WiLan-X2.
50
+
51
+
### ✅ Growatt WiLan-X2 — known good
52
+
53
+
Growatt's own dongle, which exposes Modbus directly. Reported working in [#309](https://github.com/0xAHA/Growatt_ModbusTCP/issues/309) after two third-party adapters had been ruled out. It also buffers roughly a month of data and re-synchronises after a power cut, which no generic serial server does.
54
+
43
55
### ⚠️ PUSR / ShineWiFi-class serial bridges — replay stale frames
44
56
45
57
Reported in [#360](https://github.com/0xAHA/Growatt_ModbusTCP/issues/360) and [#367](https://github.com/0xAHA/Growatt_ModbusTCP/issues/367).
@@ -74,6 +86,8 @@ On the PUSR unit in #367, 113 registers cost the same as 1 — every read landed
74
86
75
87
**Careful measuring latency from logs.** A 15-18 s figure reported on #367 turned out to be the integration's own failure cycle — a 10 s timeout plus reset and retry — not gateway latency. Measure with raw sockets and the integration disabled.
76
88
89
+
**Symptom survives a gateway swap?** Then the gateway is not the variable. One reporter saw every entity read zero on an EW11A, fitted a Waveshare, and got exactly the same result — which ruled out both adapters in a single step and pointed at the inverter side instead ([#309](https://github.com/0xAHA/Growatt_ModbusTCP/issues/309)). Swapping hardware is slow, but it is decisive in a way that reading logs often is not.
90
+
77
91
**Running a register scan?** Disable the integration entry first (**⋮ → Disable**, don't delete), wait ~30 s, then scan. The scanner opens a second connection, and on a sensitive gateway that contends with the poller. A scan taken while polling came back with 9 successful reads out of 1304 rows, every range reporting "no response" on a device that was working fine.
0 commit comments