# 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-.json`, and never touches the real devices. --- © 2026 Setti Solutions S.R.L, [www.setti.md](https://www.setti.md). All rights reserved.