CMSIS-RTX  
Keil RTX5 Real-Time Operating System
 
Loading...
Searching...
No Matches
Functions
Timer Functions
RTX v5 Specific API » Event functions

Events generated by timer functions. More...

Functions

void EvrRtxTimerError (osTimerId_t timer_id, int32_t status)
 Event on timer error (Error)
 
void EvrRtxTimerCallback (osTimerFunc_t func, void *argument)
 Event on timer callback call (Op)
 
void EvrRtxTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)
 Event on timer create and initialize (API)
 
void EvrRtxTimerCreated (osTimerId_t timer_id, const char *name)
 Event on successful timer create (Op)
 
void EvrRtxTimerGetName (osTimerId_t timer_id, const char *name)
 Event on timer name retrieve (API)
 
void EvrRtxTimerStart (osTimerId_t timer_id, uint32_t ticks)
 Event on timer start (API)
 
void EvrRtxTimerStarted (osTimerId_t timer_id)
 Event on successful timer start (Op)
 
void EvrRtxTimerStop (osTimerId_t timer_id)
 Event on timer stop (API)
 
void EvrRtxTimerStopped (osTimerId_t timer_id)
 Event on successful timer stop (Op)
 
void EvrRtxTimerIsRunning (osTimerId_t timer_id, uint32_t running)
 Event on timer running state check (API)
 
void EvrRtxTimerDelete (osTimerId_t timer_id)
 Event on timer delete (API)
 
void EvrRtxTimerDestroyed (osTimerId_t timer_id)
 Event on successful timer delete (Op)
 

Description

Events generated by timer functions.

Function Documentation

◆ EvrRtxTimerError()

void EvrRtxTimerError ( osTimerId_t  timer_id,
int32_t  status 
)

Event on timer error (Error)

Parameters
[in]timer_idtimer ID obtained by osTimerNew or NULL when ID is unknown.
[in]statusextended execution status.

The event TimerError is generated when Timer Management routines complete their execution due to an error.

The status parameter indicates the execution status and can be one of the osStatus_t codes or one of the extended execution status codes which are summarized in the table below.

Extended Status Code Description
osRtxErrorKernelNotReady Kernel scheduler is not in Ready state.
osRtxErrorKernelNotRunning Kernel scheduler is not executing - there is no running thread.
osRtxErrorInvalidControlBlock Object control block with invalid alignment or size was specified.
osRtxErrorInvalidDataMemory Object data memory with invalid alignment or size was specified.
osRtxErrorInvalidThreadStack Thread stack memory with invalid alignment or size was specified.
osRtxErrorInvalidPriority Invalid thread priority was specified.
osRtxErrorInvalidPrivilegedMode Privileged thread cannot be created - kernel protect privileged is active.
osRtxErrorThreadNotJoinable Specified thread is not joinable.
osRtxErrorMutexNotOwned Specified mutex is not owned by the current running thread.
osRtxErrorMutexNotLocked Specified mutex is not locked.
osRtxErrorMutexLockLimit Maximum number of recursive mutex locks reached.
osRtxErrorSemaphoreCountLimit Semaphore count limit reached.
osRtxErrorTZ_InitContext_S Secure context memory system initialization failed.
osRtxErrorTZ_AllocContext_S Secure context memory allocation failed.
osRtxErrorTZ_FreeContext_S Secure context memory deallocation failed.
osRtxErrorTZ_LoadContext_S Secure context load failed.
osRtxErrorTZ_SaveContext_S Secure context save failed.

Value in the Event Recorder shows:

  • timer_id : timer ID.
  • status : execution status code.

◆ EvrRtxTimerCallback()

void EvrRtxTimerCallback ( osTimerFunc_t  func,
void *  argument 
)

Event on timer callback call (Op)

Parameters
[in]funcstart address of a timer call back function.
[in]argumentargument to the timer call back function.

The event TimerCallback is generated when the timer callback function is called.

Value in the Event Recorder shows:

  • func : start address of a timer call back function.
  • argument : memory address of argument to the timer call back function.

◆ EvrRtxTimerNew()

void EvrRtxTimerNew ( osTimerFunc_t  func,
osTimerType_t  type,
void *  argument,
const osTimerAttr_t *  attr 
)

Event on timer create and initialize (API)

Parameters
[in]funcstart address of a timer call back function.
[in]typeosTimerOnce for one-shot or osTimerPeriodic for periodic behavior.
[in]argumentargument to the timer call back function.
[in]attrtimer attributes.

The event TimerNew is generated when the function osTimerNew is called.

Value in the Event Recorder shows:

  • func : start address of a timer call back function.
  • type : timer type: osTimerOnce for one-shot or osTimerPeriodic for periodic behavior.
  • argument : memory address of argument to the timer call back function.
  • attr : memory address of Timer attributes or 0 when they are not specified.

◆ EvrRtxTimerCreated()

void EvrRtxTimerCreated ( osTimerId_t  timer_id,
const char *  name 
)

Event on successful timer create (Op)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.
[in]namepointer to timer object name.

The event TimerCreated is generated when the function osTimerNew successfully creates a timer object.

Value in the Event Recorder shows:

  • timer_id : timer ID.

◆ EvrRtxTimerGetName()

void EvrRtxTimerGetName ( osTimerId_t  timer_id,
const char *  name 
)

Event on timer name retrieve (API)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.
[in]namepointer to timer object name.

The event TimerGetName is generated when the function osTimerGetName is called and its execution result is known.

Value in the Event Recorder shows:

  • timer_id : timer ID.
  • name : retrieved memory address of name string (0 in case of a failure).

◆ EvrRtxTimerStart()

void EvrRtxTimerStart ( osTimerId_t  timer_id,
uint32_t  ticks 
)

Event on timer start (API)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.
[in]tickstime ticks value of the timer.

The event TimerStart is generated when the function osTimerStart is called.

Value in the Event Recorder shows:

  • timer_id : timer ID.
  • ticks : time ticks value of the timer.

◆ EvrRtxTimerStarted()

void EvrRtxTimerStarted ( osTimerId_t  timer_id)

Event on successful timer start (Op)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.

The event TimerStarted is generated when the function osTimerStart successfully starts or restarts the timer operation.

Value in the Event Recorder shows:

  • timer_id : timer ID.

◆ EvrRtxTimerStop()

void EvrRtxTimerStop ( osTimerId_t  timer_id)

Event on timer stop (API)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.

The event TimerStop is generated when the function osTimerStop is called.

Value in the Event Recorder shows:

  • timer_id : timer ID.

◆ EvrRtxTimerStopped()

void EvrRtxTimerStopped ( osTimerId_t  timer_id)

Event on successful timer stop (Op)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.

The event TimerStopped is generated when the function osTimerStop successfully stops the timer operation.

Value in the Event Recorder shows:

  • timer_id : timer ID.

◆ EvrRtxTimerIsRunning()

void EvrRtxTimerIsRunning ( osTimerId_t  timer_id,
uint32_t  running 
)

Event on timer running state check (API)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.
[in]runningrunning state: 0 not running, 1 running.

The event TimerIsRunning is generated when the function osTimerIsRunning is called and its execution result is known.

Value in the Event Recorder shows:

  • timer_id : timer ID.
  • running : timer running state: 0 not running, 1 running.

◆ EvrRtxTimerDelete()

void EvrRtxTimerDelete ( osTimerId_t  timer_id)

Event on timer delete (API)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.

The event TimerDelete is generated when the function osTimerDelete is called.

Value in the Event Recorder shows:

  • timer_id : timer ID.

◆ EvrRtxTimerDestroyed()

void EvrRtxTimerDestroyed ( osTimerId_t  timer_id)

Event on successful timer delete (Op)

Parameters
[in]timer_idtimer ID obtained by osTimerNew.

The event TimerDestroyed is generated when the function osTimerDelete successfully deletes the timer object.

Value in the Event Recorder shows:

  • timer_id : timer ID.