2.1 KiB
Cantabile Modbus bridge
The bridge reads inverters, meters and batteries over Modbus TCP by Cantabile's device profiles and shows them in Home Assistant (MQTT discovery, the device under its own name), in Cantabile's units, so the Cantabile agent maps them exactly.
Devices
Add each device in the options: its profile (for example hm8042-hybrid),
a name, the address and port of its Modbus TCP gateway, and its Modbus id.
The add-on makes everything else from the profile at every start; nothing
is kept by hand.
One Modbus master per gateway: if Home Assistant's own modbus integration already reads a device, keep that, or stop it before the bridge reads it. Some RS485 gateways send every answer to every connected client, so a second master's answers reach the first one too.
Per device, optionally: poll_s (seconds between reads, at least 10),
read_only (commands are checked and logged but never written: a dry run)
and simulate (this device only).
Circuits from Home Assistant
A SONOFF SPM-4Relay (profile sonoff-spm) is read from the SonoffLAN
integration's entities (LAN mode is enough): give its eWeLink id as
device (the ab40... in switch.sonoff_ab40..._1). Each of its four
circuits shows its switch, power, current and voltage under Cantabile's
names; the energy is added up from the power (SonoffLAN reads energy only
from the cloud). A circuit is switched only through this add-on's switch,
after its protection check.
Protection
Each control has a protection: none, protected (commands that would switch it off are refused; for a control without an off, every command) or sealed (set by Cantabile, locked). Every relay and circuit, and the inverter's settings, start protected. Only you lift a protection, on the add-on's page (Cantabile devices in the sidebar); every change is written to the add-on's log with who and when.
Simulate
With Simulate on, the add-on answers for the devices itself, from a
recorded trace in /share/cantabile/trace-<profile>.json, and never
touches the real devices.
© 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.