CL2.CstCycleOpen* (FUN)

 

This function of the CAA_CanL2.library creates a handle for a send cycle. An event which was triggered a certain period of time (udiCstFore­warnTime) 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 "xEnableSyn­cWindow” 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