RNB_CFG
Este bloco tem por função enviar uma sequência de comandos AT defindos a um modem para configura-loe habilitálo na rede celular NBIot.
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
RNB_CFG
+-------------------+
BOOL ----|RESET ACC_STS|---- INT
| |
BOOL ----|START DONE_EVT|---- BOOL
| |
BOOL ----|SIM_STK READY|---- BOOL
| |
USINT ----|COMM_SRC RESULT|---- UINT
| |
| NET_QLT|---- INT
| |
| NET_IP|---- STRING
| |
| NET_OPER|---- STRING
| |
| NSI_MOD|---- USINT
| |
STRING ----|APN -------------- |----
| |
STRING ----|USER ------------- |----
| |
STRING ----|PASSW ------------ |----
| |
STRING ----|PIN -------------- |----
+-------------------+
Parâmetros
Nome |
Classe |
Tipo |
Dim. |
V. Ini. |
Descrição |
RESET |
Entrada |
BOOL |
0 |
Habilita soft reset do modem |
|
START |
Entrada |
BOOL |
FALSE |
Habilita incio da configuração |
|
SIM_STK |
Entrada |
BOOL |
FALSE |
Chip Multioperadora: SIM ToolKit habilitado |
|
COMM_SRC |
Entrada |
USINT |
0 |
Canal de comunicação a ser utilizado |
|
APN |
Entrada/Saída |
STRING |
:31 |
Apn da operadora |
|
USER |
Entrada/Saída |
STRING |
:15 |
usuário da operadora |
|
PASSW |
Entrada/Saída |
STRING |
:10 |
Senha da operadora |
|
PIN |
Entrada/Saída |
STRING |
:4 |
PIN do SIM Card |
|
ACC_STS |
Saída |
INT |
-1 |
Status de registro na rede 3G: inicializado com um valor “invalido” |
|
DONE_EVT |
Saída |
BOOL |
FALSE |
Pulso de saida que indica “bloco finalizado”, é preciso verificar no CFG_STS se o evento terminou com sucesso ou erro |
|
READY |
Saída |
BOOL |
FALSE |
Flag indicativo de config. OK |
|
RESULT |
Saída |
UINT |
0 |
Resultado da operação |
|
NET_QLT |
Saída |
INT |
0 |
Qualidade do sinal |
|
NET_IP |
Saída |
STRING |
:30 |
IP recebido pela rede NBIOT |
|
NET_OPER |
Saída |
STRING |
:10 |
Operadora do SIM CARD |
|
NSI_MOD |
Saída |
USINT |
0 |
Status de conexão do modem na rede 3G |
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. |
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.
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 |
|
Valor |
Descrição |
0 |
Processo executado com sucesso |
10 |
Pin Bloqueado |
20 |
Numero do PIN errado |
30 |
Pin Security sts não desbloqueado |
40 |
Erro no comando de reset |
50 |
Não detectou rede ( não se autoconectou em nenhuma rede) |
51 |
Não se registrou ainda esta procurando rede |
52 |
Registro negado |
60 |
APN inválida |
110 |
Não foi possivel ativar perfil |
120 |
Não pegou IP na rede |
200 |
Ficou offline (pelo pino de STS_MOD) |
999 |
Erro de hardware (modem não responde) |
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, RNB_NET_IP, RNB_OPER, STS_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%.
RNB_OPER: Operadora identificada.
RNB_NET_IP: IP do modem atribuído pela rede.
STS_MOD : Network Status Indicator, ou status de conexão do modem na rede . Os valores de STS_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.
STS_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 |
Exemplo
Declaração de variáveis
Nome |
Classe |
Tipo |
Valor Inicial |
Descrição |
|---|---|---|---|---|
START |
Local |
BOOL |
FALSE |
Flag de START do bloco |
MY_APN |
Local |
STRING |
‘claro.com.br’ |
APN do chip |
MY_USER |
Local |
STRING |
‘claro’ |
Usuario da operadora |
MY_PASSW |
Local |
STRING |
‘claro’ |
Senha da operadora |
MY_PIN |
Local |
STRING |
‘1010’ |
PIN do chip |
MY_OPERADORA |
Local |
STRING |
Operadora detectada |
|
MY_MODEM_IP |
Local |
STRING |
IP na rede |
|
MY_NET_QLT |
Local |
SINT |
0 |
Qualidade od sinal |
MY_NSI |
Local |
UINT |
0 |
Network Status indicator |
MODEM_CONFIG |
Local |
RNB_CFG |
Instancia do bloco de configuração do MODEM |
|
READY |
Local |
BOOL |
FALSE |
Flag de status do bloco |
RESULT |
Local |
UINT |
0 |
Resultado do bloco |
Código ST
MODEM_CONFIG( // RNB_CFG
START := START, // [BOOL] Habilita incio da configuração
COMM_SRC := HILS.COM1_PORT_ID, // [USINT] Canal de comunicação a ser utilizado
APN := MY_APN, // [STRING] Apn da operadora
PASSW := MY_PASSW, // [STRING] Senha da operadora
PIN := MY_PIN, // [STRING] PIN do SIM Card
USER := MY_USER // [STRING] usuário da operadora
);
IF MODEM_CONFIG.DONE_EVT THEN
MY_OPERADORA := MODEM_CONFIG.NET_OPER;
MY_MODEM_IP := MODEM_CONFIG.NET_IP;
MY_NET_QLT := MODEM_CONFIG.NET_QLT;
RESULT := MODEM_CONFIG.RESULT;
END_IF;
READY := MODEM_CONFIG.READY;
MY_NSI := MODEM_CONFIG.NSI_MOD;