Equipo (Dispositivos) > PLC200 > Programa > Communication Network > Modbus TCP > MBTCP

Bloque que ejecuta una lectura de hasta 128 datos binarios (vía Read Coils o Read Discrete Inputs) de un servidor en red Modbus TCP.

Representación Ladder

MBTCP_READBINARY_block

Estructura del Bloque

Tipo de Variable	Nombre	Tipo de Dato	Descripción
VAR_INPUT	Execute	BOOL	Habilitación del bloque
	ServerAddress	DWORD	Dirección IP del servidor (Ej: 192.168.0.1)
	ServerPort	WORD	Puerta Modbus TCP del servidor (Estándar: 502)
	UnitID	BYTE	UnitID del servidor (Estándar: 255)
	Function#	BYTE	Código de la función de lectura
	InitialDataAddress	WORD	Dirección del bit inicial de los datos a ser leídos
	NumberOfData	BYTE	Número de bits a ser leídos (1 a 128)
	Timeout#	WORD	Tiempo máximo de espera por la respuesta del servidor [ms]
	Offset#	BOOL	Indicación de offset en InitialDataAddress, o sea, necesidad de sustraer 1 de este número
VAR_OUTPUT	Done	BOOL	Habilitación de salida
	Active	BOOL	Señalizador de espera de respuesta
	Busy	BOOL	Señalizador de que la conexión está ocupada con otra solicitud
	Error	BOOL	Señalizador de error en la ejecución
	ErrorID	BYTE	Identificador del error ocurrido
	Value	BOOL	Variable que almacena los datos recibidos
VAR	MBTCP_READBINARY _INST_0	MBTCP_READBINARY	Instancia de acceso a la estructura del bloque

Operación

Este bloque, cuando detecta un flanco de subida en Execute, verifica si el servidor Modbus TCP, en la dirección especificada en ServerAddress, está libre para envío de datos (variable Busy en nivel FALSE). En caso de que lo esté, enviará la solicitud de lectura de un número de bits indicado por NumberOfData a la dirección InitialDataAddress utilizando la función escogida en Function# y ajustará la salida Active, reseteándola al recibir la respuesta del servidor. Los datos recibidos serán almacenados en la variable Value. En caso de que el servidor no esté libre, el bloque aguardará que Busy pase a nivel FALSE para reenviar la solicitud.

¡NOTA!

En caso de Execute pase a nivel FALSE y Busy aún esté en nivel TRUE, la solicitud será cancelada.

¡NOTA!

Value es un array de tamaño igual a NumberOfData. Es importante verificar esta compatibilidad para no generar errores en el bloque.

Cuando Execute tiene valor FALSE, Done permanece FALSE. La salida Done sólo es activada cuando el bloque termina la ejecución exitosamente, permaneciendo en nivel TRUE hasta que Execute reciba FALSE.

En caso de que haya algún error en la ejecución, la salida Error será activada y ErrorID exhibirá el código del error según la tabla de abajo.

Código	Descripción
0	Ejecutado exitosamente
1	Algún dato de entrada inválido
2	Cliente no habilitado
4	Timeout en la respuesta del servidor
5	Servidor retornó error
6	Falla al conectarse con el servidor
7	Conexión TCP/IP terminada prematuramente

Compatibilidad

Equipo	Versión
PLC300	1.30 o superior

Diagrama de Flujo del Bloque

MBTCP_READBINARY_flowchart

Ejemplo en Ladder

MBTCP_READBINARY_example01

El ejemplo de arriba solicita la lectura de un número de datos binarios descrito por DATA_COUNT, posicionados en INIT - 1 en el servidor Modbus TCP de dirección SERVER:PORT, a través de la función Read Discrete Input. Esos datos son pasados a VALUE. Finalizado exitosamente el bloque, será activada la salida Done.

Ejemplo en ST

El siguiente ejemplo muestra las instrucciones para aplicar el ejemplo anterior en el lenguaje 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_READBINARY_INST_0 : FB_MBTCP_ReadBinary;

END_VAR

MBTCP_READBINARY_INST_0.Execute := DI1;

MBTCP_READBINARY_INST_0(

ServerAddress:=SERVER,

ServerPort:=PORT,

UnitID:=UNITID,

Function:=2,

InitialDataAddress:=INIT,

NumberOfData:=DATA_COUNT,

Timeout:=100,

Offset:=1,

Value=>VALUE);

DO1 := MBTCP_READBINARY_INST_0.Done;