IAR PowerPac RTOS User Guide

Prototypevoid OS_StartTimer (OS_TIMER* pTimer);ParameterDescriptionpTimerPointer to the OS_TIMER data structure which contains the data of the timer.Table 22: OS_StartTimer() parameter listAdditional InformationOS_StartTimer() is used for the following reasons:●●Start a timer which was created by OS_CreateTimer(). The timer will start with its initial timer value.Restart a timer which was stopped by calling OS_StopTimer(). In this case, the timer will continue with theremaining time value which was preserved by stopping the timer.ImportantThis function has no effect on running timers. It also has no effect on timers that are not running, but has expired. UseOS_RetriggerTimer() to restart those timers.OS_StopTimer()DescriptionStops a specified timer.Prototypevoid OS_StopTimer (OS_TIMER* pTimer);ParameterDescriptionpTimerTable 23: OS_StopTimer() parameter listAdditional InformationThe actual value of the timer (the time until expiration) is kept until OS_StartTimer() lets the timer continue.OS_RetriggerTimer()DescriptionRestarts a specified timer with its initial time value.Prototypevoid OS_RetriggerTimer (OS_TIMER* pTimer);ParameterDescriptionpTimerTable 24: OS_RetriggerTimer() parameter listAdditional InformationOS_RetriggerTimer() restarts the timer using the initial time value programmed at creation of the timer or with thefunction OS_SetTimerPeriod().ExampleOS_TIMER TIMERCursor;BOOL CursorOn;Pointer to the OS_TIMER data structure which contains the data of the timer.Pointer to the OS_TIMER data structure which contains the data of the timer.void TimerCursor(void) {if (CursorOn) ToggleCursor(); /* Invert character at cursor-position */OS_RetriggerTimer(&TIMERCursor); /* Make timer periodical */}void InitTask(void) {/* Create and start TimerCursor */OS_CREATETIMER(&TIMERCursor, TimerCursor, 500);}40IAR PowerPac RTOSfor ARM CoresPPRTOS-2