Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Índice
O primeiro passo antes de iniciar a utilização do componente, é realizar sua instalação do pacote que contém
todas as dependências necessárias para o perfeito funcionamento da OCX.
Clique em Iniciar – Executar:
Digite o caminho (path) que se encontra a instalação do componente (figura 1):
Figura 1.
Figura 5.
Clique no botão Browse, e selecione o arquivo CM3_RT.ocx, localizado por default no diretório (pasta)
C:\Arquivos de programas\OCX de Comunicação CM3_RealTime (Figura 6).
Figura 6.
Figura 7.
Figura 8.
Figura 9.
Após o componente ser incluído no projeto ele estará disponível na barra de ferramentas e pronto para ser
incluído em um formulário.
Figura 10.
Para utilizar a OCX em um projeto do Delphi 6.0 ou superior, é necessário incluir o componente de
comunicação no projeto. Com o Delphi aberto, clique no menu Tools->Environment Options->Type Library.
Figura 11.
Selecione as opções Ignore Special CoClass Flags when importing e Can Create, clique em ok (figura 11).
Na tela Install você pode instalar em um pacote existe (Into existing package) ou em um novo pacote (Into
new package).
Figura 13.
Figura 14.
1) Método InicializarComponente
A. Quantidade de dígitos - define a quantidade de dígitos (números) que compõe o número da credencial
(crachá), de 04 a 20.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
-2147220891 – CM3_RT: InicializarComponente. O número de dígitos do crachá deve estar entre 4 e 20.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
3) Método AdicionaTerminal
Determina os parâmetros para indicar para o componente os Terminais que queremos comunicar em realtime.
Obs.: Cada concentradora pode ter no máximo 10 terminais.
Enumerador
Aberto = 0, Curto = 1.
Acesso_Nao_Concluido_Numero_Entrada NumeroEntrada Selecione o número da entrada do acesso não
concluído. Desabilitado: não será utilizado o
sensor de acesso não concluído. Entrada 1: será
utilizada a entrada 1 do terminal para o acesso
não concluído. Entrada 2: será utilizada a
entrada 2 do terminal para o acesso não
concluído.
Enumerador
Entrada_Desabilitada = 0, Entrada_1 = 1,
Entrada_2 = 2.
Acesso_Via_Teclado Boolean Sim: permite o acesso via teclado. Não:
desativa o teclado.
Enumerador
Aberto = 0, Curto = 1.
Acionamento_Numero_Saida NumeroSaida Selecione o número da saída do rele
acionamento. Desabilitado: não será utilizado o
rele de saída para acionamento. Saída 1: será
utilizada o rele 1 do terminal para o
acionamento.
Enumerador
Aberto = 0, Curto = 1.
Burla_Numero_Entrada NumeroEntrada Selecione o número da entrada da burla.
Desabilitado: não será utilizado a entrada da
burla. Entrada 1: será utilizada a entrada 1 do
terminal para entrada da burla. Entrada 2: será
utilizada a entrada 2 do terminal para entrada
da burla.
Enumerador
NaoDigital = 0, SempreDigital = 1,
DigitalseHouver = 2, DigitalseNaoSenha = 3.
Modo_Leitura Boolean Sim: permite a leitura com Porta Aberta. Não:
não permite a leitura com Porta Aberta.
Enumerador
Aberto = 0, Curto = 1.
Sensor_Acesso_Numero_Entrada NumeroEntrada Selecione o número de entrada do sensor de
Enumerador
Entrada_Desabilitada = 0,
Entrada_1 = 1,
Entrada_2 = 2.
Sensor_Acesso_Sinaliza_Intrusao Boolean Selecione se sensor de acesso sinaliza intrusão
de porta. Sim: sinaliza intrusão de porta. Não:
não sinaliza intrusão de porta.
Enumerador
Sensor_Porta = 0,
Retorno_Acesso_Concluido = 1.
Sentido_Acesso SentidoAcesso Selecione se o Terminal é de entrada ou Saída.
Enumerador
Sentido_Entrada = 1,
Sentido_Saida = 2.
Solicitacao_Acionamento_Debounce Integer Informe o tempo de estabilidade do sensor de
entrada do terminal em milisegundos, onde caso
ocorra uma alteração no sinal elétrico, não será
considerado o recebimento do pulso de
acionamento durante o tempo definido. Este
tempo varia de acordo com o fabricante do
sensor de porta.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description) sendo:
-2147220587 - CM3_RT: AdicionaTerminal. Um formato para a leitura selecionada deve ser preenchido.
-2147220563 - CM3_RT: AdicionaTerminal. O valor do Setor do Tipo de Cartão SmartCard deve estar entre 0 e
15.
-2147220561 - CM3_RT: AdicionaTerminal. O valor do OffSet do Tipo de Cartão SmartCard deve estar entre 0
e 27.
-2147220559 - CM3_RT: AdicionaTerminal. A Quantidade de Digitos do Tipo de Cartão SmartCard deve estar
entre 4 e 20.
-2147220584 - CM3_RT: AdicionaTerminal. Número do nivel de segurança da biometria deve estar entre 1 e 9.
-2147220581 - CM3_RT: AdicionaTerminal. O Tempo de Pulso do Acionamento deve estar entre 0 e 99.
-2147220576 - CM3_RT: AdicionaTerminal. O Tempo de Debounce do Sensor de Acesso deve estar entre 0 e 99.
-2147220574 - CM3_RT: AdicionaTerminal. Nivel Sinal de Repouso do Acesso não Concluido inválido.
-2147220573 - CM3_RT: AdicionaTerminal. O Tempo de Debounce do Acesso não Concluido deve estar entre 0
e 99.
-2147220566 - CM3_RT: AdicionaTerminal. O Tempo de Debounce da Burla deve estar entre 0 e 99.
Determina os parâmetros para indicar ao componente a enviar os Parâmetros da Lista (listagem dos crachás)
para ser utilizada quando o equipamento não estiver comunicando (não em Realtime). Assim somente os crachás
contidos na lista terão acesso ao equipamento.
5) Método AdicionaCrachas
Determina os parâmetros para indicar ao componente a enviar os crachás que farão parte da Lista (listagem dos
crachás) para ser utilizada quando o equipamento não estiver comunicando (não em Realtime). Assim somente os
crachás contidos na lista terão acesso ao equipamento. Os parâmetros a serem enviados são:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
-2147220291 – CM3_RT: AdicionaCrachas. O número do crachá: (Numero_Cracha) não pode conter letras ou
caracteres especiais.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
6) Método AdicionaTerminalLista
Determina qual terminal estará em cada lista adicionada, os parâmetros enviados são:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
7) Método EnviarLista
Envia a lista após Adcionado Crachas a Lista e Adcionado Terminais a Lista.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description). Sendo:
8) Método AnulaLista
Envia para o equipamento um comando que anula a lista de crachás da memória do equipamento. O parâmetro
a ser enviado é:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) .
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
-2147219991 - CM3_RT: AdicionaTemplates. O Crachá não pode conter letras ou caracteres especiais.
Inicializa o componente a enviar os Parâmetros da Lista (listagem dos templates) para ser utilizada quando o
equipamento não estiver comunicando (batch). Assim somente os templates contidos na lista terão acesso ao
equipamento.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description). Sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) .
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Enquanto o firmware esta sendo enviado aos equipamentos e gerado o evento CarregandoFirmware, e ao termino do
processo e gerado o evento ConcluidoEnviarFirmware, senão, retorna o evento Erro.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description) sendo:
Enquanto o firmware esta sendo enviado aos equipamentos e gerado o evento CarregandoFirmware, e ao termino do
processo e gerado o evento ConcluidoEnviarFirmwareTerminal, senão, retorna o evento Erro.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Deve ser enviado este comando para concentradora após adicionar os terminais para que a concentradora
reconheça os terminais adicionados.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description).
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão
(Err.Number + Err.Source + Err.Description). Sendo:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Método usado para obter os registro e mover a posição do ponteiro do registro para o próximo registro, gerando assim o
evento RegistroSolicitado.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Este método deve ser utilizado para avisar ao componente que foram recebidos os registros em Batch através
do evento RegistroSolicitado, para o componente excluí-los do equipamento. Os parâmetros a serem enviados são:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Metodo usado na resposta do Evento ConsultaCracha onde e informado ao equipamento a decisão do acesso.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Método usado para solicitar a Versão do Firmware, Versão do BootLoader, Data e Hora dos equipamentos.
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Como resposta a este método teremos o Evento ConcluidoStatusComunicacaoConcentradora, que nos retorna as
seguites informações:
Erros que o componente retorna, caso os parâmetros estejam fora dos padrões, seguindo o seguinte padrão (Err.Number
+ Err.Source + Err.Description).
Retorno Descrição
Porta Numero da Porta Conectada.
Evento gerado durante o Envio do Firmware usado para mostrar a progressão deste processo.
Os parâmetros que são retornados são:
Retorno Tipo Descrição
Numero_Equipamento Integer Numero do equipamento.
Pacote_Enviado Integer Pacote do firmware enviado. Usado na progressão.
Pacote_Total Integer Total do Pacote. Final da progressão.
Tipo_Firmware TipoFirmware Tipo do Firmware classificado em:
Concentradora = 0,
Terminal = 1,
BootLoaderConcentradora = 2,
BootLoaderTerminal = 3
Evento gerado durante a Carga da Lista usado para mostrar a progressão deste processo.
Os parâmetros que são retornados são:
Retorno Tipo Descrição
Numero_Equipamento Integer Numero do equipamento.
Total_Enviado long Valor long informando o valor enviado.
Total_Geral long Valor ling informando o total a enviar.
Evento gerado durante a Carga dos Templates usado para mostrar a progressão deste processo.
Os parâmetros que são retornados são:
Retorno Tipo Descrição
Numero_Equipamento Integer Numero do equipamento.
Total_Enviado long Valor long informando o valor enviado.
Total_Geral long Valor ling informando o total a enviar.
Evento gerado na conclusão do comando Status. Alguns parâmetros só retornam na versão 02.01.0003 ou superior do
firmware.
Os parâmetros que são retornados são:
Retorno Tipo Descrição
Resposta_Status RespostaStatus Conjunto de parâmetros configurados no equipamento
Enumerador
Aberto = 0, Curto = 1.
Acesso_Nao_Concluido_Numero_Entrada NumeroEntrada Número da entrada do acesso não concluído.
Desabilitado: não será utilizado o sensor de
acesso não concluído. Entrada 1: será utilizada
a entrada 1 do terminal para o acesso não
concluído. Entrada 2: será utilizada a entrada 2
do terminal para o acesso não concluído.
Enumerador
Entrada_Desabilitada = 0, Entrada_1 = 1,
Entrada_2 = 2.
Acesso_Via_Teclado Boolean Sim: permite o acesso via teclado. Não:
desativado o teclado.
Enumerador
Aberto = 0, Curto = 1.
Acionamento_Numero_Saida NumeroSaida Número da saída do rele acionamento.
Desabilitado: não será utilizado o rele de saída
para acionamento. Saída 1: será utilizada o rele
1 do terminal para o acionamento.
Enumerador
Saida_Desabilitada = 0, Saida_1 = 1,
Saida_2 = 2.
Acionamento_Permite_Acesso_Continuo Boolean Indica se permite acionamento continuo do rele
para o acionamento da porta. Sim: efetua o
acionamento continuo do rele até atingir o
tempo de timeout. Não: não efetua o
acionamento continuo do rele.
Enumerador
Aberto = 0, Curto = 1.
Burla_Numero_Entrada NumeroEntrada Número da entrada da burla. Desabilitado: não
será utilizada a entrada da burla. Entrada 1: será
utilizada a entrada 1 do terminal para entrada
da burla. Entrada 2: será utilizada a entrada 2
do terminal para entrada da burla.
Enumerador
Entrada_Desabilitada = 0, Entrada_1 = 1,
Entrada_2 = 2.
Cartao_2de5_Especial Boolean Leitor padrão Dimep utilizado para código de
barras.
Enumerador
NaoDigital = 0, SempreDigital = 1,
DigitalseHouver = 2, DigitalseNaoSenha = 3.
Modo_Leitura Boolean Sim: permite a leitura com Porta Aberta. Não:
não permite a leitura com Porta Aberta.
Enumerador
Aberto = 0, Curto = 1.
Sensor_Acesso_Numero_Entrada NumeroEntrada Número de entrada do sensor de acesso:
Desabilitado: não será utilizado o sensor de
entrada. Entrada 1: será utilizada a entrada 1 do
terminal. Entrada 2: será utilizada a entrada 2
do terminal.
Enumerador
Entrada_Desabilitada = 0,
Entrada_1 = 1,
Entrada_2 = 2.
Sensor_Acesso_Sinaliza_Intrusao Boolean Sensor de acesso sinaliza intrusão de porta.
Sim: sinaliza intrusão de porta. Não: não
sinaliza intrusão de porta.
Enumerador
Sensor_Porta = 0,
Retorno_Acesso_Concluido = 1.
Sentido_Acesso SentidoAcesso Terminal é de entrada ou Saída.
Enumerador
Sentido_Entrada = 1,
Sentido_Saida = 2.
Solicitacao_Acionamento_Debounce Integer Tempo de estabilidade do sensor de entrada do
terminal em milisegundos, onde caso ocorra
uma alteração no sinal elétrico, não será
considerado o recebimento do pulso de
acionamento durante o tempo definido. Este
tempo varia de acordo com o fabricante do
sensor de porta.
Evento gerado para informar que o equipamento não encontrasse em estado de ocupado e pode receber novos
comandos.