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.
Descrição dos fios
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
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
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
As credenciais padrão são:
Usuário
: adminSenha
: admin
Dados atuais
Nesta sessão são exibidos os dados de configurações de rede atuais.
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.
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.
Parâmetros gerais
Nesta sessão é possível definir os parâmetros gerais do equipamento.
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.
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.
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.
- Modo Escravo: É utilizado quando o equipamento deve aguardar comandos de leitura vindos da biblioteca DLL ou pelo Socket de rede.
Buzzer
: Habilita ou desabilita o Buzzer. Necessário reiniciar o leitor após definiçãoIntervalo 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çãoEnviar 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:
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ção URL Coletar leituras com retorno em JSON
http://[IP]:8080/getTagSDCard Excluir leituras armazenadas http://[IP]:8080/clearTagSDCard
Operação | URL | |
---|---|---|
Coletar Status do GPIO de Entrada 1 | http://[IP]:8080/getInput1Status | |
Coletar Status do GPIO de Entrada 2 | http://[IP]:8080/getInput2Status | |
Acionar o GPIO de Saída 1 | http://[IP]:8080/gpio.php?output=1&status=on | |
Desligar o GPIO de Saída 1 | http://[IP]:8080/gpio.php?output=1&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. O filtro definido aqui é considerado para o acionamento automático do GPIO de saída, envio para URL e envio para saída adicional TTL/RS232.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
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_company_id":" ",
"reading_created_at":"2022-05-17 11:26:57"
},
{
"reading_reader_ip":"192.168.15.220",
"reading_epc_hex":"721E8D7D0000000000000000",
"reading_company_id":" ",
"reading_created_at":"2022-05-17 11:26:58"
}
]
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.Enviar parâmetros para o Front end
: Quando habilitado permite enviar os parâmetros para o Front end.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.Código de Validação
: Quando habilitado, permite acionamento de determinada saída conforme a validação do código de resposta do WS.Adicionar Saída após Validação WS
: Determina a saída e o tempo de acionamento.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.
Atenção
Enquanto o equipamento estiver sendo atualizado, é crucial que não seja desligado e que a internet tenha uma conexão estável.
Certificado SSL
Para fazer a exportação do certificado da página siga os passos abaixo:
- Após concluir a exportação, será exibido uma mensagem:
- 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":
GPIO's
Tipo | Descrição | Status Padrão | Tensão Acionamento |
---|---|---|---|
Entrada | GPIO Entrada 1 | Desligada | 5v DC |
Entrada | GPIO Entrada 2 | Desligada | 5v DC |
Saída | GPIO Saída 1 | Desligada | 5v 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_company_id":" ",
"reading_created_at":"2022-05-17 11:26:57"
},
{
"reading_reader_ip":"192.168.15.220",
"reading_epc_hex":"721E8D7D0000000000000000",
"reading_company_id":" ",
"reading_created_at":"2022-05-17 11:26:58"
}
]
}
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.
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.