Manual do Usuário

Fotocélula LoRa® Khomp

Índice
1. Sobre este manual …………………………………………………………………………………..……………………………….. página 3
2. Apresentação ……………………………………………………………………………………………………………..……………….. página 3
2.1. Selo de interoperabilidade Everynet …………………………………………………………………………….. página 3
2.2. Características ………………………………………………………………………………………………………...………. página 4
2.3. Sensor de luminosidade ………………………………………………………………………………………………... página 4
2.4. Medidor de energia …………………………………………………………………………………………………...…... página 4
2.5. GPS ……………………………………………………………………………………………………………………………….…... página 5
2.6. Giroscópio e Acelerômetro …………………………………………………………………………..………….…... página 5
2.7. Intensidade do sinal (RSSI) e Relação Sinal-Ruído (SNR) ………………….…………….…….. página 6
2.8. Especificações LoRa® ……………………………………………………………………………….………………….. página 6
2.9. Dados de provisionamento do dispositivo na rede LoRaWAN™ ……………….…...……... página 6
3. Comportamento geral da Fotocélula …………………………………………………………………...…….…………. página 7
3.1. Inicialização ………………………………………………………………………………………………………...…………... página 7
3.2. Pós inicialização ……………………………………………………………………………………………………………... página 7
3.3. Evento de colisão ………………………………………………………………………………………………...…………. página 7
3.4. Evento de falha de energia ……………………………………………………………………………….……………. página 8
3.5. Relógio interno …………………………………………………………………………………………………..…………... página 8
4. Modo de operação …………………………………………………………………………………………………….……………... página 8
4.1. Lora® ……………………………………………………………………………………………………………...………………... página 8
4.1.1. Entrar na rede Lora® ……………………………………………………………………….………………….. página 8
4.2. Funcionamento do Controle da Luminária ……………………………...…………………………………. página 9
4.2.1. Modo manual ……………………………………………………………………………………………………….. página 9
4.2.2. Modo automático ………………………………………………………………………………………………... página 9
4.2.3. Modo Slots de Tempo Programáveis ………………………………………………………………. página 9
5. Mensagens enviadas pelo dispositivo ……………………………………………………………………………………. página 10
5.1. Periódica ……………………………………………………………………………………………………………………………. página 10
6. Mensagens de configuração via downlink ……………………………………………………………………………. página 17
6.1. Configuração dos parâmetros LoRaWAN™ ………………………………………………………………... página 17
6.2. Configuração de padrões do dispositivo …………………………………………………………………….. página 21
7. Obter acesso aos documentos ………………………………………………………………………………………………... página 24

2
1. Sobre este manual
Este manual contém informações necessárias para a instalação e configuração da Fotocélula
LoRa® Khomp.

2. Apresentação
São 4 modelos de Fotocélula:

● ITP 100 - Endpoint Fotocélula LoRa® versão básica.

● ITP 101 - Endpoint Fotocélula LoRa® com GPS integrado.
● ITP 110 - Endpoint Fotocélula LoRa® com giroscópio/ acelerômetro integrados.
● ITP 111 - Endpoint Fotocélula LoRa® com GPS, giroscópio/ acelerômetro integrados.

Principais características:

● Telegestão da Iluminação Pública.

● Compatível com o protocolo LoRaWAN™.
● Retenção da medição de consumo.
● Antena interna integrada.
● Georreferenciamento por GPS (opcional).
● Reporte de avaria da fixação da luminária via acelerômetro/ giroscópio (opcional).
● Dimerização remota ou automática (programável).

Aplicações:

● SmartCity

2.1. Selo de interoperabilidade Everynet

Os dispositivos LoRa® da Khomp foram certificados pela Everynet, parceira tecnológica da
rede ATC LoRaWAN. O selo "E-thingz" de interoperabilidade contempla a linha Fotocélula.

Este padrão é o resultado de uma série minuciosa de testes que verifica se cada dispositivo
atende aos critérios técnicos estabelecidos pela companhia, para operar na rede ATC LoRaWAN,
seguindo o padrão LA915-928.

Durante o estudo, foram avaliados:

● Configurações.
● Funcionalidades (capacidade de integração, disponibilidade de canais, taxas de erros e tempo de
resposta).

3
2.2. Características

Funcionalidades Características

Relé de acionamento: Liga a luminária à noite.
Circuito de dimerização: 0-10V PWM.
Circuito de dimerização: 0-10V PWM.
Giroscópio/ acelerômetro (opcional).
GNSS: GPS, Glonass (opcional).
● Opera sob rede LoRaWAN® classe C
● Aceita operação Multicast
● 7 pinos (pode ser usado em bases de 3, 5 ou 7 pinos)
● 2 para dimerização
● 3 para neutro, fase e retorno de AC
● 2 para uso futuro de troca de dados
● Antena integrada ao case
● Memória interna: 512 Kbit
● Relógio UTC
● Tensão: 100-240 VAC
● Capacidade: 5A

LoRa®
Sensor de luminosidade.

● Protocolo LoRaWAN™ 1.0.3.

Backup interno com supercapacitor. ● Faixa de frequência: 860 a 930 MHz.
● Canais: 8 (configuráveis).
Monitor de consumo: ● Potência: até +20 dBm.
● Tensão RMS. ● Sensibilidade: a partir de -137 dBm.
● Corrente RMS. ● Distância de comunicação: alguns Km de acordo .com a
● Fator de potência. área de instalação.
● Frequência.
● Energia ativa (acumulado).
● Energia reativa (acumulado).
● Temperatura.
● Nível de dimerização.

2.3. Sensor de luminosidade

O Sensor de luminosidade fornece a medição da intensidade luminosa em Lux, permitindo que
a aplicação do usuário obtenha o controle desta informação para possíveis tomadas de decisão.
Suas características são:
● Intervalo de amostragem de 5 segundos.
● Intervalo de envio da informação pela Rede LoRaWAN™ de 1 hora (Configurável).
● Resolução: 1 Lux.

2.4. Medidor de energia

O ITP1xx possui um medidor de energia integrado, permitindo o controle do consumo de
energia da Luminária em conjunto do próprio dispositivo.

Suas características são:

● Intervalo de amostragem: 1 h (Configurável).
● Leitura dos seguintes parâmetros:
● Tensão RMS.
● Corrente RMS.
● Fator de Potência.
● Frequência.
● Energia Ativa Acumulada.
● Energia Reativa Acumulada.
● Temperatura.
● Precisão: Erro < 1%.
4
● Não necessita de calibração.
● Informa evento de queda de tensão.
2.5. GPS
Os modelos ITP 101 e ITP 111 possuem GPS integrado que permite informar sua
geolocalização com alta precisão.

Suas características são:

● Intervalo de amostragem: Uma vez ao dia ou quando solicitado via comando de Downlink.
● Informa Latitude/Longitude.
● Posição no formato Graus decimais (DD), Exemplo: 41.40338, 2.17403
● Precisão de 2 metros.
● Informa a Data/Hora.
● Formato Unix Epoch Time (Segundos) (GMT - 0).

● O produto deve estar instalado em ambiente outdoor para possibilitar que o

Nota sistema determine a sua posição.
● Ambientes indoor não são ideais para a função de posicionamento da linha ITP.

2.6. Giroscópio e acelerômetro

O ITP modelos 110/111 possuem Giroscópio e Acelerômetro integrado que permite detectar a
inclinação, colisão e balanço do poste o qual a Luminária está instalada.
Suas características são:
● Intervalo de amostragem para dados indicando de inclinação e balanço: 5 segundos e
enviados a cada 1h (Configurável).
● Intervalo de amostragem para dados indicando colisão: Imediato.
● Comunica evento de colisão quando aceleração mínima definida é ultrapassada.
● Informa o ângulo de inclinação do eixo com maior valor em relação a sua origem.
● Indica a % do tempo de amostragem em que a luminária permaneceu balançando
(ultrapassando um ângulo mínimo pré-definido).
● Precisão: 2 casas decimais.

Os valores de aceleração mínima e ângulo mínimo pré-definidos podem ser

Nota
configurados através de comandos de Downlink.

5
2.7. Intensidade do sinal (RSSI) e Relação Sinal-Ruído (SNR)
A cada mensagem recebida pelo(s) Gateway(s) é calculado sua intensidade do sinal (RSSI) e
sua relação sinal-ruído (SNR). Com isso, o usuário terá dois parâmetros para avaliar a qualidade do
sinal que chega ao rádio (Gateway), podendo tomar medidas para otimizar a posição dos nós na
rede.

A tabela a seguir, exemplifica a qualidade do sinal com base nos dados de RSSI e SNR:

Qualidade Escala de valores (RSSI)

Bom > -80 dBm

Médio (< -80 dBm a -110 dBm) ou (< -110 dBm e SNR > 0 dB)

Fraco < -110 dBm e SNR < 0 dB

2.8. Especificações LoRa®

Esta seção é dedicada aos usuários com alguma familiaridade ao protocolo LoRaWAN™ e
suas terminologias.

Suas características principais são:

● LoRaWAN™: Specification v1.0.3/Regional Parameters v1.0.3revA.
● Classe do dispositivo: C.
● Multicast: Sim, sendo possível configurar até 4 grupos por dispositivo.
● Método de ativação: ABP ou OTAA (Configurável).
● Região: LA915 ou AU915 (Configurável).
● Data Rate: DR3.
● Adaptive Data Rate: On (Configurável).
● Potência Máxima: 20 dBm.
● Tipo de mensagem: Não confirmada.
● Intervalo entre transmissões configurável (Padrão 1 h ).

2.9. Dados de provisionamento do dispositivo na rede LoRaWAN™

Para autenticação do dispositivo na rede, é necessário informar seu Device EUI (MAC Address)
e outras informações ao servidor de rede listadas a seguir:

Dados de rede:
● Device EUI: F8 03 32 02 + valor único para cada dispositivo (8 dígitos).
● Join EUI (App EUI): F8 03 32 02 00 00 00 00.
● Device Address: 8 últimos dígitos do Device EUI.

Chaves de segurança de rede:

● Application Key : 4b4170706c69636174696f6e204b6579
● Network Session Key: 4b4170706c69636174696f6e204b6579
● Application Session Key: 4b4170706c69636174696f6e204b6579

Para maior segurança, é altamente recomendado a troca das chaves de

segurança padrões do device. Para mais informações de como alterar as 6
Atenção chaves, acesse a seção "Configuração dos parâmetros LoRaWAN™".
3. Comportamento geral da Fotocélula
Nesta seção do Manual será descrito o comportamento geral da Fotocélula em todos os seus
modelos. As informações abordadas descrevem os seguintes pontos:

● Inicialização: Comportamento do dispositivo após ser energizado.

● Pós inicialização: Comportamento do dispositivo após o primeiro uplink.
● Evento de Colisão: Comportamento do dispositivo quando ocorrer um evento de colisão em
modelos que contém Acelerômetro/Giroscópio instalados.
● Evento de Falha de Energia: Comportamento do dispositivo quando ocorrer queda no
fornecimento de energia do mesmo.
● Funcionamento do Relógio Interno (RTC).

3.1. Inicialização
O dispositivo ITP1xx quando energizado inicializará seu processo de detecção e configuração
dos periféricos, a partir deste ponto pode-se dividir em 2 casos:
1. Inicialização com sucesso dos sensores essenciais (Power Meter e Lux Sensor).
2. Inicialização com falha dos sensores essenciais.

Caso o dispositivo identifique falha (caso 2), uma mensagem periódica será enviada a cada 30
minutos para informar o status atual e qual sensor encontra-se com defeito.

Nenhuma operação será realizada na luminária na condição de falha dos sensores essenciais,
Nota com exceção do envio de Report da Falha através da rede LoRaWAN™.

Em caso de sucesso na inicialização o dispositivo seguirá para o próximo passo, que é o envio
do primeiro uplink.

Entre o tempo do dispositivo inicializar com sucesso e enviar o primeiro uplink, seu modo de
operação é executado normalmente (Modo Automático Padrão).

O primeiro uplink do dispositivo pode levar de 1 até 2 minutos para ser enviado. Este tempo é
definido não só para que a Fotocélula tenha tempo suficiente para fixar sua posição em caso de GPS
instalado, mas também para evitar a inundação da rede LoRaWAN™ quando um alto número de
dispositivos são ligados ao mesmo tempo.

3.2. Pós inicialização

Seguidamente após o processo de inicialização (envio do primeiro uplink), o dispositivo
começará a operar em seu modo normal. Neste modo, a Fotocélula envia dados de telemetria
periodicamente de acordo com o tempo programado e executa operações de acionamento da
luminária levando em conta o nível de luminosidade e permanece nesse estado enquanto não ocorre
eventos.

O tempo padrão entre mensagens periódicos é de 1 hora e 5 minutos, para mais ou para
menos, sendo possível a alteração do período de 1 hora via comando de downlink. Assim como o
primeiro uplink, os subsequentes também seguem a regra de variar o momento de envio, neste caso
+-5 minutos para evitar inundação da rede.

3.3. Evento de colisão

Modelos de Fotocélulas que contém o sensor Acelerômetro/Giroscópio tem a capacidade
de informar através de uma mensagem LoRa que ocorreu um movimento brusco no
dispositivo/luminária/poste. Essa mensagem é enviada imediatamente após a detecção do
7
movimento, e em seguida, o dispositivo volta a operar normalmente.
3.4. Evento de falha de energia
A fotocélula também tem a capacidade de detectar queda no fornecimento de energia do
dispositivo (queda de tensão), ocasionando o envio de uma mensagem de alerta imediatamente
informando o problema.

O tempo entre a volta do fornecimento de energia elétrica e o

Nota retorno do funcionamento do dispositivo pode levar até 20
segundos.

3.5. Relógio interno

A fotocélula em todos os seus modelos, possui um relógio interno (RTC) utilizado para
informar à aplicação de eventos ocorridos, assim como uso interno para controle de dimerização a
partir de Slots de Tempo Programáveis.

O dispositivo quando ligado pela primeira vez, não possui seu RTC configurado/sincronizado,
portanto, é necessário que uma ação seja tomada a fim de configurar o mesmo de maneira correta.
Existem duas maneiras de se configurar/sincronizar o RTC:
● Via Comando de Downlink;
● Via Dados de GPS (Para modelos que possuem GPS instalado).

Quando o RTC é atualizado via comando de Downlink é preciso ter cuidados ao montar a
mensagem de sincronização (veja a seção de comandos de Downlink para saber como proceder).

Em caso de atualização por Dados de GPS, a captura das informações de sincronização é do é

feita automaticamente pelo dispositivo logo que inicializado. Também é feito uma sincronização
automática do relógio a cada 18 horas quando encontrado uma defasagem maior de 1 minuto.
Também é possível enviar um comando de Downlink para que o dispositivo busque novos dados de
GPS assim que receber o comando.

A aquisição de dados do GPS para a sincronização do RTC não é

Nota realizada durante a execução de um Slot de Tempo Programável.

4. Modo de operação
4.1. Lora®
4.1.1. Entrar na rede LoRa®

O ITP possui um processo automático de conexão a uma rede LoRa®. Por padrão o
dispositivo sai da fábrica com o modo de ativação ABP. Caso já alterado para OTAA, o dispositivo irá
realizar o seguinte comportamento:
Ao ser alimentado o dispositivo iniciará a busca por uma rede aberta, e caso encontre, o
dispositivo iniciará o processo de conexão (Join). Caso não encontre uma rede, o dispositivo
reiniciará o processo de varredura.
Uma vez na rede, ele será visto no gateway ou na aplicação do usuário através da sua
identificação única, ou seja, do seu número MAC, que será disponibilizado no produto, bem como
dos seus valores do modelo "ITP1xx".

● Compatível com a Rede Pública ATC LoRaWAN™ e Redes Privadas.

● Os contadores de Uplink e Downlink, em modo ABP/OTAA, são retornados ao valor 0 (zero)
Nota
após a reinicialização do dispositivo ou novo procedimento de Join em uma rede 8
LoRaWAN™.
4.2. Funcionamento do controle da luminária

O ITP possui três modos de operação em relação ao controle da Luminária, são eles:
1. Manual.
2. Automático (Padrão).
3. Slots de tempo programáveis.

4.2.1. Modo Manual

Quando em modo Manual, o ITP receberá comandos de Downlink para controlar a
luminária informando na mensagem qual o nível de dimerização desejado. Esses valores são
representados em porcentagem (0% até 100%), considerando como 0% a luminária desligada. Após
o recebimento do comando, o dispositivo irá manter a luminária ligada/desligada independente do
nível de intensidade luminosa detectado pelo sensor de luminosidade.

4.2.2. Modo Automático

Quando em modo Automático, o ITP operará de acordo com o nível de intensidade luminosa
detectado pelo sensor de luminosidade. De acordo com o nível, a fotocélula poderá Ligar/Desligar a
luminária. Assim como em modo Manual, em modo Automático é possível configurar qual o nível de
dimerização a luminária irá operar quando ligada.

Regras de controle quando em modo Automático:

● A fotocélula em modo Automático irá Ligar quando: Intensidade Luminosa for menor que
120 Lux (Padrão).
● A fotocélula em modo Automático irá Desligar quando: Intensidade Luminosa for maior
que 240 Lux (Padrão).

Os valores padrões de Lux utilizados para Ligar/Desligar podem

Nota ser configurados através de comandos de Downlink.

4.2.3. Modo Slots de tempo programáveis

O Modo Slots de Tempo Programáveis serve para indicar ao dispositivo para operar em
determinado período do dia a Ligar/Dimerizar ou Desligar a luminária de acordo com os parâmetros
programados. Esse modo é geralmente utilizado para redução do consumo de energia elétrica em
períodos com baixa movimentação de pessoas/veículos em determinada região/via.
A seguir será apresentada uma tabela que contém os parâmetros que descrevem suas
características:

Slot Ativação Hora início Minuto Hora Minuto fim Dias Nível

início fim semana dimerização

Ativo/La
Valores 0-2 0-23 0-59 0-23 0-59 0-9 0-100
tente

9
 O campo Slot diz respeito ao número do perfil que se deseja programar. A fotocélula possui até
3 perfis de slots disponíveis, variando do número 0 (correspondendo ao primeiro Slot) até o Slot de
número 2 (último). É possível programar os 3 slots e criar uma sequência de dimerização ao longo
do dia, por exemplo.
O campo Dias da Semana pode ser preenchido com valores de 0 há 9 e são descritos como:
0, 1, 2, 3, 4, 5 e 6, sendo 0 representando Domingo (primeiro dia da semana) e 6 Sábado (último
dia da semana), dando a possibilidade de escolher somente 1 dia específico da semana para
executar.
7, Executará em dia de Semana (Segunda a Sexta-feira)
8, Executará nos finais de Semana (Sábado e Domingo)
9, Todos os dias (Sem exceções)
O tempo máximo entre o Início e Fim de um único Slot não pode ultrapassar 18 horas.
Durante os períodos que não contemplam os intervalos programados, o dispositivo irá operar
como em modo Automático, inclusive seu nível de dimerização pré-programado (padrão 100%).

Para que este modo de operação de seja de fato executado como programado, é necessário que
Nota o Relógio (RTC) esteja configurado e sincronizado, caso contrário o dispositivo irá operar como
em modo Automático.

5. Mensagens enviadas pelo dispositivo

Esta seção visa apresentar o protocolo adotado para formatar as mensagens enviadas. Isso
se torna importante principalmente ao utilizar um servidor de rede externo e/ou um gateway de
terceiros. Ao utilizar o servidor de rede interno do gateway Khomp, as mensagens já são
decodificadas e apresentadas no dashboard.

As mensagens enviadas pelos dispositivos ITP1xx são formadas por até 5 mensagens
distintas:

5.1. Periódica
Mensagem enviada de acordo com o tempo programado e contempla os dados dos sensores
do seu modelo e outros indicadores de operação do dispositivo.

Sua estrutura pode ser descrita a seguir como:

Estrutura de uma mensagem periódica

HEADR Indicador do tipo de Versão de Máscara de Dados Dados

Mensagem Firmware

Tamanho em Bytes 1 1 2 4 Até 45

Versão de Firmware

Bits 12-15 8-11 4-7 0-3

- Bug Feature Compatibility Hardware

● Bits [12-15]: indica o número referente a quantidade de bugs corrigidos.

● Bits [8-11]: refere-se ao número de features implementadas.
● Bits [4-7]: informa a alteração de compatibilidade. 10
● Bits [0-3]: usado para representar a mudança de hardware.
 Máscara de Dados

Bits 7 6 5 4 3 2 1 0

Swing
- Angle Lux Temperature Frequency Power Factor Current Voltage
Duty

● Os bits a seguir representam se há as seguintes informações que podem vir contidas na

mensagem caso o bit representado seja 1:
● Bit 7: Balanço da Luminária.
● Bit 6: Ângulo de Inclinação.
● Bit 5: Lux do Ambiente.
● Bit 4: Temperatura do Circuito.
● Bit 3: Frequência da Rede Elétrica.
● Bit 2: Fator de Potência.
● Bit 1: Corrente da Carga.
● Bit 0: Tensão da Rede Elétrica.

Máscara de Dados

Bits 15 14 13 12 11 10 9 8

Light Last Dimmer Reactive Active Standard

- RSSI Position
On Commutation Duty Energy Energy Deviation

● Os bits a seguir representam se há as seguintes informações que podem vir contidas na

mensagem caso o bit representado seja 1:
● Bit 15: RSSI.
● Bit 14: Luminária Ligada.
● Bit 13: Tempo desde a Última Comutação da Luminária.
● Bit 12: Nível de Dimerização da Luminária.
● Bit 11: Posição do GPS.
● Bit 10: Energia Reativa Acumulada.
● Bit 9: Energia Ativa Acumulada.
● Bit 8: Desvio Padrão do Ângulo.

Máscara de Dados

Bits 24-31 20-23 19 18 16-17

– RFU Slot Running Timestamp RTC Operation Mode

● Os bits a seguir representam se há as seguintes informações que podem vir contidas na

mensagem caso o bit representado seja 1 (com exceção de: Operation Mode, RTC e Slot
Running):
● Bits 24-31: Reservado para uso futuro.
● Bits 20-23: Slot Sendo Executado.
● Bit 19: Timestamp.
● Bit 18: RTC Configurado.
● Bits 16-17: Modo de Operação da Fotocélula.
● Os dados dos sensores e seus indicadores são concatenados de acordo com a sequência de
bits de sua respectiva máscara.

A seguir, é observada sua representação e tamanho:

11
 Dados de Sensores e Indicadores de Operação

Swing Power
Angle Lux Temperature Frequency Current Voltage
Duty Factor

Tamanho
2 2 2 2 2 2 3 2
em Bytes

Dados de Sensores e Indicadores de Operação

Last Dimmer Reactive Active Standard

Timestamp Longitude Latitude
Commutation Duty Energy Energy Deviation

Tamanho
4 2 1 4 4 7 7 2
em Bytes

Exemplo de mensagem enviada:

Mensagem: 4C 01 02 21 FF FD B7 FF 08 A2 00 14 00 03 83 EA 55 72 FD 00 7A 00 00 00 00 00 0C
00 00 00 00 02 2B 8A 00 00 00 00 00 D5 41 64 00 2E 5D A0 B9 D8

12
 Decodificação

Hexadecimal (MSB) Decimal Conversão Medida

HEADER 4C 76 - -

Tipo de Mensagem 01 1 - -

Versão de Firmware {02,21} - Verificar Tabela Versão 1.2.2.0

Máscara de Dados {FF, FD, B7, FF} - Verificar Tabela -

Tensão {08, A2} 2210 Dividir por 10 221.0 Volts

Corrente {00, 14, 00} 5120 Dividir por 10000 0,5120 Ampére

Fator de Potência {03 , 83} 899 Dividir por 1000 0,899

Frequência {EA , 55} 59989 Dividir por 1000 59,989 Hertz

Temperatura {72 , FD} 29437 Dividir por 100 294,37 Kelvin

Lux {00 , 7A} 122 - 122 Lux

Ângulo {00 , 00} 0 Dividir por 10 0°

Balanço {00 , 00} 0 Dividir por 10 0%

Desvio Padrão {00 , 0C} 12 Dividir por 100 0,12

{00, 00, 00, 02, 2B, Multiplicar por 256 e

Energia Ativa 142218 36,408 kWh
8A} Dividir por 1000000

{00, 00, 00, 00, D5, Multiplicar por 256 e

Energia Reativa 54593 13,976 kWh
41} Dividir por 1000000

Nível de Dimerização 64 100 - 100%

Ultima Comutação {00, 2E} 46 - 46 segundos

1570814424
Timestamp {5D, A0, B9, D8} 1570814424 -
Segundos

Quando dados de Posição (Latitude e Longitude) são enviados, dados de Timestamp

Nota
não são incluídas na mesma mensagem.

13
Exemplo de Dados de GPS:
Admitindo que o bit de dados de GPS (Position) contido na máscara de dados indique a
existência das informações de Latitude e Longitude na mensagem (payload), a decodificação dessas
informações devem seguir o padrão descrito abaixo:

Exemplo de mensagem contendo dados de GPS:

Mensagem: 4C 01 02 21 FF F1 9F FF 01 F4 00 00 AA 02 53 E9 FF 73 FE 00 93 00 00 00 00 00 0B
00 00 00 00 00 00 F6 00 00 00 00 00 00 00 81 A5 1F C7 82 E4 41 7C 64

Verificando que os bytes 81A51FC7 em MSB contemplam informações de Latitude e

82E4417C informações de Longitude, o Bit Mais Significativo (MSb) indica os pontos cardeais das
coordenadas, e deve ser utilizado unicamente para este propósito. O exemplo a seguir (em pseudo
código) exemplifica como realizar o cálculo corretamente:

/* Latitude Decode */

Latitude = 81 << 24 | A5 << 16 | 1F << 8 | C7

if(81 >> 7 == 1)
{
Latitude = - (Latitude - 80000000)
}

Latitude = Latitude/1000000.0

Latitude Decodificado: -27.598791 Degree

/* Longitude Decode */

Longitude = 82 << 24 | E4 << 16 | 41 << 8 | 7C

if(82 >> 7 == 1)
{
Longitude = - (Longitude - 80000000)
}

Longitude = Longitude/1000000.0

Longitude Decodificado: -48.513405 Degree

Na Latitude o MSb representa o Norte Geográfico caso seu valor seja 0, caso
Nota contrário indica ao Sul. Assim como na Latitude, na Longitude o MSb determina que
o ponto em questão se situa à Leste tendo valor 0 e à Oeste sendo 1.

14
Alarme de Colisão (TILT Alarm):
Enviada assim que uma colisão é detectada. É formada de acordo com a estrutura a seguir:

HEADR Indicador do tipo de Mensagem

Tamanho em Bytes 1 1

Exemplo de mensagem enviada:

Mensagem: 4B 02
Decodificação:
O HEADR 4B indica uma mensagem vinda da fotocélula, 02 representa uma mensagem de
alerta do tipo TILT Alarm.

Mensagens de Alarme são enviadas somente nos modelos que contém sensores de
Nota Acelerômetro e Giroscópio.

Alarme de Queda de Energia (Power Alarm):

Mensagem enviada quando o dispositivo identifica uma queda no fornecimento de energia
da Fotocélula/Luminária. Esta mensagem é enviada no ato do evento e sua estrutura de mensagem
pode ser descrita a seguir como:

HEADR Indicador do Tipo de Mensagem (Power Alarm)

Tamanho em Bytes 1 1

Exemplo de mensagem enviada:

Mensagem: 4B 03
Decodificação:
O HEADR 4B indica uma mensagem vinda da fotocélula, 03 representa uma mensagem de
alerta do tipo Power Alarm.

15
Mensagem de Report de Falha Crítica:
Mensagem enviada quando o dispositivo identifica falha em algum dos sistemas críticos
como: Power Meter, Lux Sensor, GPS e Accelerometer Sensor. A estrutura da mensagem pode ser
descrita a seguir como:

HEADR Indicador do tipo de Mensagem Máscara de Report

Tamanho em Bytes 1 1 1

Máscara de report

Bits 4-7 3 2 1 0

- RFU Accelerometer Sensor GPS Sensor Lux Sensor Power Meter Sensor

Exemplo de mensagem enviada:

Mensagem: 4B 04 01
Decodificação:
O HEADR 4B indica uma mensagem vinda da fotocélula, 04 representa uma mensagem de
Report e 01 indica uma falha no sensor Power Meter.

Evento de Ativação/Desativação da Luminária:

Mensagem enviada quando a Fotocélula executa uma ação de Ativação ou Desativação da
Luminária. Essa mensagem contém duas informações que indica qual a ação foi executada e
quando. A estrutura da mensagem pode ser descrita a seguir como:

HEADR Indicador do Tipo de Indicador da Ação Momento em que

Mensagem (Event) (Ativar/Desativar) ocorreu

Tamanho em
1 1 1 4
Bytes

Exemplo de mensagem enviada:

Mensagem: 4B 05 01 5D A4 CC 99
Decodificação:
O HEADR 4B indica uma mensagem vinda da fotocélula, 05 representa uma mensagem de
Evento, 01 a ação (Ligar), (MSB) 5D A4 CC 99 o momento da ação (Unix epoch time).

Para mais informações e exemplos de decodificação de mensagens de

Nota
dispositivos LoRa Khomp, acesse: Khomp LoRaWAN Decoder

16
6. Mensagens de configuração via downlink
Os dispositivos ITP 100/101/110/111 aceitam, além das próprias configurações do protocolo
LoRaWAN™, configurações através de comandos proprietários via downlink. Nesta seção,
apresenta-se exemplos de tais comandos de configuração, especificando sua estrutura e as portas
que devem ser utilizadas.

6.1. Configuração dos parâmetros LoRaWAN™

Através dos comandos descritos abaixo, é possível alterar os parâmetros referentes ao
protocolo LoRaWAN™, que são:
● Tempo de Report.
● Chaves de Autenticação.
● Adaptive Datarate.
● Máscara de Canais.
● Método de Autenticação.
● Região.
● Grupos Multicast.

Configuração de tempo de report:

Através da porta 2, é possível alterar a periodicidade de envio de mensagens. Por exemplo,
para alterar este parâmetro para 2 horas (o padrão é 1 hora), pode-se utilizar o seguinte comando:

Porta: 2
Padrão: 01 + novo valor em hexadecimal (2 Bytes)
Exemplo: 010078

Este parâmetro de tempo deve ser enviado considerando a unidade em minutos. Note que
0078= 120 minutos = 2 hora.

O tempo mínimo programável, é de 10 minutos, que pode variar entre 5 e 15

Nota
minutos.

Alterando endereço de rede e chaves de segurança:

É importante notar que, ao alterar umas das chaves, é necessário recadastrar o dispositivo no
servidor de rede para continuar a enviar comandos e receber mensagens de uplink.

Quando em modo ABP:

Para alterar o Device Address pode-se enviar o seguinte comando:

Porta: 2
Padrão: 03 + novo valor (4 Bytes)
Exemplo: 031933C07F

Para alterar a Network Session Key e Application Session Key pode-se enviar o seguinte
comando:

Porta: 2
Padrão: 04 + novo valor NwkSKey (16 Bytes) + novo valor AppSKey (16 Bytes)
Exemplo: 04112233445566778899AABBCCDDFF1122112233445566778899AABBCCDDFF1122
17
Quando em modo OTAA:
Para alterar a Application EUI e Application Key pode-se enviar o seguinte comando:

Porta: 2
Padrão: 02 + novo valor AppEUI (8 Bytes) + novo valor AppKey (16 Bytes)
Exemplo: 0299AABBCCDDFF1122112233445566778899AABBCCDDFF1122

Também é possível atualizar um parâmetro de cada vez, informando apenas o padrão 02 +

novo valor do parâmetro desejado. O dispositivo será reiniciado em cada alteração.

Alterando o Adaptive Datarate:

Por padrão, o dispositivo vem de fábrica com seu Adaptive Datarate habilitado. Para que seja
desabilitado deve-se seguir o seguinte comando de Downlink:

Porta: 2
Comando: 0500

Para voltar ao valor padrão:

Porta: 2
Comando: 0501

Para que o Adaptive Datarate funcione corretamente, tanto o dispositivo quando o

Network Server devem estar como o mesmo Habilitado. Para mais informações
Nota
sobre o protocolo LoRaWAN™ acesse LoRaWAN® Specification v1.0.3, disponível
em nossa área de documentação

Alterando Máscara de Canais de Transmissão:

A Máscara de Canais de Transmissão pode ser alterada a partir de um comando de downlink
representando os novos canais. Esse comando consiste em um Byte onde cada bit representa qual
sub-banda é desejado ativar. O padrão de fábrica é Sub-Band 1. A tabela a seguir descreve em
detalhes:

Máscara de canais

Bits 7 6 5 4 3 2 1 0

Sub-Band Sub-Band Sub-Band Sub-Band Sub-Band Sub-Band Sub-Band Sub-Band

-
8 7 6 5 4 3 2 1

Porta: 2
Padrão: 06 + novo valor (1 Byte)
Exemplo: 0601

É possível selecionar mais de uma Sub-Banda ao mesmo tempo. Para mais

Nota informações, acesse: LoRaWAN® Regional Parameters v1.0.2rB, disponível em
nossa área de documentação

18
Alterando o modo de autenticação:
Por padrão, o dispositivo realiza autenticação usando o modo ABP. Para alterar esse parâmetro
para OTAA, pode-se enviar o seguinte comando:

Porta: 2
Comando: 0701

Para voltar ao padrão:

Porta: 2
Comando: 0700

Após o dispositivo receber o comando por downlink, o mesmo irá reiniciar já no novo
modo configurado. Para mais informações sobre modos de autenticação e o
Nota
protocolo LoRaWAN™, acesse LoRaWAN® Specification v1.0.3, disponível em nossa
área de documentação.

Alterando a Região:
Como comentado anteriormente, por padrão, a região configurada no dispositivo é a LA915.
Para alterá-la para AU915, pode-se enviar o seguinte comando de downlink:

Porta: 2
Comando: 0801

Para alterar a região para LA915, pode-se enviar o seguinte comando de downlink:

Porta: 2
Comando: 080A

● Após o dispositivo receber o comando por downlink, o mesmo irá reiniciar já no

novo modo configurado. Para mais informações sobre modos de autenticação e
o protocolo LoRaWAN™, acesse LoRaWAN® Specification v1.0.3, disponível em
nossa área de documentação.
● A diferença entre AU915 e LA915 encontra-se no tempo entre o Uplink e a
Nota Primeira e Segunda janela de recepção (RX1 e RX2) como exemplificado na
figura abaixo.
● Quando em AU915, o tempo é de 1 e 2 segundos e em LA915 é de 5 e 6
segundos. Essa diferença se reflete ao realizar downlinks em Classe A. LA915 é
o padrão utilizado pela ATC em modo ABP na região da America Latina, para
utilização em modo OTAA não é necessário a troca da região.

19
Configurando Grupos de Multicast:
Através desse comando, é possível configurar grupos de multicast (até 4 grupos por
dispositivo).
Um grupo multicast é constituído por 4 parâmetros:
● Group ID (0 - 1 - 2 - 3)
● Address
● Multicast Application Session Key
● Multicast Network Session Key

E pode ser configurado de duas maneiras:

● A - Utilizando as chaves de sessão pré programadas no dispositivo e informar apenas o
Group ID e o respectivo Address.
● B - Utilizando de uma chave de criptografia AES-128 (McKey) como seed para a geração
das chaves de Aplicação e Rede. Para mais informações em como obter a chave McKey,
consulte o LoRaWAN™ Remote Multicast Setup Specification v1.0.0 - Pag. 9, disponível em
nossa área de documentação, ou entre em contato através do suporte.

A segunda opção informada é a maneira mais segura e recomendada.

Exemplo de como configurar um grupo Multicast através de um comando de Downlink

utilizando a maneira A (chaves pré-configuradas):

● Group ID: 0
● Address: 01FFFFFF

Porta: 2
Padrão: 0D + GroupID (1 Byte) + Address (4 bytes)
Comando: 0D0001FFFFFF

Exemplo de como configurar um grupo Multicast através de um comando de Downlink

utilizando a maneira B (chaves a serem geradas):

● Group ID: 0
● Address: 01FFFFFF

McKey (já encriptada pela McEKey): ace0aac86ac5fd5a8750d276d9b3492d

Porta: 2
Padrão: 0D + GroupID (1 Byte) + Address (4 bytes) + McEKey Encrypted (16 Bytes)
Comando: 0D0001FFFFFFace0aac86ac5fd5a8750d276d9b3492d

McKey_encrypted é a chave de grupo multicast criptografada pela McKEKey, da qual

McAppSKey e McNwkSKey será derivada. Para se obter a McKey_encrypted utilize a seguinte
operação:
McKey_encrypted = aes128_dencrypt (McKEKey, McKey)

A McKEKey é uma chave específica do dispositivo e vitalícia, usada para criptografar a chave
Multicast transportada pelo ar (é uma chave de criptografia de chave). Para ter acesso a McKEKey,
por questões de segurança, entre em contato com o suporte.

20
6.2. Configuração de padrões do dispositivo
Nesta seção contém comandos de downlink relacionados ao comportamento do dispositivo.

Configuração do Relógio Interno:

Através da porta 3, é possível atualizar o RTC do dispositivo informando o Timestamp no
formato Unix Epoch Time em segundos. Por exemplo, para atualizar o RTC para a hora atual em
GMT, pode-se utilizar o seguinte comando:

Porta: 3
Padrão: 02 + novo valor em hexadecimal (4 Bytes)
Exemplo: 025DA5FEF1

O valor 5DA5FEF1 representado em segundos: 1571159793 e sua data/hora: GMT: Tuesday,

15 October 2019 17:16:33

Caso o dispositivo possuir GPS integrado, seu RTC é sincronizado automaticamente ao iniciar
e também uma vez ao dia caso detectar uma defasagem de tempo maior que 60 segundos.

Utilizar Classe C ao realizar o downlink, caso contrário, o dispositivo poderá ter

Atenção seu RTC dessincronizado.

Por motivos de sincronização e diferenciação nos fusos, SEMPRE considere e

Nota
programe o dispositivo como padrão UTC.

Configurações de Controle de Relé e Dimerização:

A fotocélula possui 3 modos de operação que podem ser alterados e configurados a partir dos
seguintes comandos:

Alteração dos modos de Operação:

Modo de operação:

● Manual: 01
● Automático: 02
● Slot: 03

Porta: 3
Padrão: 0300 + valor em hexadecimal do modo de operação (1 Byte)
Exemplo: 030001

No exemplo anterior, foi solicitado que a Fotocélula opere em modo Manual, admitindo um
valor de dimerização pré-configurado (padrão 100%).

21
Configuração do modo Manual:
No modo manual deve-se informar o valor do nível de dimerização desejado através da porta
3.
Porta: 3
Padrão: 0301 + valor em hexadecimal (1 Byte)
Exemplo: 030150

No exemplo acima foi solicitado que a Fotocélula opere em modo manual e seu nível de
dimerização seja de 80%.

Configuração do modo Automático:

No modo automático deve-se informar o valor do nível de dimerização desejado.

Porta: 3
Padrão: 0302 + valor em hexadecimal (1 Byte)
Exemplo: 03023C

No exemplo acima foi solicitado que a Fotocélula opere em modo Automático e seu nível de
dimerização seja de 60%.

O dispositivo quando operando em modo Automático, somente irá Ligar/Desligar a

Nota luminária de acordo com os limitantes superiores e inferiores de Lux padrões ou
configurados previamente.

Configuração do modo Slots Programáveis:

No modo Slots Programáveis, deve-se informar qual dos 3 Slots disponíveis deseja-se
configurar, se em modo ativo ou latente, Hora/Minuto de inicio/fim do slot, quais dias da semana
será executado e qual o nível de dimerização desejado.

Segue abaixo um exemplo:

Cada parâmetro (slot, ativo, Hora Início...) é definido por 1 Byte apenas.

Porta: 3
Padrão: 0303 + slot + ativo + Hora Inicio + Min Inicio + Hora Fim + Min Fim + Dias + Dimmer
Exemplo: 03030201060009000950

No exemplo acima o Slot 2 foi programado para estar ativo e executar das 03:00 até 06:00
(GMT-3) todos os dias da semana em 80% de Nível de Dimerização.

● Lembre-se de que os comandos da Fotocélula são em base Hexadecimal.

● Para programar corretamente, é necessária a conversão dos valores das
Nota
unidades para a base Hexadecimal ( "Hora/Minuto", "Dimmer", e as demais
unidades).

Para maiores detalhes sobre o padrão do comando, veja: Modo Slots de Tempo
Programáveis, disponível em nossa área de documentação

Nota Programar considerando o relógio interno do dispositivo operando em UTC (GMT-0). 22

Configurações de Limitantes Superiores e Inferiores de Lux:

Como mencionado anteriormente, a Fotocélula possui comandos de ajustes para seus

limitantes de operação quando em modo Automático.
A seguir, são observados 2 exemplos para alteração dos limitantes:

Porta: 3
Padrão: 0400 + Valor limitante em Hexadecimal
Exemplo: 04000032

O exemplo acima representa a alteração do limitante inferior em valores de Lux para: 50 Lux
● Valor mínimo aceito: 0
● Valor máximo aceito: Limitante Superior - 1

Porta: 3
Padrão: 0401 + Valor limitante em Hexadecimal
Exemplo: 040100C8

O exemplo acima representa a alteração do limitante superior em valores de Lux para: 200 Lux.
● Valor mínimo aceito: Limitante Inferior + 1
● Valor máximo aceito: 63000

Caso o valor do limite superior for menor que o inferior ou caso o valor do limite
Nota
inferior for maior que o limite superior, o comando será ignorado pelo dispositivo.

Solicitação de Dados de GPS:

Comando responsável por solicitar ao GPS novos dados de Latitude, Longitude e Hora. Segue
abaixo um exemplo do comando:

Porta: 3
Comando: 0501

Os novos dados serão enviados no próximo uplink periódico.

Nota

Solicitação de Dados dos Sensores Imediato:

Comando responsável por solicitar dados dos sensores imediatamente ao receber o comando
por downlink. Segue abaixo um exemplo do comando:

Porta: 3
Comando: 0707

Após o envio dos dados solicitado pelo comando, o tempo de envio do próximo
uplink periódico será reiniciado, ou seja, caso a Fotocélula esteja programada para
Nota enviar dados a cada 1 hora +- 5 minutos e, após o recebimento desse comando, a
mesma enviará o dado imediato e iniciará a contagem do tempo para enviar o
próximo uplink após 1 hora +-5 minutos. 23
7. Obter acesso aos documentos

Você encontra outros documentos desta linha de produtos em nosso site, www.khomp.com.
Veja a seguir como se cadastrar e acessar nossa documentação.

Para usuários que não possuem cadastro:

1. No site da Khomp, acesse o menu "Suporte Técnico" → "Área restrita".
2. Clique em "Inscreva-se".
3. Escolha o perfil que melhor o descreve.
4. Cadastre seu endereço de e-mail. É necessário utilizar um e-mail corporativo.
5. Preencha o formulário que será enviado ao seu e-mail. Caso não tenha recebido em sua caixa de
entrada, confira sua caixa de spam.
6. Siga os passos descritos a seguir para fazer login na área restrita.

Para usuários que possuem cadastro:

1. Acesse o menu "Suporte Técnico" → "Área restrita".
2. Faça login com seu endereço de e-mail e senha cadastrada.
3. Acesse a opção Documentos. Você será direcionado à Wiki da Khomp.

Você também pode entrar em contato com nosso suporte técnico através do e-mail
suporte@khomp.com ou pelo telefone +55 (48) 3722-2930.

Este equipamento não tem direito a proteção contra interferência prejudicial, e não pode
causar interferências em sistemas devidamente autorizados.
Este produto contém a placa NIT 21 LI , código de Homologação Anatel 06425-19-03237.
Este produto não é apropriado para uso em ambientes domésticos, pois poderá causar
interferências eletromagnéticas, que obrigam os usuários a tomar medidas necessárias para
minimizar estas interferências.

Rua Joe Collaço, 253 - Florianópolis, SC

+55 (48) 3722.2930 24
suporte@khomp.com