1 INTRODUÇÃO
1.1 Apresentação
O Driver Facial Topdata é um middleware desenvolvido pela Topdata para integrar os dispositivos de controle de acesso Topdata ao sistema de gestão Senior X. Ele atua como canal de comunicação bidirecional entre os equipamentos e a plataforma Senior, garantindo a troca organizada e segura de dados operacionais, registros de acesso e comandos administrativos.
Este manual reúne as orientações para instalação, configuração, integração e utilização do Driver Facial Topdata. Inclui requisitos de ambiente, parametrização, manutenção e procedimentos de diagnóstico, e é destinado a profissionais de TI, técnicos de integração e equipes responsáveis pela operação do sistema integrado.
1.2 Objetivo do manual
Este manual fornece as instruções necessárias para:
- Instalar o Driver Facial Topdata – Senior X;
- Configurar o Driver Facial Topdata – Senior X;
- Operar e monitorar o ambiente do Driver Facial Topdata – Senior X;
- Diagnosticar e solucionar problemas de comunicação entre o Driver Facial Topdata e o Senior X (Ronda X).
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, endereçamento IP e uso de proxy corporativo;
- Plataforma Senior X: cadastro de dispositivos e configuração de propriedades extensíveis.
1.4 Características
Principais características do Driver Facial Topdata – Senior X:
- Suporte a múltiplas tecnologias de leitura: compatível com leitores de proximidade, código de barras e SmartCard. Os crachás devem ter no máximo 12 dígitos para que a comunicação entre o crachá e o leitor facial ocorra corretamente.
- Integração com o Senior X: sincronização de usuários e credenciais, com suporte a comandos como ajuste de data e hora, envio de listas de usuários e consulta de status dos dispositivos.
- Cadastro de usuários com credencial e biometria facial: envio dos dados de crachá e da biometria facial para o leitor.
- Validação de acesso online: disponível quando o leitor é configurado para operar com catraca Easy.
- Atualização de credenciais: permite alterar e reatribuir crachás, além de atualizar fotos e demais informações do usuário.
- Interpretação de respostas: os comandos retornam respostas detalhadas, indicando sucesso, erro de processamento ou pendência.
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 Firewall e portas de comunicação
| Serviço | Porta | Protocolo | Descrição |
|---|---|---|---|
| API do Senior X | 443 | HTTPS | Comunicação REST com os serviços Senior |
| WebSocket de notificações | 443 | WSS | Recebimento de pendências do Senior X |
| WebSocket do leitor facial | 7792 (ou a definida na configuração) | WSS | Comunicação com os leitores faciais Topdata |
| Catraca Topdata | 3570 (ou a definida no Driver Acesso) | TCP/IP | Comunicação com as catracas Topdata |
Libere essas portas no firewall nos dois sentidos (entrada e saída).
2.3 Endereços e domínios utilizados
| Serviço | Endereço |
|---|---|
| API do Senior X | https://sam-api.senior.com.br/sdk/v1/ |
| WebSocket de notificações | wss://sam-api.senior.com.br/websocket/pendency |
Para validar a conectividade, execute no Prompt de Comando:
curl.exe -I https://sam-api.senior.com.br/sdk/v1/
O retorno esperado é HTTP 404. Esse código confirma que o servidor da Senior foi alcançado; a URL base da API não tem conteúdo próprio, por isso responde 404. Se o comando apresentar erro de tempo esgotado, de conexão recusada ou de resolução de nome, verifique firewall, proxy e DNS.
Use
curl.exe, e não apenascurl: no Windows PowerShell,curlé um alias de outro comando e não aceita o parâmetro-I.
2.4 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.5 Dependências
- .NET Desktop Runtime 8.0.8 (x86) ou superior.
O .NET Desktop Runtime é necessário para executar o serviço do driver e deve ser instalado antes da configuração do sistema.
2.6 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.
Esses requisitos garantem o desempenho mínimo para a execução do driver e sua integração com o Senior X.
3 CONFIGURAÇÃO DOS LEITORES FACIAIS NO SENIOR X
Antes de instalar o Driver Facial Topdata, é necessário cadastrar no Senior X:
- o driver que será usado pelos leitores faciais Topdata. Esse cadastro gera uma chave (Driver Key), que será informada durante a instalação;
- um dispositivo para cada leitor facial, vinculado a esse driver.
3.1 Modos de operação
O Driver Facial pode operar de duas formas:
- Modo Easy: o próprio leitor facial valida o acesso e aciona um relé para abrir uma porta ou liberar uma catraca Easy Topdata. Em ambos os casos não há controle do giro da catraca, apenas a liberação do acesso.
- Modo de manutenção de dados: o driver atua apenas como mantenedor de fotos e credenciais. Nesse cenário, é necessário um segundo driver para validar o acesso:
- Driver Acesso Topdata, para equipamentos de controle de acesso;
- Driver REP Topdata, para relógios de ponto (REP).
3.2 Gerar a Driver Key
- No Senior X, acesse Gestão de Riscos e Segurança → Ronda X → Controle de Acesso.
- Adicione um novo driver e, no campo Fabricante, selecione Driver SDK.
- Clique em Salvar. A chave será exibida automaticamente em um campo, conforme a figura abaixo.

Copie essa chave; ela será usada no passo de configuração da instalação (seção 4).
3.3 Cadastro do dispositivo
Cadastre um dispositivo para cada leitor facial, vinculado ao driver exclusivo criado na seção 3.2.
| Campo | Valor |
|---|---|
| Nome | Nome do dispositivo, usado para identificá-lo e organizar o ambiente no Senior X |
| Identificação da rede | Endereço IP do leitor facial |
| Driver | Driver exclusivo dos leitores faciais |
| Tipo gerenciador | Controle de Acesso |
| Propriedades extensíveis | Conforme a seção 3.4 |
| Leitor biométrico facial | 1 leitor biométrico facial |
| Leitor de cartão | 1 leitor de cartão de proximidade (quando necessário para enviar a credencial corretamente) |
Modelos suportados:
- Facial T4
- Facial F4
- Facial T4 50K
3.4 Propriedades extensíveis
3.4.1 Operação em modo Easy
Para que o leitor valide o acesso (catraca Easy ou porta Easy), cadastre:
| Identificador | Valor |
|---|---|
| Tipo | 7 |
Para controlador de porta, defina também o tempo de acionamento:
| Identificador | Valor |
|---|---|
| TEMPO_PORTA | Tempo, em segundos |
3.4.2 Formato do cartão quando integrado a outros dispositivos
Estas propriedades só estão disponíveis quando o leitor facial comunica diretamente com o driver ou está ligado a dispositivos Controle Catraca ou Inner Acesso II.
Leitor Abatrack — no Driver REP ou no Driver Acesso, o formato do cartão também deve ser Abatrack (geralmente TopProx):
| Identificador | Valor |
|---|---|
| FORMATO_WIEGAND | 2 |
| SAIDA_WIEGAND | 0 |
Leitor Wiegand (com Facility Code) — os equipamentos da linha Inner Acesso, já descontinuada, funcionam somente com esta configuração:
| Identificador | Valor |
|---|---|
| FORMATO_WIEGAND | 0 |
| SAIDA_WIEGAND | 1 |
3.5 Direção do dispositivo
Quando a validação de acesso é feita pelo leitor facial, ele deve estar configurado corretamente no Senior X como entrada ou saída. Como o equipamento não informa o sentido do giro, a resposta de acesso é registrada de acordo com a direção definida no cadastro do dispositivo no Senior X.
Nesta versão, isso se aplica a dois tipos de equipamento:
- Catraca Easy;
- Catraca Topdata com leitores faciais.
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.
- Faça o download do Driver Facial Topdata – Senior X.
- 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 (x86) ou superior está instalado. Caso não esteja, será exibida a mensagem: “Esta instalação requer o x86 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 x86; a versão de 64 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): informe os dados de comunicação com o Senior X, 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 Facial. Ele é aberto automaticamente durante a instalação e pode ser executado novamente a qualquer momento em:
C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\Servico\Configuracao\DriverFaceConfig.exe
5.1 Comunicação com os leitores faciais
| Campo | Descrição |
|---|---|
| Porta Leitor(es) Facial(is) | Porta usada na comunicação com os leitores faciais. Padrão: 7792. |
5.2 Dados do Senior Ronda X
| Campo | Descrição |
|---|---|
| Código do Driver na Senior (Driver Key) | Chave gerada no cadastro do driver no Senior X (seção 3.2). Identifica o driver na plataforma. |
| Chave de integração do parceiro | Chave que identifica a Topdata como parceira na integração. Já vem preenchida e só deve ser alterada mediante solicitação da Senior. |
| Endereço do banco de dados Senior (URL) | Endereço da API do Senior X, por meio da qual o driver consulta e envia dados. Padrão: https://sam-api.senior.com.br/sdk/v1/ |
| Endereço do WebSocket de comunicação da Senior | Canal WebSocket usado para receber as pendências do Senior X em tempo real. Padrão: wss://sam-api.senior.com.br/websocket/pendency |
Botões:
- Cancelar: fecha a tela sem salvar as alterações.
- Salvar: grava os dados para uso na comunicação com o Senior X.
6 REGISTRO DO WINDOWS
Durante a instalação, o Driver Facial grava suas configurações no Registro do Windows, na chave:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Topdata\DriverFacialSeniorX
Para consultar:
- Pressione Windows + R, digite
regedite pressione Enter. - Navegue até a chave acima.
- Verifique se os valores foram gravados corretamente.
| Valor | Tipo | Padrão | Descrição |
|---|---|---|---|
CaminhoInstalacao | REG_SZ | C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\... | Diretório de instalação do driver. |
DriverKey | REG_SZ | — | Driver Key gerada no Senior X (campo Código do Driver na Senior). |
LogCaminho | REG_SZ | C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\... | 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. |
PartnerKey | REG_SZ | — | Chave de integração do parceiro. |
PortaLeitor | REG_DWORD | 7792 | Porta de comunicação com os leitores faciais. |
Projeto | REG_DWORD | 1 | Parâmetro interno do driver. Não alterar. |
TempoComunicacaoInicial | REG_DWORD | 1000 | Parâmetro interno de temporização da comunicação. Não alterar. |
UrlDBSenior | REG_SZ | https://sam-api.senior.com.br/sdk/v1/ | Endereço da API do Senior X. |
UrlWebSocket | REG_SZ | wss://sam-api.senior.com.br/websocket/pendency | Endereço do WebSocket de pendências do Senior X. |
ATENÇÃO: essas informações são essenciais para a comunicação entre o driver, os leitores faciais e o Senior X. Alterar essas chaves manualmente sem o conhecimento adequado pode comprometer o funcionamento do driver. Para alterar a configuração, prefira o DriverFaceConfig (seção 5).
7 GERENCIAMENTO DO SERVIÇO
O Driver Facial é 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 Senior X 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 Facial é removido como qualquer outro programa do Windows:
- Acesse Configurações → Aplicativos → Aplicativos instalados (ou Painel de Controle → Programas e Recursos).
- Localize Driver Facial Topdata – Senior X.
- 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. Exemplo:
C:\Program Files (x86)\Topdata\Driver Facial Topdata - Senior X\Servico\Logs\20250814
| Arquivo | Conteúdo |
|---|---|
AYSD07033777_1 | Comunicação com o leitor facial. O nome corresponde ao número de série do leitor. |
CommunicationSenior | Registro bruto da comunicação com o Senior X: os comandos recebidos e enviados exatamente como trafegaram. Indicado para análise técnica detalhada. |
Info - [AYSD07033777] | Descrição legível das etapas de processamento de cada leitor facial (identificado pelo número de série). |
Info | Descrição legível do que está acontecendo na comunicação entre o driver e o Senior X — uma “tradução” do conteúdo do CommunicationSenior. 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 CADASTRO DE BIOMETRIAS FACIAIS NO EQUIPAMENTO
9.1 Pré-requisitos
A pessoa precisa ter uma credencial (crachá) cadastrada; o equipamento não aceita pessoas sem credencial. Ao cadastrar uma pessoa com permissão de acesso, o driver envia os dados diretamente ao equipamento, desde que ele esteja cadastrado e online.
9.2 Envio de carga para o equipamento
ATENÇÃO: antes de receber a carga, o equipamento remove todas as biometrias faciais nele cadastradas.
Para que o leitor facial libere o acesso por crachá, é preciso enviar antes a lista de liberação ao equipamento. O driver armazena essa lista em sua base interna e só a envia ao dispositivo depois de concluir o carregamento das biometrias faciais.
Se a capacidade máxima do leitor for excedida, a prioridade de armazenamento é sempre da credencial facial.
10 PARTICULARIDADES DO LEITOR
10.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.
10.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.
10.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.
10.4 Usuário administrador do leitor
Para restringir o acesso ao menu do leitor facial a administradores, cadastre um usuário e uma senha no cadastro do dispositivo no Senior X. Com essa configuração, somente quem souber a senha poderá acessar o menu do equipamento.
- Código do usuário administrador: sempre
99999999. Ele deve ser o primeiro usuário registrado no equipamento. - Senha: somente números, de 1 a 8 dígitos.
O cadastro do administrador não apaga os usuários nem altera as informações já armazenadas no equipamento.