Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ Adapter for BACnet

Data source parameters

  • Last UpdatedFeb 20, 2025
  • 3 minute read

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.

Value range: 0 to 65535
Default value: 47808 (the default port for the BACnet protocol)

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.

Default value: 1

requestDelay

Optional

string

The delay between sent requests to an individual device represented in hh:mm:ss.fff format.

Minimum value: 00:00:00.000 for 0 seconds
Maximum value: 00:00:10.000 for 10 seconds
Default value: 00:00:00.000

allowedConsecutiveFailedRequests

Optional

number

The number of consecutive failed requests to a device before waiting ReconnectInterval to retry sending requests.

Minimum value: 3
Maximum value: 1000
Default value: 3

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.

Allowed value: Must be greater than 0
Default value: 01:00:00 for 1 hour

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

Default value: false

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 :

Example: 12:34:ef:cd

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.

Example: BACnet1.{DeviceId}.{ObjectType}{ObjectId}.{PropertyIdentifier}

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
Default value: null

defaultStreamIdPattern

Optional

string

Specifies the default stream ID pattern to use.

Possible parameters: {DeviceIPAddress}, {DeviceId}, {ObjectType}, {ObjectId}, and {PropertyIdentifier}.

Allowed value: The stream ID pattern can contain any string in combination with {Identifier} and/or {NamespaceIndex} placeholders that results in unique stream ID per data selection item.

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.

TitleResults for “How to create a CRG?”Also Available in