---
title: "Creating an EtherNet/IP Device"
description: "Configure a connection to an EtherNet/IP Logix controller or Generic CIP device"
source_url: https://ai-ops.com/docs/devices/creating-ethernet-ip
---

# Creating an EtherNet/IP Device

After [creating a device](https://ai-ops.com/docs/devices/creating-getting-started.md) 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:

| Type | Use Case |
|------|----------|
| **Logix Controller** | Allen-Bradley ControlLogix and CompactLogix controllers. Tags are accessed by name. |
| **Generic CIP** | Any CIP-compliant device — variable frequency drives, I/O modules, non-Allen-Bradley equipment. Data is accessed by assembly instance and byte offset. |

## 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.

| Type | Description |
|------|-------------|
| **Logix Controller** | Allen-Bradley ControlLogix or CompactLogix controllers |
| **Generic CIP** | Any CIP-compliant EtherNet/IP 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

> [!TIP] Finding the controller slot
> In most configurations, the controller is in slot **0** (the leftmost slot in the chassis). If your controller is in a different slot, check the chassis configuration in RSLogix 5000 / Studio 5000 or look at the physical slot position.

## 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.

> [!TIP] Where to find EDS files
> EDS files are typically available from the device manufacturer's website or included with configuration software. They have a `.eds` file extension.

## 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](https://ai-ops.com/docs/tags/creating-ethernet-ip.md))
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

> [!NOTE] EDS browsing works offline
> Unlike the Logix tag browser, the Generic CIP browser reads from the uploaded EDS file — it does not connect to the device. The device does not need to be powered on to browse its EDS.

See [Creating an EtherNet/IP Tag](https://ai-ops.com/docs/tags/creating-ethernet-ip.md) for details on configuring tags for both device types.