BacnetIP
Review the following information for setting up and configuring the BacnetIP device.
Compatibility parameter | Compatible items |
|---|---|
Driver type | Ethernet |
Validated devices/series | BACnet/IP devices |
- You will need to open UDP port 47808 on your firewall to successfully browse tags.
- If you are using the Docker version of Litmus Edge:
- You will need to use the --net=host option in the Docker run command for the Asset Discovery Tool to successfully work.
- When using the Asset Discovery Tool, you will need to use the IP address 0.0.0.0. You can't use the IP address of the host machine.
- If the --net=host option is not enabled:
- Device Discovery will not work.
- Browse tags will not work unless you map 47808:47808/UDP.
To set up and configure this device in Litmus Edge, you will need to do the following:
- Step 1: Set up and Configure the PLC Device
- Step 2: Set up the PLC Device in Litmus Edge DeviceHub
- Step 3: Configure the List of Registers
Important: When setting up the PLC device, the BACnet driver and your Litmus Edge instance must be on the same subnet. If they aren't on the same subnet, the BACnet driver won't be able to connect to Litmus Edge.
To find the network parameters of the driver, you have the option of using the Device Discovery Tool. Otherwise, set up the device for Ethernet access and collect the network parameters.
To use the device discovery tool:
- Navigate to DeviceHub > Devices.
Click the Connect a Device box. The Connect Device dialog box appears.
Connect a Device box- Click the Device Type drop-down list and select BACnet.
- Click the Driver Name drop-down list, and select BacnetIP.
Click Device Discovery. The Device Discovery dialog box appears.
Device Discovery option- In the Network address field, open the drop-down list and select the appropriate ethernet port. The available options are based on the interfaces configured in Litmus Edge. To review interfaces, navigate to System > Network > Interfaces.
- In the Retry count field, review the default value (5) and update it if needed. This configures the number of times Litmus Edge will attempt to discover devices.
- In the Timeout field, review the default value (2) and update it if needed.
- Click Start discovery. When the search is complete, available devices will be listed with the following parameters:
- Device ID
- IP address
- Port
- Click the appropriate device, and then click Update form with discovery results. The Connect Device dialog box appears with Network Address, Network Port, and Target Device ID pre-filled based on the discovery results.
- Move onto Step 2 and continue configuring the device with the remaining parameters.
Parameter | Value |
|---|---|
Type | BACnet |
Driver | BacnetIP |
Network Address | The device address you defined in Step 1 |
Port | 47808 |
Target Device ID | The Object ID of the device |
Instance Device ID | If the default value of 0 is configured, then a random instance ID will be generated. This ID must be unique. |
Note: When browsing for tags, only tags with the property of Present_Value will be identified.
Name | Value Types | Access Types | Address Format | Min Address | Max Address | Description |
|---|---|---|---|---|---|---|
AI | float32 | R/W | | 0 | 2147483647 | Analog input |
AO | float32 | R/W | | 0 | 2147483647 | Analog output |
AV | float32 | R/W | | 0 | 2147483647 | Analog value |
BI | uint32, bool | R/W | | 0 | 2147483647 | Binary input |
BO | uint32, bool | R/W | | 0 | 2147483647 | Binary output |
BV | uint32, bool | R/W | | 0 | 2147483647 | Binary value |
MSI | int32 | R/W | | 0 | 2147483647 | Multi state input |
MSO | int32 | R/W | | 0 | 2147483647 | Multi state output |
MSV | int32 | R/W | | 0 | 2147483647 | Multi state value |
SCH | float32 | R/W | | 0 | 2147483647 | Schedule |
LFSP | uint32 | R/W | | 0 | 2147483647 | Life safety point |
LOCTL | float32 | R/W | | 0 | 2147483647 | Local control |
OCTSTR | octet_string | R/W | | 0 | 2147483647 | Octet string |
PINT | uint32 | R/W | | 0 | 2147483647 | Positive integer |
CHV | string | R/W | | 0 | 2147483647 | Object character string value |
F | octet_string | R/W | | 0 | 2147483647 | File object |
PROPRIETARY | bool, int32, uint32, float32, float64, string, octet_string | R/W | | 0 | 2147483647 | Proprietary |