Skip to content

Installation and setup

Tom-Bom-badil edited this page Sep 15, 2026 · 2 revisions

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.


📝 Before you begin

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:

  • a ser2net adapter with enabled TCP Server function,
  • the IP address or hostname,
  • the TCP port.

Example connection settings:

  • IP: 192.168.178.35
  • Port: 502

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:

  • a regular ser2net adapter or an ESP with ESPHome installed,
  • the IP address or hostname,
  • the TCP port.

Example connection settings:

  • socket://192.168.178.35:502
  • esphome://192.168.178.35

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:

  • a serial cable (directly attached),
  • the name of the local interface,
  • baud rate, parity, stop bits, data bits (8N1).

Example connection settings:

  • /dev/tty0, 9600 8 N 1
  • /dev/USB-AMA-1, 19200 8 N 1

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



🛠️ Step 1: Install the integration

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:


Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  1. Open the repository using the button above.
  2. Add it to HACS if requested.
  3. Download the latest release of SAMSON TROVIS 557x.
  4. Restart Home Assistant.

If the button does not work, add the repository manually in HACS:

  1. Open HACS.
  2. Open Custom repositories.
  3. Enter: https://github.com/Tom-Bom-badil/samson_trovis_557x
  4. Select Integration as the repository type.
  5. Add the repository.
  6. Download the latest release.
  7. Restart Home Assistant.
Click here to show / hide how to install the integration without HACS ### Manual installation without HACS

HACS is strongly recommended because it also takes care of future updates. If you prefer a manual installation:

  1. Download the latest release.

  2. Copy the folder custom_components/samson_trovis_557x into your Home Assistant configuration so that the resulting path is /config/custom_components/samson_trovis_557x..

  3. Restart Home Assistant.



🛠️ Step 2: Add your TROVIS controller to 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:


Open your Home Assistant instance and start setting up a new integration.

If the button does not work, add the integration manually in Home Assistant:

  1. Open Settings → Devices & services.
  2. Click Add integration.
  3. Search for SAMSON TROVIS 557x.
  4. Select the integration.



🔎 Step 3: Controller detection (done automatically)

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.



🔎 Step 4: Final settings

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:

Trovis 5578

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: t5578 results in entity IDs like sensor.t5578_rk1_flow_temp.

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

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.



✅ Step 5: Done!

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



➕ Adding another TROVIS

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.



🔄 Updating the integration

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.



🛠️ Troubleshooting

➡️ Troubleshooting

➡️ Connecting your TROVIS




❤️ Thank you for using the integration - have fun with your TROVIS! ❤️

german Wiki - Start english


english Bauanleitungen

Schritt 1 - Kabel

Schritt 2 - Adapter

Schritt 3 - Schnittstelle

Schritt 4 - Regler

Schritt 5 - Erster Test

🔥 Update: Weitere Adapter


english Home Assistant Integration

🚀 Getting started

🔌 Using the integration

🧑‍💻 Technical reference

🔢 Related projects


english SmartHomeNG Plugin


german2 Anhang: Info-Sammlung

Clone this wiki locally