BACnetSetClientGlobalCommTimingParameters (FUN)

FUNCTION BACnetSetClientGlobalCommTimingParameters : IEC_BACNET_STATUS

Sets the global communication parameters of the advanced client API.

This function gives a user application the ability to configure the used APDU timings for communication with remote BACnet devices. During connection establishment the APDU parameters are read from the remote BACnet devices and used. But in some cases it might be useful TO override those parameters.

To remove the global timing parameters and use the dynamically assigned ones again set nTimeout, nSegmentTimeout AND nRetryCount TO -1.

To disable the periodic alive check set nAliveCheckInterval to 0.

InOut:

Scope

Name

Type

Comment

Return

BACnetSetClientGlobalCommTimingParameters

IEC_BACNET_STATUS

Input

nTimeout

IEC_BACNET_UNSIGNED

This is the APDU timeout in milliseconds (see |BACNET_APDU_PROPERTIES| for further information to this paramter).

nSegmentTimeout

IEC_BACNET_UNSIGNED

This is the APDU segment timeout in milliseconds (see |BACNET_APDU_PROPERTIES| for further information to this paramter).

nRetryCount

IEC_BACNET_UNSIGNED

This is the APDU retry count (see |BACNET_APDU_PROPERTIES|for further information to this paramter).

nAliveCheckInterval

IEC_BACNET_UNSIGNED

This is the alive check interval in milliseconds in which periodical requests are sent to devices to check if they are still alive. If this is set to 0 no alive check will be performed at all.

nErrorAliveCheckInterval

IEC_BACNET_UNSIGNED

In case of an detected communication failure this value is used as the timer trying to establish communication again.

bReportErrors

IEC_BACNET_BOOLEAN

If set to True special error checking will take place on reception of COV, COVP and event notifications. If the API receives an notification for an device object property reference which is not registered by any customer it will reply an error to the sender of the notification. If set to False those notifications will be positiv acknowledged.

bExtendedDeviceInfo

IEC_BACNET_BOOLEAN

If set to True extended device information will be read on connection establishment and provided to the user application in the IEC_BACNET_REMOTE_DEVICE_CAPS structure.

bNoUseOfRPM

IEC_BACNET_BOOLEAN

If set to True the polling of all registered object properties will be made using the ReadProperty service and not the ReadPropertyMultiple service event if the corresponding device supports this service.