# Add a BACnet Device

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

To successfully add your BACnet 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

## Two Methods to Add a BACnet Device <a href="#two_methods_to_add_a_bacnet_device" id="two_methods_to_add_a_bacnet_device"></a>

There are two methods to add a BACnet device to Motion:

1. BACnet device discovery
2. Manual device entry

Both methods are described next. To access these methods, you must first navigate to "Add Devices" (described next).

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

| Steps                                                                                 | Screenshots                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left side vertical menu | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FvW89w6xqMnf3uJVpnWSN%2Fimage.png?alt=media\&token=0cb85634-d340-4b9d-be03-ae58ab466ffb) |
| Under the Controls menu, click "Devices" on the left side vertical menu               | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FzGczV3AiQg4wft2WywVc%2Fimage.png?alt=media\&token=67e18ffd-1fa2-4208-8cfe-3f989407e309) |
| Click on "Add Devices"                                                                | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2F4Z3atXLKeTahDTfWBDFn%2Fimage.png?alt=media\&token=576acf7d-8356-46f8-9624-b7d269f2e4b6) |

### **Step 2**: Choose a method for adding your BACnet device <a href="#step_2-_choose_a_method_for_adding_your_bacnet_device" id="step_2-_choose_a_method_for_adding_your_bacnet_device"></a>

You can add BACnet devices by clicking one of the two options.  View below:&#x20;

| BACnet Options                                                                                       | Screenshots                                                                                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ol><li>Discover Devices <em>(Lime Green Box)</em></li><li>Manual Entry <em>(Red Box)</em></li></ol> | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FMdPKnQwmeGVlPpHV6lR9%2Fimage.png?alt=media\&token=f0a1ccf0-82b5-4e2f-bbec-1031e9f29c69) |

### **Step 3a**: Discover Devices <a href="#step_3a-_discover_devices" id="step_3a-_discover_devices"></a>

In this view, you will search and select the desired Motion Hub to discover devices. You will then select the time needed to discover that device. The "Device Discovery" view is broken down into three sections:

1. Motion Hub
2. Timeout
3. Start Discovery / Abort

#### Motion Hub <a href="#motion_hub" id="motion_hub"></a>

| Steps                                                                                                                                                                                       | Screenshots                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Search and/or select a Motion Hub connected to the same network as the BACnet/IP devices you want to find via device discovery <br><br>Click the drop menu in the Motion Hub section</p> | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2Fd0lag94DkXYacitTaqPz%2Fimage.png?alt=media\&token=8f883133-e424-4b6d-b62e-95595f42c1e8) |
| Search for and/or click the desired Motion Hub that appears in the pop-up menu                                                                                                              | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FJ5BBLwqJkoijGLfWrprj%2Fimage.png?alt=media\&token=7519d084-3ddd-42df-9b60-4486ce1b830c) |

#### Timeout <a href="#timeout" id="timeout"></a>

The timeout setting defines the amount of time before the Motion Hub will stop waiting for a response from BACnet/IP devices when attempting the device discovery. Some devices require more time than others to respond, due to factors such as device age and link speed.

| Steps                                                            | Screenshots                                                                                                                                                                                                         |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click the appropriate timeout setting to accommodate those cases | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FXNOxA7nkfHBQ6DuCZHcr%2Fimage.png?alt=media\&token=16b3bcfa-a0c3-46fb-bc0d-89c31fdfa491) |

#### Start Discovery <a href="#start_discovery" id="start_discovery"></a>

When the above settings have been selected, you are ready to discover devices on the active Motion Hub.

| Steps                   | Screenshots                                                                                                                                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click "Start Discovery" | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FKZWPLmo3hyDoPEdTnFmx%2Fimage.png?alt=media\&token=69790087-eb45-4e05-9160-e38aad815957) |

### **Step 3b**: Add Device Manually <a href="#step_3b-_add_device_manually" id="step_3b-_add_device_manually"></a>

In this view, users can add a device manually in the event that the Motion Hub is not identifying the device.  This view is broken down into seven sections which you will input device details into:

1. Motion Hub
2. Name
3. Local IP Address
4. Protocol
5. BACnet Instance ID
6. BACnet MS/TP Network Number (optional)
7. BACnet MS/TP MAC Address (optional)

| Manual Entry Inputs                                                                                                                                                                                                                                                                                     | Screenshots                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <h4 id="motion_hub_1">Motion Hub</h4><p>Search and/or select a Motion Hub connected to the same network as the BACnet/IP devices you want to find via device discovery </p><p><br>Click the "Motion Hub" Menu to select the desired Motion Hub </p>                                                     | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2F5GVv8dUS4CtrksDK3ADX%2Fimage.png?alt=media\&token=164991b0-dd7d-45f2-b6c9-d0346819c826) |
| <h4 id="name">Name</h4><p>Give your new device a name that will make it easily identifiable throughout Motion platform.</p><p><br>Type the Name in the appropriate section</p>                                                                                                                          | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FjaK4hFo3QqEm9VYM1RBD%2Fimage.png?alt=media\&token=fb0a63f0-1290-4f6b-9a4b-2ab7b0ece5a8) |
| <h4 id="local_ip_address">Local IP Address</h4><p>Input the correct local IP Address inside of this section</p>                                                                                                                                                                                         | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2F4BlkLfySjAJF31DfCgGx%2Fimage.png?alt=media\&token=3d77e567-5b61-4590-916a-d99da3696d3c) |
| <h4 id="protocol">Protocol</h4><p>For BACnet/IP, this will always be a default option.</p><p><br>No action is required in this section</p>                                                                                                                                                              | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FfPwTC3QtTpRp4DAAuNyX%2Fimage.png?alt=media\&token=9bc3a495-8cc9-4056-92fc-3a7eb41258ca) |
| <h4 id="bacnet_instance_id">BACnet Instance ID</h4><p>Type in the BACnet Instance ID below</p>                                                                                                                                                                                                          | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FcccStHTMeK8NQoLhquXH%2Fimage.png?alt=media\&token=867ffabe-5c44-4e28-acca-86f06a54a778) |
| <h4 id="bacnet_ms-tp_network_number_-optional">BACnet MS/TP Network Number (if applicable)</h4><p>This is only required for MS/TP devices bridged to an IP network with a BACnet router. If provided, a MAC address is required.</p><p><br>If applicable, type the MAC address the in section below</p> | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2Fv0tejo0GLvXZOXBcwXi4%2Fimage.png?alt=media\&token=3cdf998e-4e3c-4154-92b7-65d8fce8d616) |
| <h4 id="bacnet_ms-tp_mac_address_-optional">BACnet MS/TP MAC Address (if applicable)</h4><p>This is only required for MS/TP devices bridged to an IP network with a BACnet router. If provided, a network number is required.</p><p><br>If applicable, type the network number in the section below</p> | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FjOCF2hleuXt0nFFxTKyb%2Fimage.png?alt=media\&token=4789f8a8-2f7a-4a18-bd33-8bbcadc96f86) |
| <h4 id="save-revert">Save/Revert</h4><p>Make sure to double check all information that been manually entered is correct.  <br><br>Then click "Save"</p>                                                                                                                                                 | ![](https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FfqibTHGFn9At2slUsPMB%2Fimage.png?alt=media\&token=514aba9e-6f61-48e7-b0cf-149330a9c48a) |

<br>
