CL2.CstCycleOpen* (FUN)

提示!

The interfaces of this component contains inputs and outputs which drive and diagnose optional functionalities. With “ CL2.GetProperty” you can check, whether a driver supports a certain functionality or not. If not, its input and output values are irrelevant.

This function of the CAA_CanL2.library creates a handle for a send cycle. An event which was triggered a certain period of time (udiCstForewarnTime) before the sending time can be assigned. And then a function allocated via “CB_RegisterCallback” can be called. The class used is “CB_FIELDBUS” and the source is “CB_DRIVER”. The lowest byte of the additional callback parameter contains the number of the interface. This makes it possible to update the data to be sent on time via " CL2.CstCycleUpdate”. The priority and parameter "xEnableSyncWindow” settings are the same as in “ CL2.Write”.

Input:

hDriver

CAA.HANDLE

handle of CAN interface

eCstEvent*

CB_EVENT

event to be activated when receiving a message

0: no event

usiPriority

USINT

sending priority of message with values from 1 (highest priority) to 9. Can be retrieved with GetProperty.

usiPrioity = 0 forces immediate sending!

xEnableSyncWindow*

BOOL

TRUE: sending only inside of current Sync window

udiCstCycle

UDINT

time period for sending messages [µs]

udiCstForewarnTime

UDINT

forewarn time before sending message [µs]

peError

POINTER TO CL2.ERROR

pointer to error code (enumeration type)

Output:

hCstCycle

CAA.HANDLE

handle of sending cycle