Virtual thermostat driver for Control4, to control air conditioners by IR. The driver queries an online database for the list of compatible devices: whenever a model is updated or added, it becomes available for selection.
Search by air conditioner brand and model, or by remote control model.
Custom IR commands, shown in the Extras tab of the interfaces.
Compatible with the ZoomDH – Universal Thermostat Controller driver, to control several thermostats at once.
Prerequisites
A controller (or extender) IR output with the emitter placed on the air conditioner.
Internet access on the controller, for the device database query and for the license.
Installation
Add the driver to the project in Composer Pro and bind the IR Emitter connection to the IR output in use.
Enter the key in License Key.
Choose the search method in Select Search Method: air conditioner brand and model, or remote control model.
Select the brand in Device Brand and the model in Device Model, or the remote in Remote Model. Use Request Thermostat List to refresh the list from the server. The driver configures itself.
Check the chosen device in Device Selected and test the commands.
Custom commands
The driver accepts additional IR commands, which show in the Extras tab of the interfaces. Choose the action in Custom Commands:
Action
Description
Add New IR command
Adds a command: enter the name in Command Name and paste the hex IR code in Command IR Code.
Edit a IR command
Edits a command: select it in Command List and paste the new code in Command IR Code.
Delete a IR command
Deletes the command selected in Command List.
Show Commands in the LUA tab
Lists the commands in the Lua tab.
Export Extra Commands
Saves the custom commands so they can be imported into other instances of the driver.
Import Extra Commands
Imports the commands saved by another instance of the driver.
Properties
Property
Description
License Key
Driver license key.
License Status
License status and update information.
Control4 MAC Address
Controller MAC, used for licensing.
Driver Name / Driver Version
Name and version of the installed driver.
Log Level
Log detail level (0=Alert … 5=Trace).
Log Mode
Log destination: Off / Print / Log / Print and Log.
Driver Information
Driver status messages.
Thermostat Type
Control type. Currently IR only.
IR Repeat Count
Number of times the IR code is sent. Default: 1.
Select Search Method
Database search method: air conditioner brand and model, or remote control model.
Device Brand
Device brand. Request Thermostat List refreshes the list from the server.
Device Model
Device model, listed after the brand is chosen.
Remote Model
Remote control model, when searching by remote.
Remote Image
URL with the picture of the selected remote control, when the database has one.
Device Selected
Device selected for control.
Send Power On First
Yes: sends a power on command before the first mode command when the unit is off. Default: No.
HVAC Modes / Fan Modes
Operation modes and fan speeds available for the selected device.
Hide Heating Mode
Yes: hides heating mode from the interfaces. Default: No.
Cool Min / Max and Heat Min / Max
Cooling and heating setpoint limits.
Room Temperature C
Room temperature used by the thermostat.
Custom Commands
Manages the custom IR commands (see the section above).
Connections
Connection
Use
IR Emitter
IR output that controls the air conditioner.
Slave
Link to the ZoomDH – Universal Thermostat Controller driver, to control several thermostats at once.
Temperature In
Input for a temperature sensor.
On Button Link
Turns the thermostat on in the last mode and temperature used, with no programming.
Off Button Link
Turns the thermostat off.
Toggle Button Link
Toggles the thermostat state (on/off).
Troubleshooting
Empty brand list: the controller needs internet access and a valid license (or trial period); select Request Thermostat List in Device Brand.
The unit does not respond to some commands: increase IR Repeat Count and check the emitter position.
The first command only turns the unit on, without applying the mode: enable Send Power On First.
License deactivated right after entering the key: the controller needs internet access.
Licensing
30-day trial included; remaining time shown in License Status.
After purchasing a license, enter the key in License Key. The status changes to Activated.
The controller needs internet access for activation and periodic re-verification.
Once a day, also during the trial, the driver reports technical data of the installation to the license server (controller model and version, driver version, project name and license state). No personal data is sent. When a new driver version is available, it shows in License Status with the link to the driver page on the website.
The driver now reports the installation's technical data to the license server once a day, which speeds up support. It also shows in License Status when a new driver version is available.
20261028
10/28/2026
Model list and IR codes are now released only to a licensed driver or one in its trial period. Models without discrete on and off commands: the normalizing command is now always sent before turning on and off, including installations where the model was already selected.
20261014
10/14/2026
Thermostat list and IR codes loaded from the new site address (zoomdigitalhome.com.br), fixing the empty brand and model lists. The files are now served only to the driver.
20261012
12/10/2026
Licensing library update.
20260828
28/08/2026
Workaround for models without discrete on/off commands.
20260707
07/07/2026
Minor fixes.
316
11/03/2026
Made the Send Power On First command compatible with the SWING ON / SWING OFF version.
315
19/08/2025
Fixed an error in the decimal number conversion function.
314
17/07/2025
Fixed the conversion of temperatures using "," instead of "." as the decimal separator.
313
16/07/2025
Added support for the SWING ON and SWING OFF modes, in the Extras tab.
312
22/05/2025
Added support for fan speeds in dehumidify mode.
311
12/03/2023
Added support for fan speeds with a space in the name.
310
15/07/2024
Adjusted the Preset Changed event call.
309
24/05/2024
Added support for the multiple thermostat control driver.
308
22/05/2024
Added support for custom commands.
307
21/05/2024
Fixed the Send Power On First command.
306
01/02/2024
Added support for presets and schedules.
305
05/12/2023
Fixed an error in a temperature scale parameter variable.
304
23/06/2023
Fixed an error in the setpoint up and down commands.
303
12/06/2023
Adjusted the fan mode code.
302
07/03/2023
Added fan mode and the property to hide heating mode from the interfaces.