Overview
The 4Drivers Tholz Thermostat driver emulates a native Control4 thermostat card (thermostatV2 proxy) for the heating of a Tholz SmartPool equipment's heat exchanger. It is a Tholz-dedicated companion driver: one instance of this driver must be added for each heat exchanger in the system (up to 2 on the SmartPool equipment).
- Standard Control4 thermostat card — on/off (Off/Heat) and heating setpoint adjustment
- All communication with the equipment lives in the 4Drivers Tholz SmartPool UI — this driver only mirrors state through the "Trocador Calor" (Heat Exchanger) connection
- The thermostat card's Fan Mode field is repurposed to represent the Tholz's 5 operation modes: Ligado (On), Automatico (Automatic), Economico (Economic), Aquecer (Heat) and resfriar (Cool)
- Supports standard Control4 Presets and scheduling
- Configurable setpoint limits (Heat Set Point Min/Max)
This driver does not work on its own. It needs to be connected to the 4Drivers Tholz SmartPool UI driver to send and receive heating commands.
Requirements
- The 4Drivers Tholz SmartPool UI driver already installed and configured in the same project
- One instance of this driver for each heat exchanger to be exposed as a native thermostat
- Control4 OS 3.0.0 or higher
Properties
Tholz SmartPool
| Property | Type | Default | Description |
|---|
| Debug Mode | List | Off | Used by the developer or support. Default Off |
Modes and Settings
| Property | Type | Default | Description |
|---|
| Message | Text | — | Driver status message (read only) |
Fan Modes
| Property | Type | Default | Description |
|---|
| Show Ligado | List | Yes | Shows the "Ligado" (On) mode in the card's operation mode (Fan Mode) list |
| Show Automatico | List | Yes | Shows the "Automatico" (Automatic) mode in the card's operation mode (Fan Mode) list |
| Show Economico | List | Yes | Shows the "Economico" (Economic) mode in the card's operation mode (Fan Mode) list |
| Show Aquecer | List | Yes | Shows the "Aquecer" (Heat) mode in the card's operation mode (Fan Mode) list |
| Show resfriar | List | No | Shows the "resfriar" (Cool) mode in the card's operation mode (Fan Mode) list. Off by default, since most Tholz SmartPool equipment has no cooling |
Each property controls whether the corresponding mode appears as an option in the thermostat card's Fan Mode selector and in the mode list available on the Presets tab — the same logic used by the universal 4Drivers Thermostat Universal driver when configured for Tholz SmartPool (a fixed "Supported" list of all 5 modes, with an "allowed" subset sent dynamically to the card). At least one mode always stays enabled.
Limits (Temperature Settings)
| Property | Type | Default | Description |
|---|
| Scale | List | Celsius | Temperature scale (Celsius only, read only) |
| Heat Set Point Min | Number | 20 | Minimum allowed heating setpoint temperature (10 to 80) |
| Heat Set Point Max | Number | 40 | Maximum allowed heating setpoint temperature (10 to 80) |
Driver Info
| Property | Type | Default | Description |
|---|
| Version | Text | — | Installed driver version (read only) |
Operation Modes (Fan Mode)
The Control4 thermostat card has no native field for the Tholz operation modes, so they are mapped onto the card's Fan Mode field:
| Mode | Description |
|---|
| Ligado (On) | Heat exchanger continuously on |
| Automatico (Automatic) | Automatic control based on the setpoint |
| Economico (Economic) | Equipment's economic operation mode |
| Aquecer (Heat) | Heating mode |
| resfriar (Cool) | Cooling mode (when supported by the equipment) |
The card's Hvac mode (Off/Heat) controls whether the heat exchanger is off or operating according to the mode selected in Fan Mode.
Main Driver (required)
This driver is a companion to 4Drivers Tholz SmartPool UI, which handles all communication with the Tholz equipment.
- Bind this driver's Trocador Calor (4Drivers_Tholz_SmartPool_UI) connection to Trocador Calor 1 or Trocador Calor 2 on the 4Drivers Tholz SmartPool UI driver — one instance of this thermostat per heat exchanger
- The Room Selection connection (autobind, TEMPERATURE/TEMPERATURE_CONTROL classes) is used internally by Control4's own thermostat proxy
See the 4Drivers Tholz SmartPool UI driver documentation for the full system setup.
Step-by-Step Setup
1 — Add the driver to the project
- Copy the driver into the Composer drivers folder
Windows: C:\Users\[user]\Documents\Control4\Drivers\
- In Composer Pro, search for 4Drivers Tholz Thermostat and drag one instance of the driver into the project for each heat exchanger
2 — Bind to the SmartPool UI
- In the Composer Connections tab, bind this driver's Trocador Calor (4Drivers_Tholz_SmartPool_UI) connection to Trocador Calor 1 (for the first exchanger) or Trocador Calor 2 (for the second) on the 4Drivers Tholz SmartPool UI driver
3 — Adjust temperature limits
- In Properties, adjust Heat Set Point Min and Heat Set Point Max to match the equipment's safety limits
4 — Configure Navigator visibility
In the room/location properties, Navigator tab, set the driver as Visible in the desired climate Experience Menu.
5 — Verify
- Open the thermostat card on the Navigator and test on/off (Off/Heat), setpoint adjustment and mode (Fan Mode) selection
- Confirm the state matches what's shown in the 4Drivers Tholz SmartPool UI HTML interface
Setup complete.
Troubleshooting
| Problem | Solution |
|---|
| The thermostat card doesn't respond to commands | Check the "Trocador Calor" binding with the 4Drivers Tholz SmartPool UI driver, and whether it's connected to the equipment (Connection property on the SmartPool UI) |
| The setpoint won't accept the desired value | Check Heat Set Point Min and Heat Set Point Max — the setpoint is clamped to that range |
| The mode (Fan Mode) doesn't change | Confirm the 4Drivers Tholz SmartPool UI driver is online and that the corresponding heat exchanger is enabled on it |
Technical Information
| Item | Value |
|---|
| Proxy | thermostatV2 — native Control4 thermostat card |
| Main binding | Class 4Drivers_Tholz_Thermostat, connected to 4Drivers Tholz SmartPool UI (one instance per heat exchanger) |
| Capabilities | Heat only (can_cool=false, can_do_auto=false), single setpoint, 1°C resolution, 10-80°C setpoint range |
| Minimum OS | Control4 3.0.0 |
Change Log
| Version | Changes |
|---|
| 1100 | Initial Release |
| 2 | Added the Show Ligado, Show Automatico, Show Economico, Show Aquecer and Show resfriar properties, letting you choose which operation modes appear in the card's Fan Mode selector and in Presets (resfriar/Cool off by default) |