Pular para o conteúdo principal

Instruções de Uso


Diagrama geral de funcionamento

O diagrama apresentado abaixo, demonstra a instalação padrão do módulo M-ID10W. Ao ligar o M-ID10W pela primeira vez, ele estará em modo de operação de fábrica.

img


Descrição dos fios

img

Modelos anteriores a esta versão mudam a cor do fio.

  • Entrada1
    • Positivo: Marrom
    • Negativo: Cinza
  • Entrada2
    • Positivo: Verde
    • Negativo: Amarelo
  • Saida Digital
    • Positivo: Roxo
    • Negativo: Azul
  • Saida Relé
    • Positivo: Laranja
    • Negativo: Branco
  • Alimentação
    • 5VCD: Vermelho
    • GND: Preto
Atenção

Certifique-se de utilizar a fonte de alimentação enviada junto do leitor para não causar danos ao hardware do equipamento.


Exemplo de ligação das Entradas e Saída

img

Modelos anteriores a esta versão mudam a cor do fio.

  • Entrada2
    • Positivo: Azul Escuro
    • Negativo: Rosa

Configurações Iniciais

Ao ligar o M-ID10W pela primeira vez, ele estará com as configurações de fábrica, sendo assim, uma nova rede Wireless será criada e aguardará conexões. O nome da rede (SSID) é criado conforme o padrão, sendo mid10-xxxxxxxx (x = identificação única do leitor).

A senha padrão para conexão com o Wifi é: viaondarfid

img

Página de administração

O acesso à página de administração/configurações é feito pelo seu navegador (Google Chrome, por exemplo) através do endereço: http://192.168.0.10

img

As credenciais padrão são:

  • Usuário: admin
  • Senha: admin

Dados atuais

Nesta sessão são exibidos os dados de configurações de rede atuais.

img

Quando seu modelo não contar com RTC (Real Time Clock), será exibida a mensagem: RTC NOT PRESENT ON THIS BOARD VERSION no campo Data e Hora.

Parâmetros wireless

Nesta sessão é possível definir os parâmetros Wireless.

img

  • Modo de operação :
    • Access Point: define que o M-ID10W será usado como ponto de acesso (como um roteador).
    • Station: define que o M-ID10W será usado como estação, e deverá se conectar à uma rede WiFi existente.

      Neste modo, é obrigatório o preenchimento do nome da rede SSID onde o leitor se conectará, bem como a senha de conexão. Os parâmetros de endereçamento IP devem ser definidos manualmente, já que a configuração não permite a operação em modo DHCP, apenas com endereço IP estático.

  • SSID : quando em modo Access Point, o SSID é configurável, mudando o nome da rede Wifi como quiser. Quando em modo Station, é necessário informar o nome da rede SSID onde o leitor deverá se conectar.
  • Senha de Conexão: quando em modo Access Point, é a senha exigida para conexão de novos clientes. Quando em modo Station, é a senha de conexão da rede SSID onde o leitor deverá se conectar.

    O leitor tentará se conectar à rede fornecida por 10 vezes com intervalo de 5 segundos. Caso não consiga se conectar, o leitor se reiniciará automaticamente, repetindo o processo de conexão.

  • Porta do Socket Server : é a porta de rede que o leitor abrirá um listener aguardando conexões externas. É usado quando o equipamento estiver operando em modo Answer Mode.
  • IP: IP estático do leitor.
  • Máscara: máscara de rede.
  • Gateway: endereço IP do Gateway de rede.
  • Canal de Operação: canal de operação WiFi utilizado pelo equipamento (Apenas em modo Access Point).
  • Host: aplica DNS para customizar o link de acesso das configurações de seu leitor, como mostra o exemplo a baixo..

img

Parâmetros gerais

Nesta sessão é possível definir os parâmetros gerais do equipamento.

img

  • Usuário : nome do usuário utilizado para login na página de administração.
  • Senha : senha de acesso para o login na página de administração.
  • Imprimir dados RFID TX no Serial Debug : permite ligar ou desligar o envio de dados de Debug para a saída auxiliar RX2.
  • Debug Mode : quando habilitado permite debugar o firmware.
  • Salvar Debug Cartão SD : quando habilitado permite salvar o debug no cartão SD.
  • Keep Alive : quando habilitado permite enviar a mensagem escolhida para mostrar se há conexão persistente.

img

  • Restaurar módulo : quando o leitor for do modelo ethernet USR, você tem a opção de restaurar as configurações do módulo ethernet.

Parâmetros de rádio frequência

Nesta sessão é possível definir os parâmetros de trabalho do RFID e operação automáticas.

img

  • RF Modo de Operação : define o comportamento de operação do leitor RFID, sendo:

    • Modo Escravo: É utilizado quando o equipamento deve aguardar comandos de leitura vindos da biblioteca DLL ou pelo Socket de rede.

      Acesse http://restrito.viaondarfid.com.br para download do SDK e documentos de apoio auxiliares.

    • Modo Autônomo: Neste modo, o leitor entra automaticamente em operação de leitura, gravando as tags lidas no buffer, cartão de memória ou enviando para uma URL, quando configurados.
    • Modo Autônomo (Trigger): Assim como o modo anterior, neste modo, o leitor aguardará um pulso no GPIO de entrada para realizar a leitura. Trata-se de uma leitura autônoma com base em uma condição.
  • Buzzer : Habilita ou desabilita o Buzzer. Necessário reiniciar o leitor após definição

  • Intervalo de Leitura pós Trigger : define o tempo que o leitor realizará a leitura após o pulso no GPIO de entrada.

  • Intervalo de leitura de tags : determina o tempo de intervalo de leitura das Tags.

  • Potência das Antenas : define a potência de leitura, sendo de 1dBm à 26dBm.

  • Sessão : define a sessão que será utilizada nas leituras.

    • Sessão 0: A tag RFID responde a todas as requisições feitas pelo leitor RFID.
    • Sessão 1: Quando a tag RFID recebe a requisição do leitor pela primeira vez, ela responde de prontidão. Após isso, a tag entra em estado de silêncio e aguarda entre 0,5 a 5 segundos para responder a próxima requisição. O tempo de silêncio não é configurado, quem define isso é a própria tag.
    • Sessão 2 ou 3: A tag RFID responde na primeira vez que foi detectada pela antena. Caso ela se mantenha perto da antena, a etiqueta não irá responder novamente. Quando sair do alcance da antena, depois de até 20 segundos irá responder novamente.
  • Banco Leitura Tag : define o banco de memoria que será lido da tag.

    • EPC: código hexadecimal com gravação livre, usado para identificar determinado produto, categoria, colaborador, etc.
    • TID: código hexadecimal de identificação da tag, pré-definido pelo fabricante, ela pode ser lida, mas não editada.
  • Start Address TID : busca pelo dado no banco de leitura, conforme a posição configurada.

  • Tamanho banco TID : configura em bytes o tamanho do TID na tag que devera ser buscada.

  • Modo de Operação TTL/RS232 : define o modo de operação TTL/RS232, podendo ser entrada ou saída de dados. Quando SAÍDA estiver selecionada, os dados podem ser coletados pela serial, o EPC da tag liga pode ser coletado se a opção

    • Enviar EPC da Tag para saída auxiliar TTL/RS232 estiver habilitada. Quando ENTRADA estiver selecionada, permite que os dados recebidos na entrada RS232 acionem o trigger pelo tempo determinado.

    • Modo Autônomo-Trigger necessariamente precisa estar habilitado.

    • Baudrate: permite escolher o baudrate para saída ou entrada auxiliar TTL/RS232 Necessário reiniciar o leitor após definição

  • Enviar EPC da Tag para saída auxiliar TTL/RS232 : quando habilitado, envia o dado EPC da tag lida para a saída auxiliar TTL/RS232/TCPIP.

  • Salvar Tags lidas no cartão SD : quando habilitado, armazenará as tags lidas no cartão SD.

    Caso não haja nenhum cartão SD inserido, esta opção estará desativada e uma mensagem será exibida: img

  • Web services : utilizado para operações de leitura e acionamento dos GPIO's.

    Consulte a sessão Web services para informações sobre coleta e limpeza do buffer.

    OperaçãoURL
    imgColeta as leituras em ordem crescente com retorno em JSONhttp://[IP]:8080/getTagSDCard
    imgExcluir leituras armazenadashttp://[IP]:8080/clearTagSDCard
    OperaçãoURL
    imgColetar Status do GPIO de Entrada 1http://[IP]:8080/getInput1Status
    imgColetar Status do GPIO de Entrada 2http://[IP]:8080/getInput2Status
    imgAcionar o GPIO de Saída 1http://[IP]:8080/gpio.php?output=1&status=on
    imgDesligar o GPIO de Saída 1http://[IP]:8080/gpio.php?output=1&status=off
    imgAcionar o GPIO de Saída 2http://[IP]:8080/gpio.php?output=2&status=on
    imgDesligar o GPIO de Saída 2http://[IP]:8080/gpio.php?output=2&status=off
  • Manter saída ativa por... : quando configurado em modo autônomo ou autônomo com trigger, define o tempo em que a saída digital será mantida em ON após a leitura da TAG. Caso a máscara EPC esteja habilitada, apenas as tags que respeitem a máscara acionarão a saída digital (Com exceção das tags incluídas na lista de exclusão.).
    Este tempo pode variar de 0 (DESABILITADO) a 30 segundos.

  • Descartar Tag Repetida : quando selecionado, descarta a leitura repetida da mesma tag em sequência.

  • Máscara EPC : define a máscara de leitura. O tamanho do filtro deve ser entre 1 e 24 dígitos, podendo filtrar o prefixo do EPC ou uma tag única. Qualquer outra tag que não estiver dentro dessa máscara o leitor irá desconsiderar completamente

    Exemplo: Caso a máscara 3034541 seja definida, apenas as tags que possuam o EPC com inicio igual à máscara serão processadas, as demais serão descartadas.

  • Lista com permissão (1 EPC por linha) : permite controle de cadastro das tags no leitor, quando uma tag é cadastrada nessa função o leitor irá desconsiderar a leitura das outras tags, que não estiver registrado nesta lista.

  • Lista de Exclusão (1 EPC por linha) : quando uma tag deva ser descartada, mesmo estando dentro da regra da máscara, pode-se informar nesta lista o EPC completo da TAG (24 dígitos) que deverá (deverão) ser descartada (s).

Parâmetros do Web Service

Nesta sessão é possível configurar os parâmetros do Web Service

img

  • Enviar EPC para URL : caso este campo estiver vazio, nada será feito. Quando preenchido, o leitor enviará um HTTP POST REQUEST para a URL informada, contendo o array com o EPC da tag lida e a data.

    Exemplo: "http://www.viaondarfid.com.br/ws/getTagReading" - Quando uma tag for lida, o equipamento enviará a requisição HTTP POST:

[
{
"reading_reader_ip": "192.168.15.220",
"reading_epc_hex": "721E8D7D0000000000000000",
"reading_reader_mac": "0C:B8:15:D6:08:30",
"reading_company_id": " ",
"reading_antenna": "1",
"reading_movement_type": "1",
"reading_created_at": "2022-05-17 11:26:57",
"reading_reader_name": "Leitor 1"
},
{
"reading_reader_ip": "192.168.15.220",
"reading_epc_hex": "721E8D7D0000000000000005",
"reading_reader_mac": "0C:B8:15:D6:08:30",
"reading_company_id": " ",
"reading_antenna": "1",
"reading_movement_type": "1",
"reading_created_at": "2022-05-17 11:26:58",
"reading_reader_name": "Leitor 2"
}
]
  • Certificado SSL : quando houver o certificado na URL que será enviada, "https", necessário preencher com o certificado da página de acordo com o protocolo SSL.
  • Tempo para envio ws (s) : tempo em segundos de envio para o Web Service (Padrão 10 segundos).
  • Token API : token necessário para validação do envio para o Front end.
  • Company ID : define o ID que será atribuído.
  • Nome do leitor : nome de identificação do leitor, este nome é salvo no campo no json de envio.
  • Validação da Saída 1 pelo WS : quando habilitada permite acionar a saída 1, de acordo com código de resposta configurado, pelo tempo determinado
  • Validação da Saída 2 pelo WS : quando habilitada permite acionar a saída 2, de acordo com código de resposta configurado, pelo tempo determinado
  • Código de Invalidação pelo WS : quando habilitado permite invalidar o acionamento das saídas, conforme o código de resposta configurado
  • Log Envio WS : resultado Json da requisição, realizada através dos EndPoints.

Atualização de firmware

O equipamento só notificará se houver uma atualização se estiver em modo Station/Estação.

Quando houver atualização disponível, é possível fazer o update pela página de administração/configuração do leitor. Após atualização, o leitor será restaurado para padrão de fábrica.

img

Atenção

Enquanto o equipamento estiver sendo atualizado, é crucial que não seja desligado e que a internet tenha uma conexão estável.

Atenção

Quando o leitor for atualizado todos os dados salvos no cartão SD será deletado.

Certificado SSL

Para fazer a exportação do certificado da página siga os passos abaixo:

img

  • Após concluir a exportação, será exibido uma mensagem:

img

  • Ao concluir a exportação do certificado, é necessário abrir o arquivo em um editor de texto e copiar o código, que será inserido na página de configuração da antena no campo "Certificado SSL":

img


GPIO's

TipoDescriçãoStatus PadrãoTensão Acionamento
EntradaGPIO Entrada 1Desligada5v DC
EntradaGPIO Entrada 2Desligada5v DC
SaídaGPIO Saída 1Desligada5v DC

Web services

Controle de GPIO's

Recuperar status da entrada digital 1

URL: http://[IP]:8080/getInput1Status
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"message": "Get GPIO Status Input 1",
"Status": "OFF"
}

RETORNO 2:

{
"message": "Get GPIO Status Input 1",
"Status": "ON"
}

Recuperar status da entrada digital 2

URL: http://[IP]:8080/getInput2Status
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"message": "Get GPIO Status Input 2",
"Status": "OFF"
}

RETORNO 2:

{
"message": "Get GPIO Status Input 2",
"Status": "ON"
}

Alterar status da saída digital 1

URL: http://[IP]:8080/gpio.php?output=1&status=on
MÉTODO: HTTP GET REQUEST
PARÂMETROS: output - Ident. Saída (Padrão 1) | status - on / off | timer - Tempo para manter a saída acionada (em segundos)
RETORNO 1:

{
"message": "GPIO 14 Output turned ON"
}

URL: http://[IP]:8080/gpio.php?output=1&status=off
MÉTODO: HTTP GET REQUEST
PARÂMETROS: output - Ident. Saída (Padrão 1) | status - on / off | timer - Tempo para manter a saída acionada (em segundos)

RETORNO 1:

{
"message": "GPIO 14 Output turned OFF"
}

URL: http://[IP]:8080/gpio.php?output=1&status=on&timer=5
MÉTODO: HTTP GET REQUEST
PARÂMETROS: output - Ident. Saída (Padrão 1) | status - on / off | timer - Tempo para manter a saída acionada (em segundos)
RETORNO 1:

{
"message": "GPIO Output turned ON for 5 seconds"
}

Leitura Padrão

URL: http://[IP]:8080/leituraPadrao
MÉTODO: HTTP GET REQUEST
PARÂMETROS: acao | iniciar - Ativa leitura
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "Serviço iniciado com sucesso"
}

URL: http://[IP]:8080/leituraPadrao
MÉTODO: HTTP GET REQUEST
PARÂMETROS: acao | finalizar - Desativa leitura
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "Serviço finalizado com sucesso"
}
Atenção

Para que esse WebService funcione corretamente é necessário configurar o modo de operação RFID como "Escravo"


Dados do Cartão SD

Recupera a lista de tags lidas e armazenadas no cartão SD

URL: http://[IP]:8080/getTagSDCard
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"message": "Get tag list from SD Card",
"count_files": 0,
"tag list": [
{
"reading_reader_ip": "192.168.15.220",
"reading_epc_hex": "721E8D7D0000000000000000",
"reading_reader_mac": "0C:B8:15:D6:08:30",
"reading_company_id": " ",
"reading_antenna": "1",
"reading_movement_type": "1",
"reading_created_at": "2022-05-17 11:26:57",
"reading_reader_name": "Leitor 1"
},
{
"reading_reader_ip": "192.168.15.220",
"reading_epc_hex": "721E8D7D0000000000000005",
"reading_reader_mac": "0C:B8:15:D6:08:30",
"reading_company_id": " ",
"reading_antenna": "1",
"reading_movement_type": "1",
"reading_created_at": "2022-05-17 11:26:58",
"reading_reader_name": "Leitor 2"
}
]
}

RETORNO 2:

{
"message": "Get tag list from local buffer",
"error": "SDCard file is empty"
}

RETORNO 3 :

{
"message": "Get tag list from SD Card",
"count_files": 0,
"tag list": []
}

Limpa todas as leituras contidas Cartão SD

URL: http://[IP]:8080/clearTagSDCard
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{ 
"message": "Tag Buffer list is empty now"
}

WS BlackList

Adiciona tag na lista

URL: http://[IP]:8080/blackList?add=3074257BF4B98CC000000008
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "EPC adicionado com sucesso na black list",
"blackList": "3074257BF4B98CC000000015"
}

Remove tag na lista

URL: http://[IP]:8080/blackList?remove=3074257BF4B98CC000000008
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "EPC removido com sucesso na black list",
"blackList": ""
}

Lista tags registradas

URL: http://[IP]:8080/blackList?list
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"blackList": "3074257BF4B98CC000000025, 3074257BF4B98CC000000028, 3074257BF4B98CC000000023"
}

Limpa lista de tags

URL: http://[IP]:8080/blackList?deleteAll
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "Sucesso ao deletar arquivo de black list",
"blackList": ""
}

WS WhiteList

Adiciona tag na lista

URL: http://[IP]:8080/whiteList?add=3074257BF4B98CC000000008
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "EPC adicionado com sucesso no white list",
"whiteList": "3074257BF4B98CC000000015"
}

Remove tag na lista

URL: http://[IP]:8080/whiteList?remove=3074257BF4B98CC000000008
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "EPC removido com sucesso no white list",
"whiteList": ""
}

Lista tags registradas

URL: http://[IP]:8080/whiteList?list
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"whiteList": "3074257BF4B98CC000000025, 3074257BF4B98CC000000028, 3074257BF4B98CC000000023"
}

Limpa lista de tags

URL: http://[IP]:8080/whiteList?deleteAll
MÉTODO: HTTP GET REQUEST
PARÂMETROS: Nenhum
RETORNO 1:

{
"response code": "200",
"status": "sucesso",
"msg": "Sucesso ao deletar arquivo de white list",
"whiteList": ""
}

Restaurar padrão de fábrica

O M-ID10W, dispõe de um botão de reset, que pode restaurar as configurações aos padrões de fábrica. Para restaurar, basta desligar o equipamento da fonte de energia, pressionar o botão, ligar o equipamento. Manter o botão acionado por 10 segundos enquanto o módulo é iniciado ou com equipamento ligado pressionar o botão até ouvir um acionamento longo em seu buzzer, Isso restaurará as configurações de WiFi aos padrões de fábrica.

img

Atenção

Quando o leitor for restaurado todos os dados salvos no cartão SD será deletado.

Reiniciar Leitor

Aplica a reinicialização do equipamento, sem afetar as configurações.

Salvar

Aplicar as configurações no leitor. As configurações são salvas no equipamento e se mantém mesmo após desligado.

Idioma

A página de administração está disponível em 2 idiomas, inglês e português. Para alternar entre os idiomas, basta selecionar a bandeira do idioma desejado e a página se atualizará automaticamente.