LR_CONN_RAK3172

Envia uma sequência de comandos AT para conectar o equipamento a uma rede LoRaWAN através do módulo LoRa RAK3172; a conexão pode levar mais de 1,5 minuto devido ao tempo de resposta do comando de join. É 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

             LR_CONN_RAK3172
          +-------------------+
 BOOL ----|START      DONE_EVT|---- BOOL
          |                   |
USINT ----|COMM_SRC      READY|---- BOOL
          |                   |
          |             RESULT|---- SINT
          |                   |
      ----|R_BUF ------------ |----
          +-------------------+

Após ser habilitado, o bloco aguarda uma transição de subida em START; quando ela ocorre, inicia a tentativa de conexão à rede. A entrada START deve permanecer em nível alto durante toda a execução do bloco. Ao término, START é internamente liberado, o resultado da tentativa fica disponível em READY e um pulso em DONE_EVT sinaliza a conclusão do processo, com RESULT indicando erro ou sucesso.

A sequência de comandos AT trocada com o módulo durante a conexão é:

AT+NJS=?
>>AT+NJS=0
>>OK
AT+CFM=1
>>OK
AT+JOIN=1:0:10:20
>>OK
>>+EVT:JOINED

Nota

Para utilizar este bloco, o módulo já deve estar configurado. Utilize o bloco LR_CFG_RAK3172 para essa configuração.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
START	IN	BOOL	FALSE	—	Habilita o início do processo de conexão (avaliado por transição de subida). Deve permanecer em TRUE durante a execução.
COMM_SRC	IN	USINT	0	Canal de comunicação	Canal de comunicação a ser utilizado (ver Canais de comunicação).
R_BUF	IN_OUT	ANY	—	—	Buffer utilizado na transação corrente (envio do comando e recepção da resposta pelo bloco ASCII_SR).
DONE_EVT	OUT	BOOL	FALSE	—	Pulso que indica “bloco finalizado”; verifique `RESULT` para saber se o evento terminou com sucesso ou erro.
READY	OUT	BOOL	FALSE	—	Sinaliza que a conexão à rede LoRaWAN foi estabelecida.
RESULT	OUT	SINT	0	—	Resultado da operação (ver Códigos de retorno).

Canais de comunicação

O valor de COMM_SRC identifica o canal de comunicação. Use os identificadores com o namespace HILS (ex.: HILS.COM1_PORT_ID). Cada equipamento oferece um subconjunto destes canais — consulte o manual do equipamento.

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

Códigos de retorno

A saída RESULT (SINT) retorna o resultado da tentativa de conexão:

Código	Significado
0	Sucesso: conexão à rede LoRaWAN estabelecida.
-10	Não foi possível conectar à rede LoRaWAN.

Pré-condições

O módulo RAK3172 deve estar previamente configurado com o bloco LR_CFG_RAK3172.
R_BUF deve estar disponível para a transação (envio do comando e recepção da resposta).
START deve permanecer em TRUE durante toda a execução do bloco.

Observações

Este bloco pode demorar mais de 1,5 minuto para executar, devido ao tempo de resposta do comando de conexão à rede.
O bloco é específico para o módulo LoRa RAK3172.

Ver também

LR_CFG_RAK3172