Pi bacnet Interface

Error and Informational Messages

A string NameID is pre-pended to error messages written to the message log. Name is a non-configurable identifier that is no longer than 9 characters. ID is a configurable identifier that is no longer than 9 characters and is specified using the /id parameter on the startup command-line.

Message Logs

The location of the message log depends upon the platform on which the interface is running. See the UniInt Interface User Manual for more information.

Messages are written to PIHOME\dat\pipc.log at the following times.

• 
  When the interface starts many informational messages are written to the log. These include the version of the interface, the version of UniInt, the command line parameters used, and the number of points.
  
• 
  As the interface retrieves points, messages are sent to the log if there are any problems with the configuration of the points.
  

If the /db is used on the command-line, then various informational messages are written to the log file.

Error Messages

Tag and Interface Configuration Errors

Message	"BACnet Point Info must be specified in the InstrumentTag."
Meaning	This message is written when the InstrumentTag attribute is empty for a tag. The tag will receive a "Configure" digital state.
Message	"/DeviceIP (or /ObjectID or /ObjectType or /ObjectProperty) not found."
Meaning	This message is written when the specific parameter is not found in the InstrumentTag attribute of a tag. The tag will receive a "Configure" digital state. Verify there is no space around the "=" sign..

Message	"BACnet Router ID Must Be Greater Than 0."
Meaning	. This message is written when the /RouterDeviceID parameter in InstrumentTag is less or equal to zero. The tag will receive a "Configure" digital state
Message	"BACnet Device ID Must Be Greater Than 0."
Meaning	This message is written when the sub device ID behind the router is less or equal to zero in InstrumentTag. The tag will receive a "Configure" digital state.
Message	"BACnet Router was specified without a Target Device ID."
Meaning	This message is written when the sub device ID is not specified for a router in InstrumentTag. The tag will receive a "Configure" digital state.
Message	"BACnet Target DeviceID Specified Without a BACnet Router DeviceID."
Meaning	This message is written when a sub device ID is found without a router in InstrumentTag. The tag will receive a "Configure" digital state.
Message	"Invalid interface /ID parameter in startup command file."
Meaning	." This message is written when the /ID parameter is not found in the interface startup file.

Timeout Error

Message

"BACnet Device IO Timeout: Reconnection To Device Attempted."

Meaning

This message is written when the interface has not received data for any tag for at least the amount of time specified by the /IOTimeout parameter. It is usually caused by network disruption between the interface node and the device. It can also happen if there are only COV tags and the change of values have not exceeded the COV Increment passing the IO Timeout period. To avoid such condition, it is recommended to configure at least one polled tag with a scan interval less than the /IOTimeout value.

Communication Errors

Message	"Error initializing local BACnet port."
Meaning	This message is written when the interface cannot establish a local UDP port to listen on. It should be followed by a Winsock error message explaining the nature of the error. A common cause is that there is another BACnet interface instance already running on this machine, or the BACnet Query Tool is currently sending query requests. The Winsock error for such case is [10048]: Only one usage of each socket address (protocol/network address/port) is normally permitted.
Message	"PI BACnet Interface will shutdown because global IOCP communications could not initialize."
Meaning	This message is written after the above error message indicating the interface shutdown
Message	"Communication Error: Communication Failure on "
Meaning	This message is written when the interface loses communication from the device.

BACnet Protocol Errors

Message	"Error Building Read Property (Network) Request Packet For Object Type:<> ObjectID:<> PropertyID:<>"
Meaning	This message is written when an exception is thrown while the interface is building data request packet to be sent to the device. It should not happen under normal circumstances.
Message	"Error Building COV Subscription Request Packet For Object Type:<> ObjectID:<> PropertyID:<>"
Meaning	This message is written when an exception is thrown while the interface is building COV subscription request packet to be sent to the device. It should not happen under normal circumstances.
Message	"BACnet error packet received. Error Code: <>. Error Desc:<>. InvokeID:<>"
Meaning	This message is written when the interface receives an error response packet from the device. Some common errors are:
Message	Error Code: 31. Error Desc: Unknown Object.
Meaning	The device cannot find the combination of ObjectID/ObjectType/ObjectTag for a certain ReadProperty request. This is usually caused by incorrect InstrumentTag configuration for a polled tag. To verify which tag has caused the error, set /BACnetDBG=0x08 to log ReadProperty requests sent to the device, and restart the interface. Locate the closest debug message prior to the error message that contains the same InvokeID. The tag name can be found in the debug message.
Message	Error Code: 43. Error Desc: Cov Subscription Failed.
Meaning	The device cannot find the combination of ObjectID/ObjectType/ObjectTag for a certain COV subscription request. This is usually caused by incorrect InstrumentTag configuration for a COV tag. There is no direct way to locate the problematic COV tag because of a different algorithm for COV InvokeID generation. The user can temporarily change all COV tags to polled tags and use the previous debugging method to identify the problem.
Message	"Received network layer message is not recognized."
Meaning	This message is written when the interface receives a non-standard network layer message response from the device. It should not happen under normal circumstances.
Message	"Response from device is not a BACnet packet."
Meaning	This message is written when the interface receives a device response that does not contain the BACnet message header. It should not happen under normal circumstances.
Message	"Error Parsing BACnet Return Packet."
Meaning	This message is written when an exception is thrown while the interface is parsing the device response packet. It should not happen under normal circumstances.