What it does
Two independent functions, both off by default:
- Reading registers — the node polls up to 16 registers every 10 seconds (FC03/FC04; u16, s16, u32, s32, f32; word order; scale; unit) and publishes them as entities
own.mb_<name>or as native readings such as grid power and battery state of charge. They appear on the node card in the app, in Home Assistant through the HACS integration and on the node's local API. - Modbus TCP bridge on port 502 — Home Assistant (built-in Modbus integration), Node-RED or SCADA connect to the node over TCP and talk to any device on the RS485 bus: inverter, meter, heat pump, ventilation unit. Read functions FC1–4 always pass; writes only after you enable them.
Firmware 1.14 has been rolled out to the network (LoRa boards: 1.14-lora2); what changed in each version is in the CHANGELOG.
Wiring
You need an RS485 transceiver module (for example MAX485, or a module with automatic direction) between the node and the inverter's RS485/Modbus port (A to A, B to B, shared ground if the port has one).
| setting | default | field |
|---|---|---|
| RX pin | 16 | rx |
| TX pin | 17 | tx |
| DE/RE pin | none (module with automatic direction) | de |
| speed | 9600 baud, 8N1 | baud, parity (N/E/O) |
| Modbus address of the device | 1 | slave |
Speed 1200–115200, parity none, even or odd. Change the pins if your board uses 16/17 for something else.
Turning it on
In the beta app (1.6.6 or newer) open the node's configuration and pick Modbus RS485: pick a preset, set the pins and save. The app talks to the node in your LAN with the node's PIN.
The same over the node's local API (replace the IP and PIN):
curl http://192.168.1.50/node/modbus
curl -X POST -H "Authorization: Bearer 123456" \
-d '{"on":true,"preset":"deye1"}' http://192.168.1.50/node/modbus
GET /node/modbus returns the configuration, the list of presets, the last values and counters. POST /node/modbus (PIN required) takes the fields from the table above plus on (polling), bridge (TCP 502), write (let the bridge write) and either preset or your own regs list.
Presets
| preset | device | values |
|---|---|---|
deye1 | Deye/Sunsynk single-phase hybrid | PV1 and PV2 power, grid, load and battery power, battery SoC and voltage, grid voltage and frequency, PV today and total, inverter temperature, warning and fault codes |
deye3 | Deye/Sunsynk three-phase LV hybrid | the same set for the three-phase low-voltage models |
sdm | Eastron SDM120 meter (single-phase) | voltage, current, power, frequency, import and export energy |
A preset is only a ready-made register list: after loading it you can edit or replace the registers with your own (up to 16).
Home Assistant over the bridge
Turn the bridge on ("bridge":true) and add a Modbus hub in Home Assistant pointing at the node:
modbus:
- name: inverter
type: tcp
host: 192.168.1.50
port: 502
The node forwards each TCP request to the RS485 bus and returns the answer. The bridge has priority over the node's own polling, so both can run at the same time.
Beta status
- Read-only polling; the node never changes inverter settings unless you enable writes on the bridge.
- The Deye/Sunsynk maps are not yet verified on a real inverter — compare with the display, especially the sign of battery power.
- Want to help? The testers programme has a Deye scenario: testers.