Skip to content

Change log

Tom-Bom-badil edited this page Sep 15, 2026 · 1 revision

v2026.08.5: Major milestone: feature parity achieved

Note

Due to the number of internal and entity changes, for updating it is highly recommended to re-install or at least re-configure your existing controller.

This release marks an important milestone for the new Home Assistant integration:

trovis-modbus-hass has now reached and in most areas surpassed (by far!) the functional scope of the former Home Assistant YAML configuration and the SmartHomeNG plugin.

The old YAML solution required a large collection of Modbus entities, templates, helpers and automations. The new integration now provides the corresponding controller functionality natively, while automatically adapting the entity set to the detected TROVIS model, hydronic system, control-circuit roles, configured sensors and enabled controller functions.

No Modbus YAML configuration is required anymore - ALL features are now provided by the integration, including what the old template sensors were offering.

👉 Highlights

More complete controller and heating-circuit configuration

A large number of remaining controller functions and parameters have been added or refined, including:

  • additional Rk1-Rk3 configuration and diagnostic entities,
  • PI/PID and two-point controller parameters,
  • configured control type,
  • room setpoints and control-circuit parameters,
  • model-aware Optimization and Adaptation support,
  • room control-unit support,
  • corrected FG / remote-transmitter semantics,
  • improved model-, hydronic-system- and Rk-specific entity availability.

Entities are created only where the underlying controller configuration supports them.

New "Pumps and Valves" device

The integration now provides a dedicated Pumps and Valves device as the central status view for controller actuators.

It includes the relevant pump states and numeric valve setpoints for the available control circuits, providing a much clearer overview of what the controller is currently driving.

System overall status

A new System overall status sensor exposes the controller's major actuator states as a compact 8-bit status value.

The existing high-level SystemActivity logic remains unchanged; the new value is an additional detailed actuator-status view.

Native heating-curve data and simulation helpers

Heating circuits now expose calculated curves using the common calculation backend from trovis-modbus.

The integration supports:

  • gradient characteristics,
  • four-point characteristics,
  • fixed setpoints,
  • separate day and night curves,
  • active curves,
  • flow and return curves.

Internal UI simulation helpers are available for Rk1-Rk3 and for Rk4/DHW.

For Rk1-Rk3, simulation values can be changed locally without writing anything to the physical controller. The simulation automatically uses the configured control mode and the same calculation backend as the live controller representation.

Rk4 provides a corresponding local simulation snapshot for:

  • day setpoint,
  • night setpoint,
  • hysteresis,
  • charging-temperature boost,
  • maximum charging temperature,
  • maximum return-flow temperature.

New entity actions allow simulation parameters to be changed and reset to the current live controller values.

Manual Modbus read exclusions

Two new controller configuration entities allow individual zero-based Modbus addresses to be excluded from reading:

  • Excluded registers
  • Excluded coils

Example: 22,33-47,119

This is intended as a troubleshooting option for controller variants or firmware versions where individual registers or coils reject Modbus reads.

The excluded addresses are removed from the actual library read plan - they are not merely hidden after a failed read.

Improved diagnostics

  • Added the controller's raw model code.
  • Improved controller-, circuit- and sensor-specific diagnostics.
  • Refined physical sensor/input handling.
  • Improved visibility of controller operating modes and calculated control states.
  • Extended recorder-backed statistics information for physical measurements.

👉 A note for users of the old YAML configuration

The new integration is now the recommended path for Home Assistant.

Compared with the former YAML-based setup it provides:

  • automatic model detection,
  • automatic hydronic-system detection,
  • automatic sensor/input discovery,
  • model- and configuration-aware entities,
  • native Home Assistant devices and sub-devices,
  • native read/write support,
  • significantly less manual configuration,
  • no large Modbus YAML entity lists,
  • no duplicated template logic,
  • and several functions that were not available in the original YAML solution.

The legacy YAML repository remains useful as documentation and as a reference for older installations, but new installations should normally use this integration.

👉 Updating existing installations

This release adds and reorganizes a number of entities and device views.

If you use custom dashboards, automations or templates, please review newly added or changed entity IDs after updating.

The controller configuration itself is not changed by installing this update, and write operations remain protected by the integration's explicit Write access switch.


v2026.08.4: Fine-tune entities to detected controller

This release contains a substantial entity and presentation audit for the TROVIS control circuits, with a particular focus on Rk1-Rk4 and domestic hot water.

👉 Added

  • Add a configurable thermal-disinfection switch for Rk4 / domestic hot water (CO4-F14).
  • Keep the actual thermal-disinfection runtime state as a separate binary sensor.
  • Add a numeric operating-mode code sensor for each control circuit Rk1-Rk4. These expose the native TROVIS operating-mode value as an integer and are intended for dashboards, visualizations and automations.
  • Expose the configured summer-period start and end as writable Home Assistant date entities.

👉 Changed

  • Update to modbus-connection >= 4.8.1.
  • Improve handling of TROVIS month/day values in Home Assistant date entities. Summer-period dates are displayed using the controller year while only month/day are written back to the controller.
  • Remove the redundant separate controller-year number entity.
  • Move the native Rk operating-mode selects from Configuration to normal control entities.
  • Mark derived Rk values such as the active room setpoint and heating-curve information as diagnostic where appropriate.
  • Remove the six low-level per-circuit autonomous-control status entities from the Home Assistant user-facing entity set; the library continues to handle these internally.
  • Refine valve opening/closing binary-sensor presentation.
  • Rework Rk4 intermediate heating:
    • use the documented CO4-F07 function switch,
    • stop exposing the unclear CL1831 control as a second user-facing switch until its exact purpose is confirmed.
  • Correct Rk4 storage-tank charging pump and circulation pump presentation to simple on/off binary states.
  • Improve German and English entity naming and terminology throughout Rk1-Rk4, including:
    • heating curves and four-point characteristics,
    • domestic-hot-water setpoints and charging parameters,
    • autonomous-control and GLT terminology,
    • thermal disinfection,
    • intermediate heating,
    • valve and pump states.
  • Rename the local development scripts to:
    • script/format_code.sh
    • script/run_checks.sh

👉 Climate entities

Climate entities are temporarily disabled.

The TROVIS control circuits are heating-curve controllers, not conventional room thermostats, and the previous Home Assistant climate representation could suggest semantics that the controller does not actually provide.

The native TROVIS controls remain available through the dedicated select, number, switch and sensor entities. Climate support will be reconsidered separately instead of exposing a misleading thermostat abstraction.

👉 Development

  • Harmonize the local development override mechanism with the other project integrations through the git-ignored _local_dev_overrides package.
  • Local development can continue to use a checked-out trovis-modbus library without affecting normal installations.

👉Dependencies

  • trovis-modbus >= 2.2.0, <3
  • modbus-connection[tmodbus] >= 4.8.1, <5
  • tmodbus >= 0.5.0

This project is still under active development. Feedback from additional TROVIS models, firmware versions and hydronic systems is very welcome.


v2026.08.3: Internal changes & docs

👉 Bug fixes

  • bump modbus-connection to 4.6.1
  • update readme and wiki documents (still work in progress)
  • add logger for dependency / library versions on startup (in dev mode only)

v2026.08.2: Update dependencies

👉 Bug fixes

  • Explicitly add tmodbus as a Home Assistant requirement.

This fixes an issue where Home Assistant/HACS would install the integration without the tmodbus backend dependency. In that case the integration failed to start with:

ModuleNotFoundError: No module named 'tmodbus'

Existing installations may have appeared unaffected when tmodbus was already present from an earlier setup, while fresh installations or Home Assistant upgrades could expose the problem.

No integration functionality or entity behavior has changed in this release.


v2026.08.1: First solo-installable release (HACS custom)

This release introduces a major change to the Modbus connection architecture and extends heating-circuit functionality.

👉 New features

  • Add direct Modbus connection setup to the TROVIS integration.

  • Add support for:

    • native Modbus TCP,
    • RTU over TCP,
    • serial Modbus RTU.
  • Add automatic migration of existing TROVIS configuration entries to the new connection model.

  • Add fixed-setpoint operating mode support for Rk1–Rk3.

  • Add heating-circuit control mode detection for:

    • heating curve,
    • four-point characteristic,
    • fixed setpoint.
  • Add four-point characteristic parameters for flow, return and outdoor temperature.

  • Add calculated heating curves for day and night operation, including return-flow curves where available.

  • Add additional buffer-tank support and related entities.

👉 Improvements

  • The TROVIS integration now manages its own Modbus connection.
  • A separate Home Assistant modbus_connection integration is no longer required.
  • Existing configuration entries referencing the previous Modbus Connection integration are migrated automatically.
  • Legacy socket://host:port serial connections are migrated to first-class RTU-over-TCP connections.
  • Update to trovis-modbus >= 2.1.0.
  • Update to modbus-connection >= 4.2 using the tmodbus backend.
  • Connection failures are now handled by the Modbus connection layer without reloading the complete Home Assistant config entry.
  • Update setup and reconfiguration flows for the new connection architecture.
  • Update English and German configuration-flow translations.
  • Update documentation for the simplified installation and connection setup.

👉 Installation

A separate Modbus integration is no longer required.

For a new installation:

  1. Install SAMSON TROVIS 557x through HACS.
  2. Restart Home Assistant.
  3. Add the integration under Settings → Devices & services.
  4. Choose Network or Serial and enter the Modbus connection data.
  5. The integration will automatically probe the controller and detect its model and available sensors.

Existing installations

Existing configuration entries using the former modbus_connection integration are migrated automatically when Home Assistant starts.

The migration has been verified with:

  • TROVIS 5578 using native Modbus TCP.
  • TROVIS 5579 using RTU over TCP.

No manual recreation of the TROVIS configuration entry should be required.

Dependencies

  • trovis-modbus >= 2.1.0
  • modbus-connection[tmodbus] >= 4.2, <5

👉 Note

This is an ongoing project and still considered a beta release. Please report unexpected migration, connection, or entity behavior through discussions.


v2026.07.3: Update docs

This is a pure documentation-based release:

  • update readme.md
  • restructure Wiki
  • update Wiki pages

v2026.07.2: Adopt changes in trovis-modbus library 2.0.0

👉 List of (major) changes

  • Automatically create Rk1-Rk4 sub-devices according to the detected controller model and hydronic-system roles.

  • Create domestic-hot-water entities only when Rk4 is present and expose climate entities only for actual heating circuits.

  • Add a dedicated Solar sub-device and buffer-tank status and controls under Rk1.

  • Standardize physical sensor entity IDs and names using the official German TROVIS abbreviations.

  • Improve automatic entity selection using detected sensors, model capabilities and hydronic configuration.

  • Breaking: control-circuit and sensor entity IDs have changed; existing dashboards and automations may require adjustment or clean reconfiguration.

Successfully tested with Trovis 5576 (live heating system), 5578 (test device) and 5579 (test device). All devices, sub-devices / circuits and entites are available and operate as expected.


v2026.07.1-beta: [!BETA ONLY!] First release

This is the first public release.

The integration has successfully been tested with 2 Trovis devices running simultaneously for >24 hours.

The test was based on the trovis-modbus library 1.1.1. No errors in the log; 2x6 = 12 devices up, with a total of 466 entities.

Hk1...3 and Hk4/WW fully implemented. All sensors as well as analog control signals and remote control signals are available; installed sensors are detected on startup. The model (also detected on startup) cotrols which heating circuits are enabled.





template - please ignore

Changes in v2026.xx

Important

❗Breaking changes ❗
lorem ipsum

👉 Bug fixes

  • one
  • two
  • three

👉 New features

  • one
  • two
  • three

👉 Improvements

  • one
  • two
  • three

👉 Internal changes

  • one
  • two
  • three
  • bumped version to ...

👉 Credits

Special thanks for ideas, feature requests and testing go out to: ... .

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