BACnetFindUpdateDeviceAddressBindings (FUN)

FUNCTION BACnetFindUpdateDeviceAddressBindings : POINTER TO IEC_BACNET_ADDRESS

Finds or updates a BACnet MAC address for some specified device instance number.

For an successful communication to a remote device in a BACnet network the application needs the BACnet MAC address for the device instnace number. If the device, which the application needs to communicate with, supports the dynamic address binding, the user application can use this function to retrieve the BACnet MAC address. The API will send in configurable periods (see function BACnetSetDeviceAddressBindingsCacheOptions requests to retrieve the right BACnet MAC address.

The property “Address_Binding” from a device object which is defined in this BACnet server API’s database is also searched for an valid address by this function. The property is used by the API for ‘static’ address bindings only, but if the property is beeing read from a BACnet client ‘dynamic’ address bindings resolved from this function will also appear in the returned response.

InOut:

Scope	Name	Type	Comment
Return	BACnetFindUpdateDeviceAddressBindings	POINTER TO IEC_BACNET_ADDRESS	A pointer of type IEC_BACNET_ADDRESS or 0 if the address is still unknown.
Input	pSource	POINTER TO IEC_BACNET_ADDRESS	A pointer with a valid BACnet MAC address if the ‘binding’ should be updated or a 0 pointer if the device instance should be resolved into an BACnet MAC address.
	deviceNumber	IEC_BACNET_UNSIGNED	The device instance number for which the MAC address shall be retrieved or updated.
	bForceRefresh	IEC_BACNET_BOOLEAN	If set to True the dynamic address binding is forced to be refreshed for the given device instance number.