O driver 4Drivers Yale Connect Hub integra a plataforma Yale Connect Brazil (ASSA ABLOY) ao sistema Control4. Ele gerencia a autenticação na nuvem Yale, sincroniza as fechaduras cadastradas na conta e se comunica com os drivers de fechadura individuais (4Drivers Yale Connect Lock) instalados no projeto.
Autentica na API Yale Connect Brazil via e-mail e senha
Sincroniza automaticamente a lista de fechaduras da conta
Repassa comandos de abertura e fechamento para cada fechadura
Consulta e exibe o histórico de acessos com gráfico de atividade do dia
Disponibiliza interface HTML responsiva em qualquer Navigador Control4
Dispara eventos Hub Online e Hub Offline conforme disponibilidade da API
Interface HTML
Acessivel em qualquer Navigador Control4 — touchscreen fisico, app iOS/Android e browser.
Interface completa com lista de fechaduras, status, histórico e gráfico de atividade do dia
Secao
Descricao
Fechaduras
Lista todas as fechaduras visiveis com estado (Trancada/Aberta) e indicador Online/Offline
Painel de Status
Detalhe da fechadura selecionada: nome, estado, alerta de bateria, botoes Abrir e Fechar
Histórico de Acessos
Eventos por data: hora, fechadura, estado, meio de acesso e usuario
Gráfico de Atividade
Timeline visual de 0h a 23h59 — barras verdes (aberta) e vermelhas (trancada). Hover mostra horario exato
Compartilhar
Exporta o histórico como texto para compartilhamento ou copia para area de transferencia
Requisitos
Conta Yale Connect Brazil ativa com pelo menos uma fechadura cadastrada no app
Fechaduras adicionadas e funcionando normalmente pelo aplicativo Yale Connect
Control4 OS 3.0.0 ou superior
Driver 4Drivers_Yale_Connect_Lock.c4z disponÃvel na pasta de drivers do Composer (a instalação no projeto e feita automaticamente pelo List Locks)
Controlador com acesso a internet (comunicação direta com a API Yale)
Propriedades
Yale Connect User Data
Propriedade
Tipo
Padrao
Descricao
Email
Texto
—
E-mail de login da conta Yale Connect Brazil
Password
Senha
—
Senha da conta Yale Connect (campo mascarado)
Icon Type
Lista
Yale
Icone exibido no Navigador
Interface Preferences
Propriedade
Tipo
Padrao
Descricao
Add Control4 Lock Driver
Lista
Yes
Yes: adiciona automaticamente o proxy de fechadura Control4 ao adicionar um driver Lock pela primeira vez. No: ignora essa etapa (use quando o proxy ja existe no projeto).
Language
Lista
Portuguese
Idioma da interface HTML: Portuguese, English ou Spanish
Driver License
Propriedade
Tipo
Padrao
Descricao
License Key
Texto
Trial
Chave de licenca fornecida pela 4Drivers. Use Trial para avaliação
Validação
Texto
auto
Status da licenca — preenchido automaticamente (somente leitura)
Developer Use
Senha
—
Reservado para uso da 4Drivers
Driver Info
Propriedade
Tipo
Padrao
Descricao
Debug Mode
Lista
Off
Quando On, exibe no log do Composer o trafico entre hub e drivers de fechadura. Desative apos o comissionamento.
Status
Texto
—
Estado atual do driver: autenticado, erro, offline (somente leitura)
Driver Version
Texto
—
Versao instalada do driver (somente leitura)
Actions
Acao
Quando usar
List Locks
Sincroniza fechaduras da conta Yale e detecta drivers Lock instalados. Use sempre que adicionar uma nova fechadura ao app ou instalar um novo driver Lock.
Login
Autentica com as credenciais configuradas e ja executa a sincronização. Use na primeira configuração ou apos trocar a senha.
Force Poll
Refaz o login e atualiza os estados de todas as fechaduras. Útil para forcaar uma atualização imediata.
Get Status Fechaduras
Consulta o estado atual sem refazer o login — usa o token ja obtido.
Get Access History
Busca o histórico de acessos do dia atual.
Eventos
Evento
Quando dispara
Hub Online
A comunicação com a API Yale foi restaurada apos um periodo offline
Hub Offline
O driver detectou falha de comunicação com a API Yale
Use estes eventos em programações para notificar o usuario final quando a conexão com a nuvem Yale for perdida ou restabelecida.
Configuração Passo a Passo
1 — Adicionar o driver Hub ao projeto
Copie 4Drivers_Yale_Connect_Hub.c4z para a pasta de drivers do Composer Windows: C:\Users\[usuario]\Documents\Control4\Drivers\
No Composer Pro, busque por 4Drivers Yale Connect e arraste o driver 4Drivers Yale Connect Account para o projeto
2 — Inserir as credenciais
Abra a aba Properties do driver
Preencha Email e Password com os dados da conta Yale Connect
Salve (File > Save) — o driver detecta as credenciais e faz o login automaticamente
Aguarde alguns segundos e observe a propriedade Status — deve exibir Autenticado — X fechadura(s)
Copie 4Drivers_Yale_Connect_Lock.c4z para a pasta de drivers do Composer
O driver de fechadura não precisa ser adicionado manualmente ao projeto. A ação List Locks cria e configura automaticamente uma instancia do driver para cada fechadura encontrada na conta Yale.
5 — Sincronizar fechaduras
Nas Actions do driver Hub, clique em List Locks
O driver cria automaticamente um driver Lock para cada fechadura da conta, ja vinculado e configurado com o ID correto
Verifique na propriedade Status a contagem de fechaduras detectadas
6 — Configurar cada driver Lock
Abra as Properties do driver Lock criado automaticamente
Ajuste Lock Name Selected para um nome amigavel ao usuario final se desejar
Defina VisÃvel na Interface: Sim (exibe na UI) ou Não (oculta — útil para fechaduras de servico ou areas privadas)
7 — Configurar visibilidade no Navigator
Nas propriedades do ambiente, aba Navigator, defina o driver 4Drivers_Yale_Connect_Hub como Visible no Experience Menu desejado — recomendamos Security.
Aba Navigator do ambiente — driver configurado como Visible no menu Security
9 — Verificar a interface HTML
No Navigador, acesse o item Yale Connect
Confirme que as fechaduras aparecem com estado correto (Trancada/Aberta)
Teste os botoes Abrir e Fechar
Acesse Histórico de Acessos e clique Ver Histórico para validar os registros
10 — Finalizar
Certifique-se de que Debug Mode esta em Off
Salve e publique o projeto
Configuração concluida. O driver renovara o token de autenticação automaticamente e mantera os estados das fechaduras atualizados por polling.
Resolucao de Problemas
Problema
Solucao
Erro de login / Token inválido
Confirme e-mail e senha no app Yale Connect. Clique em Login no Composer.
Fechaduras não aparecem na interface
Execute List Locks. Verifique se os drivers Lock estao vinculados ao Hub.
Fechadura aparece mas não responde
Verifique o indicador Online/Offline. Se Offline, o hub fisico Yale pode estar sem conexão com a internet.
Histórico sem eventos
Verifique se a data tem movimentação no app Yale. O histórico e buscado em tempo real da nuvem.
Informações Tecnicas
Item
Valor
Protocolo
HTTPS — API Yale Connect Brazil
Autenticação
Token Bearer com renovação automática
Polling de estado
Automatico por polling
Comúnicação hub-lock
Binding virtual Control4 (ID 100, classe 4d_Yale_Connect)
Persistencia
Token, IDs e mapa de fechaduras em PersistData — sobrevivem ao reboot
