ReadEIP

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.

Note:
  • For In-Sight vision systems running In-Sight 5.1.0 and later firmware, when a job containing this function is loaded, an error message will be displayed, because this function is not present in In-Sight 5.1.0 or later firmware.This function should be replaced by the ReadUserDataBuffer function.Formore 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.
  • Althoughan In-Sight vision system can communicate with more than one device at the sametime using EtherNet/IP protocol, it is not recommended to have more thanone connection at a time.
  • In-Sight vision systems support both Explicit and Implicit EtherNet/IP messaging.Formore 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 anull 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.

  • Formore information, see Communicate with a Rockwell ControlLogix PLC.

ReadEIPInputs

Syntax: ReadEIP(Event,Mapping)

Event

Specifies the update event on which to readdata. 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.

Mapping

Specifies a data mapping, which consistsof a list of specifiers delimited by colon (:) characters.Each specifierhas two parts:

  • The starting byte.
  • A data type code.

The data typecodes are:

Code Data Type

i

8-bit integer

il

16-bit integer

d

32-bit integer

f

32-bit floating-point number

s

Text string

Example:The data mapping, "0i:1f:5d:9s" specifies that the first dataitem (at offset 0) is an 8-bit integer; the second item (at offset 1)is a 32-bit floating-point value; the third (at offset 5) is a 4-bytesigned integer; and the rest of the packet (starting at offset 9) is astring.

Note: When using the Input Assembly Instance 12 included within the Major Revision 10, the maximum length for input data is 488 bytes.When using the Input Assembly Instance 11 included with the In-Sight Major Revision 4, the maximum length for input data is 492 bytes.

ReadEIPOutputs

Returns

A ReadEIP data structure containingthe data sent by a client.Or, #ERR if any input parameters are invalidor a connection from a client has not been established.

Results

Data in the ReadEIP structure isaccessed using the GetBufferDatafunction.For more information, see Input/Output.