2016

Manual Firmware Digicon

MCA – Módulo Controlador de Acesso
Manual de Comandos da Console do Firmware

Digicon S. A. Controle Eletrônico para Mecânica – Copyright © 2010-Digicon S.A.–Todos os direitos reservados.
Versão 5.3 - 19/09/2016
 Digicon S.A
2016

Todos os direitos reservados. Nenhuma parte destapublicação

pode ser reproduzida, transmitida, transcrita, arquivada num
sistema de recuperação, ou traduzida paraqualquer língua ou
linguagem de computador de qualquer meio eletrônico,
magnético, óptico, químico, manual ou de outra maneira, sem a
permissão expressa por escrito da Digicon S.A.

Protocolo: 5
Revisão: 3
Data: 19/09/2016

As informações contidas neste documento estão

sujeitas a alterações sem prévio aviso.
Este manual foi elaborado por:
DIGICON S.A.

Setor de Engenharia de
Desenvolvimento de Sistemas

Manual – Console do Firmware Digicon Acesso 5.3 2

Sumário
1. Histórico de revisões do manual......................................................................................... 4
2. Objetivos ............................................................................................................................. 5
3. Arquitetura da solução acesso............................................................................................ 5
4. Definições Gerais ................................................................................................................ 6
4.1. Codificação das revisões .............................................................................................. 6
5. Resumo Firmware de Acesso .............................................................................................. 6
5.1. Funcionalidades do Firmware Digicon Acesso............................................................. 6
6. Integração ........................................................................................................................... 7
7. Conectando no Dispositivo ................................................................................................. 8
7.1. Usuário e senha ........................................................................................................... 8
7.2. Erro ao conectar via telnet .......................................................................................... 9
8. Comandos que podem ser executados sem parar o firmware ........................................ 10
8.1. Verificando parâmetros disponíveis na console ........................................................ 10
8.2. Verificando a versão do Firmware Acesso Digicon .................................................... 10
8.3. Verificando versão do kernel do Linux ...................................................................... 11
8.4. Verificando a composição de espaços ....................................................................... 11
8.5. Verificando se o Firmware está rodando .................................................................. 11
8.6. Finalizando o Firmware ............................................................................................. 12
9. Comandos que devem ser executados com o Firmware parado ..................................... 14
9.1. Iniciando o Firmware Acesso Digicon manualmente ................................................ 14
9.2. Configuração das propriedades de comunicação do Firmware ................................ 14
9.3. Verificando processos automáticos ........................................................................... 15
9.4. Verificando permissões de acesso do dipositivo ....................................................... 15
9.5. Verificando ligações da pessoa com o sensor biométrico ......................................... 16
9.6. Verificando quantidade de usuários gravados no sensor biométrico ....................... 16
9.7. Removendo todos os templates ................................................................................ 17
9.8. Verificando quantidade de usuários gravados no sensor biométrico HandKey........ 17
9.9. Removendo todos os templates HandKey................................................................. 18
9.10. Verificando as configurações e propriedades do dispositivo .................................. 18
9.11. Verificando as configurações gerais do dispositivo ................................................. 18
9.12. Verificando as configurações e propriedades da leitora ......................................... 19
9.13. Verificando as propriedades de comunicação do dispositivo ................................. 21
9.14. Verificando as mensagens cadastradas para cada evento ...................................... 21
9.15. Verificando as configurações para acionamento em estado de emergência.......... 22
9.16. Verificando as ações de acionamento configuradas para a entrada X.................... 22
9.17. Verificando as formas de distribuição no mapa do Smart Card .............................. 23
10. Problemas, compreendendo e resolvendo .................................................................... 25

Manual – Console do Firmware Digicon Acesso 5.3 3

 11. Glossário ......................................................................................................................... 26

1. Histórico de revisões do manual

Versão Data Descrição

5.1 01/10/2014 - Criação deste manual.

5.2 21/09/2015 - Ajustado a indexação dos tópicos;

- Alterado a nomenclatura do Manual de Manual SDK Acesso –
Console Firmware para “Manual – Console Firmware Digicon Acesso”;
- Alterado forma de derrubar o Firmware comando “kill” do Linux
- Ajustado as palavras chaves para utilizar maiúscula.

5.3 19/09/2016 - Incluído no capítulo de conexão com o Firmware a possibilidade de

fazer utilizando o aplicativo putty, passado referência do site.
- Ajustado forma de finalização do Firmware no capítulo 8.6.

Manual – Console do Firmware Digicon Acesso 5.3 4

 2. Objetivos

Este documento tem por objetivo explicar como conectar no dispositivo via telnet
(Protocolo cliente-servidor usado para permitir a comunicação entre computadores ligados
numa rede) e descreve quais operações pode ser executada depois de realizada a conexão.
Este procedimento somente deve ser executado por usuários avançados.

3. Arquitetura da solução acesso

Manual – Console do Firmware Digicon Acesso 5.3 5

 4. Definições Gerais

Seguem, neste, macro-definições que norteiam o funcionamento deste protocolo.

4.1. Codificação das revisões

 Visando melhor entendimento, compatibilidade, distribuição e facilidade nas

manutenções, estabelecemos a codificação deste manual seguindo “P.R”, onde:

 P = Protocolo, o número do protocolo do Firmware que será incrementado toda vez

que ocorrer uma alteração no datagrama do Firmware, acompanhará o primeiro dígito
do código de versão do Firmware.

 R = Revisão do documento, será incrementado para toda alteração dentro da

codificação do Protocolo (P), ou qualquer alteração na estrutura do manual, seja por
correções de linguagem, melhorias nas explicações, estrutura de capítulos, etc.
Iniciando sempre do algarismo 1, acompanhará todas implementações de novas
funcionalidades, sem quebra de compatibilidades e correções, refletindo diretamente
nas mudanças de Versões e Build do Firmware que deverá ser anotada no quadro
revisões deste documento.

5. Resumo Firmware de Acesso

Aliado a uma mecânica robusta e eletrônica refinada, foi desenvolvido um Firmware capaz
de executar ações pré-configuradas pelos sistemas de acesso, servindo uma grande variedade
de empresas com suas necessidades on-line e off-line, nosso Firmware funciona sobre o
gerenciamento do poderoso sistema operacional Linux.
Para facilitar a inicialização dos projetos, os equipamentos saem de Fábrica com o
Firmware 9.1.0.0, sendo que esta versão contempla comandos para atualização do Firmware.
Quando as aplicações solicitam status dos dispositivos o código da versão é precedido do
algarismo “9”, que significa código de produto da Digicon, caso o “Firmware Acesso” for “6” o
código de produto é da Senior.
O equipamento quando iniciado pela segunda vez no display estará apresentando
“BLOQUEADO”, isso não é um defeito, SIM é um alerta, que significa que o mesmo está sem
configuração alguma ou com parâmetros faltantes.
Para configurar as informações de conexão, na inicialização elétrica, seja por chave ou
desconexão da fonte das controladoras MCA e MCANET, observando o display logo após ficar
back-ligth, o Firmware entrará por 4 segundos em modo de configuração, neste intervalo
pressionar “ENTRA” na MCA ou “ENT” na MCANET, serão solicitadas na sequência.

5.1. Funcionalidades do Firmware Digicon Acesso

 Temos mais de 200 requisitos funcionais e não funcionais, fornecendo ao mercado uma
grande variedade de combinações e casos de uso;
 Permite configurar controladoras IP fixo e DHCP;
 Permite trabalhar on-line ou off-line por controladora através de comando da
aplicação;
 Permite configurar comportamento do estado off-line de forma que não fique gerando
sobre carga de requisições desnecessárias de autenticação na rede;

Manual – Console do Firmware Digicon Acesso 5.3 6

  Permite configuração do tamanho das áreas de armazenamento de eventos e backup;
 Permite na mesma leitora que seja configurado ações de acionamentos para: Acesso
Válido, Acesso Inválido e Acesso com Revista Aleatória;
 Permite configurar acionamentos para modo de emergência;
 Permite configurar acionamentos agravés das entradas (botoeiras e alarmes);
 Permite configurar nomenclatura das mensagens default do acesso;
 Permite que sejam montadas as mensagens que serão mostradas nos equipamentos a
critério do desenvolvedor;
 Possui mecanismo de backup dos eventos enviados de forma automática;
 Permite configuração automática de horário de verão e GMT (Greenwich Mean Time);
 Executam operações com dados armazenados no chip do cartão smartcard classic 1K,
são mais de 70 campos de dados (Nível, Afastamento, Situação, Crédito Refeição, etc.);
 Possui rotinas de autenticação dupla de pessoas ou veículos (autorizado/autorizador,
condutor/veículo);
 Armazenamento de listas de acesso ou bloqueios com cerca de 50 mil cartões;
 Permite configurações de funções para reserva de refeições, coletas de biometrias,
digitação de cadastro para acesso, etc.
 Permite operação com senha geral ou específica por pessoa
 Permite que seja designado por pessoa o percentual do grau de conferência biométrica
 Permite configurar agendamentos de acionamentos programados do tipo liga e desliga
sirenes, quadro de energia ou qualquer equipamento;
 Opera na mesma controladora com leitores distintos, smartcard, barras (1D e 2D), RFID,
biometria Sagem (finger) e Handkey (geometria da palma da mão);
 No caso da MCANET II gerencia até 6 leitoras RS 485 MRA, inclusive com biometria
Sagem (ainda não habilitada para mapa do cartão smartcard);
 MRA podem ser configuradas para operação com validação local (listas locais) e remota
utilizando a inteligência da MCANET II;
 Trabalha com validação on-line com tempo menor que 2 segundos e off-line com 800
milessegundos;
 Grande variedade de validações: Local, Anti-Dupla, Nível, Afastamento, Situação,
Revista Aleatória, Faixa Horária, Tipo de Pessoa, Etc.;
 Validações das portarias da receita federal para atendimento de recintos alfandegados:
31, 59, 65 (Paranaguá, São Francisco do Sul, Itajaí) e 200 (BDCC - Santos).

6. Integração

A solução de controle de acesso Digicon é desenvolvida e mantida em todos seus níveis,

ela é composta de mecânica, eletrônica, Firmware e um poderoso Framework API DFS, que
permite alto nível de integração.
Aliado com mecânica robusta e eletrônica refinada foi desenvolvido um Firmware capaz de
executar ações pré-configuradas pelos Sistemas de Acesso, servindo uma grande variedade de
empresas com suas necessidades on-line e off-line, nosso Firmware funciona sobre o
gerenciamento do poderoso sistema operacional Linux.
Para que a integração seja bem sucedida, a Digicon fornece um SDK de alto nível,
juntamente com dispositivos para testes, tudo isso contribui para elevado grau de
produtividade no desenvolvimento de soluções de nossas Alianças.

Manual – Console do Firmware Digicon Acesso 5.3 7

 7. Conectando no Dispositivo

Para iniciar a conexão via telnet (aplicativo do MS-DOS), deve-se abrir um prompt de linha
de comando DOS e executar o comando telnet seguido o IP do dispositivo.

O usuário também pode utilizar o aplicativo putty (http://www.putty.org/), este permite

também a gravação de log da sessão conectada.

7.1. Usuário e senha

Após conectar será solicitado o usuário e senha (root/digicon), no caso específico da

MCANET I não exige senha.

Manual – Console do Firmware Digicon Acesso 5.3 8

7.2. Erro ao conectar via telnet
Caso não seja possível conectar via telnet no dispositivo será exibida a mensagem abaixo:

Manual – Console do Firmware Digicon Acesso 5.3 9

 8. Comandos que podem ser executados sem parar o firmware

Os comandos abaixo podem ser executados sem a necessidade de encerrar a execução do

Firmware.
Estes comandos não fazem uso de interface de periféricos, tão pouco faz leitura do banco
de dados.
Os comandos que são precedidos com “fd” são do Firmware Digicon, demais do sistema
operacional Linux.

8.1. Verificando parâmetros disponíveis na console

fd -help

Este comando apresenta a lista de comandos suportados pelo Firmware seguido de uma
breve descrição.

8.2. Verificando a versão do Firmware Acesso Digicon

fd -version

Este comando retorna a versão do Firmware Acesso Digicon e da biblioteca utilizada.

O primeiro dígito indica a fábrica, quem compilou o Firmware, lembrando que até a versão
6.1.8.x, apenas a Senior era mantenedora do Firmware Digicon.
Quando o código da versão iniciar com “1” ou “6” significa que a compilação é da época
que a Senior Sistemas desenvolvia o Firmware. Mais informações.

Manual – Console do Firmware Digicon Acesso 5.3 10

 8.3. Verificando versão do kernel do Linux

uname –a

Por conta do barramento do processador que comporta cada uma das placas
controladoras a equipe de desenvolvimento precisa empacotar versões diferentes do kernel
do Linux.

Comando “uname –a” retorna qual a versão do kernel, quando mandamos um pacote de 1
MB o comando de atualização que já está instalado na MCA vai receber esse pacote e vai
desempacota-lo, vai procurar os arquivos que são da plataforma que ele quer, esse comando
retorna a versão do kernel.

8.4. Verificando a composição de espaços

df

Para saber qual o tamanho do disco deve-se executar o comando “df”.

No caso da plataforma MCA “/dev/ram0” significa o montante de memória RAM utilizado.

“/mnt/flash/” significa montante de Flash de armazenamento.

8.5. Verificando se o Firmware está rodando

ps

Para verificar se o Firmware está rodando, execute o comando “ps (process show)”.

Este comando exibe a lista de processos que estão rodando dentro do dispositivo.

Na controladora MCA a execução do Firmware abre 6 (seis) processos (primeira figura), já

na MCANET 7 (sete) processos (segunda figura), conforme demonstrado abaixo:

Manual – Console do Firmware Digicon Acesso 5.3 11

 8.6. Finalizando o Firmware

Para execução dos comandos de manutenção do capítulo seguinte, faz-se necessário

finalizar a execução do Firmware.

Para finalizar ou “parar” o Firmware, iremos utiliza os comandos, “kill” (mata processo
pelo PID) e “killall” (mata processo pelo nome), executar os passos:

Primeiro passo é parar o processo inicializador do Firmware, desta forma impediremos

uma nova execução automática:

MCA e MCANET I  “/bin/sh ./inic_firmware”, versões atuais ou “/bin/sh ./inicsenior”,

versões antigas, a primeira coluna é o PID (process identification), no caso das figuras
mostradas no comando anterior (ps), 138 ou 87.

MCANET II  “/bin/sh /etc/init.d/main_app.sh”.

Manual – Console do Firmware Digicon Acesso 5.3 12

 kill 138 <enter>

Execute novamente o comando “ps” e veja se existe algum processo com nome
“/tmp/firmware-digicon”, se sim, execute novamente o passo anterior, se não iremos para o
segundo passo.

Segundo passo é parar os processos do Firmware:

killall –sigint firmware-digicon <enter>

Para verificar se o Firmware foi finalizado, deve-se executar o comando “ps”.

Os processos do Firmware não devem aparecer na lista de processos, como a seguir.

Manual – Console do Firmware Digicon Acesso 5.3 13

 9. Comandos que devem ser executados com o Firmware parado

Para a execução dos comandos deste capítulo é necessário que o Firmware seja encerrado,
pois os comandos concorrem com manipulação de periféricos ou banco de dados do Firmware
Digicon, podendo provocar danos a estrutura de dados do Firmware.

9.1. Iniciando o Firmware Acesso Digicon manualmente

Para iniciar o Firmware Manualmente, com a finalidade de acompanhar sua execução e

depurar para estudo, deve-se executar:

fd <enter>

Este comando executa o Firmware Digicon dentro da sessão telnet em andamento, caso
seja finalizado a sessão saindo do telnet não haverá Firmware em execução, quando existir
display, a controladora ficará “Back Light”.

fd & <enter>

Este comando, mesmo anterior precedido do caracter “&”, executa o Firmware Digicon em
“background”, caso seja finalizado a sessão saindo do telnet o Firmware ficará em execução.

9.2. Configuração das propriedades de comunicação do Firmware

Este comando apresenta a configuração das propriedades de comunicação do Firmware

permitindo alterar as informações, deve-se executar o seguinte comando:

fd –config <enter>

Manual – Console do Firmware Digicon Acesso 5.3 14

 ID do dispositivo: Identificador único do dispositivo
Utiliza DHCP? Responder sim (S) ou não (N). No caso de não significa dizer que usa IP fixo.
IP local: Ip do dipositivo. Somente para o Ip Fixo
Máscara de sub-rede: Mascára de rede. Somente para Ip fixo
Gateway: Endereço do Gateway. Somente para Ip Fixo
Ip do Servidor: Endereço Ip do servidor da concentradora
Porta: Porta de comunicação da concentradora

Após a confirmação a nova configuração é salva e exibida ao usuário:

9.3. Verificando processos automáticos

Este comando lista os processos automáticos agendados no Firmware.

fd –autotasks

9.4. Verificando permissões de acesso do dipositivo

Este comando lista as permissões de acesso do dipositivo, identificando se a leitora é

bloqueada ou liberada e as faixas horárias de acesso.

Manual – Console do Firmware Digicon Acesso 5.3 15

 Observação: As faixas horárias são apresentadas em minutos somados desde a zero hora,
ou seja 1439 correponde a 23:59 minutos.

9.5. Verificando ligações da pessoa com o sensor biométrico

fd –fingers

Este comando mostra a ligação da pessoa com o sensor biométrico. Informando a

identificação da pessoa e o índice que informa em que posição da memória do sensor o
template da pessoa esta gravada.

9.6. Verificando quantidade de usuários gravados no sensor biométrico

fd –biousers

Este comando apresenta a quantidade de usuários gravados no sensor biométrico, sendo

necessário informar dois parâmetros: Leitora e fabricante do sensor

Leitora: reader10, reader11, reader 12

Fabricante do sensor: sagem e suprema

Exemplo: fd –biousers reader10 sagem

Manual – Console do Firmware Digicon Acesso 5.3 16

 9.7. Removendo todos os templates

fd –clearfingers

Este comando exclui o arquivo de ligação entre as pessoas e o sensor biométrico e

também exclui todos os templates gravados no sensor biométrico selecionado. É necessário
informar a leitora biomátrica e o fabricante na execução do comando, sendo:

Leitora: reader10, reader11, reader 12

Fabricante do sensor: sagem e suprema

Exemplo: fd –clearfingers reader10 sagem

9.8. Verificando quantidade de usuários gravados no sensor biométrico

HandKey

fd –hands

Este comando mostra a ligação da pessoa com o template HandKey, informando a

identificação da pessoa e o próprio templtate

Manual – Console do Firmware Digicon Acesso 5.3 17

 9.9. Removendo todos os templates HandKey

fd –clearhands

Este comando exclui todos os templates HandKey do dispositivo.

9.10. Verificando as configurações e propriedades do dispositivo

fd –trace

Este comando apresenta as configurações e propriedades do dispositivo. O comando pode

ser executado com ou sem parâmetros. Se executado sem parâmetros tratá de uma vez todas
as propriedades e configurações, porém se executado com parâmetros tratá somente a
informação selecionada, conforme abaixo:

9.11. Verificando as configurações gerais do dispositivo

fd –trace general

Este comando apresenta as configurações gerais do dispositivo.

Manual – Console do Firmware Digicon Acesso 5.3 18

 9.12. Verificando as configurações e propriedades da leitora

fd –trace readerX

Este parâmetro trás as informações de configuração e propriedades da leitora. O valor X

representa o código da leitora no dispositivo (1 a 13)

Manual – Console do Firmware Digicon Acesso 5.3 19

 Observação: “Action” indica a ação e um valor diferente de zero indica que existe uma
ação configurada. “t” indica a quantidade de tempo em milisegundos e que a ação será

Manual – Console do Firmware Digicon Acesso 5.3 20

executada. “dep” indica alguma dependência, ou seja, somente vai acionar se alguma outra
entrada dor acionada em conjunto.

9.13. Verificando as propriedades de comunicação do dispositivo

fd –trace properties

Este parâmetro apresenta as informações das propriedades de comunicação do

dispositivo.

9.14. Verificando as mensagens cadastradas para cada evento

Manual – Console do Firmware Digicon Acesso 5.3 21

 fd –trace messages

Este parâmetro apresenta as mensagens cadastradas para cada evento e as mensagens

padrão do dispositivo.

Observação – “Conf L1 ” e “Conf L2” indicam a configuração de exibição da primeira e da

segunda linha do display. Os valores possíveis são: 0 Mensagem padrão; 1 Mensagem
configurada por evento; 2 Data e hora; 3 Número do Crachá

9.15. Verificando as configurações para acionamento em estado de emergência

fd –trace emergency

Este comando apresenta as ações configuradas para acionamento em caso do dispositivo

ficar em estado de emergência.

9.16. Verificando as ações de acionamento configuradas para a entrada X

fd –trace inputX

Este comando apresenta as ações de acionamento configuradas para a entrada X.

Manual – Console do Firmware Digicon Acesso 5.3 22

 Caso não seja selecionada uma entrada serão exibidas as configurações de todas as
entradas.

9.17. Verificando as formas de distribuição no mapa do Smart Card

fd –trace smartcard

Este comando apresenta como as informações estão distribuídas no mapa Smart Card.

Manual – Console do Firmware Digicon Acesso 5.3 23

 Observação: As posições marcadas como “???” indicam posições não ocupadas. As demais
informações são ocupadas e o seu significado deve ser solicitado para a Digicon caso seja
necessário.

Manual – Console do Firmware Digicon Acesso 5.3 24

 10. Problemas, compreendendo e resolvendo

Mesmo com toda atenção e preocupação constante com nossos produtos, não estamos
imunes de erros ou problemas.

Nosso processo de qualidade prevê melhoria contínua nos processos para

desenvolvimento de produtos e serviços, neste sentido estamos abertos a críticas e sugestões.

Estamos trabalhando compilando informações sobre análise de erros e situações

encontradas pelos usuários e em breve farão parte deste manual.

Dúvidas, críticas e sugestões, favor enviar e-mail para: suporte.vca@digicon.com.br.

Manual – Console do Firmware Digicon Acesso 5.3 25

11. Glossário

 Middleware  Em informática é um mediador, composto de hardware e/ou

software, comumente utilizado para mover ou transportar informações e dados
entre programas de diferentes protocolos de comunicação e plataformas.
 SDKSoftware Development Kit, conjunto de bibliotecas e padrões de protocolo
para desenvolvimento de aplicativos para integração.
 DG710  Leitora de mesa para cartões Mifare de fabricação Digicon.
 MSO 1300  Leitora de mesa de template biométrico de fabricação Sagem.
 MP 1.510 Portaria do Ministério do Trabalho e Emprego (MTE) que disciplina o
controle de ponto eletrônico (www.mte.gov.br/pontoeletronico/).
 FTP File Transfer Protocol, protocolo para transferência de arquivos.
 TCP Transport Control Protocol, camada de transporte do protocolo TCP/IP.
 DLL Dynamic Link Library, biblioteca de vínculo dinâmico, desenvolvida
inicialmente pela Microsoft para o conceito de biblioteca compartilhada.
 DFS  Digicon Framework Server, API de integração do SDK Digicon.
 API Application Programming Interface, bibliotecas ou camadas intermediárias,
normalmente fazem parte do SDK.

Manual – Console do Firmware Digicon Acesso 5.3 26