BACnetSetDeviceAddressBindingsCacheOptions (FUN)

FUNCTION BACnetSetDeviceAddressBindingsCacheOptions : IEC_BACNET_STATUS

Configures timing an retry parameters for the ‘dynamic’ address binding procedure.

This function configures the timing and retry parameters for the ‘dynamic’ address binding procedure as defined in the BACnet standard.

Return: IEC_BACNET_STATUS

InOut:

Scope

Name

Type

Comment

Return

BACnetSetDeviceAddressBindingsCacheOptions

IEC_BACNET_STATUS

Input

refreshIamCache

IEC_BACNET_UNSIGNED

Specifies the refresh time in seconds after all listed dynamic bindings get refreshed. After expiration of the refresh interval all bindings are requested using Who-Is requests again. The lowest value accepted here is 10 and the default is 500 seconds.

whoIsInterval

IEC_BACNET_UNSIGNED

Specifies the interval in which periodically Who-Is requests are sent as long as they have not been answered and thus it is also the timeout in which an answer is expected. The lowest value accepted here is 1 and the default is 5 seconds.

whoIsRetries

IEC_BACNET_UNSIGNED

Specifies the number of retries made before dynamic resolution will stop until next refresh interval has expired. The lowest value accepted is 1 and the default is 5.

whoIsMaxPending

IEC_BACNET_UNSIGNED

Specifies the maximum number of requests with outstanding replies which might be sent out into the network. The lowest value accepted here is 1 and the default is 20.

bPrefillCache

IEC_BACNET_BOOLEAN

If set to True all received I-Am requests from the network are collected even if no dynamic address resolution is requested for that device.

bAllowUnicastIams

IEC_BACNET_BOOLEAN

If set to True all received Who-Is requests are answered with unicast I am’s sent to the source address over which they have been received. True is the default setting for this option.

bAllowBroadcastIams

IEC_BACNET_BOOLEAN

If set to True all received Who-Is requests are answered with broadcast I am’s. False is the default setting for this option.

bUseGlobalBcastWhoIs

IEC_BACNET_BOOLEAN

If set to True all sent WhoIs gequests will use the global broadcast address to pass over BACnet routers instead of local broadcast addresses which are not routed.