U3G_CFG

Envia uma sequência de comandos AT a um modem para configurá-lo e habilitá-lo na rede celular 3G. Requer habilitação por EN e uma transição de subida em START (que deve permanecer em nível alto durante toda a execução). É 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

                   U3G_CFG
           +---------------------+
  BOOL ----|START           READY|---- BOOL
           |                     |
  BOOL ----|FORCE_CFG    DONE_EVT|---- BOOL
           |                     |
 USINT ----|COMM_SRC       RESULT|---- UINT
           |                     |
  BOOL ----|SIM_STK       ACC_STS|---- SINT
           |                     |
           |              NET_QLT|---- SINT
           |                     |
           |              NSI_MOD|---- UINT
           |                     |
           |               IP_LOC|---- UDINT
           |                     |
           |             NET_OPER|---- STRING
           |                     |
           |             U3G_IMEI|---- STRING
           |                     |
           |            U3G_ICCID|---- STRING
           |                     |
STRING ----|PIN ---------------- |----
           |                     |
STRING ----|APN ---------------- |----
           |                     |
STRING ----|USER --------------- |----
           |                     |
STRING ----|PASSW -------------- |----
           +---------------------+

Após ser habilitado pela entrada EN, o bloco aguarda uma transição de subida em START; nesse instante inicia a configuração do modem. A entrada START deve permanecer em nível alto durante a execução. A saída READY indica que o modem foi configurado com sucesso e vai a zero se houver transição de descida em START ou se o acesso à rede ficar indisponível.

A cada evento de erro durante as etapas de configuração, DONE_EVT gera um pulso e o código correspondente é apresentado em RESULT. Se qualquer um dos parâmetros PIN, APN, USER ou PASSW for modificado, um novo pulso em START deve ser gerado.

Nota

Para abrir conexão com IP e porta especificados, utilize o bloco MODEM_CONN.

Parâmetros

Nome

Direção

Tipo

Dimensão

Padrão

Faixa / Unidade

Descrição

START

IN

BOOL

—

FALSE

—

Habilita o início da configuração (transição de subida). Deve permanecer alto durante a execução.

FORCE_CFG

IN

BOOL

—

TRUE

—

Força a configuração da rede 3G independentemente de o modem detectar que já está conectado.

COMM_SRC

IN

USINT

—

0

0 .. 23 (ID do canal)

Canal de comunicação em que o modem está referenciado (ver tabela abaixo).

SIM_STK

IN

BOOL

—

FALSE

—

Chip multioperadora: habilita o SIM ToolKit.

PIN

IN_OUT

STRING

:*

—

—

Código PIN do chip SIM Card.

APN

IN_OUT

STRING

:*

—

—

APN da operadora.

USER

IN_OUT

STRING

:*

—

—

Usuário da operadora (pode ser vazio em alguns casos).

PASSW

IN_OUT

STRING

:*

—

—

Senha da operadora (pode ser vazia em alguns casos).

READY

OUT

BOOL

—

FALSE

—

Indica configuração concluída com sucesso e acesso à rede disponível.

DONE_EVT

OUT

BOOL

—

FALSE

—

Pulso de “bloco finalizado”; verifique RESULT para saber se terminou com sucesso ou erro.

RESULT

OUT

UINT

—

0

RET_CODE

Status de saída das operações do bloco (ver Códigos de retorno).

ACC_STS

OUT

SINT

—

-1

0 .. 5 (-1 = inválido)

Status de registro na rede 3G durante a inicialização.

NET_QLT

OUT

SINT

—

0

0 .. 100 %

Qualidade do sinal.

NSI_MOD

OUT

UINT

—

0

0 .. 7

Network Status Indicator: status de conexão do modem na rede (mesmos valores da variável de sistema F138).

IP_LOC

OUT

UDINT

—

0

—

Endereço IP atribuído pela rede (inteiro de 32 bits; cada byte é um octeto do IP).

NET_OPER

OUT

STRING

:10

—

—

Operadora do SIM Card.

U3G_IMEI

OUT

STRING

:25

—

—

IMEI do módulo de interface celular.

U3G_ICCID

OUT

STRING

:30

—

—

ICCID do chip SIM Card conectado.

Identificadores de canal de comunicação (COMM_SRC), do tipo COMM_CHAN_ID (namespace HILS):

Identificador

Valor

Recurso

HILS.COM1_PORT_ID .. HILS.COM8_PORT_ID

0 .. 7

Canais seriais COM1 a COM8.

HILS.SOCK0_PORT_ID .. HILS.SOCK7_PORT_ID

8 .. 15

Controlador Ethernet 1: sockets 0 a 7.

HILS.ETH2_SOCK0_PORT_ID .. HILS.ETH2_SOCK7_PORT_ID

16 .. 23

Controlador Ethernet 2: sockets 0 a 7.

Cada equipamento possui um subconjunto dos recursos de comunicação acima; consulte o manual do equipamento para saber quais estão disponíveis.

Códigos de retorno

RESULT reporta o status das operações do bloco. 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 na execução do comando (bloco preso em algum estado; provavelmente o modem não respondeu a um comando).

63

CO_CONEX_FAIL

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

67

CO_SOCK_ERR

Erro na abertura do socket (falha ao adquirir 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 bloco deve estar habilitado pela entrada EN.

  • START deve receber uma transição de subida e permanecer em nível alto durante a execução.

  • COMM_SRC deve indicar um canal de comunicação válido para o modem no equipamento.

Observações

  • A saída READY indica que o modem foi configurado com sucesso; vai a zero na transição de descida de START ou quando o acesso à rede fica indisponível.

  • IP_LOC retorna o IP como inteiro de 32 bits. Exemplo: 10.236.22.24 ? 0A.EC.16.18 ? IP_LOC = 16#0AEC1618 = 183244312.

  • U3G_ICCID é enviado sem os dois primeiros dígitos (em geral “89”), com 18 dígitos, para poder ser convertido em uma variável LONG posteriormente. Ex.: +CCID: 89551080157031823831 ? U3G_ICCID = '551080157031823831'.

  • Quando são utilizados chips multioperadora, alguns fornecedores orientam habilitar o SIM_STK (SIM ToolKit) para otimizar a varredura de sinal e o chaveamento entre operadoras; consulte o fornecedor do chip.

Valores de ACC_STS (status de registro na rede):

Valor

Descrição

0

Não registrado; o MT não está buscando uma nova operadora para registro.

1

Registrado, rede local (home network).

2

Não registrado, mas o MT está buscando uma nova operadora para registro.

3

Registro negado.

4

Desconhecido (ex.: fora da cobertura GERAN/UTRAN/E-UTRAN).

5

Registrado, roaming.

Valores de NSI_MOD (Network Status Indicator):

Valor

Descrição

0

Modem não disponível.

1

Modem em reset.

2

Sem rede disponível / chip desconectado / procurando rede.

3

Rede 2G detectada.

4

Rede 3G detectada.

5

Rede 4G detectada (NB-IoT).

6

Rede roaming 2G detectada.

7

Rede roaming 3G detectada.

Ver também

MODEM_CONN