background image

Function blocks

TX1200

9

Version: 1.0

3

Function blocks

3.1

FB_ModbusTcpOpen

The function block opens a TCP/IP connection to a remote partner on the MODBUS/TCP port. To keep
resource consumption to a minimum, the maximum number of open connections has been limited to 4. If it is
necessary to establish a further connection, a connection that is not currently in use can first be closed using
the 

FB_ModbusTcpClose [

}

 10]

 function block. If successful, the FB_ModbusTcpOpen function block

supplies a port number in the 

iMyPortNo

 output variable. This port number is required in order to send a

MODBUS request using either of the 

FB_ModbusTcpRequest [

}

 12]

 or 

FB_ModbusTcpClose [

}

 10]

 function

blocks, e.g. to close the connection. When opening the connection, the 

tTimeout

 input parameter is also

used to specify the time-out period for the MODBUS request and for the disconnection. After about 10
seconds, a connection that has been opened but has not been used during that period is automatically
closed, and must be reopened if needed.

VAR_INPUT

VAR_INPUT
    bStart       : BOOL;
    sRemoteIPAddr: STRING(15);
    tTimeOut     : TIME;
END_VAR

bStart

: the function block is activated by a rising edge at this input.

sRemoteIPAddr

: this variable is a string containing the network address (IP address) of the remote partner.

tTimeOut

: indicates the time, which must not be exceeded during command execution.

VAR_OUTPUT

VAR_OUTPUT
    bBusy       : BOOL;
    bError      : BOOL;
    iErrorId    : WORD;
    iMyPortNo   : WORD;
END_VAR

bBusy

: if the function block is activated, this output is set. It remains set until a feedback is received.

bError

: if an error should occur during the execution of the command, then this output is set, after the bBusy

output has been reset.

iErrorId

: supplies the command-specific error code (table) or the 

device-specific error code [

}

 14]

 if the

bError output is set.

iMyPortNo

 : when successful, the port number associated with the connection is returned at this output. The

port number is a dynamic number, generated afresh each time the connection is established.

Error Codes

Description

0x8500

Resource error

0x8501

No socket available

0x8502

Open connection error

Содержание TX1200

Страница 1: ...Manual EN TX1200 TwinCAT 2 PLC Library TcModbusTCPBC 2022 05 02 Version 1 0...

Страница 2: ......

Страница 3: ...1 Foreword 5 1 1 Notes on the documentation 5 1 2 Safety instructions 6 1 3 Notes on information security 7 2 Overview 8 3 Function blocks 9 3 1 FB_ModbusTcpOpen 9 3 2 FB_ModbusTcpClose 10 3 3 FB_Modb...

Страница 4: ...Table of contents TX1200 4 Version 1 0...

Страница 5: ...ve already been supplied may be made on the basis of the data diagrams and descriptions in this documentation Trademarks Beckhoff TwinCAT TwinCAT BSD TC BSD EtherCAT EtherCAT G EtherCAT G10 EtherCAT P...

Страница 6: ...familiar with the applicable national standards Description of symbols In this documentation the following symbols are used with an accompanying safety instruction or note The safety instructions mus...

Страница 7: ...The latter should be connected to the corporate network or the Internet only if appropriate protective measures have been set up In addition the recommendations from Beckhoff regarding appropriate pr...

Страница 8: ...se of resources at a minimum If it is necessary to establish a further connection a connection that is not required must first be closed After about 10 seconds a connection that has not been used duri...

Страница 9: ...during that period is automatically closed and must be reopened if needed VAR_INPUT VAR_INPUT bStart BOOL sRemoteIPAddr STRING 15 tTimeOut TIME END_VAR bStart the function block is activated by a risi...

Страница 10: ...r in order to maintain the use of resources at a minimum If it is necessary to establish a further connection a connection that is not currently in use must first be closed A connection is automatical...

Страница 11: ...put has been reset iErrorId supplies the command specific error code table or the device specific error code 14 if the bError output is set Error Codes Description 0x8400 Connection is already closed...

Страница 12: ...passed here as a parameter The port number is generated afresh dynamically each time the connection is established with the FB_ModbusTcpOpen 9 function block pReqBuff contains the address of the buff...

Страница 13: ...x error Wrong protocol ID 0x8102 Rx error Wrong length 0x8103 Rx error Exceeding length 0x8104 Rx error Wrong unit ID Sample of calling the function block in FBD PROGRAM MAIN VAR fbModbusRequest FB_Mo...

Страница 14: ...Receive exceeding length 0x8104 Receive wrong unit ID Value hex Description Transmit Error 0x8300 Transmit timeout 0x8301 Transmit Shutdown 0x8302 Transmit internal error 0x8303 Transmit resource erro...

Страница 15: ......

Страница 16: ...Beckhoff Automation GmbH Co KG H lshorstweg 20 33415 Verl Germany Phone 49 5246 9630 info beckhoff com www beckhoff com More Information www beckhoff com tx1200...

Отзывы: