Skip to content

Feature parity with YAML version and shNG Plugin, richer control-circuit model and advanced diagnostics

Choose a tag to compare

View all tags
@Tom-Bom-badil Tom-Bom-badil released this 30 Aug 11:40
· 12 commits to main since this release
3.0.0
9c3d34b

Version 3.0.0 - Major milestone
Feature parity reached, base functionality completed, registers/coils audits completed
All known Trovis models are auto-detected and auto-configured

With this release, trovis-modbus has reached and in several areas surpassed the functional scope previously provided by the legacy Home Assistant YAML configuration and the SmartHomeNG plugin.

The library now provides a substantially more complete, model-aware and reusable representation of SAMSON TROVIS 557x controllers while remaining independent of Home Assistant and of the underlying Modbus transport.

What's new

Expanded heating-circuit support

  • Added and refined model-, hydronic-system- and control-circuit-aware datapoint availability.
  • Improved handling of Rk1-Rk3 roles and controller-specific capabilities.
  • Added additional heating-circuit functions and parameters required for practical controller monitoring and adjustment.
  • Added PI/PID and two-point control parameters where supported.
  • Added support for the configured control type and related controller functions.
  • Refined room-unit / remote-transmitter semantics, including correct handling of FG inputs depending on their configured role.
  • Added model- and circuit-aware support for TROVIS 5570 room control units.
  • Added and refined Optimization and Adaptation related capabilities.

Heating-curve calculation

  • Added a common, transport-independent heating-curve calculation backend.
  • Supports all three TROVIS setpoint-generation modes:
    • gradient characteristic,
    • four-point characteristic,
    • fixed setpoint.
  • Day and night curves are calculated separately.
  • Four-point characteristics are linearly interpolated between the configured points and keep the P1/P4 boundary values outside the configured point range.
  • Fixed-setpoint mode returns constant day/night curves.
  • The same calculation backend is available to applications such as the Home Assistant simulation helpers, avoiding duplicate heating-curve implementations.

Pumps, valves and overall controller state

  • Added/refined canonical pump and valve state information.
  • Added SystemOverallStatus, an 8-bit actuator-status matrix covering:
    • Rk1 valve,
    • Rk2 valve,
    • Rk3 valve,
    • storage tank charging pump,
    • circulation pumps UP1/UP2/UP3,
    • DHW circulation pump.

The existing SystemActivity logic remains unchanged and separate.

Improved controller diagnostics

  • Added the raw controller model code as diagnostic information.
  • Expanded metadata and availability information for model-, circuit- and configuration-dependent datapoints.
  • Improved handling of physical sensor / input semantics and unsupported combinations.

Manual read exclusions

A new per-device support mechanism allows applications to exclude individual zero-based Modbus register or coil addresses from reading.

This is intended primarily as a troubleshooting tool for controller models, hardware revisions or firmware versions where individual addresses are known to reject Modbus reads.

Excluded addresses are removed from the actual readable ranges, so no generated block read will span across them.

Example: 22,33-47,119

This is deliberately a runtime/device-specific override; the normal model address maps remain unchanged.

Architecture

trovis-modbus remains transport-independent.

Applications provide a modbus_connection.ModbusUnit, while the library handles:

  • controller and hydronic-system discovery,
  • controller-specific datapoint availability,
  • neutral metadata,
  • grouped reads,
  • validated writes,
  • write-access handling,
  • derived controller states,
  • heating-curve calculation.

Compatibility

Supported SAMSON TROVIS 557x controllers and compatible OEM variants continue to use their corresponding TROVIS model profiles.

This release does not attempt to reproduce every controller menu or commissioning function. Its scope remains operational monitoring and fine adjustment of already commissioned heating systems.

Assets 2
Loading