LR1_CFG

Envia uma sequência de comandos AT para configurar um módulo LoRa Breakbord RAK811 através de um canal de comunicação serial. É um bloco de função (mantém estado entre scans; requer instância).

Biblioteca: HI_STD · Namespace: HILS · Tipo: bloco de função

Bloco de função

                  LR1_CFG
           +--------------------+
  BOOL ----|EN               ENO|---- BOOL
           |                    |
  BOOL ----|START       DONE_EVT|---- BOOL
           |                    |
 USINT ----|COMM_SRC       READY|---- BOOL
           |                    |
 USINT ----|LORA_MODE     RESULT|---- INT
           |                    |
STRING ----|DEV_EUI ----------- |----
           |                    |
STRING ----|APP_EUI ----------- |----
           |                    |
STRING ----|APP_KEY ----------- |----
           |                    |
       ----|R_BUF ------------- |----
           +--------------------+

Após habilitado por EN, o bloco aguarda uma transição de subida em START; quando ela ocorre, inicia a configuração do módulo. START deve permanecer em nível alto durante toda a execução do bloco. Ao finalizar, START é desabilitado e o resultado do processo de configuração fica disponível em READY. Os pulsos de DONE_EVT sinalizam em RESULT os eventuais erros ou o sucesso do processo.

Nota

Para conectar o módulo à rede LoRaWAN após a configuração, utilize o bloco LR1_CONN.

Parâmetros

Nome	Direção	Tipo	Dimensão	Padrão	Faixa / Unidade	Descrição
EN	IN	BOOL	—	TRUE	—	Habilita a execução do bloco.
START	IN	BOOL	—	FALSE	—	Habilita o início da configuração (avaliado por transição de subida).
COMM_SRC	IN	USINT	—	0	ver Canais de comunicação	Canal de comunicação a ser utilizado.
LORA_MODE	IN	USINT	—	0	1 = OTAA · 2 = ABP	Modo de operação do LoRa.
DEV_EUI	IN_OUT	STRING	:16	—	—	Device EUI gerado pela aplicação no LoRa Network Server.
APP_EUI	IN_OUT	STRING	:32	—	—	Application EUI gerado pela aplicação no LoRa Network Server.
APP_KEY	IN_OUT	STRING	:32	—	—	App Key gerado pela aplicação no LoRa Network Server.
R_BUF	IN_OUT	ANY	—	—	—	Buffer da transação corrente (envio do comando e recepção da resposta, via bloco ASCII_SR).
ENO	OUT	BOOL	—	FALSE	—	Saída de habilitação.
DONE_EVT	OUT	BOOL	—	FALSE	—	Pulso que indica “bloco finalizado”; verifique RESULT para sucesso ou erro.
READY	OUT	BOOL	—	FALSE	—	Indica que a configuração foi concluída com sucesso.
RESULT	OUT	INT	—	0	ver Códigos de retorno	Resultado da operação.

Canais de comunicação

O valor de COMM_SRC identifica o recurso de comunicação. Cada equipamento possui um subconjunto dos recursos abaixo; consulte o manual do equipamento para saber quais estão disponíveis. Os identificadores pertencem ao namespace HILS.

Identificador	Valor	Recurso
COM1_PORT_ID .. COM8_PORT_ID	0 .. 7	Portas seriais 1 a 8.
SOCK0_PORT_ID .. SOCK7_PORT_ID	8 .. 15	Sockets 0 a 7 da interface Ethernet 1.
ETH2_SOCK0_PORT_ID .. ETH2_SOCK7_PORT_ID	16 .. 23	Sockets 0 a 7 da interface Ethernet 2.

Códigos de retorno

RESULT é do tipo INT e assume os valores específicos deste bloco:

Valor	Significado
2	Erro no comando de leitura do status.
11	DEV_EUI inválida.
12	APP_EUI inválido.
13	APP_KEY inválido.
30	Erro de hardware (módulo não responde).

Pré-condições

• START deve permanecer em nível alto durante toda a execução do bloco.

• DEV_EUI, APP_EUI e APP_KEY devem estar preenchidos com os valores gerados no LoRa Network Server.

Observações

• Ao término, DONE_EVT pulsa e RESULT indica sucesso ou erro; READY sinaliza a configuração concluída.

Ver também

LR1_CONN, ASCII_SR