# Receiving values from EtherNet/IP

In this example we'll configure Clarity Gateway to receive a value from an EtherNet/IP tag, and drive an Iron Pi digital output with that value.

## Bulk mapping via the channels table

In the page for your EtherNet/IP connection, scroll down to the **Channels From EtherNet/IP** section. Click the **Show Detected** switch if it is not already on:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-cc9ac8c1a5c9fb6c62111c20a3e86f2695b8e8f7%2Flocalhost_50000_connections_10%20\(1\).png?alt=media)

All detected tags from EtherNet/IP will then appear in the table. In this example we'll be mapping the EtherNet/IP tag **Bool Tag 1** to the system tag **channel1**, which is configured as a digital output.

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-c1ebb942dfcd3346ffda0fc4fea1d153ea6b3f0f%2Flocalhost_50000_connections_10%20\(2\).png?alt=media)

First check the **Enabled** checkbox to enable this mapping:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-4ae9f3dd2d32001923aa60a931933dbd9dd9b820%2Flocalhost_50000_connections_10%20\(5\).png?alt=media)

Then enter the **System Tag** to send values to. In this example we'll use **channel1:**

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-e34057ef00a332ec50483e69a74d59de162d6d88%2Flocalhost_50000_connections_10%20\(6\).png?alt=media)

Finally, click **Save:**

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-8bc5afb359d8e7fbed13797750ca34c1706acdce%2Flocalhost_50000_connections_10%20\(7\).png?alt=media)

Once the mapping is applied, the arrow should change color from gray to blue to indicate that the mapping is active (the row may move to a different position)asdfa:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-cda34ca6a89ee3e94e6a2d7f9bdc3b8141cebe98%2Flocalhost_50000_connections_10%20\(8\).png?alt=media)

## Advanced mapping

For more options when mapping a channel, click the `+` icon in the **Channels To MQTT** section:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-7029b599fae96cfe7a1161e608619bbb47a0080a%2Flocalhost_50000_connections_8%20\(3\).png?alt=media)

This will take you to a separate **Create Channel** page. In that page, first enter the Clarity Gateway **System Tag** you would like to send to MQTT. In this example, we'll be using **channel1**, which is configured as a Local I/O analog input:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-ce870eb97415f70f30319f711956b6f3793c67fe%2Flocalhost_50000_connections_8%20\(4\).png?alt=media)

Optionally, you can enter a **Slope** and **Offset** to transform the values that get sent to MQTT. In this example we will enter **2** and **3**:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-ead1239836ca856935e35c7d5f182045523a4058%2Flocalhost_50000_connections_8%20\(6\).png?alt=media)

Finally, enter the **MQTT Tag** to send to and **Data Type** to use. In this example, we'll send values to **localio/channel1** as **Float**s:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-86420dbe6a98f48dfc010bdaa51dc13b46d36b4c%2Flocalhost_50000_connections_8%20\(7\).png?alt=media)

Finally, click **Save** to create the channel:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-5a9d55f05b336e569cb45e70e517681f5b034edf%2Flocalhost_50000_connections_8%20\(8\).png?alt=media)

Once the channel has been created, you will return to the connection page. The new channel should appear in the **Channels To MQTT** table. Notice how the system value is 9.68, and the value sent to MQTT is 2 \* 9.68 + 3 = 22.2:

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-3b1377dd87d66b026f4c57c26870115810b7cd66%2Flocalhost_50000_connections_8%20\(11\).png?alt=media)

### Read / Write Channels

If you have a channel that comes from the device but occasionally needs to be set by a user or software action, you can make that From EtherNet/IP channel settable. Channels marked settable will still be read from the device on every scan cycle, and will be written to the device only when a user or software set action happens.

{% hint style="info" %}
Read / Write EtherNet/IP channels are available in Clarity Gateway version 5.6.0 and higher.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jcore.io/clarity-gateway/connections/ethernet-ip/receiving-values-from-ethernet-ip.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.