Q4GA1_CONTROLLER

Ativa ou desativa o processo de conexão do módulo de modem celular 4G (CAT-M1) Q4GA1 com o servidor configurado no próprio módulo, e reporta o status de operação do modem. Requer que o equipamento possua o módulo Q4GA1 integrado. É 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

           Q4GA1_CONTROLLER
        +--------------------+
BOOL ---|CONN_ON           EV|--- BOOL
        |                    |
BOOL ---|CONN_OFF   CONNECTED|--- BOOL
        |                    |
        |           ON_CONFIG|--- BOOL
        |                    |
        |              RESULT|--- INT
        |                    |
        |              STATUS|--- INT
        |                    |
        |            SIGN_QLY|--- INT
        +--------------------+

A transição para ativo em CONN_ON inicia o processo de conexão (quando desconectado) e a transição para ativo em CONN_OFF inicia o processo de desconexão (quando conectado). Ao iniciar uma comutação de estado, RESULT assume HILS.GL_CMD_PEND, indicando processo em andamento; deve-se aguardar a ativação da saída EV (pulso de 1 scan), instante em que RESULT e CONNECTED estarão atualizados com o estado corrente. Quando o comando é de conexão e o processo é bem-sucedido, CONNECTED fica ativa.

O bloco reserva um tempo máximo de 30 segundos para a comutação. Se esse tempo for excedido, EV é ativada e RESULT recebe HILS.RE_ACS_TMO.

Dica

O módulo Q4GA1, quando presente em um equipamento, pode ser configurado pelo script “Configura módulo 4GA1”, disponível no HIstudio em Ferramentas ‣ Ferramentas avançadas ‣ Scripts.

Nota

O valor de SIGN_QLY é atualizado apenas durante o processo de conexão do modem com o servidor configurado ou quando o modem está em modo de configuração (conexão inativa).

Parâmetros

Nome	Direção	Tipo	Padrão	Retain	Faixa / Unidade	Descrição
CONN_ON	IN	BOOL	FALSE	—	—	Na transição para ativo, inicia o processo de conexão caso esteja desconectado.
CONN_OFF	IN	BOOL	FALSE	—	—	Na transição para ativo, inicia o processo de desconexão caso esteja conectado.
EV	OUT	BOOL	FALSE	no_retain	—	Pulso de 1 scan sempre que houver alteração do status do modem; nesse instante RESULT e CONNECTED estão atualizados.
CONNECTED	OUT	BOOL	FALSE	no_retain	—	Ativo quando a conexão TCP/IP com o servidor programado está estabelecida.
ON_CONFIG	OUT	BOOL	FALSE	no_retain	—	Ativo quando o modem está em modo de configuração.
RESULT	OUT	INT	0	no_retain	RET_CODE	Código de retorno do processo de conexão/desconexão (ver Códigos de retorno).
STATUS	OUT	INT	0	no_retain	-1 .. 19	Status de operação reportado pelo modem (ver Observações).
SIGN_QLY	OUT	INT	0	no_retain	-1 .. 100 (%)	Qualidade do sinal da rede celular; -1 = falha na obtenção, 0..100 = percentual do sinal.

Códigos de retorno

RESULT carrega códigos de retorno do namespace HILS (ex.: HILS.CO_CONEX_FAIL) e é atualizado a cada ativação de EV. Códigos possíveis deste bloco:

Código	Identificador	Significado
0	SUCCESS	Módulo funcional, sem falhas detectadas.
16	GL_CMD_PEND	Módulo em processo de alteração do estado de conexão.
22	RE_ACS_TMO	Timeout na alteração do estado de conexão (motivo não identificado com precisão pelo firmware).
182	CN_NO_NET	Rede celular não detectada.
185	CN_AUTH_DENIED	Falha de autenticação na rede celular (PIN, usuário ou senha inválidos).
63	CO_CONEX_FAIL	Falha de conexão; servidor não encontrado ou conexão rejeitada.
3	GL_INV_CFG	Configuração inválida nos parâmetros de operação do modem.
4	GL_HDW_SUP	Módulo de modem não identificado (equipamento sem o módulo Q4GA1).
15	GL_HDW_FAIL	Falha na inicialização do módulo Q4GA1.

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

Observações

• A saída STATUS reporta o estado corrente do modem, conforme a tabela:

  Valor	Descrição
  -1	Hardware incompatível.
  0	Falha de hardware.
  1	Configuração do modem inválida.
  2	Sem SIMCard.
  10	Sem rede celular.
  11	Falha de autenticação na rede celular.
  12	Modem em modo de configuração.
  15	Erro no acesso ao servidor (ex.: IP/porta inválidos).
  19	Modem com conexão estabelecida.

• SIGN_QLY é apresentado na faixa de -1 a 100: -1 indica falha na obtenção da informação; 0 significa sem sinal e 100 o valor máximo detectado pelo módulo.

Ver também

Q4GA1_SET_MODE, Q4GA1_GETSTS, Q4GA1_SIGQLY

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    MODEM_ON_OFF : BOOL;                   (* Comando para conectar/desconectar o modem *)
    MODEM        : HILS.Q4GA1_CONTROLLER;  (* Instancia do bloco de função *)
END_VAR

// Utilize a variável MODEM_ON_OFF para controlar a conexão do modem com o servidor remoto
MODEM(  // Q4GA1_CONTROLLER
  CONN_OFF  := NOT MODEM_ON_OFF, // [BOOL] Ativa processo de desconexão
  CONN_ON   := MODEM_ON_OFF      // [BOOL] Ativa processo de conexão
  );

if (MODEM.CONNECTED) then
  //(* ... *) Conexão estabelecida
else
  if (MODEM.EV) then
    if (MODEM.RESULT <> HILS.SUCCESS) then
      //(* ... *) Falha identificada no modem
    end_if;
  end_if;
end_if;