QC1_CONN

Envia a sequência de comandos AT do modem 4G (CAT-1) para abrir uma conexão TCP com um IP/Host name e porta especificados pela rede celular, exigindo que o modem já tenha sido inicializado por QC1_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

                 QC1_CONN
           +-------------------+
  BOOL ----|START      DONE_EVT|---- BOOL
           |                   |
  BOOL ----|AUTH         RESULT|---- INT
           |                   |
  BOOL ----|SYNC_RTC      READY|---- BOOL
           |                   |
 USINT ----|COMM_SRC     CLOSED|---- BOOL
           |                   |
           |            NET_QLT|---- SINT
           |                   |
STRING ----|IP_HN ------------ |----
           |                   |
STRING ----|PORT ------------- |----
           +-------------------+

Após o bloco ser habilitado, ele aguarda uma transição de subida em START; quando ela ocorre, o bloco configura o modem e, se o procedimento for bem-sucedido, ativa o sinal READY. A entrada START deve permanecer ativa durante toda a execução do bloco.

Nota

Para utilização desse bloco, o modem deverá estar com o acesso à rede 4G (CAT-1) disponível. Deve ser utilizado o bloco QC1_CFG para a configuração inicial do modem. O bloco QC1_CONN só deve ser ativado após o bloco de configuração indicar que esse processo terminou corretamente.

SYNC_RTC — antes de abrir conexão com o IP e a porta especificados, sincroniza o relógio calendário do equipamento com a data e a hora da rede celular, levando em consideração o Time-Zone em que se encontra o equipamento.

AUTH — quando ativada, ao final de um processo de conexão bem-sucedido com o IP destino, o bloco monta um pacote de autenticação e o envia ao destino da conexão. Nesse caso, o servidor que recebe a conexão deve ser o portal de telemetria da HI Tecnologia. O pacote efetua a autenticação do equipamento no portal no padrão V1 e, portanto, só é enviado se a porta destino for 16800 (MODBUS-TCP) ou 16810 (MODBUS-RTU).

IP_HN e PORT — strings que devem ser preenchidas pelo usuário para a execução do bloco. Se esses parâmetros forem modificados, um novo pulso em START deve ser gerado. Tamanho máximo: IP_HN = 40 e PORT = 6.

READY — indica que o modem foi configurado e a conexão TCP foi estabelecida com o endereço destino. Vai a zero em uma transição de descida de START, se o acesso à rede ficar indisponível ou se a conexão TCP for fechada. Neste último caso, se START se mantiver habilitado, o bloco tentará abrir a conexão novamente com o endereço destino.

DONE_EVT — pulso que indica que algum evento do bloco foi gerado, seja um erro durante o processo, seja a finalização do bloco. Sempre que DONE_EVT estiver ativo, RESULT indica se o processo foi realizado com sucesso (RESULT = 0) ou não.

CLOSED — indica que o processo de fechamento da conexão TCP com o IP e a porta destino na rede celular foi finalizado. O usuário só deve habilitar novamente o START do bloco, para tentar uma nova conexão, se essa saída estiver em TRUE.

O canal de comunicação (COMM_SRC) é especificado por um identificador numérico (namespace 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

Parâmetros

Nome

Direção

Tipo

Dimensão

Padrão

Faixa / Unidade

Descrição

START

IN

BOOL

—

FALSE

—

Habilita o início do tratamento do bloco (avaliado por transição de subida).

AUTH

IN

BOOL

—

FALSE

—

Se autentica no portal de telemetria (V1) da HI Tecnologia ao se conectar.

SYNC_RTC

IN

BOOL

—

TRUE

—

Sincroniza o relógio calendário do controlador pela rede celular.

COMM_SRC

IN

USINT

—

0

0 .. 23

Canal de comunicação a ser utilizado (ver tabela de identificadores).

IP_HN

IN_OUT

STRING

:*

—

máx. 40 caracteres

IP destino ou nome do host.

PORT

IN_OUT

STRING

:*

—

máx. 6 caracteres

Porta destino.

DONE_EVT

OUT

BOOL

—

FALSE

—

Pulso que sinaliza uma mudança de estado do bloco; nesse instante RESULT é válido.

RESULT

OUT

INT

—

0

RET_CODE

Resultado da operação, válido quando DONE_EVT está ativo (ver Códigos de retorno).

READY

OUT

BOOL

—

FALSE

—

Indica que a conexão de abertura foi comandada/estabelecida.

CLOSED

OUT

BOOL

—

TRUE

—

Sinaliza que a conexão foi fechada no lado do modem.

NET_QLT

OUT

SINT

—

0

0 .. 100 %

Qualidade do sinal.

Códigos de retorno

RESULT é do tipo RET_CODE e indica o resultado de um processo interno do modem; é válido quando DONE_EVT está ativo. Use os identificadores com o namespace HILS (ex.: HILS.CO_SOCK_ERR). Códigos mais comuns deste bloco:

Código

Identificador

Significado

0

SUCCESS

Processo executado com sucesso.

10

GL_CMD_TMO

Timeout (ficou preso em algum estado; provavelmente o modem não respondeu a um comando).

63

CO_CONEX_FAIL

Erro na conexão com o IP e a porta especificados.

67

CO_SOCK_ERR

Erro na aquisição/abertura de um socket disponível no modem.

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

Pré-condições

  • O modem deve estar com acesso à rede 4G (CAT-1) disponível.

  • O bloco QC1_CFG deve ter concluído a configuração inicial do modem com sucesso.

  • IP_HN e PORT devem estar preenchidos antes da transição de subida de START.

Observações

  • START deve permanecer ativo durante toda a execução do bloco.

  • Se IP_HN ou PORT forem alterados, gere um novo pulso em START.

  • Uma nova conexão só deve ser tentada quando CLOSED estiver em TRUE.

  • O pacote de autenticação (AUTH) só é enviado se a porta destino for 16800 ou 16810.

Ver também

QC1_CFG