Overview
The 4Drivers Tholz RGBW driver emulates a native Control4 lighting card (light_v2 proxy) for the pool's RGBW lighting, mirroring the state controlled by the 4Drivers Tholz SmartPool UI driver. It is a Tholz-dedicated companion driver: it no longer supports the other lighting integrations (Controlart RGB, Hubitat, HDL SBUS Piero) that existed in the original universal version.
- Standard Control4 lighting card with color wheel, brightness and effects
- All communication logic with the equipment lives in the 4Drivers Tholz SmartPool UI — this driver only mirrors state through the
4Drivers_RGBW_TholzControl binding
- Supports the Tholz equipment's built-in preset effects through a custom preset (the Effect command)
- The Integration property is locked to
Others — properties from other integrations stay hidden in the Composer screen
This driver does not work on its own. It needs to be connected to the 4Drivers Tholz SmartPool UI driver through the 4Drivers_RGBW_TholzControl connection to send and receive lighting commands.
Requirements
- The 4Drivers Tholz SmartPool UI driver already installed and configured in the same project
- Control4 OS 3.0.0 or higher
Properties
Light Behavior
| Property | Type | Default | Description |
|---|
| Effects List | Text | — | List of available effects, used by the Effect command's custom preset |
| Supports CCT | List | True | Whether the driver emulates correlated color temperature (CCT) support |
| CCT Min / CCT Max | Number | 500 / 4000 | Emulated CCT range (Kelvin) |
| Color Rate Min / Color Rate Max | Number | 0 / 3600000 | Emulated color transition time range (ms) |
| Feedback from Protocol | List | Yes | Whether the driver expects state feedback from the protocol (Yes, No or Imediate Levels) |
| Show Speed Transitions | List | Yes | Shows (Yes) or hides (No) the transition speed control on screen |
| Speed Transitions | Number | 50 | Color/brightness transition speed (0-100), shown when Show Speed Transitions = Yes |
Color Calibration
| Property | Type | Default | Description |
|---|
| RED / GREEN / BLUE | Number | 0 | Fine calibration adjustment for each color channel (-100 to 100) |
Driver Info
| Property | Type | Default | Description |
|---|
| Driver Version | Text | — | Installed driver version (read only) |
| Debug Mode | List | Off | Where debug logs are sent (Off, Print, Log, Print and Log) |
| Debug Level | List | Off | Debug log detail level. Keep it Off unless instructed by support |
| Debug Duration Minutes | Number | 15 | Minutes before Debug Mode automatically returns to Off (0-1440) |
Several properties from the original universal template are hidden in the Composer screen on this Tholz-dedicated driver, since they no longer apply: Integration, Module ID, Modules ID, Config, Message, Show White Ch on Extras, Color Rate, Color Space, Dimmable, Has Gain Control, Supports Color, Driver Specific Test Presets, plus every SBUS property (Subnet, Device ID, Channels). Their values stay locked internally to the correct defaults for Tholz (for example, Has Gain Control = Yes and Supports Color = True, both required for brightness control to work correctly with the SmartPool UI).
Commands (Programming)
| Command | Description |
|---|
| Effect | Applies one of the Tholz equipment's built-in preset effects (chosen through a custom preset selector) |
The remaining color, brightness and on/off commands are the standard commands of Control4's native lighting proxy (light card), automatically available in project programming.
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 4Drivers_RGBW_TholzControl connection to the connection of the same name (binding 999) on 4Drivers Tholz SmartPool UI
- The 4Drivers Universal White Light connection (class
4Drivers_Universal_Light) remains available for legacy scenarios with a separate white-channel driver, but is not required in a standard Tholz installation
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 RGBW and drag the driver into the project
2 — Bind to the SmartPool UI
- In the Composer Connections tab, bind this driver's 4Drivers_RGBW_TholzControl connection to the connection of the same name on the 4Drivers Tholz SmartPool UI driver
3 — Configure Navigator visibility
In the room/location properties, Navigator tab, set the driver as Visible in the desired lighting Experience Menu.
4 — Verify
- Open the lighting card on the Navigator and test on/off, color and brightness
- Confirm the state matches what's shown in the 4Drivers Tholz SmartPool UI HTML interface
Setup complete.
Troubleshooting
| Problem | Solution |
|---|
| The lighting card doesn't respond to commands | Check the 4Drivers_RGBW_TholzControl binding with the 4Drivers Tholz SmartPool UI driver, and whether it's connected to the equipment (Connection property on the SmartPool UI) |
| Brightness doesn't change correctly | Make sure the driver is on the current version — older versions relied on Has Gain Control, now locked to Yes internally |
| Effects don't show up | Check the Effects List property and use the Effect command in programming |
Technical Information
| Item | Value |
|---|
| Proxy | light_v2 — native Control4 lighting card |
| Main binding | Class 4Drivers_RGBW_TholzControl, connected to 4Drivers Tholz SmartPool UI |
| Origin | Converted from the universal "4Drivers Universal RGB v2" driver, with non-Tholz integrations removed/hidden |
| License | No validation/trial system — the driver always runs unlocked |
| Minimum OS | Control4 3.0.0 |
Change Log
| Version | Changes |
|---|
| 1100 | Driver converted from "4Drivers Universal RGB v2" to a Tholz-dedicated driver. Renamed to 4Drivers Tholz RGBW; connection renamed from "4Drivers RGB Control" to 4Drivers_RGBW_TholzControl; properties from other integrations (Controlart RGB, Hubitat, HDL SBUS Piero) hidden; license/trial validation system removed; Has Gain Control property set to Yes (required for brightness control to work with the SmartPool UI) |