Skip to content

Writing and write access

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

Reading a controller is relatively harmless. Writing to a heating controller is different, so the integration deliberately keeps the Home Assistant safety gate separate from the controller-side write logic.

This page documents the technical write path. For normal users, see Changing-settings-safely.


✍️ Writing values

Writing is part of the integration architecture because it crosses the boundary between Home Assistant and the controller model.

Writes pass through two different safety layers:

flowchart TD
    ENTITY["Home Assistant entity write"]
    GATE["Write access switch"]
    LIB["trovis-modbus write API"]
    MODBUS["Modbus write"]
    CTRL["Controller"]

    ENTITY --> GATE
    GATE --> LIB
    LIB --> MODBUS
    MODBUS --> CTRL
Loading

The controller-level Write access switch is the Home Assistant safety gate. After that gate has allowed a write, trovis-modbus remains authoritative for the controller-side write semantics and validation.

The integration should therefore use the library's public write API instead of writing raw Modbus addresses from an entity.

The exact Home Assistant entity platforms used for writable datapoints are documented in Devices-and-entities.

For user-facing information about enabling and using writes, see Changing-settings-safely.

For the library-side write model, see Datapoints, reading, and writing.




🚫 Do not write raw TROVIS addresses from entities

A Home Assistant entity should never contain its own TROVIS register or coil write such as:

await unit.write_register(123, value)

The datapoint, its valid range, encoding, access requirements and write preconditions belong in trovis-modbus.

The integration should only decide how that writable datapoint is represented in Home Assistant and whether the Home Assistant Write access gate currently allows the request.

This keeps the same controller-side write rules usable by Home Assistant, the library CLI, tests and other future consumers.


🧩 Writable Home Assistant entities

Depending on the datapoint, writable values can appear as normal Home Assistant platforms such as:

  • number,
  • select,
  • switch,
  • date,
  • time,
  • climate,
  • water_heater.

The entity structure itself is documented in Devices-and-entities.


📚 Related pages

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