# Configuring Modbus TCP Points (and creating Modbus Tiles)

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

Before attempting to configure Modbus TCP points, make sure:

1. You've already [added your Modbus device](https://kb.motion.cloud/motion-platform-software/devices/add-a-modbus-device) to Motion
2. The device you added supports Modbus TCP
3. The Modbus device is connected to the same local area network as the Motion Hub with which it is associated

## Configure Modbus TCP Points <a href="#configure_modbus_tcp_points" id="configure_modbus_tcp_points"></a>

Follow these steps to initiate point discovery:

### **Step 1**: Navigate to "Devices" view <a href="#step_1-_navigate_to_-devices-_view" id="step_1-_navigate_to_-devices-_view"></a>

Follow these steps to initiate point discovery:

| Steps                                                                                              | Screenshots                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left side vertical menu *(Figure 1)* | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FuWi16nJGk50aO5xW3aO9%2Fimage.png?alt=media\&token=86e3f667-7234-49eb-a52a-869e2b2b9045) |
| Under the "Controls" drop down menu, select the "Devices" option                                   | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FjWS99WUoL5ULBGdNwlZQ%2Fimage.png?alt=media\&token=d5940423-36b9-464d-93b7-6688f944d2f4) |

### **Step 2**: Identify Modbus device to configure points on the device <a href="#step_2-_identify_modbus_device_to_configure_points_on_the_device" id="step_2-_identify_modbus_device_to_configure_points_on_the_device"></a>

| Steps                                                                                                                                                          | Screenshots                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| In the "Devices" view, quickly identify the Modbus devices that have been added to Motion by simply typing "Modbus" in the search bar                          | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2F7KIsCQJ4fGEFd0O290lM%2Fimage.png?alt=media\&token=29412ee0-1414-4060-bbfe-bb90646b50e2) |
| Now, identify the correct Device Name for which you would like to configure points for (far left column in dashboard), and click the "Configure Points" button | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FzObY1qm3BPQqIiUQ4Bi2%2Fimage.png?alt=media\&token=2eda4a04-54ea-41af-8e00-12513a9fd29d) |

### **Step 3:** Add Modbus TCP point <a href="#step_3-_add_modbus_tcp_point" id="step_3-_add_modbus_tcp_point"></a>

In the "Point Configuration" view, you will see two windows:

1. Point Configuration
2. Known Points

#### Point Configuration <a href="#point_configuration" id="point_configuration"></a>

This window shows the specific Modbus TCP device you are accounting for.  Make sure the device is correct.  If not, you can choose another Modbus TCP device from the dropdown menu.

#### Known Points <a href="#known_points" id="known_points"></a>

This window displays every point that has been configured on this device and added to Motion. &#x20;

It also contains a green "Add Point" button that will allow you to add additional Modbus points.

| Steps                                               | Screenshots                                                                                                                                                                                                         |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| To add a Modbus point, click the "Add Point" button | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FR6gN1fqe2PPLq3eqjkTd%2Fimage.png?alt=media\&token=56bf6e3b-93b0-477e-a6fd-69b8a2312c1f) |

### **Step 4:** Configure Modbus TCP point <a href="#step_4-_configure_modbus_tcp_point" id="step_4-_configure_modbus_tcp_point"></a>

After clicking "Add Point", you will be directed to the "Configure Point" view.  In this view, you will input/select details about that point inside the following sections:

1. Name&#x20;
2. Address *(Manufacturer Manual Specification)*
3. Data Type&#x20;
4. Functions *(Manufacturer Manual Specification)*
5. Byte Order *(Manufacturer Manual Specification)*

| Inputs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Screenshots                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <h4 id="name">Name</h4><p>Give the point a name that you will use to identify it.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FxFUqPqFWp10PY3oEmwWG%2Fimage.png?alt=media\&token=41383539-99ea-404b-b85e-1e149d5d01c7) |
| <h4 id="address">Address</h4><p>Refer to the manufacturer's manual specifications to identify the desired point's address.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                     | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FMnVRFwlA9SixoZEhleLv%2Fimage.png?alt=media\&token=6c70caec-6da2-4fba-9d87-acddabd81dfb) |
| <h4 id="functions">Functions</h4><p>Motion supports both "Read-Only" and "Read/Write" points.  Refer to the manufacturer's manual specifications to determine if the desired point is "Read-Only" or "Read/Write."<br><br>Click the drop down menu to select the correct point function</p>                                                                                                                                                                                                                                                                        | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FV735XTxikK7AIDyi7Aq6%2Fimage.png?alt=media\&token=e82417ae-eb09-4e84-bb17-0704a70e47d9) |
| <h4 id="data_type_">Data Type </h4><p>As of now, Motion supports 16-bit value data type.  Additional data types are coming soon.  The correct data type, by default, will be determined by the point's function that you identified and selected above. Therefore, no action is needed here. <br><br>If the function is "Read-Only", the default data type will be "16-bit Integer" (also referred to as "Input Register") <br></p><p>If the function is "Read/Write", the default data type will be "16-bit Integer" (also referred to as "Holding Register")</p> |                                                                                                                                                                                                                     |
| <h4 id="byte_order">Byte Order</h4><p>(insert description)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FA1I8ZUdgu8cZaMMiAmh9%2Fimage.png?alt=media\&token=7c8ac3f3-b9c7-4134-a6cc-8038874fca7a) |

### **Step 5:** Save configuration details <a href="#step_5-_save_configuration_details" id="step_5-_save_configuration_details"></a>

| Steps                                                                                   | Screenshots                                                                                                                                                                                                         |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Confirm all Modbus point configuration options are correct, and click the "Save" button | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FL891vrVpGH4qsLmCekuC%2Fimage.png?alt=media\&token=1780eea9-3a4b-4901-8c7f-52f5589e91be) |


---

# 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://kb.motion.cloud/motion-platform-software/tiles/creating-point-based-tiles/configuring-modbus-tcp-points-and-creating-modbus-tiles.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.
