BACnet driver
troubleshooting
This content describes the features of the previous BACnet driver. For the most latest BACnet driver, see BACnet / IP driver - Version 3.
For BACnet driver troubleshooting, the following sections list common tasks and problems and a list of BACnet error codes.
The features and functions available in a node are controlled by the licenses that are installed in the node.
To verify that the BACnet driver license is installed:
- From the Workbench left pane, expand the node whose license you want to check, and then select the Administration icon.
- From the Administration window, select the Licenses tab.
- Select the appropriate license. Details of the license appear on the tab.
- View the Features column to identify the device driver.
If you do not see the correct license, or if the license is expired, you must request a license from your license key provider.
For information on how to install a license, refer to System Administration > Licenses.
The BACnet driver is not part of this node's installation. The BACnet driver is installed as a package separate from the base product installation.
You may be working with different levels of nodes, each with different levels of support for devices. Ensure that this node is the one with support for BACnet devices.
For information on how to add the BACnet driver package, refer to System Administration > Packages.
The BACnet device needs to be configured using the device’s configuration software. The complete description of this configuration is beyond the scope of this documentation. Ensure that the IP Address, Port, the Network ID and / or Device ID BACnet settings are correctly configured for your network setup and that they match the definitions in the device that represents the BACnet device.
The device has been located but the enumeration is taking a long time because of the large number of BACnet devices connected to the device and/or the large number of BACnet objects connected to each device. While it is performing the enumeration process, the state of the device will be Starting. Once the enumeration has completed the state will change to Started. A .csv file will be created for the device after the first time it successfully. This file will be used at subsequent device Starts to dramatically improve the amount of time needed to start a device.
The BACnet device was started and used the definition outlined in its .csv file located in the Staging directory. A connection won't be made with the device until the first attempt to read a variable. Read failures could indicate that the BACnet device defined in the .csv file is offline. The configuration of the BACnet device may also have changed. A read failure may also indicate that there are firewall restrictions that are preventing the communication to and from the node.
Start and Validation failures may indicate that there are firewall restrictions that are preventing the communication to and from the node. If this is not the case, verify the settings defined in the BACnet device definition match the hardware configuration settings for the physical BACnet device. You will need the hardware vendor's configuration software to gain access to the device. For example, the Johnson Controls Metasys browser based software package can be used to view the IP Address, Network ID, and the Device ID for every BACnet device accessible from the BACnet I/P network. This software can also be used to access BACnet devices connected via MS / TP to BACnet controllers. Often times a BACnet device has to be configured to allow access from external entities such as the BACnet driver.
This section describes the error codes that you might encounter when using deviceWISE and the BACnet driver. These error codes are available from the Devices window in the Extended Status column. The error codes may also be referenced in the Exceptions Log.
When the system experiences an abnormal condition (such as a device start failure, a read error from the BACnet Controller, or software error), an error code and extended error code are recorded in the Exceptions Log. In the Devices window, the Status column will always be a generic error code that can tell you if the error is a communication error, a data error, or some other internal device error. The Extended Status column provides the error code from the driver. These error codes can be basic deviceWISE error codes or specific to the BACnet driver.
The errors at times will be returned in two parts, the class code and the error code. The class code indicates the BACnet component in error, while the error code indicates the actual error condition.
| Class code | BACnet Component in Error |
|---|---|
| 0x00 | BACnet Device, such as a Thermostat |
| 0x01 | BACnet Object, such as a Temperature setting |
| 0x02 | BACnet Property, such as a description |
| 0x03 | BACnet Resources |
| 0x04 | BACnet Security |
| 0x05 | BACnet Services |
| Error Code | Error name |
|---|---|
| 1 | Authentication Failed. |
| 2 | Configuration in Progress |
| 3 | Device Busy |
| 4 | Dynamic Object Creation not Supported |
| 5 | File Access Denied |
| 6 | Incompatible Security Levels |
| 7 | Inconsistent Parameters |
| 8 | Inconsistent Selection Criteria |
| 9 | Invalid Data Type |
| 10 | Invalid Access Method |
| 11 | Invalid File Start Position |
| 12 | Invalid Operator Name |
| 13 | Invalid Parameter Data Type |
| 14 | Invalid Timestamp |
| 15 | Key Generation Error |
| 16 | Missing Required Parameter |
| 17 | No Objects of Specified Type |
| 18 | No Space for Object |
| 19 | No Space to add List Element |
| 20 | No Space to Write Property |
| 22 | Property is not a List |
| 23 | Object Definition Not Permitted |
| 24 | Object Identifier Already Exists |
| 25 | Operational Problem |
| 26 | Password Failure |
| 27 | Read Access Denied |
| 28 | Security Not Supported |
| 29 | Service Request Denied |
| 30 | Request Timeout |
| 31 | Unknown Object Requested |
| 32 | Unknown Property Requested |
| 36 | Unsupported Object Type |
| 37 | Value Out Of Range |
| 41 | Character Set Not Configured |
| 42 | Invalid Array Index |