Y_IM_ModbusMasterRTU

This function block (FB) handles the RS422/ 485 communication module 040-1CA00.
The FB provides the communication to a Modbus slave.
The FB shall be usable in IEC programs.

Parameters

*	Parameter	Data Type	Description	Default
VAR_IN_OUT
V	InputData	Yt_ByteArray60	Array of 60 bytes with actual values of the CP040 module. To have a consistent data access, please define the type of the connected variable as "IN Port".
V	OutputData	Yt_ByteArray60	Array of 60 bytes with set values for the CP040 module. To have a consistent data access, please define the type of the connected variable as "OUT Port".
V	ModbusData	Yt_WordArray512	Array of 512 words for data received or send by modbus.
VAR_INPUT
B	Execute	BOOL	Upon the rising edge of the Execute input, all other inputs are read and the function block becomes operational. If an input needs to be modified, the value will have to be changed and the Execute input will have to be re-triggered.	FALSE
V	SlaveAddress	USINT	Address of the slave. Use 0 for broadcast - for write function codes. Valid values: 0 .. 247.	USINT#0
V	FunctionCode	BYTE	Supported function codes: 1, 2, 3, 4, 5, 6, 15, 16, 103	BYTE#16#00
V	SubFunction	WORD	Supported function codes for FunctionCode = 103 values = 16#010D, 16#010E	WORD#16#00
V	Length	UINT	Length for command. Datatype depends on function code. Length is not used for function codes: 0x05, 0x06.	UINT#0
V	SlaveOffset	UINT	Offset for command on Slave side. Datatype depends on function code.	UINT#0
V	MasterOffset	UINT	Offset for command on Master side for access on ModbusData. Datatype depends on function code.	UINT#0
E	Reset	BOOL	With Reset = TRUE the communication to the CP040 is reset and an active send command is aborted.	FALSE
VAR_OUTPUT
B	Done	BOOL	The Done output is set to TRUE when the commanded action has completed successfully. If another function block takes control before the action is completed, the Done output will never become TRUE. This output is reset when Execute becomes FALSE.
B	Busy	BOOL	For function blocks with Execute input, the Busy output is set to TRUE upon the rising edge of the Execute, and set to FALSE when Done, CommandAborted or Error outputs becomes TRUE. In the case of a function block with an Enable input, Busy indicates that the function block is operating, but may not be ready to provide valid outputs.
E	DoneReset	BOOL	Reset was done.
B	Error	BOOL	The Error output is set to TRUE if an error has occurred during the operation of the function block. The output is cleared when the Execute or Enable input becomes FALSE.
B	ErrorID	UINT	The ErrorID output provides the identifier of the error when there is an active error in the function block execution. The output is cleared when the Execute or Enable input becomes FALSE.

Notes

The unit of Length and the maximum value of Length are depending on the FunctionCode.
FunctionCode 1, 2, 5: Unit of Length is Bits. Length must be between 1 and 2000 Bits.
FunctionCode 15: Unit of Length Bits. Length must be between 1 and 1968 Bits.
FunctionCode 3, 4: Unit of Length Words. Lenght must be between 1 and 125 Words.
FunctionCode 16: Unit of Length Words. Lenght must be between 1 and 123 Words
FunctionCode 103: Unit of Length Words. Lenght must be between 1 and 123 Words
The unit of MasterOffset and the maximum value of MasterOffset are depending on the FunctionCode.
FunctionCode 1, 2, 5, 15: Unit of MasterOffset is Bits. MasterOffset and Length together are not allowed to be larger than 8192 Bits.
FunctionCode 3, 4, 16, 103: Unit is MasterOffset is Words. MasterOffset and Length together are not allowed to be larger than 512 Words.
"InputData" port have to be linked with Port "cp-1/ ~IN". "cp-1" is the name of the CP040 module used in the project
"OutputData" port have to be linked with Port ""cp-1/ ~OUT"."cp-1" is the name of the CP040 module used in the project
In some applications, when using a low baud rate it might be necessary to adapt the time for detecting a receive time out.
This can be done by writing the instance variable ReceiveTimeout of the function block.
Datatype: TIME, range T#100ms .. T#60s, default value is T#2s.
Example: Y_CO_ModbusMasterRTU1. ReceiveTimeout := T#5s; // Time 5 seconds
For some devices it my be necessary to adapt the waiting time between modbus requests.
This can be done by writing the instance variable ProtocolTimeout of the function block.
Datatype: TIME, range T#100ms .. T#60s, default value is T#3s .
Example: Y_CO_ModbusMasterRTU1.ProtocolTimeout := T#4s ; // Time 4 seconds
Regarding Subfunction code meaning please refer to product manual for GA500 or GA700

Error Description

See the Function Block ErrorID List list.