ZOOM – Lutron HomeWorks QS Gateway v20261121

Driver: Control4 DriverWorks Platform: Lutron HomeWorks QS (processor) Minimum OS: 3.0

PT EN

Overview

Integrates Lutron HomeWorks QS systems with Control4 directly through the HomeWorks QS processor, with no extra interface. The driver reads the processor's project and creates the ZOOM Universal drivers for every light, shade and keypad on its own, already with the names and rooms from the Lutron project.

Prerequisites

Installation

  1. Add the ZOOM – Lutron HomeWorks QS Gateway driver in Composer Pro.
  2. Fill in IP Address with the processor IP and Login / Password with the integration login of the HomeWorks QS project.
  3. Once Connection Status = Connected, discovery runs on its own on the first connection (or run Discover Devices).
  4. The Universal drivers are created and connected automatically, each one in the Control4 room named after its area in the Lutron project. Rooms that do not exist yet are created on the same floor as the gateway.
Requirement: the ZoomDH_Universal_Light.c4z, ZoomDH_Universal_Blind.c4z and ZoomDH_Universal_Keypad.c4z drivers must be on the controller. If automatic creation fails, manually add one instance of each type in Composer (this sends the driver to the controller) and run Create Missing Devices.

Discovery

Discovery uses the project's Integration Report, which the processor itself provides. It carries the names of lights, shades and keypads, the areas, the type of each output and the names engraved on the buttons. The source is shown in Report Source.

Running discovery again after changing the Lutron project adds whatever is new and updates the connection names, without duplicating or deleting anything.

Supported devices

Lutron project itemDriver createdNotes
Dimmed lighting zone (incandescent, ELV, MLV, LED, DALI, EcoSystem, 0-10 V, GRAFIK Eye)Universal LightLevel 0–100% with ramp and fade time.
On/off output (non-dim, contact closure)Universal Light (relay)On and off only.
Individual Sivoia QS shadeUniversal BlindReal position 0–100%. Use Use Levels = On.
Shade groupUniversal BlindAll shades of the group together, with position.
Keypads (seeTouch, Palladiom, Architrave, Signature, Hybrid, Tabletop, Dynamic), Pico and contact closure interfacesUniversal KeypadUp to 10 buttons per keypad, with the engraved names. Press, release and hold events.
Processor buttons (virtual keypads)—Pressed with the Press Keypad Button command.
Sensors, HVAC and other items—Ignored.

Keypads with more than 10 buttons keep the first 10 in Control4 and are listed in Notes. The other buttons remain available in the Press Keypad Button command.

Names and rooms

Once created, devices can be renamed and moved freely: the link with the Lutron item does not change.

Keypads and LEDs

Properties

PropertyDescription
IP AddressHomeWorks QS processor IP.
PortIntegration port (default 23).
Login / PasswordIntegration login created in the HomeWorks QS software.
Connection StatusConnection state.
Discovered DevicesNumber of lights, shades and keypads found.
Integration Report URLBlank (default): the report comes from the processor. Fill in only if the report is at another address.
Report SourceWhere the last discovery came from and the Lutron project name.
NotesDiscovery warnings (e.g. keypads with more than 10 buttons).
Auto Create DevicesNew Only (default): creates only what discovery found for the first time; a driver deleted on purpose does not come back. New and Missing: also recreates missing ones. No: creates nothing on its own.
Auto Discover On ConnectRuns discovery on the first connection if nothing has been discovered yet.
Device RoomLutron Area (create if missing) (default): room named after the Lutron area, created if missing. Lutron Area (existing rooms only): only rooms that already exist. Gateway Room: everything in the gateway's room.
Control Keypad LEDsLets Control4 turn the Lutron keypad LEDs on and off.
License Key / License StatusDriver license (see Licensing).
Log Level / Log ModeLog detail for troubleshooting.

Actions

ActionDescription
Discover DevicesReads the processor's project. Running it again duplicates nothing and adds new items.
Create Missing DevicesCreates any missing Universal drivers.
Refresh AllRefreshes the level of every light and shade.
ReconnectReconnects to the processor.
Press Keypad ButtonPresses a button of a keypad or of the processor (to test Lutron scenes).
Show DevicesLists what was found and the drivers created in the Lua log.
Send Command (diagnostics)For technical support (only with support mode on).
Clear DiscoveryRemoves every connection and everything discovered (confirm with Yes). The Universal drivers are not deleted.

Commands

CommandDescription
Press Keypad ButtonPresses and releases (or only presses, or only releases) the chosen button of a keypad or of the processor. The button number is the same as in the Lutron project (for processor buttons, the virtual button number).

Programming example

When  Keypad Entry → Button 1 pressed
Do    ZOOM Lutron HomeWorks QS Gateway → Press Keypad Button "Processor 1 [1]" button 5

Troubleshooting

SymptomLikely cause / fix
Connection timeoutWrong IP or processor off the network.
Login failedWrong login or password. Check the integration login in the HomeWorks QS software and that the project was transferred.
Report Source = Telnet (no names)The processor did not provide the report. Export the project XML from the HomeWorks QS software, put it on a web server on the network and enter it in Integration Report URL; then run Discover Devices.
Project item did not show upIt has no Integration ID in the Lutron project, or its type is ignored (see Devices).
Shade showed up as a lightOnly happens without the report. Use the report (see Discovery).
Keypad button does not trigger in Control4Check that the keypad has an Integration ID and that the integration login receives button events.
Universal driver was not createdDriver missing on the controller; see Requirement in Installation.

To investigate, use Log Level = 5 - Trace and Log Mode = Print: all communication shows in Composer's Lua tab.

Licensing

What the license controls

OperationTrial activeTrial expired
Connection and discoveryOKOK
Level and button feedbackOKOK
Light commands (level, ramp)OKBlocked
Shade commands (open, close, position)OKBlocked
Keypad LEDs and Press Keypad ButtonOKBlocked

Support and Updates

Release Notes

VersionDateDescription
20261121 11/21/2026 First release: HomeWorks QS lights, shades, shade groups and keypads found and created automatically with the names and rooms from the Lutron project, keypad LEDs and processor buttons from Control4 programming. Missing Control4 rooms are created automatically.