Integração com driver Apollo

O Ronda senior X possui integração com o driver do fabricante Apollo, que pode ser utilizado em dispositivos cadastrados no sistema. Esta página detalha especificações sobre o funcionamento deste driver, sua configuração e quais recursos do sistema são atendidos por ele.

Funcionamento do driver Apollo

Instalação e configuração do driver

O driver Apollo deve ser instalado no cliente para que a integração com dispositivos Apollo ocorra com sucesso. O driver monitora a comunicação (on-line ou off-line) com todos os dispositivos conectados a ele, envia-lhes dados e informações, e efetua os procedimentos necessários para sua integração com o sistema.

Para obter o driver Apollo, efetue um cadastro na tela de drivers e selecione o item "Apollo" no campo Tipo do driver. Em seguida, para baixá-lo, acesse a tela Downloads. Depois que o driver estiver descompactado, ele pode ser iniciado e parado através dos arquivos start-service.bat e stop-service.bat, respectivamente.

A configuração do driver é feita no arquivo config.properties, que fica no diretório onde o driver foi descompactado. Este arquivo também pode ser obtido pelo botão Baixar arquivo de configuração da tela de drivers. O arquivo possui as configurações padrão já preenchidas, mas se for necessário alterar algum dos seus campos, utilize um editor de texto (Bloco de Notas, por exemplo) para abri-lo.

Campos do arquivo config.properties

• sdk.host: endereço de acesso ao Ronda senior X seguido da porta e outros parâmetros.
• sdk.api_key: token gerado para este driver na tela de cadastro de drivers.
• sdk.connection.timeout: tempo máximo, em milissegundos, pelo qual o driver Apollo irá esperar pela resposta de uma placa antes de considerá-la off-line.
• sdk.request.timeout: intervalo de tempo, em milissegundos, no qual o driver Apollo fará a busca de eventos em cada placa.

Estas configurações são enviadas aos dispositivos quando o driver Apollo for iniciado e quando o comando "Configurar dispositivo" for enviado no sistema.

Informações de pessoas, crachás, locais e permissões de acesso são enviadas ao dispositivo sempre que houver uma inclusão, alteração ou exclusão nestes dados. "Permissões de acesso" aqui correspondem a tudo que define se uma pessoa pode efetuar acesso em um dispositivo: papéis, níveis, faixas horárias e afins. Somente pessoas que possuam acesso permitido no dispositivo e não estejam bloqueadas são enviadas.

Ao enviar estas informações e configurações aos dispositivos, se a comunicação estiver off-line, estes dados serão enviados no momento que a comunicação for restabelecida.

Geração de logs

Os procedimentos efetuados pelo driver Apollo são registrados em arquivos de log, que podem ser acessados dentro da pasta onde o driver está instalado. Cada mensagem do log possui uma classificação dentre as seguintes:

• FATAL: mensagens que interrompem o funcionamento da aplicação, forçando o serviço ou o executável a ser reiniciado;
• ERROR: mensagens de mal funcionamento da aplicação, que deve ser analisada pela equipe técnica da Senior, porém o serviço ou o executável continua executando;
• WARN: mensagens que indicam falha em cadastros ou nas configurações do sistema. Devem ser analisadas pelo administrador do sistema;
• INFO: mensagens de funcionamento normal do sistema (exemplos: evento recebido, pendência enviada, etc.) para efeitos informativos;
• DEBUG: mensagens de funcionamento interno de componentes do sistema (exemplos: timer iniciado, parâmetros lidos, etc.) para efeitos informativos à equipe técnica da Senior. Esse nível de log deve ser habilitado somente em caso de problemas com o ambiente;
• TRACE: mensagens de funcionamento interno de componentes do sistema, com detalhes dos dados que estão sendo tratados.

Informações diversas desta integração

Validações realizadas pelo driver Apollo

As validações de acesso são sempre realizadas nos dispositivos - em outras palavras, baseando-se nas informações que foram enviadas aos dispositivos e encontram-se neles, e não nas informações cadastradas no sistema, que podem não constar nos dispositivos ainda.

Relação entre recursos da Apollo e do Ronda senior X

Os dispositivos Apollo possuem um certo padrão nos nomes dos seus recursos. Como o Ronda senior X possui recursos equivalentes com nomes diferentes, a tabela abaixo relaciona esses termos para facilitar sua compreensão:

Limitações identificadas

Placas AAN têm um limite de dados que podem estar relacionados a elas. Cada placa pode possuir:

• Até 124 time zones (faixas horárias de local) diferentes cadastradas, cada uma contendo até seis faixas.
• Até 254 access levels (papéis) diferentes cadastrados, cada um contendo até 96 leitoras referenciadas a ele.
• Até 100 feriados.
• Até 255 permissões.

Outras limitações encontradas:

• Um cartão associado à placa pode possuir até 37 access levels (papéis). Em outras palavras, uma pessoa cadastrada no Ronda senior X cujo cadastro será usado em placas Apollo pode possuir até 37 papéis diferentes.
• Ao incluir um cartão na placa, é preciso informar o identificador do local atual da pessoa. Esta informação é limitada a 96 locais diferentes, pois esta é a quantidade máxima de leitoras que uma placa pode possuir.
• As placas Apollo suportam cartões dos formatos Magnético (1 ou 2 dígitos de erro) e Wiegand. No momento, o Ronda senior X utiliza somente o formato Wiegand.
• Pode-se cadastrar na placa até 8 formatos Wiegand, 8 formatos Magnéticos com 1 dígito de erro e 8 formatos Magnéticos com 2 dígitos de erro.