Click or drag to resize

BACnetAddRemoteDevice(UInt32, eBACnetPriorityType) Method

Adds the specified remote device to the remote devices collection and with user settable timeout option. This function also validates the object parameters passed. Success will be returned if the device is added successfully, otherwise an exception is thrown that tells what kind of error found. If response is not received from the BACnet stack for add request before the timeout occurs, then a remove request will be sent to the BACnet stack to remove the remote from the stack and also the remote device will be deleted from the local collection.

Namespace: Crestron.SimplSharpPro
Assembly: SimplSharpPro (in SimplSharpPro.dll) Version: 2.21.121
Syntax
C#
public bool AddRemoteDevice(
	uint paramDeviceId,
	eBACnetPriorityType paramPriority
)

Parameters

paramDeviceId  UInt32
Remote device ID.
paramPriority  eBACnetPriorityType
Remote BACnet device priority level at which the device will communicate.

Return Value

Boolean
Returns 'true' if the device is added successfully, otherwise throws an exception.
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionThe BACnet remote device id passed is not valid.
BACnetExceptionUnable to add the BACnet remote device due to no response received or error response received from the BACnet stack.
BACnetDeviceOrObjectAlreadyExistsExceptionThe BACnet remote device with the same device id is already present in the collection, so ignored the add request.
OutOfObjectLicensesExceptionUnable to add the BACnet remote device, due to the maximum number of endpoints are reached.
Remarks
This method will block pending a response. It is recommended to not invoke this method from within an event handler. Please launch a timer/thread to add a remote device. Also – this method shall not be called from the control system constructor.

Version Information

.NET

Supported in: 6.0

.NET Compact Framework

Supported in: 3.5
See Also