LR1_CONN

Envia uma sequência de comandos AT para conectar o módulo LoRa Breakbord RAK811 à rede LoRaWAN; o módulo já deve estar configurado (ver LR1_CFG). É 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_CONN
          +-------------------+
 BOOL ----|EN              ENO|---- BOOL
          |                   |
 BOOL ----|START      DONE_EVT|---- BOOL
          |                   |
USINT ----|COMM_SRC      READY|---- BOOL
          |                   |
          |             RESULT|---- SINT
          |                   |
      ----|R_BUF ------------ |----
          +-------------------+

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

Importante

Este bloco pode demorar mais de 1,5 minuto para executar, devido ao tempo de resposta do comando de conexão à rede.

Nota

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

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
EN	IN	BOOL	TRUE	—	Habilita a execução do bloco.
START	IN	BOOL	FALSE	—	Habilita o início do processo de conexão (avaliado por transição de subida).
COMM_SRC	IN	USINT	0	ver Canais de comunicação	Canal de comunicação a ser utilizado (tipo COMM_SRC da HI_STD).
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 conexão foi estabelecida com sucesso.
RESULT	OUT	SINT	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 SINT e assume os valores específicos deste bloco:

Valor	Significado
0	Sucesso.
-10	Não foi possível conectar à rede LoRaWAN.

Pré-condições

• O módulo LoRa RAK811 deve estar previamente configurado (ver LR1_CFG).

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

Observações

• A execução pode levar mais de 1,5 minuto devido ao tempo de resposta do comando de conexão.

• Ao término, DONE_EVT pulsa e RESULT indica sucesso ou erro; READY sinaliza a conexão estabelecida.

Ver também

LR1_CFG