receive_data — Receive arbitrary data from external devices or applications using a generic socket connection.
receive_data receives arbitrary data over a generic socket connection. The received data is converted from a binary network packet to a value (or a tuple of values) using the parameter Format as specification and is well-suited to communicate with external devices or applications. This operator does not support the standard 'HALCON' protocol, but is intended for arbitrary data transfer.
The received data is converted to a value or tuple of values using the parameter Format. It is possible to specify multiple formats. In this case the From parameter will contain a 3rd value which tells you which format has been used to convert the data. To decide which format to use the size of the necessary data for each format is calculated initially. When data is received, the first format string with the matching size is used to convert the data to values.
The parameter From contains the IP address or hostname and port of the communication partner. For UDP connections it can be used in the send_data operator to send a response.
Please see send_data for a detailed description of the format.
Specification how to convert the data to tuples.
Default value: 'z'
Value (or tuple of values) holding the received and converted data.
IP address or hostname and network port of the communication partner.
open_socket_connect, socket_accept_connect, get_socket_param, set_socket_param