Creating an EtherNet/IP Device

After creating a device with the EtherNet/IP protocol, you'll land on its Configuration tab. This is where you provide the connection details Koios needs to communicate with your EtherNet/IP device.

Koios supports two types of EtherNet/IP devices:

Common Configuration Fields

These fields apply to both Logix and Generic CIP devices.

Hostname

The IP address or hostname of the EtherNet/IP device.

• Required
• Example: 192.168.1.100

Device Type

Select the type of EtherNet/IP device you're connecting to. This determines which additional fields are shown and how Koios communicates with the device.

• Required

Timeout (seconds)

How long Koios waits for the device to respond before giving up.

• Default: 3 seconds
• Minimum: 1 second
• Maximum: 300 seconds (5 minutes)

EtherNet/IP connections are typically fast on local networks. The default of 3 seconds provides a comfortable margin. Increase it only if the device is behind a slow network link or VPN.

Logix Controller Configuration

These fields appear when the device type is set to Logix Controller.

Controller Slot

The slot number of the controller in the chassis.

• Default: 0
• Minimum: 0
• Maximum: 30

Generic CIP Configuration

These fields appear when the device type is set to Generic CIP.

EDS File (Optional)

Upload an Electronic Data Sheet (EDS) file for the device. EDS files describe a device's assemblies and data fields in a standardized format defined by ODVA.

When an EDS file is uploaded, the tag browser can display a structured view of the device's assemblies and fields, making it easy to select data points when creating tags. Without an EDS file, you can still create tags manually by entering the assembly instance, byte offset, and data type.

After Configuration

Once you've filled in the connection settings:

1. Save the configuration
2. Test the connection — click the

   Test

   button to verify Koios can reach the device
3. Add tags — browse the device to find and add data points (see Creating an EtherNet/IP Tag)
4. Enable the device — flip the enable switch to start scanning

Browsing Device Data Points

Both EtherNet/IP device types include a device browser for discovering available data points. The browser experience differs based on the device type.

Logix Tag Browser

For Logix controllers, the tag browser reads the controller's tag database directly. Instead of manually entering tag names, you can explore the controller's tags, view their types and values, and select the ones you need.

The browser supports:

• Hierarchical navigation — drill into programs, UDTs (User-Defined Types), structures, and arrays
• Scope selection — toggle between controller-scoped and program-scoped tags
• Search and filter — find tags by name or filter by type (Structure, Array, Atomic, Array Item)
• Tag details — view data type, dimensions, path, and metadata for any tag
• One-click selection — select a tag to auto-populate the tag configuration form

Generic CIP EDS Browser

For Generic CIP devices with an EDS file uploaded, the browser parses the EDS file and displays a structured view of the device's data layout.

The browser shows:

• Assemblies — each assembly instance with its name and total size in bytes
• Fields — individual data fields within each assembly, including name, byte offset, data type, and size
• Multi-select — select multiple fields to create several tags at once
• Field details — view the exact byte offset, data type, and struct format for each field

See Creating an EtherNet/IP Tag for details on configuring tags for both device types.