Driver de integração para o UniFi Access. Funciona como gateway no Control4: conecta ao console UniFi OS que hospeda o Access, descobre as portas e os dispositivos, e cria um driver filho de Location para cada porta e um de Intercom para cada leitor com campainha, já nomeados e conectados.
A comunicação usa a API local do console (HTTPS) para os dados e comandos e um WebSocket para os eventos em tempo real. A autenticação é feita por usuário e senha de um administrador local do console, como a própria interface web do Access, com relogin automático quando a sessão expira. Chave de API (Integrations) continua aceita onde o console ainda a aceita.
O Intercom registra a conta SIP no Communications Agent do Control4 e configura automaticamente o SIP de terceiros e o destinatário da chamada no Access, de acordo com o grupo de chamada escolhido no driver.
Instalação
- Adicione o driver ZoomDH – UniFi Access Gateway ao projeto no Composer Pro. A conexão Access é ligada ao driver ZoomDH UniFi Cloud automaticamente.
- Em IP Address, informe o IP do console UniFi que hospeda o Access.
- Em Console Username e Console Password, informe um administrador local do console (recomendado: usuário dedicado ao Control4). Alternativamente, use API Token (chave de Access > Integrations) em consoles que ainda a aceitam.
- Aguarde Connection Status = Online e execute as ações Auto Install Location Drivers e Auto Install Intercom Drivers para criar e vincular os drivers filhos.
- No driver Intercom, escolha o grupo de chamada em Group to Call. O SIP e o destinatário são configurados no Access automaticamente.
Recursos
- Descobre as portas e dispositivos do Access e cria um driver filho (Location) para cada porta
- Destravar porta, destravar por tempo definido e modo de emergência por porta ou global (Lockdown / Evacuate)
- Eventos em tempo real de acesso concedido/negado, posição da porta e campainha, com usuário e método
- Intercom SIP com campainha pelo Communications Agent do Control4, com configuração automática no Access
- Destinatário da chamada escolhido pelo grupo de chamada do Control4
- Autenticação por usuário/senha de admin local do console (sessão), com relogin automático
- Saídas tipo relé para Lockdown e Evacuation e mensagens claras quando a credencial é recusada
Requisitos
- Console UniFi OS que hospeda o app Access (UDM, UDM Pro/SE, Cloud Key, UNVR etc.), com IP fixo ou reservado
- Administrador local do console (não conta SSO/2FA), de preferência dedicado ao Control4
- Controlador e console na mesma rede local, com acesso à internet no controlador
- Para o intercom, dispositivo Access com campainha (ex. UA G3 Pro)
- Drivers Location, Intercom e Cloud incluídos no pacote, na pasta Documentos\Control4\Drivers
Histórico de versões
- 20261014
Documentação atualizada para o novo padrão.
- 20260808
Suporte a licenças UniFi Protect.
- 20260420
Versão inicial.
