Módulo IOT-Telemetria

Manual de Operação

Revisão - Março 2019

Sumário
1. Descrição.....................................................................................................................3
2. Especificação..............................................................................................................3
3. Pinagem........................................................................................................................3
4. Configuração .............................................................................................................4
5. Código para cálculo do CRC16.............................................................................12
6. Configuração do dispositivo LoRaWAN..............................................................13
7. Suporte Técnico.......................................................................................................13

Revisão 1.1 - Mar/2019 2

Módulo IOT-Telemetria
1. Descrição
O IOT-Telemetria é um dispositivo end device padrão LoRaWAN™ com quatro en-
tradas configuráveis e uma interface serial TTL para configuração e comunicação com. As
quatro entradas do dispositivo são configuradas individualmente, podendo ser:

►► Digital (aberto e fechado);

►► Analógica 4-20mA;
►► Analógica 0-10V.

O dispositivo informa para a aplicação de forma periódica o estado das entradas,

além de comunicar a alteração de estado da entrada digital. O tempo de teste periódico das
entradas é configurável, sendo o mínimo 40000ms.
Cada aparelho é identificado por um identificador único com 4 bytes chamado ID.
Quando um comando é direcionado para um rádio LoRaWAN com um ID diferente do dis-
positivo, o comando é encaminhado para a serial. Os comandos podem ser enviados tanto
localmente através da interface serial, quando via RF através do Network Server LoRaWAN.

2. Especificação
Interface de comunicação Serial UART (TTL) - 9600 bps / 8 data
bits / 1 stop bit / sem bit de paridade
Entradas 4 configuráveis nos padrões 4 a 20mA, 0
a 10V e digital
Alimentação 5 a 24 Vdc

3. Pinagem
A interface física do dispositivo é um conector MiniFIT header macho de 12 vias, sen-
do que cada pino tem as funções mostradas na tabela 1. A disposição dos pinos é mostrada
na figura 1.

PINO FUNÇÃO
1 GND
2 Serial TX (ligar no pino rx da outra placa de comunicação)
3 GND
4 GND
5 GND
6 GND
7 Entrada 4
8 Entrada 3

Revisão 1.1 - Mar/2019 3

Módulo IOT-Telemetria
PINO FUNÇÃO
9 Entrada 2
10 Alimentação
11 Serial RX (ligar no pino tx da outra placa de comunicação)
12 Entrada 1
Tabela 1. Pinout.

Figura 1. Conector MiniFIT 12 vias - Lado Módulo

4. Configuração
A configuração via interface USART pode ser feita usando o software Radioenge ou
por qualquer outro dispositivo ou aplicação.
Todo comando de configuração que for enviado para a USART deve obrigatoriamen-
te incluir o ID do módulo de telemetria, caso contrário os dados recebidos serão transmitidos
para o gateway LoRaWAN.
A configuração também pode ser feita através do NetWork Server, mas o formato do
pacote enviado por RF é diferente do protocolo da USART.
Os valores medidos pelo módulo de telemetria são identificados conforme a tabela 2.

Valor Porta Função

0 Entrada 1
1 Entrada 2
2 Entrada 3
3 Entrada 4
Tabela 2. Valor da porta x Entrada.

Revisão 1.1 - Mar/2019 4

Módulo IOT-Telemetria
Serão mostrados todos os comandos que o módulo de telemetria pode aceitar. Os
campos Porta e Tipo Porta possuem a especificação mostrada na tabela 3.

Valor Tipo Porta Função Unidade da Medida

0 0 a 10V mV
1 4 a 20mA mA
Sem unidade; 1 indica curto
2 Digital
com o GND e 0, estado aberto
Tabela 3. Especificação das portas de entrada.

Protocolo de Comunicação

A comunicação com o módulo de telemetria pode ser feita localmente via interface
USART ou via RF através da rede LoRaWAN.
O formato do pacote a ser enviado para o módulo via interface USART inclui um
cabeçalho e CRC (verificador de integridade). Para envio de comandos via RF (rede Lo-
RaWAN), deve-se usar os mesmos comandos, mas remover o cabeçalho e CRC.

Byte Valor / Exemplo Função Observação

0 Cabeçalho 0xAA 0xAA Somente via USART
Quantidade de
bytes da mensagem
1 Cabeçalho Tamanho Somente via USART
(inclui o cabeçalho
e o CRC)
2 ID (MSB) ID MSB do módulo
3 ID ID do módulo
4 ID ID do módulo
5 ID (LSB) ID LSB do módulo
6 CMD Comando
O payload pode
conter mais do que
7 Payload
um byte, dependen-
do do comando
CRC 16 Byte menos
8 CRC LSB Somente via USART
significativo
CRC 16 Byte mais
9 CRC MSB Somente via USART
significativo

Revisão 1.1 - Mar/2019 5

Módulo IOT-Telemetria
a) Leitura do ID (Identificador Único) do módulo de telemetria
Importante: este comando é aceito unicamente pela interface local
USART do módulo.

Byte Valor / Exemplo Função Observações

0 0x01 Fixo
0x05 Tamanho do quadro de dados Apenas aceito
2 0xA7 Comando de leitura de ID via interface
3 0x12 CRC LSB local USART
4 0x92 CRC MSB

b) Solicitação do envio de medida (0x6A)

Byte Função Observações

0 ID (MSB)
1 ID
Onde:
2 ID
• 0x6A pedido de medida;
3 ID (LSB)
• Porta: 0, 1, 2 ou 3
4 CMD (0x6A)
5 Porta

c) Resposta do módulo com a medida (CMD 0x13)

Uplink (módulo → gateway)

Byte Função Observações

0 ID (MSB)
1 ID
2 ID
3 ID (LSB) Onde:
4 CMD (0x13) • CMD é o comando;
5 Porta • Med é a medida lida na entrada;
6 Tipo Porta • TimeStamp é o tempo em
7 Med (MSB) segundos que a medida foi
8 Med (LSB) efetuada desde que a placa foi
9 TimeStamp (MSB) energizada.
10 TimeStamp
11 TimeStamp
12 TimeStamp (LSB)

Revisão 1.1 - Mar/2019 6

Módulo IOT-Telemetria
d) Alterar intervalo de transmissão periódica (CMD 0x61)
i. Downlink

Byte Função Observações

0 ID (MSB) Onde:
1 ID • CMD é o comando pacote;
2 ID • Tempo é o período a ser configurado
3 ID (LSB) em milissegundos;
4 CMD (0x61) • Porta 0, 1, 2 ou 3.
5 Porta • Tempo:
6 Tempo (MSB) Exemplo 40000 ms
7 Tempo Byte 6 = (40000>>24) & 0xFF000000;
8 Tempo Byte 7 = (40000>>16) & 0x00FF0000;
Byte 8 = (40000>>08) & 0x0000FF00;
9 Tempo (LSB)
Byte 9 = (40000>>00) & 0x000000FF.

ii. Uplink (Resposta do módulo)

Byte Função Observações

0 ID (MSB)
1 ID
Esta é uma resposta do
2 ID
módulo confirmando a
3 ID (LSB)
configuração.
4 CMD (0x61)
5 Porta

e) Configurar porta no padrão 0-10V (CMD 0x62)

i. Downlink

Byte Função Observação

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x62)
5 Porta

Revisão 1.1 - Mar/2019 7

Módulo IOT-Telemetria
ii. Uplink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x62)
5 Porta

f) Configurar porta no padrão 4-20mA (CMD 0x63)

i. Downlink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x63)
5 Porta

ii. Uplink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x63)
5 Porta

g) Lê a configuração da porta (CMD 0x64)

i. Downlink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x64)
5 Porta

Revisão 1.1 - Mar/2019 8

Módulo IOT-Telemetria

ii. Uplink - resposta do módulo

Byte Função Observações

0 ID (MSB)
1 ID
2 ID
3 ID (LSB) Onde:
4 CMD (0x63) • CMD é o comando pacote;
5 Porta • Hab indica se a porta está
6 Tipo Porta habilitada (1) ou não (0);
7 Hab • Tempo é o período a confi-
8 Tempo (MSB) gurado em milissegundos.
9 Tempo
10 Tempo
11 Tempo (LSB)

h) Habilitar/Desabilitar Porta (CMD 0x65 e 0x66)

i. Downlink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID CMD 0x65 para habilitar
3 ID (LSB) porta e 0x66 para desabilitar.
4 CMD
5 Porta

ii. Uplink - resposta do módulo

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD
5 Porta

Revisão 1.1 - Mar/2019 9

Módulo IOT-Telemetria
i) Configurar leitura digital 9CMD 0x67)
i. Downlink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x67)
5 Porta

ii. Uplink - resposta do módulo

Byte Função Observações

0 ID (MSB)
1 ID
2 ID Onde CMD é o comando
3 ID (LSB) pacote.
4 CMD (0x67)
5 Porta

j) Solicitar leitura (CMD 0x6A)

i. Downlink

Byte Função Observações

0 ID (MSB)
1 ID
2 ID CMD 0x65 para habilitar
3 ID (LSB) porta e 0x66 para desabilitar.
4 CMD (0x6A)
5 Porta

Revisão 1.1 - Mar/2019 10

Módulo IOT-Telemetria
ii. Uplink - resposta do módulo

Byte Função Observações

0 ID (MSB)
1 ID
2 ID
3 ID (LSB) Onde:
4 CMD (0x6A) • CMD é o comando pacote;
5 Porta • Med é a medida lida na
entrada;
6 Tipo Porta
• TimeStamp é o tempo em
7 Med (MSB) segundos que a medida
8 Med (LSB) foi efetuada desde que a
9 TimeStamp (MSB) placa foi energizada.
10 TimeStamp
11 TimeStamp
12 TimeStamp (LSB)

k) Alteração de ID (CMD 0x6A)

i. Via serial

Byte Função Observações

0 0x01
1 Tam
2 CMD (0xEA) Onde:
3 ID (MSB) • CMD é o comando pacote;
• Tam é o tamanho total do
4 ID
pacote;
5 ID • CRC é o verificador de in-
6 ID (LSB) tegridade do pacote.
7 CRC (LSB)
8 CRC (MSB)

Revisão 1.1 - Mar/2019 11

Módulo IOT-Telemetria
5. Código para cálculo do CRC16
/** * @brief Calcula CRC16.
* @param data_in: Ponteiro para o buffer contendo os dados.
* @param length: Tamanho do buffer
* @retval Valor de 16 bits representando o CRC16 do buffer for-
necido. */
#define CRC_POLY (0xA001)
uint16_t CalculaCRC(uint8_t* data_in, uint32_t length)
{
uint32_t i;
uint8_t bitbang, j;
uint16_t crc_calc;
crc_calc = 0xC181;
for(i=0; i<length; i++)
{
crc_calc ^= ((uint16_t)data_in[i]) & 0x00FF; for(j=0; j<8; j++)
{
bitbang = crc_calc;
crc_calc >>= 1;
if(bitbang & 1)
{
crc_calc ^= CRC_POLY;
}
}
}
return crc_calc;
}

Revisão 1.1 - Mar/2019 12

Módulo IOT-Telemetria
6. Configuração do dispositivo
LoRaWAN
A interface de comunicação do dispositivo IOT-Telemetria é feita através da rede
LoRaWAN. Para tal, é necessário configurar ou solicitar as informações a essa topologia
de rede. Esse processo é realizado através da interface serial do dispositivo. Para mais
informações sobre comandos de rádio, verificar a seção 5 do manual do EndDevice
LoRaWAN comando ModBUS.

7. Suporte Técnico
Disponível:
Segunda a sexta - 8:30 às 12:00 / 13:00 às 17:30
Fone: +55 (41) 3052-9404
WhatsApp: +55 (41) 98775-7923
WhatsApp: +55 (41) 98790-1495
E-mail: suporte@radioenge.com.br

Revisão 1.1 - Mar/2019 13