Data source parameters
- Last UpdatedFeb 20, 2025
- 3 minute read
- PI System
- Adapter for BACnet 1.2
- Adapters
The following parameters are available to configure a BACnet data source:
|
Parameter |
Required |
Type |
Description |
|---|---|---|---|
|
ipAddress |
Required |
string |
IPv4 address of BACnet device or BACnet router. |
|
port |
Optional |
number |
UDP port number for communication with BACnet devices. |
|
maxConcurrentNetworkRequests |
Optional |
number |
The maximum number of requests that can be sent concurrently on the network. This
is not affected by the response time for the requests. A value of 0 indicates no limit. |
|
requestDelay |
Optional |
string |
The delay between sent requests to an individual device represented in hh:mm:ss.fff format. |
|
allowedConsecutiveFailedRequests |
Optional |
number |
The number of consecutive failed requests to a device before waiting ReconnectInterval to retry sending requests. |
|
reconnectInterval |
Optional |
string |
The amount of time to wait before attempting to send requests to a device after disconnection
represented in hh:mm:ss format. |
|
deviceId |
Optional |
number |
Device instance number. If specified, the IPAddress is interpreted as for a BACnet device (not a BACnet router). If empty, the IPAddress is interpreted as for a BACnet router (not an individual BACnet device). |
|
includeProperties |
Optional |
boolean |
Sets whether the adapter should poll for container overrides. Supported container
overrides for BACnet properties include minimum, maximum, and uom (unit of measurement) for each data selection item.1 To enable this option, set to true |
|
networkNumber |
Optional |
number |
Device network number for routed BACnet devices. This setting can only be specified when a DeviceId is specified. If specified, the MACAddress must also be specified. |
|
macAddress |
Optional |
string |
Device MAC address for routed BACnet devices. This setting can only be specified when
a DeviceId is specified. If specified, the NetworkNumber must also be specified. It must contain 1-6 byte strings in hexadecimal format, separated
by a dash - or colon : |
|
streamIdPrefix |
Optional |
string |
Specifies what prefix is used for stream IDs. The naming convention is {StreamIdPrefix}{StreamId}. An empty string means no prefix will be added to the stream IDs and names. A null value defaults to ComponentID followed by a period. Note: If you change the StreamIdPrefix of a configured adapter, for example when you delete and add a data source, you need to restart the adapter for the changes to take place. New streams are created on adapter restart and pre-existing streams are no longer updated. Allowed value: any string |
|
defaultStreamIdPattern |
Optional |
string |
Specifies the default stream ID pattern to use. Possible parameters: {DeviceIPAddress}, {DeviceId}, {ObjectType}, {ObjectId}, and {PropertyIdentifier}. Default value: {DeviceId}.{ObjectType}{ObjectId}.{PropertyIdentifier} |
Notes:
-
For more information on supported container overrides, see Container Messages within the OMF 1.2 documentation.
-
The overriding BACnet engineering units must match one of the formats supported by CONNECT data service. In cases where a BACnet object's Units is not supported by CONNECT data services, no UOM will be specified on the data stream for the object.