Q4GA1_SET_MODE

Seleciona o modo de operação do módulo de modem celular 4GA1 (modem 4G CAT-M integrável aos equipamentos): modo de configuração (CONFIG) ou modo de operação (RUN). É um bloco de função (requer instância).

Biblioteca: HI_STD · Namespace: HILS · Tipo: bloco de função

Bloco de função

          Q4GA1_SET_MODE
         +--------------+
 BOOL ---|START       EV|--- BOOL
         |              |
USINT ---|MODE    RESULT|--- SINT
         +--------------+

Modos de operação

CONFIG (MODE = 0): mantém a conexão com a rede celular inativa e aguarda a configuração, realizada pelo script “Configura módulo 4GA1”, disponível em Ferramentas ‣ Ferramentas avançadas ‣ Scripts. Nesse modo, a função Q4GA1_GETSTS retorna 12.
RUN (MODE = 1): com a configuração carregada, registra-se na rede celular e, em sucesso, abre a conexão com o servidor especificado. Acompanhe o processo por Q4GA1_GETSTS.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
START	IN	BOOL	FALSE	—	Habilita a operação do bloco.
MODE	IN	USINT	1	0 .. 1	Modo a selecionar: `0` = CONFIG (aguarda configuração), `1` = RUN (registra/conecta na rede).
EV	OUT	BOOL	FALSE	—	Pulso de sinalização de fim de tratamento do bloco.
RESULT	OUT	SINT	0	RET_CODE	Resultado da operação. Válido quando EV = TRUE. (ver Códigos de retorno).

Códigos de retorno

RESULT é do tipo SINT RET_CODE: 0 ( HILS.SUCCESS ) indica sucesso; qualquer valor diferente de 0 indica falha. Lista completa: RET_CODE - Códigos de retorno do firmware G5.

Observações

A qualidade do sinal pode ser lida por Q4GA1_SIGQLY (atualizada a cada segundo em CONFIG; apenas durante a conexão em RUN).

Ver também

Q4GA1_GETSTS, Q4GA1_SIGQLY

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    START   : BOOL := FALSE;       (* Habilita operação do bloco *)
    M_MODE  : USINT;               (* Modo de operação selecionado *)
    M_MODEM : HILS.Q4GA1_SET_MODE; (* Instância do bloco de função *)
END_VAR

M_MODE := 0; (* define o modo de configuração *)
M_MODEM(
  START := START,   (* [BOOL] Habilita operação do bloco *)
  MODE  := M_MODE   (* [USINT] Modo de operação a selecionar *)
  );

IF (M_MODEM.EV) THEN
  IF (M_MODEM.RESULT = 0) THEN
    (* Processo de alteração de modo concluído com sucesso *)
  ELSE
    (* Processo de alteração de modo concluído com falha *)
  END_IF;
END_IF;