cantabile_edge, cantabile_modbus, cantabile_eebus 0.1.400: full source
This commit is contained in:
1 parent
343331d234
commit
d5fbcacaa4
176 files changed
+32511
-19
No files matched your search
@@ -0,0 +1,51 @@
|
||||
# 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](https://www.setti.md). All rights reserved.
|
||||
Reference in new issue
Block a user