EtherNet/IP Route

EtherNet/IP Overview

The ETHERNETIP route enables communication with CIP (Common Industrial Protocol) compatible devices using EtherNet/IP explicit messaging. It provides access to device attributes using CIP addressing (Class, Instance, Attribute) and supports Allen-Bradley PLCs and other EtherNet/IP devices.

EtherNet/IP uses CIP addressing which provides structured access to device data. Use this route when you need explicit messaging to specific CIP objects.

Basic Syntax

DEFINE ROUTE EIPDevice WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
        WITH POLLING_MS '750'
    ADD MAPPING DeviceData
        WITH EVERY 1 SECOND
        ADD TAG Temperature
            WITH ADDRESS "1.1.100.0"
            WITH DATA_TYPE "FLOAT32"
            WITH SOURCE_TOPIC "eip/temperature"

Connection Configuration

ETHERNETIP_CONFIG Parameters

string

required

EtherNet/IP device IP address.

PORT

integer

EtherNet/IP port. Default: 44818.

POLLING_MS

integer

Polling interval in milliseconds. Default: 750.

CONNECTION_TIMEOUT

integer

Connection timeout in milliseconds. Default: 5000.

READ_WRITE_TIMEOUT

integer

Read/Write timeout in milliseconds. Default: 3000.

RETRY_ATTEMPTS

integer

Number of retry attempts. Default: 3.

RETRY_TIME_SECONDS

integer

Retry delay in seconds. Default: 5.

Connection Example

ADD ETHERNETIP_CONFIG
    WITH IP "192.168.1.100"
    WITH PORT '44818'
    WITH POLLING_MS '500'
    WITH CONNECTION_TIMEOUT '5000'
    WITH READ_WRITE_TIMEOUT '3000'
    WITH RETRY_ATTEMPTS '3'
    WITH RETRY_TIME_SECONDS '5'

CIP Addressing

EtherNet/IP uses CIP addressing in the format: ClassID.InstanceID.AttributeID.AttributeIndex

Component	Description	Example
ClassID	CIP object class	1 (Identity), 4 (Assembly), etc.
InstanceID	Object instance	1, 2, 3…
AttributeID	Attribute number	Varies by class
AttributeIndex	Index for arrays	0 for first element

Common CIP Classes

Class ID	Name	Description
1	Identity	Device identification
2	Message Router	Message routing
4	Assembly	I/O assemblies
6	Connection Manager	Connection handling
102	Analog Input Point	Analog inputs
103	Analog Output Point	Analog outputs
104	Discrete Input Point	Digital inputs
105	Discrete Output Point	Digital outputs

Data Types

DATA_TYPE

string

required

CIP data type for the attribute:

Data Type	Description	Size
`BOOLEAN`	Boolean value	1 bit
`BYTE`	Unsigned 8-bit	8 bits
`INT16`	Signed 16-bit	16 bits
`UINT16`	Unsigned 16-bit	16 bits
`INT32`	Signed 32-bit	32 bits
`UINT32`	Unsigned 32-bit	32 bits
`INT64`	Signed 64-bit	64 bits
`UINT64`	Unsigned 64-bit	64 bits
`FLOAT32`	32-bit float	32 bits
`FLOAT64`	64-bit float	64 bits
`ASCII`	ASCII character	8 bits
`STRING`	String value	Variable

TAG Configuration

Complete TAG Example

ADD TAG ProcessTemperature
    WITH ADDRESS "102.1.3.0"
    WITH DATA_TYPE "FLOAT32"
    WITH SOURCE_TOPIC "eip/process/temperature"
    WITH SCALING_FACTOR "0.1"
    WITH OFFSET "0"
    WITH DEADBAND "0.5"
    WITH PUBLISH_MODE "JSON"
    WITH LENGTH "1"

TAG Parameters

Address Configuration

ADDRESS

string

required

CIP address in format: ClassID.InstanceID.AttributeID.AttributeIndex

DATA_TYPE

string

required

CIP data type: BOOLEAN, BYTE, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT32, FLOAT64, ASCII, STRING.

LENGTH

integer

String length (for STRING type only).

Value Transformation

SCALING_FACTOR

decimal

Scaling multiplier for the value.

OFFSET

decimal

Value offset applied after scaling.

DEADBAND

decimal

Suppress updates if change is less than threshold.

Publishing

SOURCE_TOPIC

string

MQTT topic to publish tag data.

PUBLISH_MODE

string

Output format: JSON, RAW, or BINARY. Default: JSON.

Complete Examples

Device Identity
Analog I/O
Digital I/O
Assembly Data
Multi-Rate Polling

Read device identity information:

DEFINE ROUTE DeviceIdentity WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
        WITH POLLING_MS '5000'
    ADD MAPPING IdentityData
        WITH EVERY 30 SECONDS
        ADD TAG VendorID
            WITH ADDRESS "1.1.1.0"
            WITH DATA_TYPE "UINT16"
            WITH SOURCE_TOPIC "device/identity/vendor"
        ADD TAG DeviceType
            WITH ADDRESS "1.1.2.0"
            WITH DATA_TYPE "UINT16"
            WITH SOURCE_TOPIC "device/identity/type"
        ADD TAG ProductCode
            WITH ADDRESS "1.1.3.0"
            WITH DATA_TYPE "UINT16"
            WITH SOURCE_TOPIC "device/identity/product"
        ADD TAG SerialNumber
            WITH ADDRESS "1.1.6.0"
            WITH DATA_TYPE "UINT32"
            WITH SOURCE_TOPIC "device/identity/serial"
        ADD TAG ProductName
            WITH ADDRESS "1.1.7.0"
            WITH DATA_TYPE "STRING"
            WITH LENGTH "32"
            WITH SOURCE_TOPIC "device/identity/name"

Read analog input points:

DEFINE ROUTE AnalogIO WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
        WITH POLLING_MS '500'
    ADD MAPPING AnalogInputs
        WITH EVERY 500 MILLISECONDS
        ADD TAG AnalogIn1
            WITH ADDRESS "102.1.3.0"
            WITH DATA_TYPE "FLOAT32"
            WITH SOURCE_TOPIC "io/analog/in/1"
            WITH SCALING_FACTOR "0.01"
            WITH OFFSET "0"
            WITH DEADBAND "0.1"
        ADD TAG AnalogIn2
            WITH ADDRESS "102.2.3.0"
            WITH DATA_TYPE "FLOAT32"
            WITH SOURCE_TOPIC "io/analog/in/2"
            WITH SCALING_FACTOR "0.01"
            WITH DEADBAND "0.1"
        ADD TAG AnalogIn3
            WITH ADDRESS "102.3.3.0"
            WITH DATA_TYPE "FLOAT32"
            WITH SOURCE_TOPIC "io/analog/in/3"
            WITH SCALING_FACTOR "0.01"
            WITH DEADBAND "0.1"

Read discrete input/output points:

DEFINE ROUTE DiscreteIO WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
        WITH POLLING_MS '100'
    ADD MAPPING DiscreteInputs
        WITH EVERY 100 MILLISECONDS
        ADD TAG DI_Status1
            WITH ADDRESS "104.1.3.0"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "io/discrete/in/1"
        ADD TAG DI_Status2
            WITH ADDRESS "104.2.3.0"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "io/discrete/in/2"
        ADD TAG DO_Command1
            WITH ADDRESS "105.1.3.0"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "io/discrete/out/1"
        ADD TAG DO_Command2
            WITH ADDRESS "105.2.3.0"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "io/discrete/out/2"

Read assembly object data:

DEFINE ROUTE AssemblyData WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
        WITH POLLING_MS '250'
    ADD MAPPING InputAssembly
        WITH EVERY 250 MILLISECONDS
        ADD TAG InputAssembly100
            WITH ADDRESS "4.100.3.0"
            WITH DATA_TYPE "UINT32"
            WITH SOURCE_TOPIC "assembly/input/100"
            WITH PUBLISH_MODE "JSON"
        ADD TAG InputAssembly101
            WITH ADDRESS "4.101.3.0"
            WITH DATA_TYPE "UINT32"
            WITH SOURCE_TOPIC "assembly/input/101"
        ADD TAG OutputAssembly150
            WITH ADDRESS "4.150.3.0"
            WITH DATA_TYPE "UINT32"
            WITH SOURCE_TOPIC "assembly/output/150"

Different polling rates for different data:

DEFINE ROUTE MultiRateEIP WITH TYPE ETHERNETIP
    ADD ETHERNETIP_CONFIG
        WITH IP "192.168.1.100"
        WITH PORT '44818'
    
    ADD MAPPING FastData
        WITH EVERY 100 MILLISECONDS
        ADD TAG CriticalStatus
            WITH ADDRESS "104.1.3.0"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "fast/status"
        ADD TAG ProcessValue
            WITH ADDRESS "102.1.3.0"
            WITH DATA_TYPE "FLOAT32"
            WITH SOURCE_TOPIC "fast/pv"
    
    ADD MAPPING SlowData
        WITH EVERY 5 SECONDS
        ADD TAG DeviceStatus
            WITH ADDRESS "1.1.5.0"
            WITH DATA_TYPE "UINT16"
            WITH SOURCE_TOPIC "slow/device_status"
        ADD TAG DiagnosticCount
            WITH ADDRESS "1.1.8.0"
            WITH DATA_TYPE "UINT32"
            WITH SOURCE_TOPIC "slow/diagnostic"

CIP Object Reference

Identity Object (Class 1)

Attribute	Description	Data Type
1	Vendor ID	UINT16
2	Device Type	UINT16
3	Product Code	UINT16
4	Revision	UINT16[2]
5	Status	UINT16
6	Serial Number	UINT32
7	Product Name	STRING

Analog Input Point (Class 102)

Attribute	Description	Data Type
3	Value	FLOAT32/INT16
4	Status	UINT16
5	Scaling Minimum	FLOAT32
6	Scaling Maximum	FLOAT32

Discrete Input Point (Class 104)

Attribute	Description	Data Type
3	Value	BOOLEAN
4	Status	UINT16

Assembly Object (Class 4)

Attribute	Description	Data Type
3	Data	Variable
4	Size	UINT16

Troubleshooting

Connection Failed

Verify IP address is correct
Check firewall allows port 44818 (TCP and UDP)
Ensure device supports EtherNet/IP explicit messaging
Try increasing CONNECTION_TIMEOUT

CIP Path Error

Verify ClassID.InstanceID.AttributeID format
Check CIP object exists on device
Consult device documentation for valid paths
Instance usually starts at 1, not 0

Data Type Mismatch

Verify DATA_TYPE matches attribute definition
Check device documentation for correct types
Some devices use INT16 instead of FLOAT32 for analog

Timeout Errors

Increase READ_WRITE_TIMEOUT
Check network connectivity
Reduce polling rate if device is slow
Verify device is not overloaded with connections

Next Steps

Allen-Bradley

Tag-based access to Allen-Bradley PLCs.

FINS (Omron)

Connect to Omron PLCs.

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

EtherNet/IP Overview

Basic Syntax

Connection Configuration

ETHERNETIP_CONFIG Parameters

Connection Example

CIP Addressing

Common CIP Classes

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Complete Examples

CIP Object Reference

Troubleshooting

Next Steps

Allen-Bradley

FINS (Omron)

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

​EtherNet/IP Overview

​Basic Syntax

​Connection Configuration

​ETHERNETIP_CONFIG Parameters

​Connection Example

​CIP Addressing

​Common CIP Classes

​Data Types

​TAG Configuration

​Complete TAG Example

​TAG Parameters

​Complete Examples

​CIP Object Reference

​Troubleshooting

​Next Steps

Allen-Bradley

FINS (Omron)

EtherNet/IP Overview

Basic Syntax

Connection Configuration

ETHERNETIP_CONFIG Parameters

Connection Example

CIP Addressing

Common CIP Classes

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Complete Examples

CIP Object Reference

Troubleshooting

Next Steps