BACnetConstructDevice (FUN)ΒΆ

FUNCTION BACnetConstructDevice : IEC_BACNET_STATUS

Creates a local device in the BACnet server database.

This function will construct an device object in the local server database. The application has to provide a list with correctly initialized property values. The maximum number of objects that may be stored in a local device is specified at device creation.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetConstructDevice

IEC_BACNET_STATUS

Input

instNumber

IEC_BACNET_INST_NUMBER

The Device object instance number of the Device.

pAddress

POINTER TO IEC_BACNET_ADDRESS

A pointer to a BACnetAddress structure which has to be initialized by the user application. If the device shall be bound to an specified datalink, the network number in the address structure has to be one of the configured datalink network numbers and the length shall be the ::BACNET_MAC_BROADCAST_LENGTH. If a special binding is not required the network number in the address structure shall be set to ::BACNET_NETWORK_LOCAL. Upon successful creation this will be filled with the BACnet MAC address under which the device will be reachable.

propList

POINTER TO IEC_BACNET_PROPERTY_INSTANCE

Points to the device object description with the property list including their initial values along with additional flags determining default actions for each property. First property in the list shall be object-identifier. Values of object-identifier and object-name properties shall be unique inside of each device.

propCount

IEC_BACNET_PROPERTY_COUNT

Count of property instances in the array of property instances.

pError

POINTER TO IEC_BACNET_ERROR

Points to memory to store additional error information in case of any error. Can be NULL if user is not interested to get this information.

pnFirstFailedIdx

POINTER TO IEC_BACNET_PROPERTY_COUNT

Points to memory to store the index in the list of property instances which has failed to be stored in the objects database. Can be NULL if user is not interested to get this information.

maxNumberOfObjects

IEC_BACNET_UNSIGNED

Specifies the maximum number of objects which may be created in this device. If no limit checking is required set this parameter to 0.