NetworkScan allows an OPC UA Client to update the BACnet device list by using the BACnet Who-Is and I-Am services.

Signature

NetworkScan (

[in]0:UInt32 WaitTimeInSeconds

[in]0:Boolean ApplyRange

[in]0:UInt32 DeviceRangeLow

[in]0:UInt32 DeviceRangeHigh

[out]BaseDataType [] DeviceAddressBindings

[out]0:UInt32 [] MaxAPDULengthAccepted

[out]BACnetSegmentation [] SegmentationSupported

[out]0:UInt16 [] VendorIdentifier

);

Argument

Description

WaitTimeInSeconds

Wait time between sending Who-Is and returning the received I-Am results.

ApplyRange

Flag indicating if the DeviceRangeLow and DeviceRangeHigh parameters are applied.

DeviceRangeLow

This parameter is an unsigned integer in the range 0 - 4194303. In conjunction with the 'Device Instance Range High Limit' parameter, it defines the devices that are qualified to respond with an I-Am service request. If the 'Device Instance Range Low Limit' parameter is present, then the 'Device Instance Range High Limit' parameter shall also be present, and only those devices whose Device Object_Identifier instance number falls within the range 'Device Instance Range Low Limit' ≤ Device Object_Identifier Instance Number ≤ 'Device Instance Range High Limit' shall be qualified to respond. The value of the 'Device Instance Range Low Limit' shall be less than or equal to the value of the 'Device Instance Range High Limit'. If the 'Device Instance Range Low Limit' and 'Device Instance Range High Limit' parameters are omitted, then all devices that receive this message are qualified to respond with an I-Am service request.

DeviceRangeHigh

This parameter is an unsigned integer in the range 0 - 4194303. In conjunction with the 'Device Instance Range Low Limit' parameter, it defines the devices that are qualified to respond with an I-Am service request. If the 'Device Instance Range High Limit' parameter is present, then the 'Device Instance Range Low Limit' parameter shall also be present, and only those devices whose Device Object_Identifier instance number falls within the range 'Device Instance Range Low Limit' ≤ Device Object_Identifier Instance Number ≤ 'Device Instance Range High Limit' shall be qualified to respond. The value of the 'Device Instance Range High Limit' shall be greater than or equal to the value of the 'Device Instance Range Low Limit'. If the 'Device Instance Range Low Limit' and 'Device Instance Range High Limit' parameters are omitted, then all devices that receive this message are qualified to respond with an I-Am service request.

DeviceAddressBindings

The format is server-specific. In each value of the array should be the device identifier and the BACnet MAC address provided by the I-Am service.

MaxAPDULengthAccepted

This element, of type Unsigned, is the maximum number of octets that may be contained in a single, indivisible application

layer protocol data unit. The value of this property shall be greater than or equal to 50. The value of this property is also

constrained by the underlying data link technology. See Clauses 6 through 11.

If the value of this property is not encodable in the 'Max APDU Length Accepted' parameter of a ConfirmedRequest-PDU,

then the value encoded shall be the highest encodable value less than the value of this property. In such cases, a responding device may ignore the encoded value in favor of the value of this property, if it is known.

SegmentationSupported

This element, of type BACnetSegmentation, indicates whether the BACnet Device supports segmentation of messages and,

if so, whether it supports segmented transmission, reception, or both:

{SEGMENTED_BOTH, SEGMENTED_TRANSMIT, SEGMENTED_RECEIVE, NO_SEGMENTATION}

VendorIdentifier

This element, of type Unsigned16, is a unique vendor identification code, assigned by ASHRAE, which is used to distinguish proprietary extensions to the protocol.

Method Result Codes

ResultCode

Description

Common StatusCodes defined in OPC 10000-4