Skip to content

Commit 36d327e

Browse files
0xAHAclaude
andcommitted
docs: explain why a dropped read now leaves a gap instead of a zero
Nothing documented the v1.6.6 behaviour change, so a user upgrading sees new gaps in their solar graph with no explanation for them. Also records the signature that distinguishes the three cases, which #384 has now shown are routinely confused: a single-sample vertical drop (old behaviour), a one-or-two sample gap (a dropped frame), and a flat-bottomed dip across several polls where voltage and current still report plausible values - which is the inverter's own measurement and not a comms fault at all. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 41a1f85 commit 36d327e

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

docs/troubleshooting/rs485-gateways.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,32 @@ The integration holds one socket per host:port across polls. It was suspected of
157157

158158
---
159159

160+
## Gaps in the graph are the fix, not the fault
161+
162+
Since **v1.6.6** a register that could not be read is published as **unavailable** for that poll, not as `0`.
163+
164+
If you upgraded from an older version, occasional short gaps in your solar or battery graphs are the same dropped frames you always had — they are simply no longer disguised. Before, a single failed block read produced a vertical drop to 0 W and back within one poll, with nothing logged as an error, because from Home Assistant's side the poll had succeeded.
165+
166+
Zero is not a neutral placeholder. It is a plausible measurement, it enters long-term statistics, and afterwards it cannot be told apart from a real one. A gap is unambiguous.
167+
168+
**A genuine zero is still recorded.** Night-time, standby and a truly idle string all still read 0.
169+
170+
### Telling the two apart
171+
172+
This matters when you are judging whether a change actually helped:
173+
174+
| What you see | What it means |
175+
|---|---|
176+
| Vertical drop to 0 and back, **one sample** | Pre-v1.6.6 behaviour — upgrade |
177+
| **Gap**, one or two samples | A dropped frame. Normal on a serial bus; reduce by raising the scan interval |
178+
| **Flat-bottomed dip** across several consecutive polls, with voltage and current still reporting plausible values | Not a comms fault. The inverter reported this — check battery SOC, load, and whether ShinePhone shows the same dip |
179+
180+
The third row is the one most often misread as a communication problem. If the reads had failed, every sensor in that block would be gapped together; values that are present, low, and consistent with each other came from the inverter.
181+
182+
Occasional dropped frames are normal on RS485 and cannot be eliminated entirely. Raising the scan interval reduces how often they happen by reducing how many reads you make — the failure rate per read stays the same.
183+
184+
---
185+
160186
## Keeping the cloud app working
161187

162188
You do not necessarily have to choose. On both systems in #367 the inverter has a **`SYS COM` port separate from the USB port the ShineWiFi dongle occupies**, so a second RS485 master can run alongside the stock dongle. Home Assistant gets a local Modbus path, and the dongle keeps feeding Growatt's own app.

0 commit comments

Comments
 (0)