# Add a Modbus Device

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

To successfully add your Modbus TCP devices into Motion, make sure:

* You've already activated a Motion Hub with which you want to associate your BACnet device
* The Motion Hub and the BACnet device are connected to the same local area network and the network is not blocking communication between the Motion Hub and the BACnet device

## Adding a Modbus TCP Device <a href="#adding_a_modbus_tcp_device" id="adding_a_modbus_tcp_device"></a>

Every Modbus TCP Device will need to be manually entered.  Every Modbus TCP device requires an IP Address and a Slave ID, and in the steps below we will instruct users on how to do this.

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

| Steps                                                                                      | Screenshots                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| From anywhere in the Motion Platform, click "Controls" on the left-hand side vertical menu | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FMAY2Zc1utjuaApkxHdHr%2Fimage.png?alt=media\&token=9f842b14-23e9-472b-b4ee-ac1fd8e604ef)                                          |
| Under the Controls menu, click "Devices"                                                   | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FlVNacrVeIDE2G9m0teOs%2Fimage.png?alt=media\&token=4fac13b0-a7a1-4191-b6a4-e27c64bff08e)                                          |
| Click "Add Devices" tab                                                                    | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FM44KPSbu3KksySkSTOxa%2FScreen%20Shot%202022-10-13%20at%204.37.14%20PM.png?alt=media\&token=7c78f1c9-eac1-442d-b34b-1cb1820bde4c) |

### **Step 2**: Navigate to "Add Device Manually" view <a href="#step_2-_navigate_to_-add_device_manually-_view" id="step_2-_navigate_to_-add_device_manually-_view"></a>

| Steps                                                                       | Screenshots                                                                                                                                                                                                         |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click on the "Manual Entry" option, located inside of the Modbus TCP window | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FUk95cdoMryTcZIRw7oZt%2Fimage.png?alt=media\&token=0d94ce1e-7570-45d8-8c35-35bd430c9db8) |

### **Step 3**: Input Modbus TCP device details <a href="#step_3-_input_modbus_tcp_device_details" id="step_3-_input_modbus_tcp_device_details"></a>

You are now in the "Add Device Manually" view for a Modbus TCP device.  You will now input the following information in the following sections:

1. Motion Hub
2. Name
3. Local IP Address
4. Protocol
5. Modbus Slave ID
6. Save/Revert

| Inputs                                                                                                                                                                                                                                                                                          | Screenshots                                                                                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <h4 id="motion_hub">Motion Hub</h4><p>Select the Motion Hub associated with the device to be added.</p><p></p><p>Click on the Motion Hub section to view the pop-up menu of connected Motion hubs </p><p></p><p>Search for or click on the preferred Motion Hub that will read this device </p> | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FsrbmTkbJZCaPVW2gM7y4%2Fimage.png?alt=media\&token=c73a98cd-2013-4e80-90d7-5c630fc707c6) |
| <h4 id="name">Name</h4><p>Give your new device a name that will make it easily identifiable on the platform </p><p><br>Input the desired name in the section below</p>                                                                                                                          | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FFDvc6GZVsKSJ6TMW3hI6%2Fimage.png?alt=media\&token=5663a877-ec79-4747-99d6-1f42088979d2) |
| <h4 id="local_ip_address">Local IP Address</h4><p>Locate the Local IP address provided by the device manufacturer. </p><p><br>Input the Local IP address in the appropriate section  </p>                                                                                                       | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FtQGbAhOjG8Rgc1vqANO1%2Fimage.png?alt=media\&token=71a1fa79-1abf-4819-b313-a72d5e721561) |
| <h4 id="protocol">Protocol</h4><p>Make sure the protocol name reads "Modbus TCP".</p><p><br>If not, click on this section and choose "Modbus TCP"</p>                                                                                                                                           | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FQJwvnyvSNoqumRJiqvOa%2Fimage.png?alt=media\&token=79998e17-dfe6-4546-bfe2-fdfa55123c88) |
| <h4 id="modbus_slave_id">Modbus Slave ID</h4><p>Locate the Modbus Slave ID which will be provided by the device manufacturer in the user manual.</p><p><br>Input the Modbus Slave ID in the section below</p>                                                                                   | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FYEvcmDaSb3avIbLm2ViT%2Fimage.png?alt=media\&token=dc60ab8b-0d08-4443-aae3-e5ed382da273) |
| <h4 id="save-revert">Save/Revert</h4><p>Make sure everything is correct, and click the "Save" button</p>                                                                                                                                                                                        | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FI1gsX0PfvMzkL69d1ElW%2Fimage.png?alt=media\&token=7e5263ad-1ed1-454c-985e-7e09656c9ddd) |

<br>