Manual do Driver Facial Topdata – Ronda Senior XT

1 INTRODUÇÃO

1.1 Apresentação

O Driver Facial Topdata – Ronda Senior XT integra os leitores faciais Topdata à plataforma Ronda Senior XT, permitindo cadastrar, gerenciar e monitorar acessos em tempo real com a infraestrutura da Senior. O driver mantém fotos e dados dos usuários atualizados nos leitores e faz a comunicação entre os equipamentos e o Senior XT.

Este manual orienta desde a instalação do driver até a configuração e a operação dos leitores faciais integrados. É destinado a profissionais de TI, técnicos de integração e equipes responsáveis pela operação do sistema.

1.2 Objetivo do manual

Este manual fornece as instruções necessárias para:

  • Configurar o driver, o catálogo e os dispositivos faciais no Ronda Senior XT;
  • Instalar o Driver Facial Topdata – Ronda Senior XT;
  • Configurar o driver no DriverFaceConfig;
  • Gerenciar o serviço do driver no Windows;
  • Diagnosticar problemas por meio dos logs.

1.3 Conhecimentos necessários

Recomenda-se que o profissional responsável tenha conhecimento sobre:

  • Sistema operacional Windows: instalação de serviços e gerenciamento de permissões de usuários;
  • Redes TCP/IP: configuração de firewall, roteamento e endereçamento IP;
  • Ronda Senior XT: cadastro de drivers, catálogos, dispositivos e propriedades extensíveis.

2 REQUISITOS DO SISTEMA

2.1 Permissões

A conta utilizada para instalar e executar o serviço do driver deve ter permissão de administrador local do Windows.

2.2 Portas de comunicação

ServiçoPorta padrãoDescrição
Leitores faciais7792Comunicação entre o driver e os leitores faciais Topdata
Camada de Serviços Senior (HTTP)8088API da Senior usada pelo driver para ler as fotos das pessoas (seção 3.7)
Servidor Senior (concentradora)61000Comunicação entre o driver e o servidor da concentradora Senior

As portas podem ser alteradas no DriverFaceConfig (seção 5). Libere-as no firewall nos dois sentidos (entrada e saída).

2.3 Sistemas operacionais suportados

  • Windows 10 (64 bits)
  • Windows 11 (64 bits)
  • Windows Server (versões compatíveis com o .NET Desktop Runtime 8.0.8)

Todos os sistemas devem estar atualizados com os pacotes de correção e de segurança mais recentes.

2.4 Dependências

  • .NET Desktop Runtime 8.0.8 (x64) ou superior.

2.5 Requisitos mínimos de hardware

  • Processador: dual-core de 1,6 GHz ou superior;
  • Memória RAM: 8 GB ou mais;
  • Espaço em disco: pelo menos 5 GB livres para a instalação e o armazenamento dos logs.

3 CONFIGURAÇÃO NO RONDA SENIOR XT

Antes de instalar o driver, é necessário cadastrar no Senior XT:

  1. o driver que fará a comunicação entre o Senior XT e os leitores faciais;
  2. um catálogo (modelo de coletor) para os leitores faciais Topdata;
  3. um dispositivo para cada leitor facial.

3.1 Tipos de equipamento

Nesta versão, há dois tipos de equipamento:

  • Catraca Easy: equipamento sem placa controladora. O leitor facial identifica a pessoa, a Senior valida o acesso e o leitor aciona a liberação. Não há controle do giro como em uma catraca comum: o leitor apenas aciona a entrada ou a saída, conforme a direção configurada no dispositivo. Funciona como um controlador de porta, e a mesma configuração pode ser usada para controlar uma porta com o leitor facial.
  • Catraca Topdata ou Inner Ponto 4 com leitores faciais: o equipamento é controlado pelo seu próprio driver — Driver Acesso Topdata para catracas e Driver REP Topdata para o Inner Ponto 4 —, e os leitores faciais são controlados pelo Driver Facial Topdata – Ronda Senior XT, que mantém as fotos e os dados dos usuários atualizados no leitor. Nesse caso, os leitores faciais precisam de cadastro próprio, independente do cadastro do equipamento.

3.2 Cadastro do driver

  1. No Senior XT, acesse Gestão de Acesso e Segurança.
  2. Navegue até Menu → Projeto físico → Dispositivos → Driver, onde são listados todos os drivers configurados.
  3. Informe um código e uma identificação para o driver.
  4. Selecione o protocolo 8.
  5. Clique em Inserir.

Anote o código do driver. Ele será usado no cadastro do catálogo (seção 3.3) e na configuração do DriverFaceConfig (seção 5).

3.3 Cadastro do catálogo

Cadastre um modelo de coletor para os leitores faciais Topdata, preenchendo a aba Cadastro conforme a tabela abaixo. Os demais campos permanecem com o valor padrão.

CampoValor
Modelo de ColetorCódigo e descrição livres (ex.: 7700 – DISPOSITIVO FACIAL TOPDATA)
Categoria do Modelo01 – Terminal
Fabricante20 – Topdata
Modelo Controlador069 – Inner
Classificação do Modelo08 – Controlador Acesso
Protocolo3 – TCP-IP
Mídia de Comunicação01 – Ethernet
Banda de Comunicação04 – 10mbs
Código Driver IntegradorCódigo do driver cadastrado na seção 3.2
Quantidade Interface Entrada000
Quantidade Interface Saída000

3.4 Cadastro do dispositivo

Cadastre um dispositivo para cada leitor facial, usando o catálogo criado na seção 3.3, mesmo que o leitor esteja integrado a outro equipamento de acesso. Cada dispositivo deve ter:

ComponenteQuantidade
Dispositivo gerenciador1
Leitor biométrico facial1
Leitor de cartão (código de barras, proximidade ou SmartCard)1

3.5 Propriedades extensíveis

As propriedades extensíveis são cadastradas no dispositivo de cada leitor facial.

3.5.1 Catraca Easy

Para que o leitor facial libere o acesso no modo Catraca Easy (catraca ou porta), cadastre:

IdentificadorValor
Tipo7

Para controle de porta, defina também o tempo de acionamento:

IdentificadorValor
TEMPO_PORTATempo, em segundos

3.5.2 Usuário administrador do leitor

Para restringir o acesso ao menu do leitor facial, cadastre um usuário e uma senha de administrador. Com essa configuração, somente quem souber a senha poderá acessar o menu do equipamento.

IdentificadorValor
USUARIO_ADMINCódigo do usuário administrador: somente números, até 12 dígitos
SENHA_ADMINSenha do administrador: somente números, até 8 dígitos

3.5.3 Detecção de rosto vivo

Define o nível de detecção de rosto vivo (prova de vida), que impede o acesso com fotos ou vídeos do rosto da pessoa.

IdentificadorValor
ROSTO_VIVO1 – validação baixa
2 – validação média
3 – validação alta

O driver só envia essa configuração ao leitor quando a propriedade está cadastrada no dispositivo. Sem ela, o leitor mantém a configuração de rosto vivo que já possui.

3.6 Credenciais das pessoas

Para que a pessoa seja cadastrada no leitor facial, ela precisa ter no Senior XT:

  • uma credencial de biometria facial;
  • uma credencial de cartão da mesma tecnologia do leitor de cartão cadastrado no dispositivo.

O número do cartão é o identificador da pessoa no leitor facial. Por padrão, ele usa o formato Wiegand 42; por isso, o número digitado deve ter no máximo 12 dígitos.

3.7 Camada de Serviços (Central de Configurações Senior)

O driver lê as fotos das pessoas por meio de uma API HTTP da Senior, configurada na Camada de Serviços da concentradora. No servidor da Senior:

  1. Abra a Central de Configurações Senior (SeniorConfigCenter).
  2. Navegue até Sistemas → Ronda Senior → Concentradora → Camada de Serviços.
  3. Selecione o servidor e clique em Editar.
  4. Marque Habilitar conexão não segura (HTTP).
  5. Confira o valor de Porta HTTP dos serviços/aplicações web (padrão: 8088).
  6. Clique em OK.

Essa mesma porta deve ser informada no campo Porta HTTP dos Serviços/Aplicações Web – Senior XT do DriverFaceConfig (seção 5).


4 INSTALAÇÃO DO DRIVER FACIAL

A instalação inclui a instalação do serviço no Windows e a configuração inicial feita no DriverFaceConfig.

  1. Execute o instalador: localize o arquivo de instalação, clique duas vezes nele e, se solicitado, conceda privilégios de administrador.
  2. Verificação de pré-requisitos: o instalador verifica automaticamente se o .NET Desktop Runtime 8.0.8 (x64) ou superior está instalado. Caso não esteja, será exibida a mensagem:“Esta instalação requer o x64 Runtime do .NET versão 8.0.0. Instale o Runtime do .NET e execute a instalação novamente. O Runtime do .NET pode ser obtido na Web. Deseja fazer isso agora?”Ao confirmar, você será redirecionado para a página de download. Baixe e instale o .NET Desktop Runtime 8.0.8 na versão x64; a versão x86 (32 bits) não é compatível.NOTA: instale o Desktop Runtime. As opções .NET Runtime e ASP.NET Core Runtime não funcionam. O SDK também funciona, mas não é recomendado, pois contém componentes desnecessários para o driver.
  3. Inicie a instalação: na tela inicial do instalador, clique em Avançar.
  4. Selecione o local de instalação: escolha o diretório de instalação. Recomenda-se manter o caminho padrão.
  5. Configure o driver (DriverFaceConfig): o DriverFaceConfig é aberto automaticamente. Informe os dados descritos na seção 5. Os dados são gravados no Registro do Windows (seção 6).
  6. Conclua a instalação: o instalador copia os arquivos e registra o serviço no Windows. Clique em Fechar para finalizar.

5 CONFIGURAÇÃO DO DRIVER FACIAL

O DriverFaceConfig é o utilitário de configuração que acompanha o driver. Ele é aberto automaticamente durante a instalação e pode ser executado novamente a qualquer momento a partir da pasta:

C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\Servico\Configuracao
CampoDescrição
Porta Leitores FaciaisPorta usada na comunicação com os leitores faciais. Padrão: 7792.
Endereço do Servidor SeniorEndereço IP do computador onde está instalada a concentradora Senior.
Porta HTTP dos Serviços/Aplicações Web – Senior XTPorta da API da Senior usada para ler as fotos das pessoas. Deve ser igual à configurada na Camada de Serviços (seção 3.7). Padrão: 8088.
Arquivo do CertificadoCaminho do certificado Senior. Padrão: C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\Servico\Certificado\TPD.CER
Código do driver no sistema SeniorCódigo do driver cadastrado no Senior XT (seção 3.2).

6 REGISTRO DO WINDOWS

Durante a instalação, o driver grava suas configurações no Registro do Windows, na chave:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Topdata\DriverFacialTopdataXT

Para consultar:

  1. Pressione Windows + R, digite regedit e pressione Enter.
  2. Navegue até a chave acima.
  3. Verifique se os valores correspondem à configuração feita no DriverFaceConfig (seção 5).
ValorTipoPadrãoDescrição
CaminhoCertificadoREG_SZC:\Program Files\Topdata\Driver Facial Topdata - Senior XT\Servico\Certificado\TPD.CERCaminho do arquivo de certificado Senior (campo Arquivo do Certificado).
CaminhoInstalacaoREG_SZC:\Program Files\Topdata\Driver Facial Topdata - Senior XT\...Diretório de instalação do driver.
CodigoDriverSeniorREG_SZ—Código do driver cadastrado no Senior XT (campo Código do driver no sistema Senior).
IntervaloPedidoHTTPREG_DWORD30000Parâmetro interno de temporização. Não alterar.
IntervaloSincronizacaoREG_DWORD10Parâmetro interno de temporização. Não alterar.
IpServidorSeniorREG_SZ—Endereço IP do servidor da concentradora Senior (campo Endereço do Servidor Senior).
LogCaminhoREG_SZC:\Program Files\Topdata\Driver Facial Topdata - Senior XT\...Pasta onde os logs são gravados (seção 8).
LogMesesApagarREG_DWORD3Quantidade de meses que os logs são mantidos antes de serem apagados.
PortaComunicacaoSeniorREG_SZ8088Porta HTTP da Camada de Serviços Senior, usada para ler as fotos (campo Porta HTTP dos Serviços/Aplicações Web – Senior XT).
PortaLeitorREG_DWORD7792Porta de comunicação com os leitores faciais.
PortaServidorSeniorREG_SZ61000Porta de comunicação com o servidor da concentradora Senior.
ProjetoREG_DWORD1Parâmetro interno do driver. Não alterar.
TempoComunicacaoInicialREG_DWORD1000Parâmetro interno de temporização. Não alterar.
UrlDBREG_SZC:\Program Files\Topdata\Driver Facial Topdata - Senior XT\...Caminho da base de dados interna do driver. Não alterar.

ATENÇÃO: essas informações são essenciais para a comunicação entre o driver, os leitores faciais e o Ronda Senior XT. Alterar essas chaves manualmente sem o conhecimento adequado pode comprometer o funcionamento do driver. Para alterar a configuração, prefira o DriverFaceConfig.


7 GERENCIAMENTO DO SERVIÇO

O driver é instalado como um serviço do Windows e é executado automaticamente em segundo plano. O gerenciamento é feito pelo console de Serviços:

  1. Pressione Windows + R.
  2. Digite services.msc e pressione Enter.

7.1 Iniciar o serviço

Se o serviço não estiver em execução ou tiver sido parado manualmente:

  1. Localize o serviço DriverFacialTopdata_RondaSeniorXT.
  2. Clique com o botão direito sobre ele e selecione Iniciar.
  3. O status mudará para Em execução.

7.2 Parar o serviço

Para manutenção ou diagnóstico:

  1. Localize o serviço DriverFacialTopdata_RondaSeniorXT.
  2. Clique com o botão direito sobre ele e selecione Parar.

OBSERVAÇÃO: parar o serviço interrompe a comunicação com o Ronda Senior XT e com os leitores faciais. Certifique-se de que não há operações críticas em andamento.

7.3 Desinstalar o driver

O driver é removido como qualquer outro programa do Windows:

  1. Acesse Configurações → Aplicativos → Aplicativos instalados (ou Painel de Controle → Programas e Recursos).
  2. Localize o Driver Facial Topdata – Ronda Senior XT.
  3. Clique em Desinstalar e siga as instruções.

8 ANÁLISE DOS LOGS

Os logs ficam na pasta Servico\Logs do diretório de instalação, em uma subpasta por dia, no formato AAAAMMDD.

ArquivoConteúdo
<número de série>_1Comunicação com o leitor facial. O nome corresponde ao número de série do leitor.
Info - [<número de série>]Descrição legível das etapas de processamento de cada leitor facial.
InfoDescrição legível da comunicação entre o driver e o Senior XT. Indicado como ponto de partida no diagnóstico.

Os logs são mantidos por 3 meses por padrão; após esse período, são apagados automaticamente. O prazo é definido pelo valor LogMesesApagar no Registro do Windows (seção 6).


9 PARTICULARIDADES DO LEITOR

9.1 Credenciais de crachá

O leitor facial aceita apenas uma credencial de crachá por usuário. Se a pessoa tiver duas ou mais credenciais, o acesso será feito com a primeira cadastrada.

9.2 Emergência

O leitor facial responde ao comando de emergência, mas libera o acesso apenas uma vez: por configuração interna do equipamento, o relé não permanece acionado.

9.3 Acesso negado

Quando a face da pessoa não está cadastrada, o leitor não exibe a mensagem “Acesso negado”. Como o equipamento não reconhece a pessoa, ele não consegue associar um código a ela e, portanto, não tem como informar que a credencial é inválida.

Esse artigo foi útil?

Artigos relacionados