Integração Digieye (Visão Computacional)
A integração Digieye conecta o ACCELERO a dispositivos Digieye de visão computacional — equipamentos que processam imagens via módulos EyeFlow e DigiAI. Com a integração ativa, o ACCELERO cadastra e gerencia esses dispositivos, notifica o Digieye sobre eventos de acesso (para que ele analise a cena), aciona outputs do equipamento e ainda permite usar o estado do dispositivo (phase ou I/O) como regra de verificação de acesso.
Esta integração é disponibilizada como plugin (digieye) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 0.0.3, compatível com ACCELERO 2.16.8 e 2.17.2.
A versão atual do plugin (0.0.3) ainda está em estágio inicial. Telas, campos e comportamentos podem mudar entre versões. Confirme com o suporte IONGRADE antes de implantar em produção.
O que a integração faz
O Digieye é tratado como um tipo de gateway de comunicação e de dispositivo dentro do ACCELERO. Os dispositivos cadastrados se comunicam via MQTT, e o ACCELERO atua como orquestrador: encaminha eventos, comanda saídas e consulta o estado do equipamento para decisões de acesso.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Cadastro de dispositivos Digieye | Cada equipamento é registrado com número de série, IP, porta, gateway de comunicação e áreas associadas |
| Binds de eventos | Tipos de evento de acesso são vinculados a um dispositivo; quando o evento ocorre, o ACCELERO notifica o Digieye (EyeFlow / DigiAI / acionar output) |
| Binds de eventos Domocam | Tipos de evento de câmeras Domocam são vinculados a um dispositivo, disparando a mesma notificação ao Digieye |
| Acionamento de output | Um evento de acesso ou uma ação de I/O pode ligar/desligar uma saída do dispositivo Digieye |
| Regra de verificação de acesso | A regra Verificação de phase libera ou nega o acesso conforme a phase atual do Digieye ou o estado de um I/O monitorado |
| Monitoramento de status | O ACCELERO acompanha online/offline do gateway e a versão/IP/última comunicação reportados pelos dispositivos |
Permite que decisões e ações físicas do ACCELERO (liberar acesso, acionar uma saída) sejam coordenadas com a análise de visão computacional do Digieye, em tempo real, via MQTT.
Dispositivos Digieye
Caminho de acesso: Configurações > Digieye
A tela principal possui duas abas: Devices e Gateways.
Aba Devices
Lista todos os dispositivos Digieye cadastrados.
| Coluna | Conteúdo |
|---|---|
| Número de série | Número de série do dispositivo |
| Descrição | Nome/descrição do dispositivo |
| Endereço IP | IP do dispositivo |
| Porta de comunicação | Porta de comunicação |
| Dados gerais | Metadados do dispositivo |
| Ações | Editar dispositivo |
Botões da listagem:
| Botão | Função |
|---|---|
| Novo device | Abre o formulário rápido de cadastro inline |
| Pesquisar | Filtra a lista por descrição |
| Mais ações > Excluir | Exclusão em lote dos dispositivos selecionados |
Cadastro rápido (inline)
O formulário inline de Novo device pede: Número de série, Descrição, Endereço IP, Porta de comunicação e Gateway.
Aba Gateways
Lista os gateways de comunicação do tipo digieye. Para cada gateway, o ACCELERO exibe metadados reportados pelos dispositivos: última comunicação, versão, endereço IP e o status de comunicação com os dispositivos (OK / Erro por dispositivo).
O cadastro e a configuração do gateway de comunicação seguem o fluxo padrão do ACCELERO. O plugin apenas registra o tipo digieye e enriquece a listagem com os metadados reportados pelos dispositivos.
Cadastro do dispositivo
Ao editar um dispositivo (botão Editar na listagem), abre-se a tela Digieye com as abas Dados gerais, Binds de eventos e Domocam.
Aba Dados gerais
| Campo | Descrição |
|---|---|
| Inputs habilitados (separar por vírgula) | Lista de inputs do dispositivo habilitados, separados por vírgula |
| Outputs habilitados (separar por vírgula) | Lista de outputs do dispositivo habilitados, separados por vírgula |
| Número de série | Número de série do dispositivo |
| Descrição | Nome/descrição do dispositivo |
| Endereço IP | IP do dispositivo |
| Porta de comunicação | Porta de comunicação |
| Gateway | Gateway de comunicação (tipo digieye) ao qual o dispositivo pertence |
| Usuário | Usuário de acesso ao dispositivo |
| Senha | Senha de acesso ao dispositivo |
| Áreas associadas | Áreas do ACCELERO associadas a este dispositivo (multi-seleção). Define quais eventos e qual regra de acesso se aplicam ao equipamento |
Validação de horário de funcionamento de área
Ainda na aba Dados gerais, a seção Validação de horário de funcionamento de área define a estratégia de validação usada pela regra de verificação de acesso:
| Campo | Descrição |
|---|---|
| Estratégia de validação | Phase / Monitoramento I/O / Não validar |
| Phases habilitadas para validação de acesso (separar por vírgula) | (estratégia Phase) Lista de phases nas quais o acesso é permitido |
| Phase default em caso de falha de comunicação | (estratégia Phase) Phase assumida quando o dispositivo/gateway está offline |
| I/O para monitorar | (estratégia Monitoramento I/O) Número do I/O cujo estado determina o bloqueio |
Use Não validar quando o dispositivo apenas recebe notificações de evento ou aciona outputs, sem participar da decisão de liberação de acesso.
Reinício do equipamento
A partir da versão 0.0.3, a aba Dados gerais traz a seção Reinício do equipamento, que permite reiniciar um Digieye travado cortando a alimentação dele por meio de uma controladora independente. A seção só aparece para perfis com a permissão Digieye - Reiniciar equipamento.
| Campo | Descrição |
|---|---|
| Forma de reinício | Não permitir / Canal da controladora / Saída de I/O da controladora |
| Canal que corta a alimentação | (Canal da controladora) Canal acionado com o mesmo comando da abertura remota. O tempo de acionamento é o já configurado no canal |
| Saída que corta a alimentação | (Saída de I/O da controladora) Saída de I/O pulsada para cortar a alimentação |
| Duração do pulso (ms) | (Saída de I/O da controladora) Tempo do pulso na saída. Padrão: 3000 |
O botão Reiniciar equipamento pede que você digite o motivo do reinício para confirmar. O motivo fica registrado na auditoria junto com a forma de reinício e o canal ou a saída acionada.
Se o equipamento estiver travado, a saída dele mesmo não responde. Ligue o corte de alimentação a um canal ou saída de outra controladora.
Aba Binds de eventos
Vincula tipos de evento de acesso do ACCELERO a uma ação no dispositivo Digieye. Quando um evento vinculado ocorre em uma área associada ao dispositivo, o ACCELERO publica a notificação correspondente via MQTT.
Formulário de Novo bind:
| Campo | Descrição |
|---|---|
| Evento | Multi-seleção de tipos de evento de log que disparam a notificação |
| Canal | Canal do dispositivo associado ao bind |
| Tipo de integração | EyeFlow / DigiAI / Ligar output / Desligar output |
| Classe | Identificador da classe enviada na notificação ao Digieye |
| Tipo | Tipo livre da notificação (valor padrão: Multi) |
| Tipo de integração | Efeito |
|---|---|
| EyeFlow | Notifica o módulo EyeFlow do Digieye com os dados do evento (inclui a foto da pessoa, quando disponível) |
| DigiAI | Notifica o módulo DigiAI do Digieye com os dados do evento |
| Ligar output | Comanda o acionamento de um output do dispositivo no canal informado |
| Desligar output | Comanda o desligamento de um output do dispositivo no canal informado |
O processo DigieyeEventListener assina os eventos de acesso publicados pelo servidor e os eventos DOMOCAM, e publica a notificação no tópico do dispositivo. O tópico é formado por {FACILITY}/digieye/{número de série do gateway}/{ID do dispositivo}/ seguido de EyeFlow, DigiAI ou setoutput/{canal} (usado tanto por Ligar output, com value 1, quanto por Desligar output, com value 0).
Aba Domocam
Permite vincular tipos de evento de câmeras Domocam a um dispositivo Digieye. Quando o evento Domocam selecionado ocorre no dispositivo de câmera escolhido, o ACCELERO dispara a mesma notificação ao Digieye.
Formulário de Novo bind (Domocam):
| Campo | Descrição |
|---|---|
| Tipos de evento | Multi-seleção de tipos de evento Domocam que disparam a notificação |
| Dispositivos | Dispositivo de câmera Domocam de origem do evento (na listagem, coluna Domocam) |
| Canal | Canal do dispositivo associado ao bind |
| Tipo de integração | EyeFlow / DigiAI / Ligar output / Desligar output |
| Classe | Identificador da classe enviada na notificação ao Digieye |
| Tipo | Tipo livre da notificação (valor padrão: Multi) |
A aba Domocam só fica disponível quando o módulo Domocam está habilitado no ambiente. Sem o módulo, apenas os binds de eventos de acesso são utilizados.
Regra de verificação de acesso
O plugin disponibiliza uma regra de verificação de acesso dedicada, a Verificação de phase, que entra na lista de regras de acesso customizáveis do sistema. Ela libera ou nega a passagem conforme o estado do dispositivo Digieye associado à área de destino.
Caminho de acesso: Avançado > Sistema > Personalização - Regras de acesso customizáveis. No campo Regras de acesso a habilitar, selecione Verificação de phase e salve.
A habilitação é feita uma vez para o sistema, não por área. O que limita o efeito da regra às áreas certas é o campo Áreas associadas de cada dispositivo Digieye.
Como a regra decide
A regra atua sobre os dispositivos Digieye associados à área de destino do acesso. Se nenhum dispositivo estiver associado à área, o acesso é liberado por esta regra. Para cada dispositivo associado, o bloqueio depende da Estratégia de validação configurada na aba Dados gerais:
| Estratégia | Comportamento |
|---|---|
| Phase | O acesso é negado se a phase atual do dispositivo não estiver entre as Phases habilitadas. Com o dispositivo online, a phase atual vem do equipamento; offline, usa-se a Phase default |
| Monitoramento I/O | O acesso é negado quando o I/O monitorado está acionado |
| Não validar | A regra nunca bloqueia por esse dispositivo |
Quando a regra nega, o motivo registrado é o de fora do horário de funcionamento (NOT_AUTHORIZED_WORKING_HOUR).
Na estratégia Phase, defina a Phase default considerando o que deve acontecer quando o dispositivo está offline. Se a phase default não estiver entre as habilitadas, o acesso será negado durante a indisponibilidade.
Ação de I/O: acionar output Digieye
O plugin adiciona ao tratador de I/O do ACCELERO a ação Agir sobre output Digieye, que liga ou desliga uma saída de um dispositivo Digieye quando uma condição de I/O é (ou deixa de ser) atendida.
Caminho de acesso: I/O > Configurar I/O, edite o tratador e, na aba Ações, clique em Nova ação e escolha o Tipo Agir sobre output Digieye.
| Campo | Descrição |
|---|---|
| Digieye | Dispositivo Digieye alvo da ação |
| Output | Número do output a ser acionado |
| Status | Chave com o estado desejado da saída (ligado/desligado) quando a condição é atendida; o estado inverso é aplicado quando a condição deixa de valer |
O plugin também expõe a fonte de I/O I/O Digieye nas telas de tratadores de I/O, permitindo usar inputs/outputs de dispositivos Digieye como variáveis de entrada das regras de I/O.
Os inputs e outputs disponíveis para uso em I/O dependem dos valores informados em Inputs habilitados e Outputs habilitados no cadastro do dispositivo.
Como os eventos são disparados
- Eventos de acesso: quando ocorre um log de evento vinculado em um bind, e o dispositivo está associado à área do evento, o ACCELERO publica a notificação no tópico MQTT do dispositivo (EyeFlow, DigiAI ou setoutput, conforme o tipo de integração do bind).
- Eventos Domocam: quando ocorre um evento Domocam do tipo e dispositivo vinculados em um bind Domocam, a mesma notificação é publicada.
- Mudança de phase / status: o ACCELERO escuta continuamente o estado de phase dos dispositivos e o status online/offline do gateway, usados pela regra de verificação de acesso.
- Alteração de cadastro: ao salvar ou excluir um dispositivo, o ACCELERO sincroniza a configuração de dispositivos com o gateway.
A integração roda dois processos contínuos (DigieyeEventListener e DigieyePhaseListener) que escutam os eventos e o estado dos dispositivos via MQTT. Eles são iniciados automaticamente com o ACCELERO.
Casos de uso
Notificar o Digieye a cada acesso de uma área
- Cadastre o dispositivo em
Configurações > Digieye, aba Devices, botão Novo device (série, IP, porta, gateway). - Edite o dispositivo e, em Dados gerais, selecione as Áreas associadas.
- Na aba Binds de eventos, crie um bind: selecione os tipos de evento, o Canal, Tipo de integração = EyeFlow (ou DigiAI) e a Classe.
- A partir daí, cada evento vinculado naquela área é notificado ao Digieye.
Acionar um output do Digieye em um evento
- No dispositivo, garanta o output desejado em Outputs habilitados.
- Na aba Binds de eventos, crie um bind com Tipo de integração = Ligar output e o Canal/output correspondente.
- Quando o evento vinculado ocorrer, o output é acionado.
Liberar acesso apenas em determinadas phases
- No dispositivo, defina Estratégia de validação = Phase.
- Preencha Phases habilitadas e a Phase default.
- Associe a área ao dispositivo e habilite a regra Verificação de phase em
Avançado > Sistema > Personalização - Regras de acesso customizáveis. - O acesso passa a depender da phase atual reportada pelo Digieye.
Boas práticas
- Áreas associadas corretas: a notificação de evento e a regra de acesso só atuam sobre as áreas associadas ao dispositivo — confirme o vínculo.
- Phase default consciente: defina a Phase default pensando no comportamento desejado quando o dispositivo estiver offline.
- Inputs/outputs explícitos: mantenha Inputs habilitados e Outputs habilitados atualizados para que as ações de I/O encontrem as saídas corretas.
- Gateway saudável: acompanhe a aba Gateways para garantir que os dispositivos estejam comunicando (status OK e última comunicação recente).
Troubleshooting
O Digieye não recebe notificações de evento
Possíveis causas:
- O dispositivo não está associado à área onde o evento ocorre.
- Não há bind para o tipo de evento.
- Gateway de comunicação offline.
Solução:
- Em Dados gerais, confirme as Áreas associadas.
- Em Binds de eventos, confirme que existe bind para o tipo de evento.
- Verifique o status do gateway na aba Gateways.
Acesso sendo negado inesperadamente
Possíveis causas:
- Regra Verificação de phase habilitada, dispositivo associado à área com estratégia Phase, e a phase atual não está habilitada.
- Dispositivo offline e Phase default fora das Phases habilitadas.
- I/O monitorado acionado (estratégia Monitoramento I/O).
Solução:
- Confira a Estratégia de validação e as Phases habilitadas do dispositivo.
- Verifique o status online/offline do gateway.
- Para a estratégia I/O, confira o estado do I/O para monitorar.
Output não é acionado
Possíveis causas:
- Output não consta em Outputs habilitados.
- Bind/ação de I/O com Canal/output incorreto.
- Gateway offline.
Solução:
- Confirme o output em Outputs habilitados.
- Revise o Canal/output do bind ou da ação Agir sobre output Digieye.
- Verifique a comunicação do gateway.
Integração com outros módulos
Áreas
O vínculo de Áreas ao dispositivo é o que define quais eventos são notificados e onde a regra de verificação de acesso atua.
Controladores e Logs
Os eventos que disparam notificações vêm dos logs de evento de acesso gerados pelos Controladores. Consulte Logs e Monitoramento para entender os tipos de evento disponíveis.
I/O e Automação
A ação Agir sobre output Digieye e a fonte I/O Digieye integram-se ao módulo de I/O e Automação.
Próximos Passos
- Áreas — Associe áreas aos dispositivos Digieye
- Controladores — Origem dos eventos de acesso
- Logs e Monitoramento — Entenda os tipos de evento que disparam notificações
- I/O e Automação — Use outputs e inputs Digieye em regras de I/O
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO