Este driver integra as fechaduras Yale Zigbee ao sistema Nice/ELAN pelo Yale Connect Hub. Ele entra na conta Yale Connect, encontra as fechaduras vinculadas e cria um driver para cada uma, já com o nome usado no app Yale.
São dois drivers no mesmo pacote:
Driver
Função
ZoomDH Yale Connect Hub
Driver de comunicação, onde ficam a conta Yale Connect e a licença. Encontra as fechaduras e instala o driver de cada uma.
ZoomDH Yale Connect Lock
Uma instância por fechadura, em Output Controllers. Traz a saída Lock para trancar e destrancar, os eventos de acesso e o histórico da fechadura.
Recursos suportados
Descoberta automática: todas as fechaduras da conta Yale Connect são encontradas e ganham um driver próprio, com o nome do app.
Trancar e destrancar: pela saída Lock de cada fechadura (ligada = trancada, desligada = destrancada), com retorno do estado real.
Eventos de acesso: trancada, destrancada e destrancada por senha, digital, cartão/tag, app, chave ou manualmente, além da trava automática.
Histórico de acessos: cada acesso fica registrado no log do driver da fechadura, com a ação, o método e o usuário.
Alertas: porta forçada, bateria baixa e fechadura off-line.
Status da nuvem e do hub: eventos quando a conta Yale Connect ou o hub da rede local ficam on-line ou off-line.
Vários hubs na mesma conta e na mesma instalação.
Modelos compatíveis: YMF 30, YMC 420W, LIA, YDF 40 e Gemini Mini. As demais fechaduras Yale Zigbee da conta Yale Connect devem funcionar da mesma forma.
Qualquer recurso não especificamente indicado como suportado deve ser considerado sem suporte, inclusive o cadastro de usuários e senhas na fechadura, que continua sendo feito pelo app Yale.
Pré-requisitos
Yale Connect Hub ativado e vinculado a uma conta Yale Connect pelo app oficial.
Fechaduras pareadas ao hub pelo app Yale e funcionando pelo app.
E-mail e senha da conta Yale Connect.
Controlador ELAN e hub Yale na mesma rede local, sem bloqueio de broadcast entre eles, e com acesso à internet.
No Nice Configurator, abra a guia Input/Output e selecione Communication Devices. Clique no botão + Communication Device, no rodapé da tela.
Clique em Import..., localize a pasta onde salvou o driver, aponte para o arquivo ZoomDH_Yale_Connect_Hub.edrvc e clique em OK.
Selecione ZoomDH Yale Connect Hub e clique em Install. Instale apenas um por controlador, mesmo havendo vários hubs Yale.
Se o driver não aparecer na lista, clique em Show All.
Insira a chave de licença no campo License Key, após adquiri-la, e confira o License Status.
Nos campos de usuário e senha do driver, preencha o e-mail e a senha da conta Yale Connect e aperte Discover Locks.
Aguarde alguns segundos. O driver faz o login, mostra o resultado em Driver Information e instala um ZoomDH Yale Connect Lock para cada fechadura, em Output Controllers, com o nome usado no app.
Use a saída Lock de cada fechadura na interface e na programação, e os eventos no Event Mapper.
Ao incluir uma fechadura nova no app Yale, clique em Discover Locks no driver Hub.
Campos de configuração
ZoomDH Yale Connect Hub
Campo
Descrição
License Key
Chave de licença para uso do driver.
License Status
Status da licença e tempo restante de avaliação (somente leitura).
Developer Debug
Ativa log detalhado para diagnóstico. Deixe desativado em uso normal.
Usuário / Senha
E-mail e senha da conta Yale Connect, a mesma usada no app. Se a Yale recusar, o driver não tenta de novo até os dados mudarem, para não bloquear a conta.
Driver Information
Resultado do login na conta Yale Connect e quantidade de fechaduras encontradas (somente leitura). Os hubs detectados na rede local e os acessos aparecem no log do driver.
Discover Locks (botão)
Refaz o login e procura fechaduras novas na conta.
ZoomDH Yale Connect Lock
Campo
Descrição
Lock (saída)
Ligada = trancada, desligada = destrancada. Ligar tranca e desligar destranca a fechadura.
License Status
Status da licença, informado pelo driver Hub (somente leitura).
Driver Information
Mensagens de status do driver em tempo real (somente leitura).
Developer Debug
Ativa log detalhado para diagnóstico. Deixe desativado em uso normal.
Lock Name / Model
Nome e modelo da fechadura no app Yale (página Lock, somente leitura).
Lock State
Trancada, Destrancada ou Desconhecido (somente leitura).
Connection / Battery
Fechadura on-line ou off-line, e bateria normal ou baixa (somente leitura).
Last Access
Último acesso nesta fechadura (somente leitura).
Log
Histórico de acessos e alertas da fechadura, com ação, método e usuário.
Eventos
ZoomDH Yale Connect Hub
Evento
Quando ocorre
Lock Accessed
Qualquer acesso em qualquer fechadura da conta.
Cloud Online / Cloud Offline
A conta Yale Connect voltou a responder ou parou de responder.
Hub Online / Hub Offline
Um hub Yale da rede local voltou ou deixou de ser visto por cerca de 90 segundos.
ZoomDH Yale Connect Lock
Evento
Quando ocorre
Locked / Unlocked
A fechadura foi trancada ou destrancada, por qualquer meio.
Unlocked by PIN / Fingerprint / Card / App / Key
Destrancada por senha, digital, cartão ou tag, app ou chave.
Unlocked Manually
Destrancada pelo lado de dentro.
Locked by Auto-lock
Trancada pela trava automática.
Door Forced
A porta foi forçada com a fechadura trancada.
Low Battery
A bateria da fechadura ficou baixa.
Lock Offline / Lock Online
A fechadura perdeu ou recuperou a comunicação com o hub. O driver confere a cada 5 minutos, e na hora em que há um acesso.
Unlocked by User / Locked by User
Destrancada ou trancada por um usuário específico (opções User 1 a User 10, ver abaixo).
Eventos por usuário
Na página Users de cada fechadura ficam até 10 nomes de usuário, como aparecem no app Yale. Quando alguém usa a fechadura pela primeira vez, o nome entra sozinho no primeiro campo vazio. Também é possível digitar ou trocar os nomes (maiúsculas e acentos não importam).
No Event Mapper, escolha Unlocked by User ou Locked by User e a opção do usuário (User 1 a User 10) para disparar uma ação só quando aquela pessoa abrir ou fechar a porta.
Solução de problemas
Falha no login: confira o e-mail e a senha entrando no app Yale com a mesma conta, e se o controlador tem acesso à internet.
Nenhuma fechadura encontrada: confira no app se as fechaduras estão vinculadas à mesma conta e clique em Discover Locks.
Comandos não funcionam: confira o License Status. Sem licença válida, o driver não tranca nem destranca e não atualiza o estado das fechaduras.
Estado e eventos demoram a chegar: confira se o log do driver mostra o hub na rede. Se não mostrar, o controlador não está recebendo os avisos do hub na rede local (redes ou VLANs diferentes, ou broadcast bloqueado). O driver continua funcionando pela nuvem, com até 15 segundos de atraso.
Driver de uma fechadura apagado por engano: clique em Discover Locks no driver Hub para reinstalá-lo.
Fechadura renomeada no app: clique em Discover Locks para o driver reconhecer o nome novo.
Licenciamento
Este driver funciona por um período de avaliação de 7 dias. Após esse período, é necessário inserir uma chave de licença para continuar operando.
A chave é inserida no campo License Key do driver ZoomDH Yale Connect Hub e vale para todas as fechaduras. As licenças são emitidas e vinculadas por controlador.
Sem licença válida, o driver continua encontrando as fechaduras, mas não envia comandos, não atualiza o estado nem gera eventos.
Eventos por usuário para programar ações só para quem abriu ou fechou a porta. Estado das fechaduras sempre igual ao do app Yale. Correção de fechaduras que apareciam off-line ou desconectadas mesmo funcionando. Log mais simples.
This driver integrates Yale Zigbee locks with the Nice/ELAN system through the Yale Connect Hub. It signs in to the Yale Connect account, finds the linked locks and creates a driver for each one, named as in the Yale app.
The package has two drivers:
Driver
Role
ZoomDH Yale Connect Hub
Communication driver that holds the Yale Connect account and the license. Finds the locks and installs a driver for each one.
ZoomDH Yale Connect Lock
One instance per lock, under Output Controllers. Provides the Lock output to lock and unlock, the access events and the lock history.
Supported features
Automatic discovery: every lock in the Yale Connect account is found and gets its own driver, named as in the app.
Lock and unlock: through the Lock output of each lock (on = locked, off = unlocked), with real state feedback.
Access events: locked, unlocked, and unlocked by PIN, fingerprint, card/tag, app, key or manually, plus auto-lock.
Access history: every access is recorded in the lock driver log, with action, method and user.
Alerts: door forced, low battery and lock offline.
Cloud and hub status: events when the Yale Connect account or the local hub goes online or offline.
Multiple hubs in the same account and installation.
Compatible models: YMF 30, YMC 420W, LIA, YDF 40 and Gemini Mini. Other Yale Zigbee locks in the Yale Connect account should work the same way.
Any feature not specifically listed as supported should be considered unsupported, including enrolling users and codes on the lock, which is still done in the Yale app.
Prerequisites
Yale Connect Hub activated and linked to a Yale Connect account with the official app.
Locks paired to the hub with the Yale app and working from the app.
E-mail and password of the Yale Connect account.
ELAN controller and Yale hub on the same local network, with no broadcast blocking between them, and with internet access.
Internet access on the controller to activate the license.
In the Nice Configurator, open the Input/Output tab and select Communication Devices. Click the + Communication Device button at the bottom of the screen.
Click Import..., browse to the folder where you saved the driver, select ZoomDH_Yale_Connect_Hub.edrvc and click OK.
Select ZoomDH Yale Connect Hub and click Install. Install only one per controller, even with several Yale hubs.
If the driver is not listed, click Show All.
Enter the license key in the License Key field, after purchasing it, and check the License Status.
In the driver user name and password fields, enter the Yale Connect account e-mail and password and press Discover Locks.
Wait a few seconds. The driver signs in, shows the result in Driver Information and installs one ZoomDH Yale Connect Lock per lock under Output Controllers, named as in the app.
Use the Lock output of each lock in the interface and in programming, and the events in the Event Mapper.
After adding a new lock in the Yale app, click Discover Locks in the Hub driver.
Configuration fields
ZoomDH Yale Connect Hub
Field
Description
License Key
License key for the driver.
License Status
License status and remaining evaluation time (read only).
Developer Debug
Enables detailed logging for diagnostics. Keep it disabled in normal use.
User name / Password
Yale Connect account e-mail and password, the same one used in the app. If Yale rejects them, the driver does not retry until they change, so the account is not locked.
Driver Information
Result of the Yale Connect sign-in and number of locks found (read only). Hubs detected on the local network and accesses are shown in the driver log.
Discover Locks (button)
Signs in again and looks for new locks in the account.
ZoomDH Yale Connect Lock
Field
Description
Lock (output)
On = locked, off = unlocked. Turning it on locks and turning it off unlocks the lock.
License Status
License status, reported by the Hub driver (read only).
Driver Information
Driver status messages in real time (read only).
Developer Debug
Enables detailed logging for diagnostics. Keep it disabled in normal use.
Lock Name / Model
Lock name and model in the Yale app (Lock page, read only).
Lock State
Locked, Unlocked or Unknown (read only).
Connection / Battery
Lock online or offline, and battery normal or low (read only).
Last Access
Latest access on this lock (read only).
Log
Access and alert history of the lock, with action, method and user.
Events
ZoomDH Yale Connect Hub
Event
When it fires
Lock Accessed
Any access on any lock in the account.
Cloud Online / Cloud Offline
The Yale Connect account started or stopped responding.
Hub Online / Hub Offline
A local Yale hub came back or has not been seen for about 90 seconds.
ZoomDH Yale Connect Lock
Event
When it fires
Locked / Unlocked
The lock was locked or unlocked, by any means.
Unlocked by PIN / Fingerprint / Card / App / Key
Unlocked by PIN, fingerprint, card or tag, app or key.
Unlocked Manually
Unlocked from the inside.
Locked by Auto-lock
Locked by auto-lock.
Door Forced
The door was forced while locked.
Low Battery
The lock battery is low.
Lock Offline / Lock Online
The lock lost or regained communication with the hub. The driver checks every 5 minutes, and right away when there is an access.
Unlocked by User / Locked by User
Unlocked or locked by a specific user (options User 1 to User 10, see below).
Events by user
Each lock's Users page holds up to 10 user names, as shown in the Yale app. When someone uses the lock for the first time, the name fills the first empty field on its own. You can also type or change the names (case and accents don't matter).
In the Event Mapper, pick Unlocked by User or Locked by User and the user option (User 1 to User 10) to run an action only when that person opens or closes the door.
Troubleshooting
Sign-in failure: check the e-mail and password by signing in to the Yale app with the same account, and check that the controller has internet access.
No lock found: check in the app that the locks are linked to the same account and click Discover Locks.
Commands do not work: check the License Status. Without a valid license, the driver neither locks nor unlocks and does not update the lock state.
State and events arrive late: check that the driver log shows the hub on the network. If it does not, the controller is not receiving the hub notifications on the local network (different networks or VLANs, or broadcast blocked). The driver keeps working through the cloud, with up to 15 seconds of delay.
Lock driver deleted by mistake: click Discover Locks in the Hub driver to reinstall it.
Lock renamed in the app: click Discover Locks so the driver picks up the new name.
Licensing
This driver works for a 7-day evaluation period. After that period, a license key is required to keep it running.
The key is entered in the License Key field of the ZoomDH Yale Connect Hub driver and covers every lock. Licenses are issued and bound per controller.
Without a valid license, the driver still finds the locks, but sends no commands, does not update the state and raises no events.
Events by user, to run actions only for whoever opened or closed the door. Lock states always match the Yale app. Fixed locks that showed off-line or disconnected while working. Simpler log.
