LR_CFG_RAK3172

Envia uma sequência de comandos AT que configura o módulo LoRa RAK3172 (parâmetros OTAA/ABP e credenciais DevEUI/AppEUI/AppKey) por um canal de comunicação. É 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

                  LR2_CFG
           +--------------------+
  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 ser habilitado pela entrada EN, o bloco aguarda uma transição de subida em START; quando ela ocorre, o módulo é configurado. A entrada START deve permanecer em nível alto durante a execução do bloco. Ao finalizar, o resultado do processo de configuração é indicado por READY. O pulso de DONE_EVT sinaliza, em RESULT, os eventuais erros ou o sucesso do processo.

Nota

Para se conectar à rede LoRaWAN, utilizar o bloco LR_CONN_RAK3172.

Parâmetros

Nome	Direção	Tipo	Dimensão	Padrão	Faixa / Unidade	Descrição
START	IN	BOOL	—	FALSE	—	Habilita o início da configuração (nível alto durante a execução).
COMM_SRC	IN	USINT	—	0	Canal de comunicação	Canal de comunicação a ser utilizado (ver tabela de canais abaixo).
LORA_MODE	IN	USINT	—	0	1 .. 2	Modo de operação do LoRa: OTAA [1] ou ABP [2].
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 usado na transação corrente (envio do comando e recepção da resposta pelo bloco ASCII_SR).
DONE_EVT	OUT	BOOL	—	FALSE	—	Pulso de saída indicando “bloco finalizado”; verificar RESULT para saber se terminou com sucesso ou erro.
READY	OUT	BOOL	—	FALSE	—	Flag indicativo de configuração concluída com sucesso.
RESULT	OUT	INT	—	0	Código	Resultado da operação (ver Códigos de retorno).

Canais de comunicação disponíveis em COMM_SRC (HILS):

Identificador	Valor
COM1_PORT_ID .. COM8_PORT_ID	0 .. 7
SOCK0_PORT_ID .. SOCK7_PORT_ID	8 .. 15
ETH2_SOCK0_PORT_ID .. ETH2_SOCK7_PORT_ID	16 .. 23

Códigos de retorno

Valores sinalizados em RESULT no pulso de DONE_EVT. Use os identificadores com o namespace HILS (ex.: HILS.GL_INV_PAR).

Código	Identificador	Significado
0	SUCCESS	Configuração concluída com sucesso.
5	GL_INV_PAR	Parâmetro inválido (DEV_EUI, APP_EUI ou APP_KEY inválido).
15	GL_HDW_FAIL	Falha de hardware (o módulo não responde aos comandos AT).

Lista completa: RET_CODE - Códigos de retorno do firmware G5.

Pré-condições

• O bloco deve estar habilitado pela entrada EN.

• COMM_SRC deve apontar para o canal serial conectado ao módulo RAK3172.

• DEV_EUI, APP_EUI e APP_KEY devem estar preenchidos com as credenciais válidas.

Observações

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

• Sequência de comandos AT enviados ao módulo durante a configuração:

  ATZ
  >>bCurrent Work Mode: LoRaWAN.
  AT+NWM=1
  >>bCurrent Work Mode: LoRaWAN.
  AT+NJM=1
  >>OK
  AT+DEVEUI=AC1F09FFFE0538DD
  >>OK
  AT+APPEUI=000000000000005A
  >>OK
  AT+APPKEY=A515C840ECBA9A89592298A6B3526412
  >>OK
  

Ver também

LR_CONN_RAK3172, ASCII_SR