CONFIG_SERIAL

A função deste bloco é configurar o canal serial especificado com valores de baud rate, paridade, stop bits, data bits e protocolo. A configuração é realizada somente em RAM, ou seja, se o equipamento for resetado a configuração salva na flash é restaurada. A restauração dos valores salvos em flash também pode ser realizada com o bloco de função RESTORE_COMM. É necessária uma transição de subida na entrada START para execução do comando.

Bloco

             CONFIG_SERIAL
          +-----------------+
 BOOL ----|START    COMPLETE|---- BOOL
          |                 |
USINT ----|CHANN      RESULT|---- INT
          |                 |
USINT ----|BAUD             |
          |                 |
USINT ----|DATA             |
          |                 |
USINT ----|PARITY           |
          |                 |
USINT ----|STOPB            |
          |                 |
USINT ----|PROT             |
          +-----------------+

Parâmetros

Nome	Classe	Tipo	Dim.	V. Ini.	Descrição
START	Entrada	BOOL		FALSE	Inicia processo de configuração dos parâmetros
CHANN	Entrada	USINT			Número do canal serial a ser utilizado
BAUD	Entrada	USINT		255	Código do baud rate a ser configurado
DATA	Entrada	USINT		255	Código do nro de bits de dados a ser configurado
PARITY	Entrada	USINT		255	Código da paridade a ser configurada
STOPB	Entrada	USINT		255	Código stop bits a ser configurado
PROT	Entrada	USINT		255	Protocolo a ser configurado
COMPLETE	Saída	BOOL			Indica fim da execução do comando
RESULT	Saída	INT			Resultado da operação

START

O bloco necessita de uma transição de subida para executar a configuração.

CHANN_ID

O canal de comunicação utilizado é especificado por um identificador (valor numérico) conforme indicado na tabela a seguir:

Nome [1]	Ident.	Descrição [4]
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
HILS.CBUS_ID	24	Interface CBUS (disponível no P7C)

	[1] Este texto pode ser utilizado como parâmetro pois esta definido no tipo COMM_CHAN_ID disponível na biblioteca HI_STD. [4] Os recursos de comunicação disponíveis dependem do modelo do equipamento. Para identificar quais recursos estão disponíveis em um dado equipamento, consulte o manual do mesmo.

BAUD

O baud rate utilizado é especificado por um identificador (valor númerico) conforme indicado na tabela a seguir:

BAUD	Baud rate
0	1200
1	2400
2	4800
3	9600
4	19200
5	38400
6	57600
7	115200
255	Mantem o valor configurado

DATA

O tamanho dos bits de dados é especificado por um identificador (valor númerico) conforme indicado na tabela a seguir:

DATA	Data bits
0	7
1	8
255	Mantem o valor configurado

PARITY

A paridade utilizada é especificada por um identificador (valor numérico) conforme indicado na tabela a seguir:

PARITY	Paridade
0	Nenhuma
1	Par
2	Ímpar
255	Mantem o valor configurado

STOPB

O nro de stop bits utilizado é especificado por um identificador (valor numérico) conforme indicado na tabela a seguir:

STOPB	Stop bits
0	1
1	2
255	Mantem o valor configurado

PROT

O protocolo utilizado é especificado por um identificador (valor numérico) conforme indicado na tabela a seguir:

PROT	Protocolo
0	ASCII
1	ASCII com SOF
2	ASCII com EOF
3	ASCII com SOF + EOF
6	MQTT_CLIENT
8	MODBUS-RTU
9	MODBUS-TCP
10	HTTPServer
255	Mantem o valor configurado

Nota

Verifique na especificação do equipamento utilizado se o firmware do mesmo possui recurso para o protocolo desejado.

RESULT

Tipo Dado	Descrição
INT	Código de retorno na execução da função, do tipo RET_CODE, onde: Se for igual a 0: Função executada com sucesso - código HILS.SUCCESS Se for diferente de 0: Falha na execução da função indica o respectivo código de erro. [5]

[5] Para consultar a lista completa dos códigos de retorno acesse: RET_CODE - Códigos de retorno do firmware G5.

Exemplo

Declaração de Variáveis

Nome	Classe	Tipo	Valor Inicial	Descrição
CFG_SERIAL	Local	CONFIG_SERIAL		Instancia de configuração do canal serial
MY_START	Local	BOOL	FALSE	Flag de start
COUNT	Local	UINT	0	Contador de execuções do comando
MY_CHANN	Local	USINT	0	Canal a ser configurado
MY_BAUD_RATE	Local	USINT	0	Baud rate a ser configurado
MY_DATA_BITS	Local	USINT	1	Data bits a ser configurado (8bits)
MY_PARITY	Local	USINT	0	Paridade a ser configurada (nenhuma)
MY_STOP_BITS	Local	USINT	0	Stop bits a ser configurado (1stop)
MY_PROTOCOL	Local	USINT	8	Protocolo a ser configurado (Modbus-RTU)
RET	Local	USINT	0

Clique aqui para baixar a tabela de variáveis

Código ST

// Exemplo do bloco de configuração de um canal serial

CFG_SERIAL(
  START  := MY_START,
  CHANN  := MY_CHANN,
  BAUD   := MY_BAUD_RATE,
  DATA   := MY_DATA_BITS,
  PARITY := MY_PARITY,
  STOPB  := MY_STOP_BITS,
  PROT   := MY_PROTOCOL
  );

// Aguarda fim da configuracao
IF (CFG_SERIAL.COMPLETE) THEN
  RET := CFG_SERIAL.RESULT;
  COUNT := COUNT + 1;
  MY_START :=0;
END_IF;