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ço | Porta padrão | Descrição |
|---|---|---|
| Leitores faciais | 7792 | Comunicação entre o driver e os leitores faciais Topdata |
| Camada de Serviços Senior (HTTP) | 8088 | API da Senior usada pelo driver para ler as fotos das pessoas (seção 3.7) |
| Servidor Senior (concentradora) | 61000 | Comunicaçã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:
- o driver que fará a comunicação entre o Senior XT e os leitores faciais;
- um catálogo (modelo de coletor) para os leitores faciais Topdata;
- 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
- No Senior XT, acesse Gestão de Acesso e Segurança.
- Navegue até Menu → Projeto físico → Dispositivos → Driver, onde são listados todos os drivers configurados.
- Informe um código e uma identificação para o driver.
- Selecione o protocolo 8.
- 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.

| Campo | Valor |
|---|---|
| Modelo de Coletor | Código e descrição livres (ex.: 7700 – DISPOSITIVO FACIAL TOPDATA) |
| Categoria do Modelo | 01 – Terminal |
| Fabricante | 20 – Topdata |
| Modelo Controlador | 069 – Inner |
| Classificação do Modelo | 08 – Controlador Acesso |
| Protocolo | 3 – TCP-IP |
| Mídia de Comunicação | 01 – Ethernet |
| Banda de Comunicação | 04 – 10mbs |
| Código Driver Integrador | Código do driver cadastrado na seção 3.2 |
| Quantidade Interface Entrada | 000 |
| Quantidade Interface Saída | 000 |
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:
| Componente | Quantidade |
|---|---|
| Dispositivo gerenciador | 1 |
| Leitor biométrico facial | 1 |
| 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:
| Identificador | Valor |
|---|---|
| Tipo | 7 |
Para controle de porta, defina também o tempo de acionamento:
| Identificador | Valor |
|---|---|
| TEMPO_PORTA | Tempo, 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.
| Identificador | Valor |
|---|---|
| USUARIO_ADMIN | Código do usuário administrador: somente números, até 12 dígitos |
| SENHA_ADMIN | Senha 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.
| Identificador | Valor |
|---|---|
| ROSTO_VIVO | 1 – validação baixa2 – validação média3 – 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:
- Abra a Central de Configurações Senior (SeniorConfigCenter).
- Navegue até Sistemas → Ronda Senior → Concentradora → Camada de Serviços.
- Selecione o servidor e clique em Editar.
- Marque Habilitar conexão não segura (HTTP).
- Confira o valor de Porta HTTP dos serviços/aplicações web (padrão:
8088). - 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.
- Execute o instalador: localize o arquivo de instalação, clique duas vezes nele e, se solicitado, conceda privilégios de administrador.
- 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.
- Inicie a instalação: na tela inicial do instalador, clique em Avançar.
- Selecione o local de instalação: escolha o diretório de instalação. Recomenda-se manter o caminho padrão.
- 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).
- 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

| Campo | Descrição |
|---|---|
| Porta Leitores Faciais | Porta usada na comunicação com os leitores faciais. Padrão: 7792. |
| Endereço do Servidor Senior | Endereço IP do computador onde está instalada a concentradora Senior. |
| Porta HTTP dos Serviços/Aplicações Web – Senior XT | Porta 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 Certificado | Caminho do certificado Senior. Padrão: C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\Servico\Certificado\TPD.CER |
| Código do driver no sistema Senior | Có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:
- Pressione Windows + R, digite
regedite pressione Enter. - Navegue até a chave acima.
- Verifique se os valores correspondem à configuração feita no DriverFaceConfig (seção 5).
| Valor | Tipo | Padrão | Descrição |
|---|---|---|---|
CaminhoCertificado | REG_SZ | C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\Servico\Certificado\TPD.CER | Caminho do arquivo de certificado Senior (campo Arquivo do Certificado). |
CaminhoInstalacao | REG_SZ | C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\... | Diretório de instalação do driver. |
CodigoDriverSenior | REG_SZ | — | Código do driver cadastrado no Senior XT (campo Código do driver no sistema Senior). |
IntervaloPedidoHTTP | REG_DWORD | 30000 | Parâmetro interno de temporização. Não alterar. |
IntervaloSincronizacao | REG_DWORD | 10 | Parâmetro interno de temporização. Não alterar. |
IpServidorSenior | REG_SZ | — | Endereço IP do servidor da concentradora Senior (campo Endereço do Servidor Senior). |
LogCaminho | REG_SZ | C:\Program Files\Topdata\Driver Facial Topdata - Senior XT\... | Pasta onde os logs são gravados (seção 8). |
LogMesesApagar | REG_DWORD | 3 | Quantidade de meses que os logs são mantidos antes de serem apagados. |
PortaComunicacaoSenior | REG_SZ | 8088 | Porta HTTP da Camada de Serviços Senior, usada para ler as fotos (campo Porta HTTP dos Serviços/Aplicações Web – Senior XT). |
PortaLeitor | REG_DWORD | 7792 | Porta de comunicação com os leitores faciais. |
PortaServidorSenior | REG_SZ | 61000 | Porta de comunicação com o servidor da concentradora Senior. |
Projeto | REG_DWORD | 1 | Parâmetro interno do driver. Não alterar. |
TempoComunicacaoInicial | REG_DWORD | 1000 | Parâmetro interno de temporização. Não alterar. |
UrlDB | REG_SZ | C:\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:
- Pressione Windows + R.
- Digite
services.msce pressione Enter.
7.1 Iniciar o serviço
Se o serviço não estiver em execução ou tiver sido parado manualmente:
- Localize o serviço DriverFacialTopdata_RondaSeniorXT.
- Clique com o botão direito sobre ele e selecione Iniciar.
- O status mudará para Em execução.
7.2 Parar o serviço
Para manutenção ou diagnóstico:
- Localize o serviço DriverFacialTopdata_RondaSeniorXT.
- 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:
- Acesse Configurações → Aplicativos → Aplicativos instalados (ou Painel de Controle → Programas e Recursos).
- Localize o Driver Facial Topdata – Ronda Senior XT.
- 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.
| Arquivo | Conteúdo |
|---|---|
<número de série>_1 | Comunicaçã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. |
Info | Descriçã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.