Click or drag to resize

BACnetRegister(UInt32, String, UInt32) Method

Register this BACnet slot with the system. BACnet stack will be intimated about all the objects or devices that were already added to the local device/object collections so that those objects/devices will be added to the BACnet stack also.

Namespace: Crestron.SimplSharpPro
Assembly: SimplSharpPro (in SimplSharpPro.dll) Version: 2.21.121
Syntax
C#
public eDeviceRegistrationUnRegistrationResponse Register(
	uint paramDeviceId,
	string paramDeviceName,
	uint paramPortNumber
)

Parameters

paramDeviceId  UInt32
Host Device ID, valid range is from 0 to 4194302.
paramDeviceName  String
Host Device Name. Host Device Name is trimmed in this function.
paramPortNumber  UInt32
Host Device Port Number, valid port number ranges are, from 1024 to 65535.

Return Value

eDeviceRegistrationUnRegistrationResponse
An enum of type eDeviceRegistrationUnRegistrationResponse. Returns NotLicensed if BACnet license is not available and an error is logged. An exception is thrown if an error is found while adding the host device to the BACnet stack. Will log an error if an error is found while adding a remote device, host object or remote object to the BACnet stack.
Exceptions
ExceptionCondition
BACnetExceptionUnable to add BACnet host device due to no response received or error response received from the BACnet stack.
BACnetDeviceOrObjectAlreadyExistsExceptionBACnet host device with the same id is already present in the BACnet stack object/device list, so ignored the add request.
OutOfObjectLicensesExceptionUnable to add a BACnet host device, due to the maximum number of endpoints are reached.
ArgumentOutOfRangeExceptionHost Device ID or Host Device Port number is out of range.
ArgumentNullExceptionHost Device Name is null or empty.
FileNotFoundException"BACnetVendorList.xml" is not found under \sys folder on the control system.
BACnetDeviceOrObjectAlreadyExistsExceptionDevice ID passed is already in use by a remote device in the collecion.
Remarks
This method will block pending a response. It is recommended to not invoke this method from within a event handler. Please launch a timer/thread to call this method. Also – this method not be called from the control system constructor.

Version Information

.NET

Supported in: 6.0

.NET Compact Framework

Supported in: 3.5
See Also