Repository navigation
Installation and setup
Installing the integration itself only takes a few minutes. The only thing you need beforehand is a working Modbus connection between Home Assistant and your TROVIS controller.
Please make sure that:
- your controller is listed under Supported controllers,
- the Modbus interface of your TROVIS is available and enabled,
- you know the controller's Modbus unit ID. The factory TROVIS Modbus unit ID is 255. Change it to 246.
You will also need to know which connection type your setup uses:
| 🌐 Modbus TCP | 🛜 Remote Serial | 🔌 Direct Serial |
|---|---|---|
|
During installation, you will need:
Example connection settings:
The adapter must be set to act as a TCP server. Its local serial communication remains Modbus RTU, and it translates to Modbus TCP on the network end. Baud rate, data bits, parity, stop bits are set in the adapter (always 9.600 or 19200 8N1). |
During installation, you will need:
Example connection settings:
The entire Modbus communication remains Modbus RTU; only the serial connection is transported remotely through the network by using a socket or serialx proxy. Baud rate, data bits, parity, stop bits are set in the adapter (always 9.600 or 19200 8N1). |
During installation, you will need:
Example connection settings:
This applies when the TROVIS is connected directly to the Home Assistant host, for example through a USB-to-serial adapter on a Raspi. Baud rate, data bits, parity, stop bits are set on the host (always 9.600 or 19200 8N1). |
The recommended way to install and update the integration is through HACS.
| 💯 One-click setup | 🧑💻 Add it manually |
|---|---|
|
If you already use HACS, the easiest way is to open the custom repository directly with this button:
|
If the button does not work, add the repository manually in HACS:
|
Click here to show / hide how to install the integration without HACS
### Manual installation without HACSHACS is strongly recommended because it also takes care of future updates. If you prefer a manual installation:
-
Download the latest release.
-
Copy the folder
custom_components/samson_trovis_557xinto your Home Assistant configuration so that the resulting path is/config/custom_components/samson_trovis_557x.. -
Restart Home Assistant.
After Home Assistant has restarted, add the integration using one of the two methods below. The setup flow has two technical connection paths: Network for Modbus TCP / RTU over TCP, and Serial for both Remote Serial (socket://, esphome://) and Direct Serial connections.
| 💯 One-click setup | 🧑💻 Add it manually |
|---|---|
|
Use this button to open the TROVIS integration directly in Home Assistant: |
If the button does not work, add the integration manually in Home Assistant:
|
If the connection succeeds, the integration automatically probes the controller.
It detects:
- the TROVIS controller model,
- the configured hydronic system,
- the available control circuits,
- and the available physical sensor inputs.
You do not need to select your TROVIS model or system configuration manually.
After the controller has been detected, you will be asked for three final settings (click Submit when done):
| 🏷️ Unique name | 🔤 Entity ID prefix | 🔐 Access code |
|---|---|---|
|
The name used for the controller in Home Assistant. For example:
If you use more than one TROVIS controller, give each one a different name. |
The prefix used for all entities created for this controller. A suitable prefix is automatically suggested; it must be unique for this controller.
Example: Important Choose wisely - changing this later would also require changing all entity IDs used in your dashboards, automations and scripts. |
The TROVIS access code is used when Home Assistant is allowed to write settings
back to the controller.
You can find the applicable code in the controller manual; the factory default is Note The integration is safe to use for monitoring without enabling write access. Writing to the controller requires the separate Write access switch in Home Assistant to be enabled explicitly. |
After setup, your TROVIS appears under: Settings → Devices & services → SAMSON TROVIS 557x
Depending on the controller and its configured hydronic system, Home Assistant will create several linked subdevices, for example:
- the TROVIS controller itself,
- Measurements for detected physical sensors,
- Rk1, Rk2 and Rk3 for the control-circuit slots that are actually used,
- Rk4 – Domestic hot water if the system includes DHW,
- Solar if a solar circuit is configured.
Not every TROVIS installation will show all of these devices. The integration only creates the parts that are relevant to the detected controller and system. ➡️ Learn what the devices and entities mean
You can add multiple controllers to the same Home Assistant installation.
Simply start Add integration → SAMSON TROVIS 557x again and repeat the setup.
Use a unique name and entity ID prefix for each controller.
When installed through HACS, new releases appear as normal HACS updates.
After updating, restart Home Assistant if HACS asks you to do so.
Manual installations must be updated manually by replacing the integration files with those from the latest release.
Disclaimer: Any information on this wiki is informal advice only. It is not supported nor endorsed by Samson, Sauter, YADOS, Pewo or any other equipment maker or OEM. There is no warranty expressed or implied: you take sole responsibility for everything you do with your heating controller.
-
Wozu dieses Projekt?
What is this project about?
-
Wie funktioniert das?
How does it work?
- Was wird benötigt? Kosten?
What's required? Costs?
- Supported controllers
- Connecting your TROVIS
- Installation and setup
- Current limits and migration
- Troubleshooting
- Architecture and internals
- Connections and transports
- Config flow and reconfiguration
- Coordinator and runtime updates
- Devices and entities
- Writing and write access
- Development and testing
- LAN/WLAN
USR-TCP232-T2, USR-TCP232-410S, USR-K7, USR-DR301 (Hutschiene), Elfin-EE10 (WLAN) - USB
AZDelivery FT232RL, Waveshare USB 2 RS232/485/TTL - ESP
ESP-01, Wemos D1 - SPS
S7 1200, Wago 750-889 - KNX
Masifi Modbus Gateway
- Edomi
- espHome/HomeAssitant
- FHEM
- HomeAssistant
- ioBroker
- KNX
- Loxone
- NodeRed
- openHAB
- SIMATIC Step7
- smarthomeNG
- Tasmota/MQTT
- Wago CODESYS
Wiki - Start