Skip to content

Commit a83f850

Browse files
0xAHAclaude
andcommitted
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>
1 parent c257492 commit a83f850

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

docs/troubleshooting/rs485-gateways.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,18 @@ Firmware V1.523, reported in [#367](https://github.com/0xAHA/Growatt_ModbusTCP/i
4040

4141
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.
4242

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+
4355
### ⚠️ PUSR / ShineWiFi-class serial bridges — replay stale frames
4456

4557
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
7486

7587
**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.
7688

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+
7791
**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.
7892

7993
---

0 commit comments

Comments
 (0)