IEC_BACNET_APDU_PROPERTIES (STRUCT)

TYPE IEC_BACNET_APDU_PROPERTIES : STRUCT

Structure which holds the main APDU communikation parameters for communication, interacting and exchange of values between BACnet network devices.

InOut:

Name

Type

Comment

mask

IEC_BACNET_UNSIGNED

Mask of flags which define which member of this struct is valid. Possible flags are: APDU_MAX_LENGTH_FLAG, APDU_SEGMENTATION_FLAG, APDU_MAX_SEGMENTS_FLAG, APDU_WINDOW_SIZE_FLAG, APDU_SEGMENT_TIMEOUT_FLAG, APDU_TIMEOUT_FLAG, APDU_NUM_RETRIES_FLAG, APDU_MAX_SEGMENTS_TO_SEND_FLAG, APDU_ROUTE_RESOLVE_TIME_FLAG and APDU_MAX_ROUTE_RETRIES_FLAG

nMaxLength

IEC_BACNET_UNSIGNED

The maximum number of octets that may be contained in a single, indivisible application layer protocol data unit. The value of this property shall be greater than or equal to 50. The maximum value of this parameter is constrained by the underlying data link technology.

eSegmentation

IEC_BACNET_SEGMENTATION

Defines which kind of segmentation may be used in an BACnet request or response.

nMaxSegments

IEC_BACNET_UNSIGNED

Indicate the maximum number of segments of an APDU that an device will accept.

nWindowSize

IEC_BACNET_UNSIGNED

Is the proposed size of a segmented message. The actual size window size is determine as the minimum of the proposed window size of both communicated device.

nSegmentTimeout

IEC_BACNET_UNSIGNED

Indicates the amount of time in milliseconds between retransmission of an APDU segment.

nTimeout

IEC_BACNET_UNSIGNED

Indicates the amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received.

nRetryCount

IEC_BACNET_UNSIGNED

Indicates the maximum number of times that an APDU shall be retransmitted before it will be terminated with an error state.

nMaxSegmentsToSend

IEC_BACNET_UNSIGNED

Indicates the maximum number of segments of an APDU that this device will send. If it is set to 0, then it is considered to be the same as Max-Segments-Accepted.

nRouteResolutionTimeout

IEC_BACNET_UNSIGNED

Indicates the amount of time in milliseconds between retries to establish an routing path for the APDU frames to be sent. This timeout will be added to the normal APDU timeout specified in nTimeout if the network layer needs to find a routing path. A value of 0 indicates that the normal APDU timeout specified in nTimeout will be used.

nRouteResolutionRetries

IEC_BACNET_UNSIGNED

Indicates the maximum number of retries to ask for an specified router if routing path is unknow. This value will be added to the normal number of APDU retries specified in nRetryCount if the network layer needs to find a routing path. A value of 0 indicates that the normal APDU retries specified in nRetryCount will be used.