Driver Platform para Crestron Home que integra os processadores Lutron HomeWorks QSX e RadioRA 3 pelo protocolo LEAP, o mesmo usado pelo aplicativo da Lutron. Tem os mesmos recursos do driver ZoomDH Lutron LEAP Gateway para Control4.
Pareamento pelo app: toque em Parear e aperte o botão do processador.
Descoberta automática de zonas de luz, cortinas, teclados e cenas (virtual buttons). Cada zona e cada teclado vira um dispositivo filho no Crestron Home.
Feedback em tempo real por assinaturas LEAP (níveis das zonas e eventos dos botões), sem polling.
Conexão robusta: ping a cada 30 s e reconexão automática (5 a 60 s), com as assinaturas refeitas a cada reconexão.
Cortinas sem posição (OpenCloseStop) com acompanhamento do movimento pelos botões Lutron vinculados.
Pré-requisitos
Processador HomeWorks QSX ou RadioRA 3 com o projeto transferido pelo Lutron Designer.
Processador Crestron Home (4-Series) e o app Crestron Home Setup.
Processador Crestron e processador Lutron na mesma rede local, com as portas TCP 8081 (LEAP) e 8083 (pareamento) liberadas.
IP fixo (ou reserva de DHCP) no processador Lutron.
Acesso físico ao processador Lutron para apertar o botão de pareamento.
Instalação
Copie ZoomDH_Lutron_LEAP.pkg para o processador (SFTP em /user/ThirdPartyDrivers/Import) ou importe pelo Crestron Home Setup.
No Setup, em Emparelhar dispositivos → Drivers, adicione Lutron → LEAP Gateway (tipo Platform).
Preencha o IP do processador Lutron (ver Configuração).
Coloque o dispositivo do driver em um ambiente. No app Crestron Home, abra esse ambiente, toque no tile Lutron LEAP e depois em Parear (ver Pareamento).
Na primeira conexão o driver descobre o projeto sozinho. As luzes, cortinas e teclados aparecem como dispositivos filhos: coloque cada um no ambiente correto.
Atualização: o processador reaproveita a pasta de uma versão já importada. Cada pacote novo tem um DriverVersion novo (formato AAAAMMDDNN), então basta importar por cima.
Configuração
Campo
Descrição
Lutron Processor IP Address
IP do processador HomeWorks QSX / RadioRA 3. Alterar reconecta na hora.
UI Language / Idioma
Portuguese ou English: idioma dos textos das telas do driver.
Shade Travel Time (seconds)
Tempo de percurso das cortinas sem posição (OpenCloseStop), de 5 a 300 s (padrão 30). Depois desse tempo a cortina aparece como Aberta ou Fechada.
License Key
Chave de licença ZoomDH. Vazio = 30 dias de teste.
Deixe em branco. Uso do suporte técnico: importa um pareamento LEAP feito fora do driver (PEM). O certificado colado é usado uma vez; um pareamento feito depois pelo botão Parear passa a valer até que outro certificado seja colado.
Pareamento
Na tela do driver (Lutron LEAP), toque em Parear.
Quando o status mostrar APERTE O BOTÃO DO PROCESSADOR, aperte o botão do processador Lutron em até 3 minutos.
O status muda para Pareado e o driver conecta.
O driver gera uma chave RSA própria e pede ao processador um certificado de cliente. O pareamento fica salvo no processador Crestron e sobrevive a reinicializações e atualizações do driver. Só é preciso parear de novo depois de Esquecer pareamento ou se o processador Lutron for substituído ou resetado.
Dispositivos
Tipo LEAP (ControlType)
Dispositivo no Crestron Home
Observações
Dimmed, SpectrumTune, ColorTune
Luz (dimmer)
Liga/desliga e nível 0–100%, rampa de 1 s. Botões Aumentar / Parar / Diminuir (Raise/Lower). Toques no slider são agrupados (250 ms) em um único comando.
WhiteTune
Luz (temperatura de cor)
Nível + temperatura de cor de 1400 a 10000 K: atalhos 2700 / 3000 / 3500 / 4000 / 5000 K e ajuste fino de 100 K.
Switched, CCO, Receptacle
Luz (liga/desliga)
Só liga e desliga.
Shade, Tilt, Drape…
Cortina com posição
Posição real 0–100%, Abrir / Parar / Fechar.
OpenCloseStop
Cortina sem posição
Saídas de motor sem encoder (ex.: LQSE-4M-D). Abrir / Parar / Fechar e estado estimado (Abrindo, Fechando, Parada, Aberta, Fechada). Ver Cortinas sem feedback.
Teclados e Picos
Teclado
Até 24 botões com os nomes do projeto Lutron (gravação), botão Apertar e último evento de cada botão.
Virtual buttons
Tela do driver
Cenas programadas no Lutron Designer: seletor + Acionar na tela do driver e comando programável.
FanSpeed e outros
—
Ignorados (registrados no log durante a descoberta).
O nome de cada dispositivo é "Área - Zona" (a área padrão do Designer, Uncategorized Devices, é omitida). A descoberta é refeita sozinha quando o projeto salvo está vazio ou quando o driver encontra outro processador (número de série diferente). Para buscar mudanças do projeto Lutron, toque em Descobrir: dispositivos existentes são mantidos, os novos entram e os removidos saem.
Modo Circadiano
Nas luzes com temperatura de cor, ligue Circadiano (automático) na tela da luz (ou use os comandos Circadian On/Off nas sequências). A temperatura segue a hora do processador Crestron: 2700 K de noite (até 06:00 e depois das 20:00), sobe suavemente até 5000 K entre 06:00 e 11:00, fica em 5000 K até 15:00 e volta a 2700 K entre 15:00 e 20:00. O driver ajusta a cada minuto, com rampa de 10 s, e ao acender a luz (inclusive por um teclado Lutron). Escolher uma temperatura na mão (slider, atalho ou sequência) desliga o modo. A escolha fica salva por luz.
Cortinas sem feedback (Button Links)
As saídas de motor OpenCloseStop não têm encoder, então o processador não informa se a cortina está abrindo, fechando ou parada, nem qual zona cada botão comanda. Quando um Pico ou teclado comanda a cortina direto no Lutron, o Crestron Home não ficaria sabendo.
Na tela da cortina, em Botões do Lutron que comandam esta cortina, escolha até 3 botões e a função de cada um no Lutron. A cada aperto o driver acompanha o movimento pelo tempo de percurso da configuração. O botão continua comandando a cortina direto no Lutron.
Função
Use quando o botão no Lutron…
Alternado (abre/para/fecha/para)
É um botão único alternado: abre, para, fecha, para.
Abrir / Fechar / Parar
Tem uma função fixa a cada aperto.
Abre enquanto pressionado / Fecha enquanto pressionado
Move enquanto pressionado e para ao soltar.
Um botão comanda uma cortina só: escolher o mesmo botão em outra cortina tira o vínculo da anterior.
Parar pelo Crestron: o QSX ignora o Stop da zona depois de um movimento iniciado por botão, então o driver aperta o botão vinculado como Parar (ou o botão alternado, se a cortina estiver em movimento). Sem vínculo, envia o Stop da zona.
Os vínculos ficam salvos e são mantidos ao redescobrir, enquanto o botão e a zona existirem.
Importante: o estado é estimado. Cenas e temporizações do Lutron que movem a cortina sem passar por um botão vinculado não são percebidas. Um comando de abrir ou fechar pelo Crestron realinha o estado.
Tela do driver
Item
Descrição
Status
Estado da conexão, processador (nome, modelo, série, versão LEAP) e o último erro.
Lê áreas, zonas, teclados e virtual buttons e atualiza os dispositivos filhos. Mostra o resumo (luzes, cortinas, teclados, cenas).
Cena → Acionar
Aperta o virtual button escolhido no seletor (só os programados).
Licença → Verificar
Status da licença e consulta imediata ao servidor.
Avançado
Esquecer pareamento (apaga o certificado e desconecta) e Limpar descoberta (remove todos os dispositivos filhos e vínculos). Os dois pedem um segundo toque em até 10 s.
Comandos e eventos (sequências)
Dispositivo
Comandos programáveis
Eventos
Lutron LEAP (driver)
Press Lutron Scene (lista de virtual buttons), Discover Devices, Reconnect, Refresh All, Check License
—
Luz
On, Off, Toggle, Set Level, Set Level With Fade (nível + segundos), Set Color Temperature, Color Temperature 2700/3000/3500/4000/5000 K, Circadian On/Off, Raise, Lower, Stop Ramp
—
Cortina
Open, Close, Stop, Set Position
—
Teclado
Press <nome do botão>
<nome do botão> Press / Release / Hold / Click
Exemplo
Quando Teclado "Living - Entry Keypad" → "Scene On Press"
Faça Lutron LEAP → Press Lutron Scene "Jantar"
Solução de problemas
Sintoma
Causa provável / solução
Pareamento não avança depois de apertar o botão
IP errado ou porta 8083 bloqueada entre os processadores.
Desconectado - nova tentativa em N s repetido
Pareamento rejeitado (processador Lutron resetado ou substituído) ou porta 8081 bloqueada. Use Avançado → Esquecer pareamento e pareie de novo.
Zona ausente depois da descoberta
Tipo não suportado (o log mostra a zona ignorada e o tipo) ou zona sem área no projeto Lutron.
Cortina movida pelo Pico não atualiza
Zona OpenCloseStop não tem feedback no LEAP. Vincule o botão à cortina, ver Cortinas sem feedback.
Conectado - comandos bloqueados (licença)
Teste expirado ou licença inválida. Informe a chave em License Key.
Driver não carrega no processador
Veja o log do processador por SSH com o comando err.
O log do driver (Crestron Home Setup ou err por SSH) registra conexão, descoberta, comandos enviados e erros, em português.
Licenciamento
Período de teste de 30 dias incluso; o tempo restante aparece em Licença na tela do driver.
Depois de adquirir a licença, informe a chave em License Key na configuração. O processador Crestron precisa de acesso à internet para ativar e reverificar.
Versão inicial para Crestron Home: pareamento pelo app, luzes com dimmer e temperatura de cor (atalhos de 2700 a 5000 K e modo Circadiano automático), cortinas com e sem posição, teclados com eventos Press, Release, Hold e Click para as sequências, cenas Lutron, retorno em tempo real e telas em português e inglês.
