ReadEIPBuffer

Reads (consumes) data sent by a remote client using EtherNet/IPprotocol.EtherNet/IP is an application-level protocol implemented on top of Ethernet and TCP/IP protocols, allowing the transfer of data in industrial environments over the Ethernet. For more information on the EtherNet/IP protocol, go to odva.org.

The referenced Buffer data structure, which is created by a FormatInputBuffer function, defines how the received data is interpreted. For more information, see FormatInputBuffer.

Note:
  • For In-Sight vision systems running In-Sight 5.1.0 and later firmware, when a job containing this function is loaded, it will automatically be replaced by the ReadUserDataBuffer function (the Protocol parameter will be set to Default). For more information, see ReadUserDataBuffer.
  • This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.
  • Although an In-Sight vision system can communicate with more than one device at the same time using EtherNet/IP protocol, it is not recommended to have more than one connection at a time.
  • In-Sight vision systems support both Explicit and Implicit EtherNet/IP messaging. For more information, see In-Sight Assembly Data Configuration (Implicit Messaging).ClosedSee Example.

    ReadEIP($A$0,"0d:4d:8s") in cell A4, reads 2 32 bit integers and a null terminated string from the PLC.

    GetBufferData($A$4,0) displays the first 32 bit integer.

    GetBufferData($A$4,1) displays the second 32 bit integer.

    GetBufferData($A$4, 2) displays the string.

  • For more information about using the EtherNet/IP protocol with a Rockwell ControlLogix PLC, see Communicate with a Rockwell ControlLogix PLC.

ReadEIPBufferInputs

Syntax: ReadEIPBuffer(Event,Buffer)

Parameter Description

Event

Specifies the update event on which to read data. This parameter must be a reference to one of the following:

  • The Image data structure in cell A0, containing the AcquireImage function. For more information, see AcquireImage.
  • A cell containing an Event function. For more information, see Event.
  • A cell containing a Button function. For more information, see Button.

Buffer

Specifies a reference to a Buffer data structure created by a FormatInputBuffer function, which defines how the received data is interpreted.

Note: The maximum length for input data is 4,000 bytes. Formore information, see In-Sight Assembly Data Configuration (Implicit Messaging).

ReadEIPBufferOutputs

Parameter Description

Returns

A ReadEIP data structure containing the data sent by a client or #ERR if any input parameters are invalid or a connection from a client has not been established.

Results

Data in the ReadEIP structure is accessed using the GetBufferData function. For more information, see Input/Output.