DOCUMENTO TÉCNICO RQ-130

Transcrição

1 DT nº: 2/5-14 Referente OE nº: Página:1 / 36 Objetivo: Descrever o funcionamento das funções existentes na DLL do REP-G1, G2 e G3. HISTÓRICO DE REVISÕES Release Escrito por Data Aprovado por Descrição 0 Augusto Serrão 05/09/2016 Versão inicial do documento. 1 Augusto Serrão 27/09/2016 Alteração referentes a DLL 01_005_ Augusto Serrão 20/10/2016 Alteração referentes a DLL 01_005_ Augusto Serrão 28/10/2016 Alteração referentes a DLL 01_005_ Ricardo Oliveira 01/11/2016 Alteração geral na documentação e inclusão da função REP_Mensagem_Erro Funções 3.1. REP_Conexao_Simples REP_Conexao_Direta_G REP_ConexaoComPorta REP_InfoTerminal REP_Tempo REP_LeTemperatura REP_Rede_Simples REP_LeCadastro REP_LeIntervaloNSR REP_LeTipoReg REP_LeRegEmpregador REP_LeRegPonto REP_LeRegFuncionario REP_GravaCadastroEmpregador REP_GravaCadastroFuncionario REP_ExcluiCadastroFuncionario REP_LeEspacoMemoria REP_LeNSR REP_StatusImpressora REP_LeFinger REP_GravaFinger REP_GravaFinger_Bytes REP_FormataFinger REP_RemoverFingerID REP_LeFingerID REP_LeFingerID_Bytes REP_LeFingerIDEspecifico_Bytes REP_LeFingersIdsPis REP_Versao REP_StatusBateria REP_ConfigRede REP_WifiConfig REP_InterfaceRede REP_GravaNovaSenha REP_LeFuncionario... 30

2 Página: 2 / REP_LeStatusMemoriaTrabalho REP_GravaFuncionariosPorArquivo REP_AtualizaFirmware REP_EnviaAssinaturaFirmware REP_MensagemErro Funcionamento da DLL Este documento possui todos os protótipos de função, de modo a tornar possível o uso da biblioteca. A partir desta, todo programa pode comunicar com os aparelhos R.E.P. REP_FUNCAO está definida como VOID (sem retorno), que será o padrão. Para observar erros na execução, o parâmetro pdwresult deve ser conferido após a chamada da função. Ao final do documento pode ser encontrada uma lista dos possíveis valores de erro e seus significados. Tenha o cuidado de reservar memória suficiente para o uso de parâmetros de saída. Caso contrário, a biblioteca poderá escrever em regiões de memória indesejadas. Para mandar mensagem / conectar / desconectar de um terminal, deverá ser passado o valor de seu endereço IP via parâmetro sip. " ", sempre terminando com um caracter nulo. Para os comandos que utilizam x, sendo x qualquer valor ou caracter sempre mandar no formato ASCII. 2 ou 0x32 a ou 0x61 2. Arquivo de configuração para REP-G3 Diferentemente do REP-G1 e G2, o REP-G3 precisa do CPF do usuário, Masterkey e senha do equipamento para se comunicar. Sem essas informações, não é possível realizar a maior parte das funções de gravação disponíveis. Assim, caso o ambiente tenha um ou mais REP-G3 (até 32), é necessário criar um arquivo chamado RepConfig.ini que conterá as informações de cada REP e será lido pela DLL. O layout deste arquivo funciona da seguinte forma: A primeira linha deve ser preenchida com o CPF do usuário, contendo 11 dígitos, ou com a string G3. Esta string serve como uma Flag para que em sistemas legados que não tenham mais REPs antigos (G1 e G2), possa ser possível conectar-se com REP-G3 sem ter que esperar 8 segundos devido a tentativa de conexão com os outros REPs.

3 Página: 3 / 36 Caso a primeira linha tenha sido preenchida com a Flag, a segunda deve conter o CPF. A linha seguinte ao CPF deve conter a seguinte sequência de dados: NFR[17 caracteres],mastekey[64 caracteres],senha[máx 8, mín 4]; Caso exista mais de um REP-G3 a ser conectado, basta adicionar uma nova linha com as configurações do respectivo equipamento. Abaixo, encontra-se um exemplo de arquivo de configuração para dois REPs: G ,F026079DBE237E23F2D0B9744CF2B00B35DC6E646EE3F08CC85CD361EABC05C7,12345; ,B23F1379EBCA6B4A68BFE8EECFD6B AACB E DB65,123456; Assim que a DLL tentar abrir conexão com algum REP pela primeira vez, ela lerá este arquivo, guardará suas informações em RAM e criará um novo arquivo chamado RepConfig.enc. Este novo arquivo contém a Flag de REP-G3, caso o primeiro documento tiver, o CPF e um dado criptografado. Este dado corresponde às informações dos REPs do primeiro arquivo. Neste momento, não é mais necessário ter o arquivo RepConfig.ini, que contém as informações em aberto, no diretório da aplicação. Sempre, na primeira vez em que a DLL for abrir conexão com um REP e ela não encontrar o primeiro arquivo, ela buscará o arquivo criptografado para encontrar as configurações. Caso seja necessário adicionar um novo REP-G3 na rede, o arquivo.ini deverá ser modificado e posto no diretório da aplicação novamente. Sempre, a DLL enviará um comando de GetNFR para o IP correspondente, na primeira conexão com o mesmo, para associar seu NFR às configurações lidas do arquivo. 3. Funções 3.1. REP_Conexao_Simples Estabelece / cancela conexão com determinado terminal. Possibilita a autenticação como administrador ou usuário de rede. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_Conexao_Simples ( BYTE * sip, BYTE bacao, DWORD * dwresult );

4 Página: 4 / 36 bacao (BYTE [IN]) Operação a ser realizada: o 0 Finaliza conexão (se sip = NULL, terminará todas as conexões). o 1 Pedido de entrada como usuário de rede o 2 Finaliza sessão de administrador o 3 Inicia modo administrador REP_Conexao_Simples(" ",. 1, // Entrar como usuário de rede Para REP-G3, esta função demora mais de 8 segundos para ser executada, pois se, por acaso, tentar conectar diretamente com o REP-G3 e na verdade existir um REP-G2 ou G1 este endereço IP, este REP irá travar e deverá ser reiniciado. Portanto, a DLL tentará abrir conexão primeiramente com um REP-G1 ou G2 com 8 segundos para receber uma resposta dos mesmos. Caso a resposta não chegue, ela tentará conexão com um G3. Para casos de conexão com REP-G3, não interessa o valor de entrada do parâmetro bacao, pois o REP não possui tipos de entrada REP_Conexao_Direta_G3 Estabelece conexão com determinado terminal de REP-G3. Utilizando esta função, a DLL não tentará abrir conexão com um REP-G1 ou G2 antes. Utilizado apenas para REP-G3. REP_FUNCAO REP_Conexao_Direta_G3 ( BYTE * sip, DWORD * dwresult );

5 Página: 5 / 36 REP_Conexao_Direta_G3(" ", Não é aconselhável utilizar esta função em ambientes com diferentes versões de REP REP_ConexaoComPorta Estabelece / cancela conexão com determinado terminal. Possibilita a autenticação como administrador ou usuário de rede. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_ConexaoComPorta ( BYTE * sip, USHORT usporta, BYTE bacao, DWORD * dwresult ); usporta (BYTE [IN]) Porta de conexão do terminal bacao (BYTE [IN]) Operação a ser realizada: o 0 Finaliza conexão (se sip = NULL, terminará todas as conexões). o 1 Pedido de entrada como usuário de rede o 2 Finaliza sessão de administrador o 3 Inicia modo administrador

6 Página: 6 / 36 REP_ConexaoComPorta(" ",. 5220, // Porta. 1, // Entrar como usuário de rede Para REP-G3, esta função demora mais de 8 segundos para ser executada, pois se, por acaso, tentar conectar diretamente com o REP-G3 e na verdade existir um REP-G2 ou G1 com este endereço IP, este REP irá travar e deverá ser reiniciado. Portanto, a DLL tentará abrir conexão primeiramente com um REP-G1 ou G2 com 8 segundos para receber uma resposta dos mesmos. Caso a resposta não chegue, ela tentará conexão com um G3. Para casos de conexão com REP-G3, não interessa o valor de entrada do parâmetro bacao, pois o REP não possui tipos de entrada REP_InfoTerminal Leitura da informação de identificação geral do aparelho. Utilizado para REP- G1, G2 e G3. Esta função retorna o NFR do equipamento. REP_FUNCAO REP_InfoTerminal ( BYTE * sip, BYTE * snome, DWORD * dwresult ); snome (BYTE * [OUT]) Nome do terminal em formato string REP_InfoTerminal(" ",. snome, // Leitura do nome do terminal

7 Página: 7 / REP_Tempo Lê ou grava data e horário no aparelho, de acordo com a operação pretendida. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_Tempo ( BYTE * sip, BYTE blegrava, BYTE * bano, BYTE * bmes, BYTE * bdia, BYTE * bhora, BYTE * bminuto, BYTE * bsegundo, BYTE * bdiasemana, DWORD * dwresult ) blegrava (BYTE [IN]) Operação a ser realizada: o 0 Leitura o 1 Gravação bano (BYTE * [IN/OUT]) Valor do ano entre 0 (2000) e 255 (2255) bmes (BYTE * [IN/OUT]) Valor do mês entre 1 (Janeiro) e 12 (Dezembro) bdia (BYTE * [IN/OUT]) Valor do dia entre 1 e 31 dependendo do mês bhora (BYTE * [IN/OUT]) Valor da hora entre 0 e 23 bminuto (BYTE * [IN/OUT]) Valor do minuto entre 0 e 59 bsegundo (BYTE * [IN/OUT]) Valor do segundo entre 0 e 59 bdiasemana (BYTE * [IN/OUT]) Dia da semana entre 1 e 7 REP_Tempo(" ", 0, // Leitura do nome do terminal &bano &bmes &bdia &bhora &bminuto &bsegundo. &bdiasemana

8 Página: 8 / REP_LeTemperatura Lê a temperatura interna do aparelho. Utilizado apenas para REP-G1 e G2. REP_FUNCAO REP_LeTemperatura ( BYTE * sip, BYTE * btemperatura, DWORD * dwresult ); btemperatura (BYTE * [OUT]) string da temperatura atual do aparelho REP_LeTemperatura(" ",. &btemperatura O REP-G3 não possui dispositivo para leitura de temperatura. Portanto, caso recebe esse comando, o retorno será comando obsoleto REP_Rede_Simples Lê ou grava as opções de rede. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_Rede_Simples ( BYTE * sip, BYTE blegrava, BYTE * sipterminal, BYTE * sipmascara, DWORD * dwresult ); blegrava (BYTE [IN]) Operação a ser realizada:

9 Página: 9 / 36 o 0 Leitura o 1 Gravação bipterminal (BYTE * [IN/OUT]) string do endereço IP bipmascara (BYTE * [IN/OUT]) string da máscara de rede REP_Rede_Simples(" ",. 0, // Leitura dos dados. sipterminal, // Leitura do IP do terminal. sipmascara, // Leitura da máscara de rede Os endereços IP e a máscara devem estar no padrão " ". Para REP-G3 existe a função REP_ConfigRede que lê o IP, máscara, gateway e MAC, e grava todas elas menos o MAC. Esta função não funciona para REP- G1 ou G REP_LeCadastro Leitura de informações cadastradas no aparelho de acordo com filtro e parâmetro. As informações são salvas no arquivo com nome passado por parâmetro. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeCadastro ( BYTE * sip, BYTE bfiltro, BYTE * sparametro, BYTE * sarquivodados, DWORD * dwencontrados, DWORD * dwresult ); bfiltro (BYTE [IN]) Operação a ser realizada: o 0 Registro do empregador. Não possui parâmetro (NULL) o 1 Todos os registros. Não possui parâmetro (NULL) o 4 Todos os funcionários cadastrados. Não possui parâmetro (NULL) o 5 Todos os registros a partir de uma NSR. Com parâmetro

10 Página: 10 / 36 sparâmetro (BYTE * [IN]) string da NSR. 512 sarquivodados (BYTE * [IN]) string do nome do arquivo no qual as informações serão salvas (relativo ou absoluto) dwencontrados (DWORD * [OUT]) número de registros encontrados e salvos REP_LeCadastro(" ",. 5, // A partir de uma NSR. "12345", //NSR. "C:\\Fabricante.txt",. &dwencontrados, 3.9. REP_LeIntervaloNSR Leitura de informações cadastradas no aparelho através de um intervalo de NSR. As informações são salvas no arquivo com nome passado por parâmetro. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeIntervaloNSR ( BYTE * sip, BYTE * snsrinicial, BYTE * snsrfinal, BYTE * sarquivodados, DWORD * dwencontrados, DWORD * pdwresult ); snsrinicial (BYTE * [IN]) string da NSR inicial para busca snsrfinal (BYTE * [IN]) string da NSR final para busca sarquivodados (BYTE * [IN]) string do nome do arquivo no qual as informações serão salvas (relativo ou absoluto) dwencontrados (DWORD * [OUT]) número de registros encontrados e salvos

11 Página: 11 / 36 REP_LeIntervaloNSR(" ",. "333", //NSR inicial. "10000", //NSR Final. "C:\\Fabricante.txt",. &dwencontrados, REP_LeTipoReg Leitura do tipo de registro através de sua NSR. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeTipoReg ( BYTE * sip, BYTE * snsr, INT * irecordtype, DWORD * pdwresult ); snsr (BYTE * [IN]) string da NSR para busca irecordtype (INT * [OUT]) tipo de registro de ponto REP_LeTipoReg(" ",. "123456", //NSR. irecordtype, REP_LeRegEmpregador Leitura do cadastro de empregador. Utilizado para REP-G1, G2 e G3.

12 Página: 12 / 36 REP_FUNCAO REP_LeRegEmpregador ( BYTE * sip, BYTE * scnpj_cpf, BYTE * scei, BYTE * srazaosocial, BYTE * slocal, DWORD * pdwresult ); scnpj_cpf (BYTE * [OUT]) CPF ou CNPJ do Empregador scei (BYTE * [OUT]) CEI do Empregador srazaosocial (BYTE * [OUT]) Razão social do Empregador slocal (BYTE * [OUT]) Endereço do Empregador REP_LeRegEmpregador(" ",. scnpj_cpf,. scei,. srazaosocial,. slocal, REP_LeRegPonto Leitura dos dados de ponto através de uma NSR, retornando os dados do ponto. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeRegPonto ( BYTE * sip, BYTE * snsr, BYTE * sdata, BYTE * shora, BYTE * smatricula, DWORD * pdwresult ); snsr (BYTE * [IN]) NSR para busca sdata (BYTE * [OUT]) Data do registro de ponto shora (BYTE * [OUT]) Hora do registro de ponto no formato HHMM smatricula (BYTE * [OUT]) Matrícula do funcionário que bateu o ponto

13 Página: 13 / 36 REP_LeRegPonto(" ",. "123456", //NSR. sdata,. shora,. smatricula, REP_LeRegFuncionario Leitura dos dados de cadastro de funcionário através de uma NSR, retornando os dados do registro. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeRegFuncionario ( BYTE * sip, BYTE * snsr, BYTE * sdata, BYTE * shora, BYTE * boperacao, BYTE * smatricula, DWORD * pdwresult ); snsr (BYTE * [IN]) NSR para busca sdata (BYTE * [OUT]) Data do registro de ponto shora (BYTE * [OUT]) Hora do registro de ponto no formato HHMM boperacao (BYTE * [OUT]) Operação realizada: inclusão I, alteração A e remoção R smatricula (BYTE * [OUT]) Matrícula do funcionário que bateu o ponto REP_LeRegFuncionario(" ",. "123456", //NSR. sdata,. shora,

14 Página: 14 / 36. boperacao,. smatricula, Para o REP-G3, os registros de remoção de funcionários possuem a letra E (Exclusão) ao invés de R (Remoção) REP_GravaCadastroEmpregador Gravação das informações de cadastro do empregador no aparelho. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_GravaCadastroEmpregador ( BYTE * sip, BYTE bacao, BYTE btipo, BYTE * scpfcnpj, BYTE * scei, BYTE * srazaonome, BYTE * slocal, DWORD * dwresult ); bacao (BYTE [IN]) Ação a ser feita: o 0 Grava cadastro o 1 Altera cadastro btipo (BYTE [IN]) Tipo de cadastro: o 1 CNPJ o 2 CPF scpfcnpj (BYTE * [IN]) string do CNPJ ou CPF da empresa em até 16 caracteres scei (BYTE * [IN]) CEI da empresa com 12 caracteres srazaonome (BYTE * [IN]) Nome da empresa de até 152 caracteres slocal (BYTE * [IN]) Endereço da empresa de até 100 caracteres REP_GravaCadastroEmpregador(" ",. 0, //Adiciona cadastro. 1, //CNPJ. " ",. " ",

15 Página: 15 / 36. "Gertec",. "Rua Guaicurus, 145", REP_GravaCadastroFuncionario Gravação das informações de cadastro de funcionário no aparelho. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_GravaCadastroFuncionario ( BYTE * sip, BYTE bacao, BYTE * snome, BYTE * smatricula, BYTE * vbcontactless, BYTE * vbcodbarras, BYTE * vbteclado, BYTE * vbbiometria, BYTE bgrupo, DWORD * dwresult ); bacao (BYTE [IN]) Ação a ser feita: o 0 Adiciona cadastro o 1 Altera cadastro snome (BYTE * [IN]) Nome do funcionário smatricula (BYTE * [IN]) string do PIS do funcionário vbcontactless (BYTE * [IN]) número do cartão RFID ou Mifare do funcionário em string hexadecimal. vbcodbarras (BYTE * [IN]) número do código de barras do funcionário no REP-G1 ou G2. Como o REP-G3 não possui leitor de código de barras, este campo é utilizado para envio do ID do funcionário. vbteclado (BYTE * [IN]) número de teclado do funcionário sendo apenas números com tamanho mínimo de 4 caracteres e máximo de 8. vbbiometria (BYTE * [IN]) número da digital do funcionário em formato string de até 8 bytes. Este parâmetro só é utilizado para REP- G1 ou G2. Para o REP-G3 é necessário utilizar a função REP_GravaFinger. bgrupo (BYTE [IN]) Filtro por grupo de funcionários (1 byte). Este parâmetro é somente utilizado para REP-G1 ou G2. REP_GravaCadastroFuncionario(" ",. 0, // Adiciona cadastro

16 Página: 16 / 36. "Jose dos Santos", //Nome. " ", //smatricula. " ", //RFID. " ", //Código de Barras. " ", //Teclado. " ", // Biometria. 255, //Grupo O REP-G3 não possui leitor de código de barras, não tem opção de pesquisa por grupo de funcionário e não cadastra biometria no momento de cadastro de funcionário. Assim, neste caso, o campo de código de barras é utilizado para o número de ID do funcionário, e os campos biometria e grupo podem ser completados como nulos para a função REP_ExcluiCadastroFuncionario Exclusão de cadastro de funcionário no aparelho. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_ExcluiCadastroFuncionario ( BYTE * sip, BYTE * smatricula, DWORD dwresult ); smatricula (BYTE * [IN]) string do PIS do funcionário REP_ExcluiCadastroFuncionario(" ",. " ", //smatricula REP_LeEspacoMemoria

17 Página: 17 / 36 Obtenção da memória utilizada e memória livre do terminal. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeEspacoMemoria ( BYTE * sip, DWORD * dwmemusada, DWORD * dwmemlivre, DWORD * dwresult ); dwmemusada (BYTE * [OUT]) Quantidade de memória utilizada em bytes dwmemlivre (BYTE * [OUT]) Quantidade de memória disponível em bytes REP_LeEspacoMemoria(" ",. &dwmemusada,. &dwmemlivre, REP_LeNSR Obtenção do Número Sequencial de Registro do terminal. Utilizado para REP- G1, G2 e G3. REP_FUNCAO REP_LeNSR ( BYTE * sip, BYTE * snsr, DWORD * dwresult ); snsr - (BYTE * [OUT]) Atual número sequencial de registros em format string

18 Página: 18 / 36 REP_LeNSR(" ",. &snsr, REP_StatusImpressora Lê status da impressora do terminal. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_StatusImpressora ( BYTE * sip, BYTE * sstatus, DWORD * pdwresult ); sstatusimpressora - (BYTE * [OUT]) string do status atual da impressora REP_StatusImpressora(" ",. sstatusimpressora, REP_LeFinger Leitura de Fingers cadastrados no REP. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeFinger ( BYTE * sip, DWORD * dwencontrados, DWORD * pdwresult );

19 Página: 19 / 36 dwencontrados - (BYTE * [OUT]) número total de templates encontrados e salvos em arquivos REP_LeFinger(" ",. &dwencontrados,. &dwresult REP_GravaFinger Gravação de arquivo contendo o Finger do funcionário no REP. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_GravaFinger ( BYTE * sip, BYTE * sarquivodados, DWORD * pdwresult ); sarquivodados - (BYTE * [IN]) nome do arquivo no qual os dados do finger serão lidos (relativo ou absoluto). REP_GravaFinger(" ",. sarquivodados,. &dwresult Para gravação de finger no REP-G1 ou G2, o nome do arquivo deve ser o PIS

20 Página: 20 / 36 do respectivo funcionário, como mostra o exemplo: rec. Para o REP-G3, como cada funcionário pode ter até 10 templates, o nome do arquivo deve ser o PIS do funcionário e o número do seu finger, como mostra o exemplo: _2.rec REP_GravaFinger_Bytes Gravação de vetor contendo o Finger do funcionário no REP. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_GravaFinger_Bytes ( BYTE * sip, BYTE * smatricula, BYTE * pbfptemplate, DWORD * pdwresult ); smatricula - (BYTE * [IN]) PIS do funcionário pbfptemplate - (BYTE * [IN]) Dados do template padrão Nitgen (404 bytes) REP_GravaFinger_Bytes(" ",. " ",. pbfptemplate,. &dwresult Esta função funciona apenas para o padrão Nitgen com vetor de 404 bytes. Como o REP-G3 pode ter o modelo Nitgen ou Fingerprints, esta função não funciona nele REP_FormataFinger Formata toda a memória finger. Utilizado apenas para REP-G1, G2.

21 Página: 21 / 36 REP_FUNCAO REP_FormataFinger ( BYTE * sip, DWORD * dwresult ); REP_FormataFinger(" ", Esta função funciona apenas para REP-G1 ou G REP_RemoverFingerID Remove o Finger cadastrado no REP de um funcionário, através de seu PIS. Utilizado apenas para REP-G1, G2. REP_FUNCAO REP_RemoverFingerID ( BYTE * sip, BYTE * smatricula, DWORD * dwresult ); smatricula - (BYTE * [IN]) PIS do funcionário REP_RemoverFingerID(" ",. " ",

22 Página: 22 / 36. &dwresult Esta função funciona apenas para REP-G1 ou G REP_LeFingerID Lê o Finger cadastrado no REP de um funcionário, através da Matrícula e grava em um arquivo. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeFingerID ( BYTE * sip, BYTE * smatricula, DWORD * dwresult ); smatricula - (BYTE * [IN]) PIS do funcionário REP_LeFingerID(" ",. " ", REP_LeFingerID_Bytes Lê o Finger cadastrado no REP de um funcionário, através da Matrícula e retorna os dados em um vetor. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_LeFingerID_Bytes ( BYTE * sip, BYTE * smatricula, BYTE * pbfptemplate, DWORD * dwresult ); smatricula - (BYTE * [IN]) PIS do funcionário pbfp - (BYTE * [OUT]) Bytes do template

23 Página: 23 / 36 REP_LeFingerID_Bytes(" ",. " ",. pbfptemplate, Para o REP-G1 e G2, esta função sempre retorna o vetor de biometria do funcionário com os 404 bytes de um template da Nitgen. Para o REP-G3, esta função retornará a última biometria cadastrada para funcionário. O template possui 404 bytes para biometria Nitgen (ótico) e 938 bytes para biometria Fingerprints (capacitivo) REP_LeFingerIDEspecifico_Bytes Lê o Finger cadastrado no REP através do seu ID. Utilizado apenas para REP- G3. REP_FUNCAO REP_LeFingerIDEspecifico_Bytes ( BYTE * sip, BYTE * sid, BYTE * pbfptemplate, DWORD * dwtamanhotemplate, DWORD * dwresult ); sid - (BYTE * [IN]) ID do template em formato string pbfptemplate - (BYTE * [OUT]) Bytes do template. 404 bytes para Nitgen (ótico) e 938 bytes para Fingerprints (capacitivo) dwtamanhotemplate (DWORD * [OUT]) Tamanho do template retornado. 404 bytes para Nitgen (ótico) e 938 bytes para Fingerprints (capacitivo)

24 Página: 24 / 36 REP_LeFingerIDEspecifico_Bytes(" ",. "105",. pbfptemplate, dwtamanhotemplate Não implementado para REP-G1 e G2. Caso seja enviado o retorno será 1021 (erro operação sem sucesso). Este comando foi criado devido à integração com a Senior REP_LeFingersIdsPis Lê os IDs dos templates do funcionário através do seu PIS. Utilizado apenas para REP-G3. REP_FUNCAO REP_LeFingersIdsPis ( BYTE * sip, BYTE * spis, BYTE * stemplatedid, DWORD * dwquantidade, DWORD * dwresult ); spis - (BYTE * [IN]) PIS do funcionário stemplatesid - (BYTE * [OUT]) string contendo os números dos templates do funcionário. O número de cada template estará separado por /. Exemplo de funcionário com 3 templates: stemplateid = 125/168/201 dwquantidade (DWORD * [OUT]) Quantidade de IDs encontrados REP_LeFingersIdsPis (" ",

25 Página: 25 / 36. " ",. stemplatesid, &dwquantidade, Não implementado para REP-G1 e G2. Caso seja enviado o retorno será 1021 (erro operação sem sucesso). Este comando foi criado devido à integração com a Senior REP_Versao Lê as versões de Finger Print, MB e MM do equipamento. Utilizado para REP- G1, G2 e G3. REP_FUNCAO REP_Versao ( BYTE * sip, BYTE * sversionmb, BYTE * sversionmm, BYTE * smodulefp, BYTE * sversionfp, DWORD * dwresult ); sversaomb - (BYTE * [OUT]) Versão da MB em formato string sversaomm - (BYTE * [OUT]) Versão da MM em formato string smodulofp - (BYTE * [OUT]) Módulo da Nitgen em formato string sversaofp - (BYTE * [OUT]) Versão da Nitgen em formato string REP_Versao(" ",. sversaomb,. sversaomm,. smodulofp,. sversaofp,

26 Página: 26 / 36 Para o REP-G3, a única versão que será retornada é a versão da MM, os outros parâmetros retornarão zerados REP_StatusBateria Lê status da bateria do terminal. Utilizado somente para REP-G3. REP_FUNCAO REP_StatusBateria ( BYTE * sip, BYTE * sstatusbateria, DWORD * pdwresult ); sstatusbateria - (BYTE * [OUT]) string do status atual da bateria REP_StatusBateria(" ",. sstatusbateria, Como REP-G1 e G2 não possuem bateria, esta função não funciona para eles REP_ConfigRede Lê ou grava as configurações de rede. Utilizado somente para REP-G3. REP_FUNCAO REP_ConfigRede ( BYTE * sip, BYTE blegrava, BYTE * sipterminal, BYTE * sipmascara, BYTE * sipgateway, BYTE * smac, DWORD * dwresult ); blegrava (BYTE [IN]) Operação a ser realizada:

27 Página: 27 / 36 o 0 Leitura o 1 Gravação sipterminal (BYTE * [IN/OUT]) string do endereço IP sipmascara (BYTE * [IN/OUT]) string da máscara de rede sipgateway (BYTE * [IN/OUT]) string do gateway de rede smac (BYTE * [OUT]) string do MAC do equipamento REP_ConfigRede(" ",. 0, // Leitura dos dados. sipterminal, // Leitura do IP do terminal. sipmascara, // Leitura da máscara de rede. sipgateway, // Leitura do gateway. smac, // Leitura do mac Esta função funciona apenas para REP-G3. O parâmetro do número MAC só pode ser lido, nunca gravado REP_WifiConfig Lê ou grava as configurações de rede Wi-Fi. Utilizado somente para REP-G3. REP_FUNCAO REP_WifiConfig ( BYTE * sip, BYTE blegrava, BYTE * sssid, BYTE * bsecurity, BYTE * skey, DWORD * dwresult ); blegrava (BYTE [IN]) Operação a ser realizada: o 0 Leitura o 1 Gravação sssid (BYTE * [IN/OUT]) string do SSID da rede Wi-Fi bsecurity (BYTE * [IN/OUT]) tipo de segurança da rede Wi-Fi podendo ser:

28 Página: 28 / 36 o 0 - NONE, nenhuma o 1 - WEP64 o 2 - WEP128 o 3 - WPA o 4 - WPA2 o 5 - MIXED skey (BYTE * [IN/OUT]) string da chave da rede Wi-Fi REP_WifiConfig(" ",. 0, // Leitura dos dados. sssid, // Leitura do SSID de rede. bsecurity, // Leitura do tipo de segurança. skey, // Leitura da chave Esta função funciona apenas para REP-G3 pois não existe modelo de REP-G1 ou G2 com Wi-Fi REP_InterfaceRede Lê ou altera a interface de rede do terminal. Utilizado somente para REP-G3. REP_FUNCAO REP_InterfaceRede ( BYTE * sip, BYTE blegrava, BYTE * binterface, DWORD * dwresult ); blegrava (BYTE [IN]) Operação a ser realizada: o 0 Leitura o 1 Gravação binterface (BYTE * [IN/OUT]) Interface de rede do terminal, sendo: o 0 Ethernet o 1 Wi-Fi

29 Página: 29 / 36 REP_InterfaceRede(" ",. 0, // Leitura dos dados. &binterface, // Interface de rede Esta função funciona apenas para REP-G3 pois não existe modelo de REP-G1 ou G2 com Wi-Fi REP_GravaNovaSenha Grava nova senha no terminal. Utilizado somente para REP-G3. REP_FUNCAO REP_GravaNovaSenha ( BYTE * sip, BYTE * snewpassword, DWORD * dwresult ); snewpassword (BYTE * [IN]) string da nova senha do menu do REP-G3 com no máximo 8 caracteres de tamanho REP_GravaNovaSenha(" ",. 1234, // nova senha

30 Página: 30 / 36 Esta função funciona apenas para REP-G REP_LeFuncionario Lê funcionário pelo PIS, ID, teclado, contactless ou biometria. Utilizado somente para REP-G3. REP_FUNCAO REP_LeFuncionario ( BYTE * sip, BYTE bsearchtype, BYTE * bdatatosearch, BYTE * sname, BYTE * spis, BYTE * scontactless, BYTE * skeyboard, BYTE * sid, DWORD * dwresult ); bsearchtype (BYTE [IN]) Tipo de busca: o 0 PIS o 1 ID o 2 Teclado o 3 Contactless o 4 Biometria sdatatosearch (BYTE * [IN]) informação de acordo com o tipo de busca sname (BYTE * [OUT]) nome do funcionário spis (BYTE * [OUT]) PIS do funcionário scontactless (BYTE * [OUT]) número do cartão contactless do funcionário skeyboard (BYTE * [OUT]) número do teclado do funcionário sid (BYTE * [OUT]) número do ID do funcionário REP_LeFuncionario(" ",. 2, // Leitura por teclado. 111, // Dado de teclado. &sname, // Nome. &spis, // PIS. &scontactless, // Número do cartão contactless. &skeyboard, // Número do teclado

31 Página: 31 / 36. &sid, // ID Esta função funciona apenas para REP-G REP_LeStatusMemoriaTrabalho Lê status da memória de trabalho do equipamento. Utilizado somente para REP-G3. REP_FUNCAO REP_LeStatusMemoriaTrabalho ( BYTE * sip, DWORD * dwenrolledemployees, DWORD * dwfreeemployees, DWORD * dwavailablememory, BOOL * boenrolledemployer, DWORD * dwresult ); dwenrolledemployees (DWORD * [OUT]) número de funcionários cadastrados dwfreeemployees (DWORD * [OUT]) número de funcionários disponíveis para cadastro dwavailablememory (DWORD * [OUT]) tamanho de memória disponível boenrolledemployer (BOOL * [OUT]) indicação de empregador cadastrado ou não REP_LeStatusMemoriaTrabalho(" ", &dwenrolledemployees, // funcionários cadastrados. &dwfreeemployees, // funcionários disponíveis. &dwavailablememory, // memória disponível. &boenrolledemployer, // empregador cadastrado

32 Página: 32 / 36 Esta função funciona apenas para REP-G REP_GravaFuncionariosPorArquivo Grava funcionários no terminal utilizando arquivo. Utilizado somente para REP- G3. REP_FUNCAO REP_GravaFuncionariosPorArquivo ( BYTE * sip,, BYTE * bpfilename, DWORD * dwemployeescounter, DWORD * dwresult ); bpfilename (BYTE * [IN]) nome do arquivo que contêm os funcionários a serem cadastrados (absoluto ou relativo) dwemployeescounter (DWORD * [OUT]) número de funcionários lidos do arquivo e efetivamente cadastrados REP_GravaFuncionariosPorArquivo(" ", &bpfilename, // nome do arquivo. &dwemployeescounter, // funcionários cadastrados Esta função funciona apenas para REP-G3. Caso não seja possível cadastrar algum dos funcionários, por exemplo, por causa que já existe um funcionário cadastrado com o mesmo número de teclado, a gravação não será interrompida REP_AtualizaFirmware Atualiza firmware do equipamento enviando dados de um arquivo. Utilizado somente para REP-G3.

33 Página: 33 / 36 REP_FUNCAO REP_AtualizaFirmware ( BYTE * sip,, BYTE * bpfilename, DWORD * dwresult ); bpfilename (BYTE * [IN]) nome do arquivo que contêm o novo firmware (absoluto ou relativo) REP_AtualizaFirmware(" ", &bpfilename, // nome do arquivo Esta função funciona apenas para REP-G3. Para a atualização ocorrer efetivamente, é necessário enviar a assinatura do firmware utilizando a função REP_EnviaAssinaturaFirmware e, caso a assinatura esteja correta, desligar e ligar o REP REP_EnviaAssinaturaFirmware Envia assinatura de firmware de atualização do equipamento utilizando dados de um arquivo. Utilizado somente para REP-G3. REP_FUNCAO REP_EnviaAssinaturaFirmware ( BYTE * sip,, BYTE * bpfilename, DWORD * dwresult ); bpfilename (BYTE * [IN]) nome do arquivo que contêm a assinatura (absoluto ou relativo)

34 Página: 34 / 36 REP_EnviaAssinaturaFirmware(" ", &bpfilename, // nome do arquivo Esta função funciona apenas para REP-G3. Para a atualização ocorrer efetivamente, é necessário desligar e ligar o REP REP_MensagemErro Obtenção da mensagem de erro referente ao valor de retorno pdwresult. Utilizado para REP-G1, G2 e G3. REP_FUNCAO REP_MensagemErro ( DWORD dwresult, BYTE * smensagemerro ); dwresult (DWORD [IN]) Código de erro smensagemerro (BYTE * [OUT]) mensagem de erro referente ao código REP_MensagemErro(1,sMsgErro); 4. Retorno das funções Código Símbolo Descrição 0 REP_OK Realizada com sucesso 1021 ERRO_OPERACAO_SEM_SUCESSO Realizada sem sucesso 1022 ERRO_RESPOSTA_DESCONHECIDA Resposta do REP desconhecida 1023 MRP_EM_USO MRP alocada em outro processo 1030 ERRO_MANIPULAR_ARQUIVO Erro na estrutura de dados do arquivo ou arquivo não encontrado

35 Página: 35 / ERRO_FILTRO_NAO_EXECUTADO Mensagem de filtro não executada 1032 NÃO_MARCACAO_PONTO O registro não é um ponto 2000 ERRO_NOME_EMPREGADOR_INVALIDO Empregador com caracteres incorretos 2001 ERRO_LOCAL_EMPREGADOR_INVALIDO Local com caracteres incorretos 2002 ERRO_CNPJ_INVALIDO CNPJ com caracter inválido 2003 ERRO_CEI_INVALIDO CEI com caracter inválido 2004 ERRO_FINGER_INVALIDO Finger com caracter inválido 2010 ERRO_TAM_NOME_EMPREGADOR_INVALIDO Tamanho do nome do empregador incorreto 2011 ERRO_TAM_LOCAL_EMPREGADOR_INVALIDO Tamanho do nome do local incorreto 2012 ERRO_TAM_CNPJ_INVALIDO CNPJ com tamanho incorreto 2013 ERRO_TAM_CEI_INVALIDO CEI com tamanho incorreto 2014 ERRO_TAM_FINGER_INVALIDO Finger com tamanho incorreto 2020 ERRO_EMPREGADOR_JA_CADASTRADO Empregador já cadastrado 2021 ERRO_EMPREGADOR_NAO_CADASTRADO Empregador não cadastrado 3000 ERRO_NOME_FUNCIONARIO_INVALIDO Nome do funcionário com caracter inválido 3001 ERRO_PIS_INVALIDO PIS com caracter inválido 3002 ERRO_CONTACTLESS_INVALIDO Contactless com caracter inválido 3003 ERRO_CODIGO_BARRAS_INVALIDO Código de barras com caracter inválido 3004 ERRO_TECLADO_INVALIDO Teclado com caracter inválido 3005 ERRO_BIOMETRIA_INVALIDO Biometria com caracter inválido 3006 ERRO_ID_INVALIDO ID com caracter inválido 3010 ERRO_TAM_NOME_FUNCIONARIO_INVALIDO Nome do funcionário com tamanho inválido 3011 ERRO_TAM_PIS_INVALIDO PIS com tamanho inválido 3012 ERRO_TAM_CONTACTLESS_INVALIDO Contactless com tamanho inválido 3013 ERRO_TAM_CODIGO_BARRAS_INVALIDO Código de barras com tamanho inválido 3014 ERRO_TAM_TECLADO_INVALIDO Teclado com tamanho inválido 3015 ERRO_TAM_BIOMETRIA_INVALIDO Biometria com tamanho inválido 3016 ERRO_TAM_ID_INVALIDO ID com tamanho inválido 3021 ERRO_PIS_JA_CADASTRADO PIS já cadastrado 3022 ERRO_CONTACTLESS_JA_CADASTRADO Contactless já cadastrado 3023 ERRO_CODIGO_BARRAS_JA_CADASTRADO Código de barras já cadastrado 3024 ERRO_TECLADO_JA_CADASTRADO Teclado já cadastrado 3025 ERRO_BIOMETRIA_JA_CADASTRADO Biometria já cadastrada 3030 ERRO_FUNCIONARIO_NAO_CADASTRADO Funcionário não cadastrado 3031 ERRO_PIS_NAO_ENCONTRADO PIS não encontrado 3101 ERRO_FINGER_HEADER_INVALIDO Cabeçalho do finger inválido

36 Página: 36 / ERRO_FINGER_RESERVADO_INVALIDO Byte inválido 3103 ERRO_FINGER_FPID_INVALIDO FPID inválido 3104 ERRO_FINGER_RESERVED_INVALIDO Byte reserved inválido 3105 ERRO_FINGER_SIZE_MSB_INVALIDO Tamanho do byte mais significativo inválido 3106 ERRO_FINGER_SIZE_LSB_INVALIDO Tamanho do byte menos significativo inválido 3107 ERRO_FINGER_RESERVED3_INVALIDO Reserved3 inválido 3108 ERRO_FINGER_TEMPLATE_INVALIDO Template inválido 3200 ERRO_AFD_TAM_DADOS_INCORRETO Tamanho dos dados da AFD incorreto 3201 ERRO_AFD_TIPO_REGISTRO_INCORRETO Registro de AFD incorreto 3300 ERRO_CPF_INVALIDO CPF com caracter inválido 3301 ERRO_TAM_CPF_INVALIDO CPF com tamanho inválido 3400 ERRO_NFR_INVALIDO NFR com caracter inválido 3401 ERRO_TAM_NFR_INVALIDO NFR com tamanho inválido 3500 ERRO_MASTERKEY_INVALIDO Masterkey com caracter inválido 3501 ERRO_TAM_MASTERKEY_INVALIDO Masterkey com tamanho inválido 3600 ERRO_TAM_SSID_INVALIDO SSID com tamanho inválido 3601 ERRO_TAM_KEY_INVALIDO Chave Wi-fi com tamanho inválido 3602 ERRO_SEGURANCA_INVALIDO Parâmetro de segurança inválido 4000 ERRO_DIA_INVALIDO Dia incorreto 4001 ERRO_MES_INVALIDO Mês incorreto 4002 ERRO_ANO_INVALIDO Ano incorreto 4010 ERRO_HORA_INVALIDA Hora incorreto 4011 ERRO_MINUTO_INVALIDO Minuto incorreto 4012 ERRO_SEGUNDO_INVALIDO Segundo incorreto 4020 ERRO_DIA_SEMANA_INVALIDO Dia da semana incorreto 4050 ERRO_SENHA_INVALIDA Senha com caracter inválido 4051 ERRO_TAM_SENHA_INVALIDA Senha com tamanho inválido 4090 ERRO_TIPO_ACAO_FILTRO_INVALIDO Tipo de filtro inválido 4095 ERRO_TAM_NSR_INVALIDO Tamanho do NSR inválido 4096 ERRO_NSR_INVALIDO NSR com caracter inválido 4100 ERRO_FINGER_NAO_CADASTRADO Finger não cadastrado 4101 ERRO_FINGER_EM_USO Módulo finger em uso 5000 ERRO_MEMORIA_CHEIA Memória cheia 5001 ERRO_GRAVACAO_REGISTRO Erro ao gravar registro ERRO_IP_JA_CONECTADO IP já conectado ERRO_INVALID_IP IP inválido ERRO_INVALID_IP_MASK Máscara IP inválida ERRO_INVALID_PORT Porta inválida ERRO_INVALID_GATEWAY Gateway inválido