MODEM_CONN

Este bloco tem por função enviar a sequência de comandos AT do modem 3G ou NBIOT para abrir conexão com um IP/(Host name) e Porta especificados pela rede celular.

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, se esse procedimento for executado com sucesso o bloco habilitará o sinal de READY. A entrada START deve permanecer ativa durante a execução do bloco. Os itens a seguir detalham o funcionamento do bloco.

Nota

Para utilização desse bloco, o modem deverá estar com o acesso à rede 3G ou NBIOT disponível. Devem ser utilizados os bloco RNB_CFG (caso modem NBIOT) ou U3G_CFG (caso modem 3G) para configuração inicial do modem. O bloco MODEM_CONN deve ser ativado apenas após o bloco de configuração indicar que este process esta terminado corretamente.

Bloco

                MODEM_CONN
           +-------------------+
  BOOL ----|START      DONE_EVT|---- BOOL
           |                   |
  BOOL ----|AUTH         RESULT|---- INT
           |                   |
 USINT ----|COMM_SRC      READY|---- BOOL
           |                   |
           |             CLOSED|---- BOOL
           |                   |
           |            NET_QLT|---- SINT
           |                   |
STRING ----|IP_HN ------------ |----
           |                   |
STRING ----|PORT ------------- |----
           +-------------------+

Parâmetros

Nome	Classe	Tipo	Dim.	V. Ini.	Descrição
START	Entrada	BOOL		FALSE	Habilita incio da configuração
AUTH	Entrada	BOOL		FALSE	Flag se autentica (V1) no portal de telemetria da HI Tecnologia ao se conectar
COMM_SRC	Entrada	USINT		0	Canal de comunicação a ser utilizado
IP_HN	Entrada/Saída	STRING	:40		IP destino ou Nome do host
PORT	Entrada/Saída	STRING	:6		Porta destino
DONE_EVT	Saída	BOOL		FALSE	Pulso que indica ocorrencia algum processo que mudou o estado do bloco. Neste instante o parâmetro RESULT indica o resultado do
RESULT	Saída	INT		0	Resultado da operação (válido quando o parâmetro DONE_EVT estiver ativo)
READY	Saída	BOOL		FALSE	Flag indicativo de comando de abertura de conexao
CLOSED	Saída	BOOL		TRUE	Saida que sinaliza que fechou conexão no lado do modem
NET_QLT	Saída	SINT		0	Qualidade do sinal (0..100%)

AUTH

Quando ativada esta entrada, ao final do processo de conexão com sucesso com o IP destino, o bloco monta um pacote de autenciação e o envia para o destino da conexão. Neste caso o servidor que recebu a conexão deverá ser portal de telemetria da HI Tecnologia. Este pacote efetua a autenticação do equipamento no portal no padrão V1 e portanto só será enviado se a porta destino for 16800 (MODBUS-TCP) ou 16810(MODBUS-RTU).

COMM_SRC

O canal de comunicação utilizado é 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.

IP_HN e PORT

Esses campos são strings que devem ser preenchidas pelo usuário para a execução do bloco. Se esses parâmetros forem modificados, um novo pulso em START deve ser gerado.

READY

A saída READY indica que o modem foi configurado e a conexão TCP foi estabelecida com endereço destino. Essa saída irá para zero se houver transição de descida na entrada START ou se o acesso a rede ficar indisponível ou se a conexão TCP com destino for fechada. Neste ultimo caso, se a conexão TCP for fechada e o sinal de START se mantiver habilitado o bloco tentará abrir conexão novamente com o endereço destino.

DONE_EVT

Pulso de saida DONE_EVT indica que algum evento do bloco foi gerado, podendo ser um erro durante o processo ou finalização do bloco. Sempre que a saída DONE_EVT estiver ativa, a saída RESULT irá indicar se o processo foi realizado com sucesso (RESULT = 0) ou não.

RESULT

Código que indica o resultado de um processo interno do MODEM. É válido quando a saída DONE_EVT estiver ativa. Os códigos da saída do RESULT são listados a seguir:

Valor	Descrição
0	Processo executado com sucesso
-10	Erro na abertura do socket (erro na aquisição de um socket disponivel no modem)
-20	Erro na conexão com IP e porta especificados
-99	Erro de timeout (ficou preso em algum estado esperando um evento, provavelmente modem não respondeu a um comando)

CLOSED

A saída CLOSED indica que o processo de fechamento da conexão TCP com o IP e PORTA destino na rede celular foi finalizado. O usuário só deverá habilitar o START do bloco, para tentar uma nova conexão, se essa varíável estiver em “TRUE”.