
Chapter
4
Reference Manual
IVC-2D
186
©
SICK AG • Advanced Industrial Sensors • www.sick.com • All rights reserved
Communication
Read Ethernet String
This tool is used for receiving a string that may contain up to 4095 characters from an-
other device over an Ethernet connection. The received string is available in the returned
value
Received string
.
The received string consists of every character that was received until a timeout occurred.
If the string that was sent contained more than 4095 characters, the remaining characters
will be queued and can be received by using this tool once more with the connection.
In order to receive data from another device, a connection to that device must have been
opened with the 'Open Ethernet Raw' tool. The program step in which the connection was
opened is used as the parameter
Open Step
.
As the length of the string is not known in advance, this tool will always wait the time
specified in the parameter
Timeout
before returning the received string.
Input Parameters
01=Open step
The program step in which the connection was opened.
02=Timeout
The time in milliseconds during which the camera will try to
receive the string. This includes the time it takes to establish
the connection, if necessary.
Returned Values
01=Received bytes
The length of the received string., that is the number of bytes
that was received.
02=Received string
The received string.
Error Messages
Err. = 1
The program step referred to by
01=Open step
is not an 'Open
Ethernet Raw' step.
Err. = 8000
Connection timed out.
Err. = 8001
Connection is broken.
Err. = 8002
Not possible to connect to the specified device.
Err. = 8004
The specified connection is for sending data only.
The Emulator does
not emulate this
tool. See section
Handling the
Emulator for more
information.