Equipamentos (Dispositivos) > PLC300 > Programa > Communication Network > Modbus TCP > MBTCP

Bloco que executa uma escrita de até 128 dados binários (via Write Single Coil ou Write Multiple Coils) em um servidor em rede Modbus TCP.

Representação Ladder

MBTCP_WRITEBINARY_block

Estrutura do Bloco

Tipo de Variável	Nome	Tipo de Dado	Descrição
VAR_INPUT	Execute	BOOL	Habilitação do bloco
	ServerAddress	DWORD	Endereço IP do servidor (Ex: 192.168.0.1)
	ServerPort	WORD	Porta Modbus TCP do servidor (Padrão: 502)
	UnitID	BYTE	UnitID do servidor (Padrão: 255)
	Function#	BYTE	Código da função de escrita
	InitialDataAddress	WORD	Endereço do bit inicial onde os dados serão escritos
	NumberOfData	BYTE	Número de bits a serem escritos (1 a 128)
	Timeout#	WORD	Tempo máximo de espera pela resposta do servidor [ms]
	Offset#	BOOL	Indicação de offset em InitialDataAddress, ou seja, necessidade de subtrair 1 deste número
	Value	BOOL	Variável que armazena os dados a serem escritos
VAR_OUTPUT	Done	BOOL	Habilitação de saída
	Active	BOOL	Sinalizador de aguardo de resposta
	Busy	BOOL	Sinalizador de que a conexão está ocupada com outra requisição
	Error	BOOL	Sinalizador de erro na execução
	ErrorID	BYTE	Identificador do erro ocorrido
VAR	MBTCP_WRITEBINARY _INST_0	MBTCP_WRITEBINARY	Instância de acesso à estrutura do bloco

Funcionamento

Este bloco, quando detecta uma borda de subida em Execute, verifica se o servidor Modbus TCP no endereço especificado em ServerAddress está livre para envio de dados (variável Busy em nível FALSE). Caso esteja, envia a requisição de escrita dos valores de Value em um número de bits indicado por NumberOfData no endereço InitialDataAddress utilizando a função escolhida em Function# e seta a saída Active, resetando-a ao receber a resposta do servidor. Caso o servidor não esteja livre, o bloco aguarda Busy ir para nível FALSE para reenviar a solicitação.

NOTA!

Caso Execute vá para nível FALSE e Busy ainda esteja em nível TRUE, a requisição é cancelada.

NOTA!

Value é um array de tamanho igual a NumberOfData. É importante verificar esta compatibilidade para não gerar erros no bloco.

Quando Execute possui valor FALSE, Done permanece FALSE. A saída Done só é ativada quando o bloco termina a execução com sucesso, permanecendo em nível TRUE até que Execute receba FALSE.

Caso haja algum erro na execução, a saída Error é ativada e ErrorID exibe o código do erro segundo a tabela abaixo.

Código	Descrição
0	Executado com sucesso
1	Algum dado de entrada inválido
2	Cliente não habilitado
4	Timeout na resposta do servidor
5	Servidor retornou erro
6	Falha ao conectar com o servidor
7	Conexão TCP/IP terminada prematuramente

Compatibilidade

Equipamento	Versão
PLC300	1.30 ou superior

Fluxograma do Bloco

MBTCP_WRITEBINARY_flowchart

Exemplo em Ladder

MBTCP_WRITEBINARY_example01

O exemplo acima requisita escrita do dado contido em VALUE, de tamanho descrito por DATA_COUNT, nos endereços posicionados a partir de INIT no servidor Modbus TCP de endereço SERVER:PORT através da função Write Single Coil. Finalizado o bloco com sucesso, a saída Done é ativada.

Exemplo em ST

O exemplo abaixo, exibe as instruções para aplicação do exemplo acima na linguagem ST.

VAR

SERVER : DWORD := 16#C0A8000A; // 192.168.0.10 = 3232235530

PORT : WORD := 502;

UNITID : BYTE := 255;

INIT : WORD;

DATA_COUNT : BYTE;

VALUE : ARRAY [0..4] OF BOOL;

MBTCP_WRITEBINARY_INST_0 : FB_MBTCP_WriteBinary;

END_VAR

MBTCP_WRITEBINARY_INST_0.Execute := DI1;

MBTCP_WRITEBINARY_INST_0(

ServerAddress:=SERVER,

ServerPort:=PORT,

UnitID:=UNITID,

Function:=5,

InitialDataAddress:=INIT,

NumberOfData:=DATA_COUNT,

Timeout:=50,

Offset:=0,

Value := VALUE);

DO1 := MBTCP_WRITEBINARY_INST_0.Done;