I’ve developed a custom Home Assistant integration for managing weekly heating schedules stored directly on compatible SONOFF radiator valves, such as the TRV-ZBT, connected through ZHA.
The panel allows you to:
- View existing weekly heating schedules.
- Create new schedules and edit existing ones.
- Copy schedules between days and valves.
- Send schedules to a valve and read them back to verify the result.
Installation
The integration is available through HACS. Add the repository as a custom repository (category: Integration) and install it.
Note: Until support is added to ZHA, the appropriate SONOFF ZHA quirk must be installed separately. It provides access to the schedule entities and private cluster commands used by the panel. The quirk is published by SONOFF (TRV-ZBT_ZHA_Script.zip), and a copy is also included in the quirks/ folder of the repository. See the GitHub repository for the full installation instructions.
GitHub repository: GitHub - 3jam3/sonoff-trv-schedule: Home Assistant panel for managing weekly schedules of SONOFF TRV valves (ZHA) · GitHub
Or use this button to open the repository in HACS on your Home Assistant instance:
Requirements
- Home Assistant with the ZHA integration (tested on Home Assistant 2026.10.3).
- A compatible SONOFF radiator valve.
Important: The integration currently supports the SONOFF TRV-ZBT. It is not intended for the older SONOFF TRVZB!
Note: Selecting a schedule to fetch or write switches the active schedule on the valve, and any logged-in Home Assistant user (including read-only accounts) can change schedules from the panel.
The project is currently in development. Feedback, testing reports and suggestions are welcome!
