Visao Geral
O driver 4Drivers Yale Connect Lock representa uma fechadura individual da conta Yale Connect dentro do projeto Control4. Ele recebe atualizações de estado e eventos de acesso do driver Hub, dispara eventos C4 para automações e pode enviar notificações por e-mail ou via 4Drivers Message Sender.
Este driver não precisa ser adicionado manualmente ao projeto. O driver Hub cria e configura automaticamente uma instancia para cada fechadura encontrada na conta Yale ao executar List Locks.
- Reflete em tempo real o estado da fechadura (trancada, aberta, online, bateria)
- Dispara eventos Control4 por tipo de acesso: app, manual, senha, digital
- Suporta notificações por e-mail e 4Drivers Message Sender
- Expoe variaveis Control4 para automações (usuario, bateria)
- Integra com o proxy LOCK do Control4 — compatível com automações de seguranca nativas
Propriedades
Identificação
| Propriedade | Tipo | Descricao |
|---|
| Lock ID Selected leitura | Texto | ID interno Yale da fechadura. Preenchido automaticamente pelo Hub via List Locks. |
| Lock Name Selected | Texto | Nome da fechadura. Preenchido pelo Hub; pode ser ajustado pelo integrador para um nome mais amigavel ao usuario final. |
| Visível na Interface | Lista | Sim (padrao) — fechadura aparece na interface HTML do Hub. Não — oculta; útil para fechaduras de servico ou areas privadas. |
| Driver Version leitura | Texto | Versao instalada do driver. |
Status da Fechadura todos somente leitura
| Propriedade | Descricao |
|---|
| Online | Indica se a fechadura esta em comunicação com o hub Yale: Sim ou Não |
| Bateria | Estado da bateria: OK ou Bateria Fraca |
| Alarme | Codigo de alarme da fechadura, quando disponível |
| Codigo de Entrada | Ultimo codigo de entrada registrado |
| Ultimo Estado | Ultima mudanca de estado (TRANCADA/ABERTA) com data e hora |
| Ultimo Acesso | Descricao completa do ultimo acesso: estado, tipo, usuario e horario |
| Tipo de Acesso | Como a fechadura foi operada: app, digital, manual, senha |
| Usuario Acesso | Nome do usuario que operou via app. Vazio quando o acesso e fisico. |
| Ultima Atualização | Data e hora da ultima comunicação recebida do Hub |
Notificações
| Propriedade | Tipo | Descricao |
|---|
| E-mail Address | Texto | Endereco de e-mail para envio de notificações de acesso |
| Quando Destrancada | Lista | Acao ao detectar abertura: E-mail, 4Drivers Message Sender, Boths ou Do not send |
| Quando Trancada | Lista | Acao ao detectar fechamento: mesmas opções acima |
Debug
| Propriedade | Tipo | Descricao |
|---|
| Debug Mode | Lista | Off (padrao) ou Print — exibe logs no console do Composer. Desative apos o comissionamento. |
| Developers Use | Senha | Reservado para uso da 4Drivers. |
Variaveis Control4
Variaveis expostas ao sistema Control4 para uso em programações e automações:
| Variavel | Tipo | Descricao |
|---|
| Last Valid User ID | Numero | ID do ultimo usuario identificado com acesso válido |
| Last Valid User Name | Texto | Nome do ultimo usuario com acesso válido |
| Battery Level | Numero | Nivel de bateria: 100 = OK, 10 = Bateria Fraca |
Eventos
O driver dispara os seguintes eventos Control4, útilizaveis em programações:
Conectividade
| Evento | Quando dispara |
|---|
| Fechadura Online | A fechadura voltou a se comunicar com o hub Yale |
| Fechadura Offline | A fechadura perdeu comunicação com o hub Yale |
Estado Geral
| Evento | Quando dispara |
|---|
| Fechadura Trancada | A fechadura foi trancada por qualquer meio |
| Fechadura Aberta | A fechadura foi aberta/destrancada por qualquer meio |
Por Tipo de Acesso
| Evento | Quando dispara |
|---|
| Trancada pelo App | Fechamento via aplicativo Yale Connect |
| Aberta pelo App | Abertura via aplicativo Yale Connect |
| Trancada Manualmente | Fechamento fisico (botao ou giro do cilindro) |
| Aberta Manualmente | Abertura fisica |
| Trancada por Senha | Fechamento via teclado numérico |
| Aberta por Senha | Abertura via teclado numérico |
| Trancada com Digital | Fechamento via impressao digital |
| Aberta com Digital | Abertura via impressao digital |
Bateria
| Evento | Quando dispara |
|---|
| Bateria Fraca | O nivel de bateria entrou em estado baixo |
| Bateria Normal | O nivel de bateria voltou ao normal |
Actions
| Acao | Descricao |
|---|
| Abrir | Envia comando de destrancamento para a fechadura via Hub |
| Fechar | Envia comando de trancamento para a fechadura via Hub |
| Refresh Devices List | Solicita ao Hub a re-sincronização do ID desta fechadura |
| List Users | Solicita a lista de usuarios cadastrados na fechadura |
Configuração
O driver e adicionado e configurado automaticamente pelo Hub. Na maioria dos casos não e necessária nenhuma ação adicional alem dos passos abaixo.
1 — Verificar a identificação
- Apos o Hub executar List Locks, abra as Properties deste driver
- Confirme que Lock ID Selected esta preenchido com o ID Yale da fechadura
- Ajuste Lock Name Selected para um nome amigavel ao usuario final, se desejar
2 — Visibilidade na interface
- Mantenha Visível na Interface em
Sim para fechaduras de uso regular
- Defina
Não para fechaduras de servico ou que não devem aparecer na interface HTML do Hub
3 — Configurar notificações (opcional)
- Preencha E-mail Address com o endereco de destino das notificações
- Em Quando Destrancada e Quando Trancada, escolha o canal de envio desejado
- Para usar 4Drivers Message Sender, o driver correspondente deve estar instalado e vinculado ao binding 4Drivers Message Sender deste driver
4 — Finalizar
- Certifique-se de que Debug Mode esta em
Off
- Salve e publique o projeto
Change Log
| Versao | Data | Alterações |
|---|
| 1055 | 24/07/2026 | Correções Iniciais |
| 1051 | 20/07/2026 | Ajustes Iniciais |
| 1050 | 19/07/2026 | Lançamento inicial |
