ENPLDEPT
Flash
All docs
Modbus · beta

Your inverter on the node — over RS485, read-only.

Firmware 1.14 can read an inverter or an energy meter over Modbus RTU and turn the values into node entities, and it can act as a Modbus TCP bridge so Home Assistant talks to the same RS485 bus. Both are off by default and work in your LAN without the internet.

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

settingdefaultfield
RX pin16rx
TX pin17tx
DE/RE pinnone (module with automatic direction)de
speed9600 baud, 8N1baud, parity (N/E/O)
Modbus address of the device1slave

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

presetdevicevalues
deye1Deye/Sunsynk single-phase hybridPV1 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
deye3Deye/Sunsynk three-phase LV hybridthe same set for the three-phase low-voltage models
sdmEastron 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.

Questions, straight answers

Is this finished?

No, it is a beta. The register maps for Deye/Sunsynk come from the manufacturer's documentation and have not yet been verified on a real inverter. Compare the values with the inverter display before you rely on them, and report what you see in the testers programme.

Can the node change inverter settings?

Not when it reads: polling uses only read functions (FC03/FC04). The TCP bridge passes write functions (FC5/6/15/16) only if you turn on "write" yourself; by default it is read-only too.

Does it need the internet?

No. Configuration goes over your LAN with the node's PIN, polling and the bridge run on the node. The internet is only needed to see the values remotely in the app or on the map.

Which firmware do I need?

1.14 or newer (also 1.14-lora2 on LoRa boards). Nodes update over the air on their own; check the version on the node card in the app.

Last updated: 2026-11-18