Skip to content

Commit b6c7fc6

Browse files
0xAHAclaude
andcommitted
docs: Waveshare multi-client and idle-timeout settings for null-byte frames (#356)
Contributed by a user running a working install. Limiting max socket clients to 1 (the default is 8) stops several clients interleaving on one RS485 bus at 9600 baud, which is what produces 'Very short frame: 0x0'. A 30-60 s TCP idle timeout drops a dead session so a restarted Home Assistant is not refused while the gateway still holds the old socket. Recorded under the known-good Waveshare entry rather than as a new section - it is additional configuration for hardware already documented there, not a new finding about a different adapter. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 796e22f commit b6c7fc6

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

docs/troubleshooting/rs485-gateways.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,15 @@ 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+
**Two more settings if you see `Very short frame: 0x0` or null bytes**, contributed from a working install ([#356](https://github.com/0xAHA/Growatt_ModbusTCP/issues/356)):
44+
45+
| Setting | Value | Why |
46+
|---|---|---|
47+
| Multi-Client / Max Socket Client | **1** | The default allows up to 8. Several clients querying one RS485 bus at 9600 baud interleave on the wire and corrupt frames |
48+
| Connection / TCP Idle Timeout | **30-60 s** | A dead session is dropped promptly, so a restarted Home Assistant is not refused while the gateway still holds the old socket |
49+
50+
The first matters more than it sounds. The bus is a single shared medium: a second client is not a second conversation but an interruption of the first, and the resulting fragment arrives as a valid-looking short read rather than as an error.
51+
4352
### ✅ Elfin EW11 / EW11A — known good
4453

4554
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).

0 commit comments

Comments
 (0)