# 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 | ![](/files/2oajktlndsC64xGYFdFc) |
| Under the Controls menu, click "Devices" on the left side vertical menu               | ![](/files/cUbMJKWU00VDN4FPLxs3) |
| Click on "Add Devices"                                                                | ![](/files/K2qlWiH3hXkaVOKRQkmE) |

### **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> | ![](/files/g6HGUWtu0oqtpX7OWUKo) |

### **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> | ![](/files/0fzieF7zrTil1ordQQS1) |
| Search for and/or click the desired Motion Hub that appears in the pop-up menu                                                                                                              | ![](/files/0VB43XDnTjWhhM1XFWvd) |

#### 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 | ![](/files/nfwfH3YTWhbmYI1PdklX) |

#### 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" | ![](/files/aL7eDB0tRy3cbgFau7ZN) |

### **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>                                                     | ![](/files/R9Vch2lR8JaZuabXKf7G) |
| <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>                                                                                                                          | ![](/files/jBTJ2hE2AXBPbl9822jl) |
| <h4 id="local_ip_address">Local IP Address</h4><p>Input the correct local IP Address inside of this section</p>                                                                                                                                                                                         | ![](/files/6PMPmDDe9gHkJ6HZsSJ2) |
| <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>                                                                                                                                                              | ![](/files/p1pNOeLCJ76qdGE8cgdV) |
| <h4 id="bacnet_instance_id">BACnet Instance ID</h4><p>Type in the BACnet Instance ID below</p>                                                                                                                                                                                                          | ![](/files/uvM8PpmztdZpcOzafjIJ) |
| <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> | ![](/files/IF1HKGR9kvKzhXdo6mc8) |
| <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> | ![](/files/3zUayZNn0b0rOOAIbmww) |
| <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>                                                                                                                                                 | ![](/files/B5NK0gXTLKsYlWnsJ7f0) |

<br>


---

# 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/devices/add-a-bacnet-device.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.
