Overview
The 4Drivers Tholz SmartPool UI driver is the central hub for Tholz SmartPool pool automation on Control4. It connects directly to the Tholz SmartPool module over the network (TCP/IP) and provides a built-in HTML interface with every lighting, heating and relay control on a single screen — with no dependency on any other driver.
- Controls RGBW/RGB/Mono pool lighting: on/off, color, effects, RGB brightness and dedicated white channel
- Controls up to 2 heat exchangers (heating) and up to 5 auxiliary relays
- Reads and displays up to 4 extra temperature sensors from the equipment
- Built-in responsive HTML interface, available on any Control4 Navigator, with Portuguese/English/Spanish language support
- Can feed native Control4 companion drivers so each function shows up with the platform's standard card:
4Drivers Tholz RGBW (native lighting card) and 4Drivers Tholz Thermostat (native thermostat card, one per heat exchanger)
- Compatible with Modern and Legacy SmartPool equipment
HTML Interface
Available on any Control4 Navigator — physical touchscreen, iOS/Android app, and browser.
| Section | Description |
|---|
| Home Screen | Lighting, heat exchanger, relay and extra temperature cards — each shown only if it has a name configured in the properties |
| Colors Button | Opens the lighting color wheel and effects. The button itself shows a small dot with the currently selected RGB color |
| Color Wheel / Effects | Free RGB color selection and selection of the equipment's built-in preset effects (Estatico, Verde-Azul, RGB Strobo, etc.) |
| White Channel | Dedicated white channel (RGBW) brightness bar, shown only if White Channel Name is filled in |
| Heat Exchangers | On/off and heating mode (On/Automatic) for each configured heat exchanger |
| Relays | On/off for each configured auxiliary relay |
| Language | Portuguese, English or Spanish — switched through the Language property |
Requirements
- A Tholz SmartPool module installed and connected to the local network (a fixed/reserved IP is recommended)
- The module's IP address and TCP port (default
4000)
- Control4 OS 3.0.0 or higher
- (Optional) The 4Drivers Tholz RGBW driver for a native lighting card
- (Optional) The 4Drivers Tholz Thermostat driver — one instance per heat exchanger — for a native thermostat card
Properties
General
| Property | Type | Default | Description |
|---|
| Language | List | Portuguese | HTML interface language: Portuguese, English or Spanish |
| Debug Mode | List | Off | When set to Print, shows traffic with the Tholz module in the Composer log. Turn it off after commissioning |
| License Key | Text | Trial | 4Drivers license key |
| Validation | Text | — | License validation state (read only) |
| Developer Restricted | Password | — | For developer use |
| Check Network and Channels - Seconds | Number | 60 | Interval, in seconds, between checks of the network connection and channel status (15 to 100s) |
| Delay Between Commands | Number | 400 | Wait time in milliseconds between commands sent to the module. Shorter intervals can cause command interpretation issues (10 to 1000ms) |
| SmartPool Version | List | Modern | Tholz SmartPool equipment version: Modern or Legacy |
| Lighting Type | List | RGBW | Type of lighting installed in the pool: RGBW, RGB or Mono |
Light
| Property | Type | Default | Description |
|---|
| Light Name | Text | — | Name shown for the lighting on screen (card title and details screen). Left blank, the default name ("Lights") is used |
| RGB Name | Text | — | Name for the RGB control (color wheel and effects). If filled in, the wheel and effect selector show up on screen; if empty, they stay hidden |
| White Channel Name | Text | — | Name for the dedicated white channel control (RGBW). If filled in, the white channel bar shows up on screen; if empty, it stays hidden |
| White Light Control | List | Independent | How the dedicated white channel reacts to RGB commands — both from the driver itself (screen/Composer) and from the connected RGB driver (4Drivers_RGBW_TholzControl). See details below |
White Light Control — Independent: the white channel is not affected by RGB commands.
Turns Off with RGB: the white channel turns off together with the RGB when it turns off.
Follow RGB Levels: the white channel follows the RGB brightness level, always sent in the same command/JSON — not as a separate command.
Connection
| Property | Type | Default | Description |
|---|
| Module IP | Text | — | IP address of the Tholz SmartPool module on the local network |
| Tholz Port | Number | 4000 | Module TCP port (1 to 65536) |
| Connection | Text | — | Current connection state with the module (read only) |
| Driver Version | Text | — | Installed driver version (read only) |
| Firmware 1 / Firmware 2 | Text | — | Firmware versions reported by the equipment (read only) |
| Message | Text | — | Temporary status message from the driver (read only) |
| Send String | Text | — | Manually send a raw string to the module (advanced/support use) |
Thermostat Names (Driver Screen)
| Property | Type | Default | Description |
|---|
| Thermostat 1 / Thermostat 2 | Text | — | Name shown on screen for the 1st/2nd heat exchanger (heat0/heat1 on the equipment). Left blank, the card is hidden |
Relay Names (Driver Screen)
| Property | Type | Default | Description |
|---|
| Relay Name 1 through 5 | Text | — | Name shown on screen for each auxiliary relay (out0 through out4 on the equipment). Left blank, the relay card is hidden |
Extra Temperatures (Driver Screen)
| Property | Type | Default | Description |
|---|
| Temperature 1 through 4 | Text | — | Name shown on screen for the temperature sensor (fields T1 through T4 on the equipment). Left blank, it's hidden |
| Temperature 1 through 4 - Thermostat | List | Heat 0 | Which heat exchanger (Heat 0 or Heat 1) provides the value for this temperature sensor |
Commands (Programming)
| Command | Description |
|---|
| Heating Mode | Sets the default heating mode (On or Automatic) |
| Send Colors | Sends an RGB value directly to the lighting (R, G, B from 0 to 255) |
| Send White Channel Level | Sets the dedicated white channel level (0-255, RGBW only) and turns the lighting on |
| Set RGB Brightness | Sets the RGB brightness level (0-100%) and turns the lighting on |
| Set Light Effect | Sets the lighting effect (Estatico keeps the last configured color; the others are the equipment's built-in cycling effects) |
| RGB Control | Turns the RGB on/off (On keeps the last configured color and white level) |
| White Control | Turns the dedicated white channel on/off (On forces it to maximum/255 and turns the lighting on; Off sets it to zero) |
| Trigger Relay | Turns a specific heat exchanger or relay on/off (Heat 0/Heat 1 or Relay 1 through 5) |
Companion Drivers (optional)
The 4Drivers Tholz SmartPool UI works on its own, with its own HTML interface. For the lighting and heat exchangers to also show up as native Control4 cards (the same screen type used by factory drivers), install the companion drivers below.
| Driver | Function | Connection |
|---|
| 4Drivers Tholz RGBW | Native lighting card (light_v2) — color, brightness, effects | Bind the RGBW driver's 4Drivers_RGBW_TholzControl connection to this connection property (binding 999) on the SmartPool UI |
| 4Drivers Tholz Thermostat | Native thermostat card (thermostatV2) — one instance per heat exchanger | Bind the Thermostat's "Trocador Calor (4Drivers_Tholz_SmartPool_UI)" connection to Trocador Calor 1 or Trocador Calor 2 on this driver |
See the 4Drivers Tholz RGBW and 4Drivers Tholz Thermostat driver documentation for installation and usage details of each.
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 SmartPool and drag the 4Drivers_Tholz_SmartPool_UI driver into the project
2 — Configure the connection to the module
- In Properties, fill in Module IP with the Tholz SmartPool module's network IP
- Check/adjust Tholz Port (default 4000)
- Watch the Connection property to confirm the driver connected successfully
3 — Configure the lighting
- Set Lighting Type (RGBW, RGB or Mono) to match the installed equipment
- Fill in Light Name, RGB Name and (if RGBW) White Channel Name — each filled-in name shows the respective control on screen
- If applicable, set White Light Control (Independent, Turns Off with RGB or Follow RGB Levels)
4 — Configure heat exchangers, relays and temperatures
- Fill in the names under Thermostat Names, Relay Names and Extra Temperatures to match the installed equipment — leave blank whatever doesn't exist
- For the extra temperature sensors, select which heat exchanger (Heat 0/Heat 1) each reading comes from
5 — (Optional) Install the companion drivers
- Add the 4Drivers Tholz RGBW driver and bind its
4Drivers_RGBW_TholzControl connection to the SmartPool UI
- Add one instance of the 4Drivers Tholz Thermostat driver per heat exchanger and bind it to Trocador Calor 1 or Trocador Calor 2
6 — Configure Navigator visibility
In the room/location properties, Navigator tab, set the driver as Visible in the desired Experience Menu.
7 — Finish up
- Make sure Debug Mode is set to
Off
- Test the lighting, heat exchangers and relays through the HTML interface
Setup complete.
Troubleshooting
| Problem | Solution |
|---|
| The Connection property shows a failure/disconnected state | Check Module IP and Tholz Port. Make sure the module is powered on and on the same network as the controller |
| The HTML interface doesn't list the lighting | Make sure RGB Name and/or White Channel Name are filled in |
| A heat exchanger or relay doesn't show up | Check the corresponding name under Thermostat Names/Relay Names in Properties |
| Commands seem to "step on" each other | Increase Delay Between Commands |
| The companion drivers' native lighting/thermostat card doesn't reflect the HTML interface | Check the binding between the companion drivers and this driver (see "Companion Drivers") |
Technical Information
| Item | Value |
|---|
| Protocol | Direct TCP/IP to the Tholz SmartPool module (JSON), configurable port (Tholz Port) |
| Proxy | uibutton — built-in HTML interface, no companion proxy required |
| Companion bindings | Class 4Drivers_RGBW_TholzControl (lighting) and 4Drivers_Tholz_Thermostat (thermostat, up to 2 instances) |
| Persistence | Lighting state, license and configuration stored in PersistData — survive a controller reboot |
| Minimum OS | Control4 3.0.0 |
Change Log
| Version | Changes |
|---|
| 1100 | Added the White Light Control property (Independent / Turns Off with RGB / Follow RGB Levels); added RGB Name and White Channel Name with conditional display of their respective controls; lighting properties grouped under the Light label; the home screen's Colors button now shows the currently selected RGB color |