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 instance 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.n 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.

Return: A pointer of type ::BACNET_ADDRESS or NULL if the address is still unknown.

InOut:

Scope	Name	Type	Comment
Return	BACnetFindUpdateDeviceAddressBindings	POINTER TO IEC_BACNET_ADDRESS
Input	pSource	POINTER TO IEC_BACNET_ADDRESS	A pointer with a valid BACnet MAC address if the ‘binding’ should be updated or a NULL pointer if the device instance should be resolved into an BACnet MAC address.
	deviceNumber	IEC_BACNET_INST_NUMBER	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.