U3G_CFG

Este bloco tem por função enviar uma sequência de comandos AT defindos a um modem para configurá-lo e habilitá-lo na rede celular 3G.

Após o bloco ser habilitado pela entrada EN, ficará aguardando uma transição de subida em START; quando essa ocorrer, o bloco irá configurar o modem. A entrada START deve permanecer em nível alto durante a execução do bloco. Os itens a seguir detalham o funcionamento do bloco.

Nota

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

Bloco

                   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 -------------- |----
           +---------------------+

Parâmetros

Nome

Classe

Tipo

Dim.

V. Ini.

Descrição

START

Entrada

BOOL

FALSE

Habilita incio da configuração

FORCE_CFG

Entrada

BOOL

TRUE

Flag que força a configuração da rede 3G independente se o modem detectar que está conectado

COMM_SRC

Entrada

USINT

0

Canal de comunicação a ser utilizado

SIM_STK

Entrada

BOOL

FALSE

Chip Multioperadora: SIM ToolKit habilitado

PIN

Entrada/Saída

STRING

:*

Nro do PIN do SIM Card

APN

Entrada/Saída

STRING

:*

Apn da operadora

USER

Entrada/Saída

STRING

:*

Usuário da operadora

PASSW

Entrada/Saída

STRING

:*

Senha da operadora

READY

Saída

BOOL

FALSE

Flag indicativo de config. OK

DONE_EVT

Saída

BOOL

FALSE

Pulso de saida que indica “bloco finalizado”, é preciso verificar no RESULT se o evento terminou com sucesso ou erro

RESULT

Saída

UINT

0

Status de saída das operações do bloco

ACC_STS

Saída

SINT

-1

Status de registro na rede 3G: inicializado com um valor “invalido”

NET_QLT

Saída

SINT

0

Qualidade do sinal

NSI_MOD

Saída

UINT

0

Status de conexão do modem na rede 3G

IP_LOC

Saída

UDINT

0

Endereço IP recebido pela rede

NET_OPER

Saída

STRING

:10

Operadora do SIM CARD

U3G_IMEI

Saída

STRING

:25

IMEI do módulo de interface celular

U3G_ICCID

Saída

STRING

:30

ICCID do chip SIM card canectado

COMM_SRC

Canal de comunicação que o modem está referenciado. Este canal é especificado por um identificador (valor númerico) conforme indicado na tabela a seguir:

Nome

Ident.

Descrição

HILS.COM1_PORT_ID

0

Canal serial COM1

HILS.COM2_PORT_ID

1

Canal serial COM2

HILS.COM3_PORT_ID

2

Canal serial COM3

HILS.COM4_PORT_ID

3

Canal serial COM4

HILS.COM5_PORT_ID

4

Canal serial COM5

HILS.COM6_PORT_ID

5

Canal serial COM6

HILS.COM7_PORT_ID

6

Canal serial COM7

HILS.COM8_PORT_ID

7

Canal serial COM8

HILS.SOCK0_PORT_ID

8

Controlador Ethernet 1: Socket 0

HILS.SOCK1_PORT_ID

9

Controlador Ethernet 1: Socket 1

HILS.SOCK2_PORT_ID

10

Controlador Ethernet 1: Socket 2

HILS.SOCK3_PORT_ID

11

Controlador Ethernet 1: Socket 3

HILS.SOCK4_PORT_ID

12

Controlador Ethernet 1: Socket 4

HILS.SOCK5_PORT_ID

13

Controlador Ethernet 1: Socket 5

HILS.SOCK6_PORT_ID

14

Controlador Ethernet 1: Socket 6

HILS.SOCK7_PORT_ID

15

Controlador Ethernet 1: Socket 7

HILS.ETH2_SOCK0_PORT_ID

16

Controlador Ethernet 2: Socket 0

HILS.ETH2_SOCK1_PORT_ID

17

Controlador Ethernet 2: Socket 1

HILS.ETH2_SOCK2_PORT_ID

18

Controlador Ethernet 2: Socket 2

HILS.ETH2_SOCK3_PORT_ID

19

Controlador Ethernet 2: Socket 3

HILS.ETH2_SOCK4_PORT_ID

20

Controlador Ethernet 2: Socket 4

HILS.ETH2_SOCK5_PORT_ID

21

Controlador Ethernet 2: Socket 5

HILS.ETH2_SOCK6_PORT_ID

22

Controlador Ethernet 2: Socket 6

HILS.ETH2_SOCK7_PORT_ID

23

Controlador Ethernet 2: Socket 7

Este texto pode ser utilizado como parâmetro pois esta definido no tipo COMM_CHAN_ID disponível na biblioteca HI_STD.

Cada equipamento possui um sub-conjunto dos recursos de comunicação indicados na tabela acima. Para identificar quais recursos estão disponíveis em um dado equipamento, consulte o manual do mesmo.

SIM_STK

Quando utilizados chips de Multi-operadora, aguns dos fornecedores orientam a habilitação do SIM ToolKit para otimizar o processo de varredura de sinal das operadores e chaveamento estre elas. Consulte o fornecedor do chip para avaliar se é necessária esta configuração.

PIN

String com o código PIN do chip SIM CARD. Se este parâmetro for modificado, um novo pulso em START deve ser gerado.

APN

String com o código APN da operadora do chip SIM CARD. Se este parâmetro for modificado, um novo pulso em START deve ser gerado.

USER

String com o código NOME DE USUÁRIO da operadora do chip SIM CARD. Em alguns casos esse parametro pode ser vazio. Se este parâmetro for modificado, um novo pulso em START deve ser gerado.

PASSW

String com o código SENHA da operadora do chip SIM CARD. Em alguns casos esse parametro pode ser vazio. Se este parâmetro for modificado, um novo pulso em START deve ser gerado.

Se qualquer um desses parâmetros forem modificados, um novo pulso em START deve ser gerado.

RESULT, DONE_EVT, READY

A cada evento de erro no bloco durante as etapas de configuração o sinal DONE_EVT gera um pulso e o código do evento é mostrado na variável RESULT. A descrição dos códigos do RESULT são listados a seguir:

RESULT

Código

Valor

Descrição

SUCCESS

0

Processo executado com sucesso

RC_CO_SOCK_ERR

67

Erro na abertura do socket (erro na aquisição de um socket disponivel no modem)

RC_CO_CONEX_FAIL

63

Erro na conexão com IP e porta especificados

RC_GL_CMD_TMO

10

Erro de timeout (ficou preso em algum estado esperando um evento, provavelmente modem não respondeu a um comando)

A saída READY indica que o modem foi configurado com sucesso. Essa saída irá para zero se houver transição de descida na entrada START ou se o acesso a rede ficar indisponível.

ACC_STS, NET_QLT, IP_LOC, NET_OPER, U3G_IMEI, U3G_ICCID, NSI_MOD

Durante a configuração do modem o bloco retornará os seguintes parâmetros da rede:

  • ACC_STS: Status de registro na rede durante a inicialização.

ACC_STS

Valor

Descrição

0

not registered, the MT is not currently searching a new operator to register to

1

registered, home network

2

not registered, but the MT is currently searching a new operator to register to

3

registration denied

4

unknown (e.g. out of GERAN/UTRAN/E-UTRAN coverage)

5

registered, roaming

  • NET_QLT: Qualidade do sinal de 0 a 100%.

  • U3G_OPER: Operadora identificada.

  • IP_LOC: IP do modem atribuído pela rede.

    Retorna um valor inteiro de 32bits (4 bytes) sendo que cada byte represente um octeto do endereço IP.

    Ex: “10.236.22.24” -> 0A.EC.16.18 -> IP_LOC = 0x0AEC_1618 = 183244312

  • NSI_MOD : Network Status Indicator, ou status de conexão do modem na rede . Os valores de NSI_MOD são os mesmos obtidos pela variável de sistema F138 e a descrição dos valores são apresentados na tabela a seguir.

NSI_MOD

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 (NBIOT)

6

Rede Roaming 2G detectada

7

Rede Roaming 3G detectada

  • U3G_IMEI: IMEI do módulo de modem celular conectado.

  • U3G_ICCID: ICCID do chip SIM card conectado (quando conectado). Sem os dois primeiros números , quem em geral é “89”. Ex: +CCID: 89551080157031823831 -> U3G_ICCID = ‘551080157031823831’ . É enviado apenas 18 digitos para poder ser transformado em uma variavel LONG posteriormente.