ZOOM – Lutron HomeWorks QS Gateway v20261121

Driver: Control4 DriverWorks Plataforma: Lutron HomeWorks QS (processador) OS mínimo: 3.0

PT EN

Visão geral

Integra sistemas Lutron HomeWorks QS ao Control4 direto pelo processador HomeWorks QS, sem interface extra. O driver lê o projeto do processador e cria sozinho os drivers ZOOM Universal de cada luz, cortina e teclado, já com os nomes e os ambientes do projeto Lutron.

Pré-requisitos

Instalação

  1. Adicione o driver ZOOM – Lutron HomeWorks QS Gateway no Composer Pro.
  2. Preencha IP Address com o IP do processador e Login / Password com o login de integração do projeto HomeWorks QS.
  3. Com Connection Status = Connected, a descoberta roda sozinha na primeira conexão (ou execute Discover Devices).
  4. Os drivers Universal são criados e conectados automaticamente, cada um no ambiente do Control4 com o nome da área do projeto Lutron. Os ambientes que ainda não existem são criados no mesmo andar do gateway.
Requisito: os drivers ZoomDH_Universal_Light.c4z, ZoomDH_Universal_Blind.c4z e ZoomDH_Universal_Keypad.c4z precisam estar no controlador. Se a criação automática falhar, adicione manualmente uma instância de cada tipo pelo Composer (isso envia o driver ao controlador) e execute Create Missing Devices.

Descoberta

A descoberta usa o Integration Report do projeto, que o próprio processador fornece. Dele vêm os nomes das luzes, cortinas e teclados, as áreas, o tipo de cada saída e os nomes gravados nos botões. A origem aparece em Report Source.

Rodar a descoberta de novo depois de mudar o projeto Lutron acrescenta o que é novo e atualiza os nomes das conexões, sem duplicar nem apagar nada.

Dispositivos suportados

Item do projeto LutronDriver criadoObservações
Zona de luz com dimmer (incandescente, ELV, MLV, LED, DALI, EcoSystem, 0-10 V, GRAFIK Eye)Universal LightNível 0–100% com rampa e tempo de transição.
Saída liga/desliga (não dimerizável, contato)Universal Light (relé)Só liga e desliga.
Cortina Sivoia QS individualUniversal BlindPosição real 0–100%. Use Use Levels = On.
Grupo de cortinasUniversal BlindTodas as cortinas do grupo juntas, com posição.
Teclados (seeTouch, Palladiom, Architrave, Signature, Hybrid, Tabletop, Dynamic), Pico e interfaces de contatoUniversal KeypadAté 10 botões por teclado, com o nome gravado. Eventos de apertar, soltar e segurar.
Botões do processador (teclados virtuais)—Acionados pelo comando Press Keypad Button.
Sensores, HVAC e demais itens—Ignorados.

Teclados com mais de 10 botões ficam com os 10 primeiros no Control4 e aparecem em Notes. Os demais botões continuam disponíveis no comando Press Keypad Button.

Nomes e ambientes

Depois de criados, os dispositivos podem ser renomeados e movidos livremente: a ligação com o item Lutron não muda.

Teclados e LEDs

Propriedades

PropriedadeDescrição
IP AddressIP do processador HomeWorks QS.
PortPorta de integração (padrão 23).
Login / PasswordLogin de integração criado no software HomeWorks QS.
Connection StatusSituação da conexão.
Discovered DevicesQuantidade de luzes, cortinas e teclados encontrados.
Integration Report URLEm branco (padrão): o relatório vem do processador. Preencha só se o relatório estiver em outro endereço.
Report SourceDe onde veio a última descoberta e o nome do projeto Lutron.
NotesAvisos da descoberta (ex.: teclados com mais de 10 botões).
Auto Create DevicesNew Only (padrão): cria só o que a descoberta encontrou pela primeira vez; um driver apagado de propósito não volta. New and Missing: recria também os que faltam. No: não cria nada sozinho.
Auto Discover On ConnectRoda a descoberta na primeira conexão, se ainda não houver nada descoberto.
Device RoomLutron Area (create if missing) (padrão): ambiente com o nome da área Lutron, criado se não existir. Lutron Area (existing rooms only): usa só ambientes que já existem. Gateway Room: tudo no ambiente do gateway.
Control Keypad LEDsPermite que o Control4 acenda e apague os LEDs dos teclados Lutron.
License Key / License StatusLicença do driver (ver Licenciamento).
Log Level / Log ModeDetalhe do log para diagnóstico.

Ações

AçãoDescrição
Discover DevicesLê o projeto do processador. Rodar de novo não duplica nada e acrescenta itens novos.
Create Missing DevicesCria os drivers Universal que estiverem faltando.
Refresh AllAtualiza o nível de todas as luzes e cortinas.
ReconnectRefaz a conexão com o processador.
Press Keypad ButtonAperta um botão de um teclado ou do processador (para testar cenas do Lutron).
Show DevicesLista no log Lua o que foi encontrado e os drivers criados.
Send Command (diagnostics)Uso do suporte técnico (só com o modo de suporte ativo).
Clear DiscoveryRemove todas as conexões e o que foi descoberto (confirmação Yes). Os drivers Universal não são apagados.

Comandos

ComandoDescrição
Press Keypad ButtonAperta e solta (ou só aperta, ou só solta) o botão escolhido de um teclado ou do processador. O número do botão é o mesmo do projeto Lutron (nos botões do processador, o número do botão virtual).

Exemplo de programação

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

Diagnóstico

SintomaCausa provável / solução
Connection timeoutIP errado ou processador fora da rede.
Login failedLogin ou senha errados. Confira o login de integração no software HomeWorks QS e se o projeto foi transferido.
Report Source = Telnet (no names)O processador não entregou o relatório. Exporte o XML do projeto no software HomeWorks QS, coloque em um servidor da rede e informe em Integration Report URL; depois execute Discover Devices.
Item do projeto não apareceuEle não tem Integration ID no projeto Lutron, ou é de um tipo ignorado (ver Dispositivos).
Cortina apareceu como luzSó acontece sem relatório. Use o relatório (ver Descoberta).
Botão do teclado não dispara no Control4Confira se o teclado tem Integration ID e se o login de integração recebe eventos de botão.
Driver Universal não foi criadoDriver ausente no controlador; ver Requisito em Instalação.

Para investigar, use Log Level = 5 - Trace e Log Mode = Print: toda a comunicação aparece na aba Lua do Composer.

Licenciamento

O que é controlado pela licença

OperaçãoTrial ativoTrial expirado
Conexão e descobertaOKOK
Retorno de níveis e botõesOKOK
Comandos de luz (nível, rampa)OKBloqueado
Comandos de cortina (abrir, fechar, posição)OKBloqueado
LEDs dos teclados e Press Keypad ButtonOKBloqueado

Suporte e Atualizações

Release Notes

VersãoDataDescrição
20261121 21/11/2026 Versão inicial: luzes, cortinas, grupos de cortinas e teclados do HomeWorks QS encontrados e criados automaticamente com os nomes e ambientes do projeto Lutron, LEDs dos teclados e botões do processador pela programação do Control4. Ambientes que faltam no Control4 são criados sozinhos.