]> begriffs open source - cmsis/blob - CMSIS/DoxyGen/RTOS2/src/rtx_evr.txt
RTX5: minor typo correction in documentation
[cmsis] / CMSIS / DoxyGen / RTOS2 / src / rtx_evr.txt
1 /** 
2 \defgroup rtx_evr Event functions
3 \ingroup rtx5_specific 
4 \brief RTX5 Event Recorder functions
5 \details
6 RTX5 interfaces to the <a href="http://www.keil.com/pack/doc/compiler/EventRecorder/html/index.html" target="_blank"><b>Event Recorder</b></a> 
7 to provide event information which helps you to understand and analyze the operation.
8
9 To use the Event Recorder together with RTX5, it is required to create an image that generates event information. 
10 The steps are described under \ref cre_rtx_proj_er.
11
12 @{
13 */
14
15 /**
16 \defgroup rtx_evr_memory Memory Functions
17 \brief Events generated memory functions 
18 \details
19 @{
20 */
21
22 /**
23 \fn void EvrRtxMemoryInit (void *mem, uint32_t size, uint32_t result)
24 \details
25 The event \b MemoryInit is generated when initialization of a variable size memory block completes.
26
27 \b Value in the Event Recorder shows:
28   - \b mem : memory address of memory pool.
29   - \b size : size of a memory pool in bytes.
30   - \b result : execution status: 1 - success, 0 - failure.
31 */
32
33 /**
34 \fn void EvrRtxMemoryAlloc (void *mem, uint32_t size, uint32_t type, void *block)
35 \details
36 The event \b MemoryAlloc is generated when allocation of a variable size memory block completes.
37
38 \b Value in the Event Recorder shows:
39   - \b mem : memory address of memory pool.
40   - \b size : size of a memory block in bytes.
41   - \b type : memory block type: 0 - generic, 1 - control block
42   - \b block : memory address of allocated memory block or 0 in case of no memory is available.
43 */
44
45 /**
46 \fn void EvrRtxMemoryFree (void *mem, void *block, uint32_t result)
47 \details
48 The event \b MemoryFree is generated when deallocation of a variable size memory block completes.
49
50 \b Value in the Event Recorder shows:
51   - \b mem : memory address of memory pool.
52   - \b block : memory address of block to be returned to the memory pool.
53   - \b result : execution status: 1 - success, 0 - failure.
54 */
55
56 /**
57 \fn void EvrRtxMemoryBlockInit (osRtxMpInfo_t *mp_info, uint32_t block_count, uint32_t block_size, void *block_mem)
58 \details
59 The event \b MemoryBlockInit is generated when initialization of a fixed size memory block completes.
60
61 \b Value in the Event Recorder shows:
62   - \b mp_info : memory address of memory pool info.
63   - \b block_count : maximum number of memory blocks in memory pool.
64   - \b block_size : size of a memory block in bytes.
65   - \b block_mem : memory address of memory for block storage.
66 */
67
68 /**
69 \fn void EvrRtxMemoryBlockAlloc (osRtxMpInfo_t *mp_info, void *block)
70 \details
71 The event \b MemoryBlockAlloc is generated when allocation of a fixed size memory block completes.
72
73 \b Value in the Event Recorder shows:
74   - \b mp_info : memory address of memory pool info.
75   - \b block : memory address of the allocated memory block or 0 in case of no memory is available.
76 */
77
78 /**
79 \fn void EvrRtxMemoryBlockFree (osRtxMpInfo_t *mp_info, void *block, int32_t status)
80 \details
81 The event \b MemoryBlockFree is generated when deallocation of a fixed size memory block completes.
82
83 \b Value in the Event Recorder shows:
84   - \b mp_info : memory address of memory pool info.
85   - \b block : memory address of the allocated memory block to be returned to the memory pool.
86   - \b status : execution status \ref osStatus_t
87 */
88
89 /**
90 @}
91 */
92
93 /**
94 \defgroup rtx_evr_kernel Kernel Functions
95 \brief Events generated by kernel functions 
96 \details
97 @{
98 */
99
100 /**
101 \fn void EvrRtxKernelError (int32_t status)
102 \details
103 The event \b KernelError is generated when \ref CMSIS_RTOS_KernelCtrl routines complete their execution due to an error.
104
105 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
106 of the extended execution status codes which are summarized in the table below.
107
108 |      Extended Status Code     | Description |
109 |:------------------------------|:------------|
110 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
111 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
112 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
113 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
114 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
115 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
116 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
117 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
118 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
119 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
120 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
121 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
122 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
123 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
124 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
125 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
126
127 \b Value in the Event Recorder shows:
128   - \b status : execution status code.
129 */
130
131 /**
132 \fn void EvrRtxKernelInitialize (void)
133 \details
134 The event \b KernelInitialize is generated when the function \ref osKernelInitialize is called.
135 */
136
137 /**
138 \fn void EvrRtxKernelInitialized (void)
139 \details
140 The event \b KernelInitialized is generated when the function \ref osKernelInitialize successfully initializes the RTOS kernel.
141 */
142
143 /**
144 \fn void EvrRtxKernelGetInfo (osVersion_t *version, char *id_buf, uint32_t id_size)
145 \details
146 The event \b KernelGetInfo is generated when the function \ref osKernelGetInfo is called.
147
148 \b Value in the Event Recorder shows:
149   - \b version : memory address of buffer for retrieving version information.
150   - \b id_buf : memory address of buffer for retrieving kernel identification string.
151   - \b id_size : size of id_buf in bytes.
152 */
153
154 /**
155 \fn void EvrRtxKernelInfoRetrieved (uint32_t ver_api, uint32_t ver_kernel, char *id_buf)
156 \details
157 The event \b KernelInfoRetrieved is generated when the function \ref osKernelGetInfo successfully retrieves kernel information.
158
159 \b Value in the Event Recorder shows:
160   - \b ver_api : API version.
161   - \b ver_kernel : kernel version.
162   - \b id_buf : memory address of buffer for retrieving kernel identification string.
163 */
164
165 /**
166 \fn void EvrRtxKernelGetState (osKernelState_t state)
167 \details
168 The event \b KernelGetState is generated when the function \ref osKernelGetState is called and its execution result is known.
169
170 \b Value in the Event Recorder shows:
171   - \b state : retrieved current \ref osKernelState_t "RTOS Kernel state".
172 */
173
174 /**
175 \fn void EvrRtxKernelStart (void)
176 \details
177 The event \b KernelStart is generated when the function \ref osKernelStart is called.
178 */
179
180 /**
181 \fn void EvrRtxKernelStarted (void)
182 \details
183 The event \b KernelStarted is generated when the function \ref osKernelStart successfully starts the RTOS kernel execution.
184 */
185
186 /**
187 \fn void EvrRtxKernelLock (void)
188 \details
189 The event \b KernelLock is generated when the function \ref osKernelLock is called.
190 */
191
192 /**
193 \fn void EvrRtxKernelLocked (int32_t lock)
194 \details
195 The event \b KernelLocked is generated when the functions \ref osKernelLock successfully completes its execution.
196
197 \b Value in the Event Recorder shows:
198   - \b lock : previous lock state (1 - locked, 0 - not locked).
199 */
200
201 /**
202 \fn void EvrRtxKernelUnlock (void)
203 \details
204 The event \b KernelUnlock is generated when the function \ref osKernelUnlock is called.
205 */
206
207 /**
208 \fn void EvrRtxKernelUnlocked (int32_t lock)
209 \details
210 The event \b KernelUnlocked is generated when the function \ref osKernelUnlock successfully completes its execution.
211
212 \b Value in the Event Recorder shows:
213   - \b lock : previous lock state (1 - locked, 0 - not locked).
214 */
215
216 /**
217 \fn void EvrRtxKernelRestoreLock (int32_t lock)
218 \details
219 The event \b KernelRestoreLock is generated when the function \ref osKernelRestoreLock is called.
220
221 \b Value in the Event Recorder shows:
222   - \b lock : lock state obtained by \ref osKernelLock or \ref osKernelUnlock.
223 */
224
225 /**
226 \fn void EvrRtxKernelLockRestored (int32_t lock)
227 \details
228 The event \b KernelLockRestored is generated when the function \ref osKernelRestoreLock successfully completes its execution.
229
230 \b Value in the Event Recorder shows:
231   - \b lock : new lock state (1 - locked, 0 - not locked).
232 */
233
234 /**
235 \fn void EvrRtxKernelSuspend (void)
236 \details
237 The event \b KernelSuspend is generated when the function \ref osKernelSuspend is called.
238 */
239
240 /**
241 \fn void EvrRtxKernelSuspended (uint32_t sleep_ticks)
242 \details
243 The event \b KernelSuspended is generated when the function \ref osKernelSuspend successfully suspends RTOS kernel execution.
244
245 \b Value in the Event Recorder shows:
246   - \b sleep_ticks : time in ticks, for how long the system can sleep or power-down.
247 */
248
249 /**
250 \fn void EvrRtxKernelResume (uint32_t sleep_ticks)
251 \details
252 The event \b KernelResume is generated when the function \ref osKernelResume is called.
253
254 \b Value in the Event Recorder shows:
255   - \b sleep_ticks : time in ticks, for how long the system was in sleep or power-down mode.
256 */
257
258 /**
259 \fn void EvrRtxKernelResumed (void)
260 \details
261 The event \b KernelResumed is generated when the function \ref osKernelResume successfully resumes RTOS kernel execution.
262 */
263
264 /**
265 \fn void EvrRtxKernelGetTickCount (uint32_t count)
266 \details
267 The event \b KernelGetTickCount is generated when the function \ref osKernelGetTickCount is called.
268
269 \b Value in the Event Recorder shows:
270   - \b count : retrieved kernel current tick count.
271 */
272
273 /**
274 \fn void EvrRtxKernelGetTickFreq (uint32_t freq)
275 \details
276 The event \b KernelGetTickFreq is generated when the function \ref osKernelGetTickFreq called.
277
278 \b Value in the Event Recorder shows:
279   - \b freq : retrieved frequency of the kernel tick in Hz.
280 */
281
282 /**
283 \fn void EvrRtxKernelGetSysTimerCount (uint32_t count)
284 \details
285 The event \b KernelGetSysTimerCount is generated when the function \ref osKernelGetSysTimerCount is called.
286
287 \b Value in the Event Recorder shows:
288   - \b count : retrieved kernel current system timer count as 32-bit value.
289 */
290
291 /**
292 \fn void EvrRtxKernelGetSysTimerFreq (uint32_t freq)
293 \details
294 The event \b KernelGetSysTimerFreq is generated when the function \ref osKernelGetSysTimerFreq is called.
295
296 \b Value in the Event Recorder shows:
297   - \b freq : retrieved frequency of the system timer in Hz.
298 */
299
300 /**
301 @}
302 */
303
304 /**
305 \defgroup rtx_evr_thread Thread Functions
306 \brief Events generated by thread functions 
307 \details
308 @{
309 */
310
311 /**
312 \fn void EvrRtxThreadError (osThreadId_t thread_id, int32_t status)
313 \details
314 The event \b ThreadError is generated when \ref CMSIS_RTOS_ThreadMgmt routines complete their execution due to an error.
315
316 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
317 of the extended execution status codes which are summarized in the table below.
318
319 |      Extended Status Code     | Description |
320 |:------------------------------|:------------|
321 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
322 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
323 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
324 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
325 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
326 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
327 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
328 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
329 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
330 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
331 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
332 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
333 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
334 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
335 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
336 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
337
338 \b Value in the Event Recorder shows:
339   - \b thread_id : thread ID.
340   - \b status : execution status code.
341 */
342
343 /**
344 \fn void EvrRtxThreadNew (osThreadFunc_t func, void *argument, const osThreadAttr_t *attr)
345 \details
346 The event \b ThreadNew is generated when the function \ref osThreadNew is called.
347
348 \b Value in the Event Recorder shows:
349   - \b func : memory address of thread function. 
350   - \b argument : memory address of thread function start argument.
351   - \b attr : memory address of Thread attributes or 0 when they are not specified.
352 */
353
354 /**
355 \fn void EvrRtxThreadCreated (osThreadId_t thread_id, uint32_t thread_addr, const char *name)
356 \details
357 The event \b ThreadCreated is generated when the function \ref osThreadNew successfully creates a thread object.
358
359 \b Value in the Event Recorder shows:
360   - \b thread_id : thread ID.
361 */
362
363 /**
364 \fn void EvrRtxThreadGetName (osThreadId_t thread_id, const char *name)
365 \details
366 The event \b ThreadGetName is generated when the function \ref osThreadGetName is called and its execution result is known.
367
368 \b Value in the Event Recorder shows:
369   - \b thread_id : thread ID.
370   - \b name : retrieved memory address of name string (0 in case of a failure).
371 */
372
373 /**
374 \fn void EvrRtxThreadGetId (osThreadId_t thread_id)
375 \details
376 The event \b ThreadGetId is generated when the function \ref osThreadGetId is called and its execution result is known.
377
378 \b Value in the Event Recorder shows:
379   - \b thread_id : retrieved thread (0 in case of a failure).
380 */
381
382 /**
383 \fn void EvrRtxThreadGetState (osThreadId_t thread_id, osThreadState_t state)
384 \details
385 The event \b ThreadGetState is generated when the function \ref osThreadGetState is called and its execution result is known.
386
387 \b Value in the Event Recorder shows:
388   - \b thread_id : thread ID.
389   - \b state : retrieved current thread state.
390 */
391
392 /**
393 \fn void EvrRtxThreadGetStackSize (osThreadId_t thread_id, uint32_t stack_size)
394 \details
395 The event \b ThreadGetStackSize is generated when the function \ref osThreadGetStackSize is called and its execution result is known.
396
397 \b Value in the Event Recorder shows:
398   - \b thread_id : thread ID.
399   - \b stack_size : retrieved remaining stack space in bytes (0 in case of a failure). 
400 */
401
402 /**
403 \fn void EvrRtxThreadGetStackSpace (osThreadId_t thread_id, uint32_t stack_space)
404 \details
405 The event \b ThreadGetStackSpace is generated when the function \ref osThreadGetStackSpace is called and its execution result is known.
406
407 \b Value in the Event Recorder shows:
408   - \b thread_id : thread ID.
409   - \b stack_space : retrieved remaining stack space in bytes (0 in case of a failure).
410 */
411
412 /**
413 \fn void EvrRtxThreadSetPriority (osThreadId_t thread_id, osPriority_t priority)
414 \details
415 The event \b ThreadSetPriority is generated when the function \ref osThreadSetPriority is called.
416
417 \b Value in the Event Recorder shows:
418   - \b thread_id : thread ID.
419   - \b priority : new priority value for the thread function. 
420 */
421
422 /**
423 \fn void EvrRtxThreadPriorityUpdated (osThreadId_t thread_id, osPriority_t priority)
424 \details
425 The event \b ThreadPriorityUpdated is generated when the function \ref osThreadSetPriority successfully updated the specified thread priority.
426
427 \b Value in the Event Recorder shows:
428   - \b thread_id : thread ID.
429   - \b priority : new priority value for the thread function. 
430 */
431
432 /**
433 \fn void EvrRtxThreadGetPriority (osThreadId_t thread_id, osPriority_t priority)
434 \details
435 The event \b ThreadGetPriority is generated when the function \ref osThreadGetPriority is called and its execution result is known.
436
437 \b Value in the Event Recorder shows:
438   - \b thread_id : thread ID.
439   - \b priority : current priority value of the specified thread.
440 */
441
442 /**
443 \fn void EvrRtxThreadYield (void)
444 \details
445 The event \b ThreadYield is generated when the function \ref osThreadYield is called.
446 */
447
448 /**
449 \fn void EvrRtxThreadSuspend (osThreadId_t thread_id)
450 \details
451 The event \b ThreadSuspend is generated when the function \ref osThreadSuspend is called.
452
453 \b Value in the Event Recorder shows:
454   - \b thread_id : thread ID.
455 */
456
457 /**
458 \fn void EvrRtxThreadSuspended (osThreadId_t thread_id)
459 \details
460 The event \b ThreadSuspended is generated when the function \ref osThreadSuspend successfully suspends the specified thread.
461
462 \b Value in the Event Recorder shows:
463   - \b thread_id : thread ID.
464 */
465
466 /**
467 \fn void EvrRtxThreadResume (osThreadId_t thread_id)
468 \details
469 The event \b ThreadResume is generated when the function \ref osThreadResume is called.
470
471 \b Value in the Event Recorder shows:
472   - \b thread_id : thread ID.
473 */
474
475 /**
476 \fn void EvrRtxThreadResumed (osThreadId_t thread_id)
477 \details
478 The event \b ThreadResumed is generated when the function \ref osThreadResume successfully resumes the specified thread.
479
480 \b Value in the Event Recorder shows:
481   - \b thread_id : thread ID.
482 */
483
484 /**
485 \fn void EvrRtxThreadDetach (osThreadId_t thread_id)
486 \details
487 The event \b ThreadDetach is generated when the function \ref osThreadDetach is called.
488
489 \b Value in the Event Recorder shows:
490   - \b thread_id : thread ID.
491 */
492
493 /**
494 \fn void EvrRtxThreadDetached (osThreadId_t thread_id)
495 \details
496 The event \b ThreadDetached is generated when the function \ref osThreadDetach successfully detaches the specified thread.
497
498 \b Value in the Event Recorder shows:
499   - \b thread_id : thread ID.
500 */
501
502 /**
503 \fn void EvrRtxThreadJoin (osThreadId_t thread_id)
504 \details
505 The event \b ThreadJoin is generated when the function \ref osThreadJoin is called.
506
507 \b Value in the Event Recorder shows:
508   - \b thread_id : thread ID.
509 */
510
511 /**
512 \fn void EvrRtxThreadJoinPending (osThreadId_t thread_id)
513 \details
514 The event \b ThreadJoinPending is generated when the function \ref osThreadJoin suspends current running thread until the specified thread terminates.
515
516 \b Value in the Event Recorder shows:
517   - \b thread_id : thread ID.
518 */
519
520 /**
521 \fn void EvrRtxThreadJoined (osThreadId_t thread_id)
522 \details
523 The event \b ThreadJoined is generated when the function \ref osThreadJoin successfully joins the specified thread.
524
525 \b Value in the Event Recorder shows:
526   - \b thread_id : thread ID.
527 */
528
529 /**
530 \fn void EvrRtxThreadBlocked (osThreadId_t thread_id, uint32_t timeout)
531 \details
532 The event \b ThreadBlocked is generated when the current running thread execution is blocked.
533
534 \b Value in the Event Recorder shows:
535   - \b thread_id : thread ID.
536   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
537 */
538
539 /**
540 \fn void EvrRtxThreadUnblocked (osThreadId_t thread_id, uint32_t ret_val)
541 \details
542 The event \b ThreadUnblocked is generated when the blocked thread execution is unblocked.
543
544 \b Value in the Event Recorder shows:
545   - \b thread_id : thread ID.
546   - \b ret_val : 
547 */
548
549 /**
550 \fn void EvrRtxThreadPreempted (osThreadId_t thread_id)
551 \details
552 The event \b ThreadPreempted is generated when current running thread execution is preempted.
553
554 \b Value in the Event Recorder shows:
555   - \b thread_id : thread ID.
556 */
557
558 /**
559 \fn void EvrRtxThreadSwitched (osThreadId_t thread_id)
560 \details
561 The event \b ThreadSwitched is generated when current running thread execution switches.
562
563 \b Value in the Event Recorder shows:
564   - \b thread_id : thread ID.
565 */
566
567 /**
568 \fn void EvrRtxThreadExit (void)
569 \details
570 The event \b ThreadExit is generated when the function \ref osThreadExit is called.
571 */
572
573 /**
574 \fn void EvrRtxThreadTerminate (osThreadId_t thread_id)
575 \details
576 The event \b ThreadTerminate is generated when the function \ref osThreadTerminate is called.
577
578 \b Value in the Event Recorder shows:
579   - \b thread_id : thread ID.
580 */
581
582 /**
583 \fn void EvrRtxThreadDestroyed (osThreadId_t thread_id)
584 \details
585 The event \b ThreadDestroyed is generated when the function \ref osThreadExit or \ref osThreadTerminate successfully terminates the thread.
586
587 \b Value in the Event Recorder shows:
588   - \b thread_id : thread ID.
589 */
590
591 /**
592 \fn void EvrRtxThreadGetCount (uint32_t count)
593 \details
594 The event \b ThreadGetCount is generated when the function \ref osThreadGetCount is called and its execution result is known.
595
596 \b Value in the Event Recorder shows:
597   - \b count : retrieved number of active threads (0 in case of a failure).
598 */
599
600 /**
601 \fn void EvrRtxThreadEnumerate (osThreadId_t *thread_array, uint32_t array_items, uint32_t count)
602 \details
603 The event \b ThreadEnumerate is generated when the function \ref osThreadEnumerate is called and its execution result is known.
604
605 \b Value in the Event Recorder shows:
606   - \b thread_array : memory address of array for retrieving thread IDs.
607   - \b array_items : maximum number of items in thread_array.
608   - \b count : number of enumerated threads (0 in case of a failure).
609 */
610
611 /**
612 @}
613 */
614
615 /**
616 \defgroup rtx_evr_wait Generic Wait Functions
617 \brief Events generated by generic wait functions 
618 \details
619 @{
620 */
621
622 /**
623 \fn void EvrRtxDelayError (int32_t status)
624 \details
625 The event \b DelayError is generated when \ref CMSIS_RTOS_Wait routines complete their execution due to an error.
626
627 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
628 of the extended execution status codes which are summarized in the table below.
629
630 |      Extended Status Code     | Description |
631 |:------------------------------|:------------|
632 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
633 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
634 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
635 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
636 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
637 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
638 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
639 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
640 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
641 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
642 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
643 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
644 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
645 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
646 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
647 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
648
649 \b Value in the Event Recorder shows:
650   - \b status : execution status code.
651 */
652
653 /**
654 \fn void EvrRtxDelay (uint32_t ticks)
655 \details
656 The event \b Delay is generated when the function \ref osDelay is called.
657
658 \b Value in the Event Recorder shows:
659   - \b ticks : \ref CMSIS_RTOS_TimeOutValue "time ticks" value. 
660 */
661
662 /**
663 \fn void EvrRtxDelayUntil (uint32_t ticks)
664 \details
665 The event \b DelayUntil is generated when the function \ref osDelayUntil is called.
666
667 \b Value in the Event Recorder shows:
668   - \b ticks : absolute delay time in ticks.
669 */
670
671 /**
672 \fn void EvrRtxDelayStarted (uint32_t ticks)
673 \details
674 The event \b DelayStarted is generated when \ref osDelay or \ref osDelayUntil delay starts.
675 */
676
677 /**
678 \fn void EvrRtxDelayCompleted (void)
679 \details
680 The event \b DelayCompleted is generated when \ref osDelay or \ref osDelayUntil delay expires.
681 */
682
683 /**
684 @}
685 */
686
687 /**
688 \defgroup rtx_evr_thread_flags Thread Flags Functions
689 \brief Events generated by thread flags functions 
690 \details
691 @{
692 */
693
694 /**
695 \fn void EvrRtxThreadFlagsError (osThreadId_t thread_id, int32_t status)
696 \details
697 The event \b ThreadFlagsError is generated when \ref CMSIS_RTOS_ThreadFlagsMgmt routines complete their execution due to an error.
698
699 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
700 of the extended execution status codes which are summarized in the table below.
701
702 |      Extended Status Code     | Description |
703 |:------------------------------|:------------|
704 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
705 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
706 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
707 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
708 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
709 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
710 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
711 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
712 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
713 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
714 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
715 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
716 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
717 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
718 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
719 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
720
721 \b Value in the Event Recorder shows:
722   - \b thread_id : thread ID.
723   - \b status : execution status code.
724 */
725
726 /**
727 \fn void EvrRtxThreadFlagsSet (osThreadId_t thread_id, int32_t flags)
728 \details
729 The event \b ThreadFlagsSet is generated when the function \ref osThreadFlagsSet is called.
730
731 \b Value in the Event Recorder shows:
732   - \b thread_id : thread ID.
733   - \b flags : flags that shall be set.
734 */
735
736 /**
737 \fn void EvrRtxThreadFlagsSetDone (osThreadId_t thread_id, int32_t thread_flags)
738 \details
739 The event \b ThreadFlagsSetDone is generated when thread flags are successfully set.
740
741 \b Value in the Event Recorder shows:
742   - \b thread_id : thread ID.
743   - \b thread_flags : thread flags after setting.
744 */
745
746 /**
747 \fn void EvrRtxThreadFlagsClear (int32_t flags)
748 \details
749 The event \b ThreadFlagsClear is generated when the function \ref osThreadFlagsClear is called.
750
751 \b Value in the Event Recorder shows:
752   - \b flags : flags that shall be cleared. 
753 */
754
755 /**
756 \fn void EvrRtxThreadFlagsClearDone (int32_t thread_flags)
757 \details
758 The event \b ThreadFlagsClearDone is generated when the function \ref osThreadFlagsClear successfully clears thread flags.
759
760 \b Value in the Event Recorder shows:
761   - \b thread_flags : thread flags before clearing.
762 */
763
764 /**
765 \fn void EvrRtxThreadFlagsGet (int32_t thread_flags)
766 \details
767 The event \b ThreadFlagsGet is generated when the function \ref osThreadFlagsGet is called and its execution result is known.
768
769 \b Value in the Event Recorder shows:
770   - \b thread_flags : current thread flags.
771 */
772
773 /**
774 \fn void EvrRtxThreadFlagsWait (int32_t flags, uint32_t options, uint32_t timeout)
775 \details
776 The event \b ThreadFlagsWait is generated when the function \ref osThreadFlagsWait is called.
777
778 \b Value in the Event Recorder shows:
779   - \b flags : flags to wait for.
780   - \b options : flags options (refer to \ref osThreadFlagsWait "thread flags options").
781   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
782 */
783
784 /**
785 \fn void EvrRtxThreadFlagsWaitPending (int32_t flags, uint32_t options, uint32_t timeout)
786 \details
787 The event \b ThreadFlagsWaitPending is generated when the function \ref osThreadFlagsWait starts waiting for thread flags to become signaled.
788
789 \b Value in the Event Recorder shows:
790   - \b flags : flags to wait for.
791   - \b options : flags options (refer to \ref osThreadFlagsWait "thread flags options").
792   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
793 */
794
795 /**
796 \fn void EvrRtxThreadFlagsWaitTimeout (void)
797 \details
798 The event \b ThreadFlagsWaitTimeout is generated when wait for thread flags to become signaled is aborted due to expired wait timeout.
799 */
800
801 /**
802 \fn void EvrRtxThreadFlagsWaitCompleted (int32_t flags, uint32_t options, int32_t thread_flags)
803 \details
804 The event \b ThreadFlagsWaitCompleted is generated when waiting for thread flags ends because requested flags were signaled.
805
806 \b Value in the Event Recorder shows:
807   - \b flags : flags thread was waiting for.
808   - \b option : flags options (refer to \ref osThreadFlagsWait "thread flags options").
809   - \b thread_flags : thread flags before clearing.
810 */
811
812 /**
813 \fn void EvrRtxThreadFlagsWaitNotCompleted (int32_t flags, uint32_t options)
814 \details
815 The event \b ThreadFlagsWaitNotCompleted is generated when the function \ref osThreadFlagsWait returns without timeout and specified thread flags were not signaled.
816
817 \b Value in the Event Recorder shows:
818   - \b flags : flags thread was waiting for.
819   - \b options : flags options (refer to \ref osThreadFlagsWait "thread flags options").
820 */
821
822 /**
823 @}
824 */
825
826 /**
827 \defgroup rtx_evr_event_flags Event Flags Functions
828 \brief Events generated by event flag functions 
829 \details
830 @{
831 */
832
833 /**
834 \fn void EvrRtxEventFlagsError (osEventFlagsId_t ef_id, int32_t status)
835 \details
836 The event \b EventFlagsError is generated when \ref CMSIS_RTOS_EventFlags routines complete their execution due to an error.
837
838 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
839 of the extended execution status codes which are summarized in the table below.
840
841 |      Extended Status Code     | Description |
842 |:------------------------------|:------------|
843 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
844 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
845 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
846 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
847 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
848 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
849 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
850 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
851 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
852 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
853 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
854 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
855 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
856 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
857 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
858 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
859
860 \b Value in the Event Recorder shows:
861   - \b ef_id : event flags ID.
862   - \b status : execution status code.
863 */
864
865 /**
866 \fn void EvrRtxEventFlagsNew (const osEventFlagsAttr_t *attr)
867 \details
868 The event \b EventFlagsNew is generated when the function \ref osEventFlagsNew is called.
869
870 \b Value in the Event Recorder shows:
871   - \b attr : memory address of Event Flags attributes or 0 when they are not specified.
872 */
873
874 /**
875 \fn void EvrRtxEventFlagsCreated (osEventFlagsId_t ef_id, const char *name)
876 \details
877 The event \b EventFlagsCreated is generated when the function \ref osEventFlagsNew successfully creates a event flags object.
878
879 \b Value in the Event Recorder shows:
880   - \b ef_id : event flags ID.
881 */
882
883 /**
884 \fn void EvrRtxEventFlagsGetName (osEventFlagsId_t ef_id, const char *name)
885 \details
886 The event \b EventFlagsGetName is generated when the function \ref osEventFlagsGetName is called and its execution result is known.
887
888 \b Value in the Event Recorder shows:
889   - \b ef_id : event flags ID.
890   - \b name : retrieved memory address of name string (0 in case of a failure).
891 */
892
893 /**
894 \fn void EvrRtxEventFlagsSet (osEventFlagsId_t ef_id, int32_t flags)
895 \details
896 The event \b EventFlagsSet is generated when the function \ref osEventFlagsSet is called.
897
898 \b Value in the Event Recorder shows:
899   - \b ef_id : event flags ID.
900   - \b flags : flags that shall be set.
901 */
902
903 /**
904 \fn void EvrRtxEventFlagsSetDone (osEventFlagsId_t ef_id, int32_t event_flags)
905 \details
906 The event \b EventFlagsSetDone is generated when event flags are successfully set.
907
908 \b Value in the Event Recorder shows:
909   - \b ef_id : event flags ID.
910   - \b event_flags : event flags after setting.
911 */
912
913 /**
914 \fn void EvrRtxEventFlagsClear (osEventFlagsId_t ef_id, int32_t flags)
915 \details
916 The event \b EventFlagsClear is generated when the function \ref osEventFlagsClear is called.
917
918 \b Value in the Event Recorder shows:
919   - \b ef_id : event flags ID.
920   - \b flags : flags that shall be cleared.
921 */
922
923 /**
924 \fn void EvrRtxEventFlagsClearDone (osEventFlagsId_t ef_id, int32_t event_flags)
925 \details
926 The event \b EventFlagsClearDone is generated when the function \ref osEventFlagsClear successfully clears the event flags.
927
928 \b Value in the Event Recorder shows:
929   - \b ef_id : event flags ID.
930   - \b event_flags : event flags before clearing.
931 */
932
933 /**
934 \fn void EvrRtxEventFlagsGet (osEventFlagsId_t ef_id, int32_t event_flags)
935 \details
936 The event \b EventFlagsGet is generated when the function \ref osEventFlagsGet is called and its execution result is known.
937
938 \b Value in the Event Recorder shows:
939   - \b ef_id : event flags ID.
940   - \b event_flags : retrieved current event flags.
941 */
942
943 /**
944 \fn void EvrRtxEventFlagsWait (osEventFlagsId_t ef_id, int32_t flags, uint32_t options, uint32_t timeout)
945 \details
946 The event \b EventFlagsWait is generated when the function \ref osEventFlagsWait is called.
947
948 \b Value in the Event Recorder shows:
949   - \b ef_id : event flags ID.
950   - \b flags : flags to wait for. 
951   - \b options : flags options (refer to \ref osEventFlagsWait "event flags options").
952   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
953 */
954
955 /**
956 \fn void EvrRtxEventFlagsWaitPending (osEventFlagsId_t ef_id, int32_t flags, uint32_t options, uint32_t timeout)
957 \details
958 The event \b EventFlagsWaitPending is generated when the function \ref osEventFlagsWait starts waiting for event flags to become signaled.
959
960 \b Value in the Event Recorder shows:
961   - \b ef_id : event flags ID.
962   - \b flags : flags to wait for.
963   - \b options : flags options (refer to \ref osEventFlagsWait "event flags options").
964   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
965 */
966
967 /**
968 \fn void EvrRtxEventFlagsWaitTimeout (osEventFlagsId_t ef_id);
969 \details
970 The event \b EventFlagsWaitTimeout is generated when wait for event flags to become signaled is aborted due to expired wait timeout.
971
972 \b Value in the Event Recorder shows:
973   - \b ef_id : event flags ID.
974 */
975
976 /**
977 \fn void EvrRtxEventFlagsWaitCompleted (osEventFlagsId_t ef_id, int32_t flags, uint32_t options, int32_t event_flags)
978 \details
979 The event \b EventFlagsWaitCompleted is generated when waiting for event flags ends because requested flags were signaled.
980
981 \b Value in the Event Recorder shows:
982   - \b ef_id : event flags ID.
983   - \b flags : flags to wait for.
984   - \b options : flags option (refer to \ref osEventFlagsWait "event flags options").
985   - \b event_flags : event flags before clearing or 0 if specified flags have not been set.
986 */
987
988 /**
989 \fn void EvrRtxEventFlagsWaitNotCompleted (osEventFlagsId_t ef_id, int32_t flags, uint32_t options)
990 \details
991 The event \b EventFlagsWaitNotCompleted is generated when the function \ref osEventFlagsWait returns without timeout and specified event flags were not signaled.
992
993 \b Value in the Event Recorder shows:
994   - \b ef_id : event flags ID.
995   - \b flags : flags to wait for.
996   - \b options : flags options (refer to \ref osEventFlagsWait "event flags options").
997 */
998
999 /**
1000 \fn void EvrRtxEventFlagsDelete (osEventFlagsId_t ef_id)
1001 \details
1002 The event \b EventFlagsDelete is generated when the function \ref osEventFlagsDelete is called.
1003
1004 \b Value in the Event Recorder shows:
1005   - \b ef_id : event flags ID.
1006 */
1007
1008 /**
1009 \fn void EvrRtxEventFlagsDestroyed (osEventFlagsId_t ef_id)
1010 \details
1011 The event \b EventFlagsDestroyed is generated when the function \ref osEventFlagsDelete successfully deletes the event flags object.
1012
1013 \b Value in the Event Recorder shows:
1014   - \b ef_id : event flags ID.
1015 */
1016
1017 /**
1018 @}
1019 */
1020
1021 /**
1022 \defgroup rtx_evr_timer Timer Functions
1023 \brief Events generated by timer functions 
1024 \details
1025 @{
1026 */
1027
1028 /**
1029 \fn void EvrRtxTimerError (osTimerId_t timer_id, int32_t status)
1030 \details
1031 The event \b TimerError is generated when \ref CMSIS_RTOS_TimerMgmt routines complete their execution due to an error.
1032
1033 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
1034 of the extended execution status codes which are summarized in the table below.
1035
1036 | Extended Status Code          | Description |
1037 |:------------------------------|:------------|
1038 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
1039 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
1040 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
1041 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
1042 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
1043 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
1044 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
1045 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
1046 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
1047 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
1048 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
1049 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
1050 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
1051 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
1052 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
1053 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
1054
1055 \b Value in the Event Recorder shows:
1056   - \b timer_id : timer ID.
1057   - \b status : execution status code.
1058 */
1059
1060 /**
1061 \fn void EvrRtxTimerCallback (osTimerFunc_t func, void *argument)
1062 \details
1063 The event \b TimerCallback is generated when the timer callback function is called.
1064
1065 \b Value in the Event Recorder shows:
1066   - \b func : start address of a timer call back function. 
1067   - \b argument : memory address of argument to the timer call back function.
1068 */
1069
1070 /**
1071 \fn void EvrRtxTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)
1072 \details
1073 The event \b TimerNew is generated when the function \ref osTimerNew is called.
1074
1075 \b Value in the Event Recorder shows:
1076   - \b func : start address of a timer call back function.
1077   - \b type : timer type: osTimerOnce for one-shot or osTimerPeriodic for periodic behavior.
1078   - \b argument : memory address of argument to the timer call back function.
1079   - \b attr : memory address of Timer attributes or 0 when they are not specified.
1080 */
1081
1082 /**
1083 \fn void EvrRtxTimerCreated (osTimerId_t timer_id, const char *name)
1084 \details
1085 The event \b TimerCreated is generated when the function \ref osTimerNew successfully creates a timer object.
1086
1087 \b Value in the Event Recorder shows:
1088   - \b timer_id : timer ID.
1089 */
1090
1091 /**
1092 \fn void EvrRtxTimerGetName (osTimerId_t timer_id, const char *name)
1093 \details
1094 The event \b TimerGetName is generated when the function \ref osTimerGetName is called and its execution result is known.
1095
1096 \b Value in the Event Recorder shows:
1097   - \b timer_id : timer ID.
1098   - \b name : retrieved memory address of name string (0 in case of a failure).
1099 */
1100
1101 /**
1102 \fn void EvrRtxTimerStart (osTimerId_t timer_id, uint32_t ticks)
1103 \details
1104 The event \b TimerStart is generated when the function \ref osTimerStart is called.
1105
1106 \b Value in the Event Recorder shows:
1107   - \b timer_id : timer ID.
1108   - \b ticks : \ref CMSIS_RTOS_TimeOutValue "time ticks" value of the timer.
1109 */
1110
1111 /**
1112 \fn void EvrRtxTimerStarted (osTimerId_t timer_id)
1113 \details
1114 The event \b TimerStarted is generated when the function \ref osTimerStart successfully starts or restarts the timer operation.
1115
1116 \b Value in the Event Recorder shows:
1117   - \b timer_id : timer ID.
1118 */
1119
1120 /**
1121 \fn void EvrRtxTimerStop (osTimerId_t timer_id)
1122 \details
1123 The event \b TimerStop is generated when the function \ref osTimerStop is called.
1124
1125 \b Value in the Event Recorder shows:
1126   - \b timer_id : timer ID.
1127 */
1128
1129 /**
1130 \fn void EvrRtxTimerStopped (osTimerId_t timer_id)
1131 \details
1132 The event \b TimerStopped is generated when the function \ref osTimerStop successfully stops the timer operation.
1133
1134 \b Value in the Event Recorder shows:
1135   - \b timer_id : timer ID.
1136 */
1137
1138 /**
1139 \fn void EvrRtxTimerIsRunning (osTimerId_t timer_id, uint32_t running)
1140 \details
1141 The event \b TimerIsRunning is generated when the function \ref osTimerIsRunning is called and its execution result is known.
1142
1143 \b Value in the Event Recorder shows:
1144   - \b timer_id : timer ID.
1145   - \b running : timer running state: 0 not running, 1 running.
1146 */
1147
1148 /**
1149 \fn void EvrRtxTimerDelete (osTimerId_t timer_id)
1150 \details
1151 The event \b TimerDelete is generated when the function \ref osTimerDelete is called.
1152
1153 \b Value in the Event Recorder shows:
1154   - \b timer_id : timer ID.
1155 */
1156
1157 /**
1158 \fn void EvrRtxTimerDestroyed (osTimerId_t timer_id)
1159 \details
1160 The event \b TimerDestroyed is generated when the function \ref osTimerDelete successfully deletes the timer object.
1161
1162 \b Value in the Event Recorder shows:
1163   - \b timer_id : timer ID.
1164 */
1165
1166 /**
1167 @}
1168 */
1169
1170 /**
1171 \defgroup rtx_evr_mutex Mutex Functions
1172 \brief Events generated by mutex functions 
1173 \details
1174 @{
1175 */
1176
1177 /**
1178 \fn void EvrRtxMutexError (osMutexId_t mutex_id, int32_t status)
1179 \details
1180 The event \b MutexError is generated when \ref CMSIS_RTOS_MutexMgmt routines complete their execution due to an error.
1181
1182 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
1183 of the extended execution status codes which are summarized in the table below.
1184
1185 |      Extended Status Code     | Description |
1186 |:------------------------------|:------------|
1187 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
1188 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
1189 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
1190 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
1191 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
1192 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
1193 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
1194 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
1195 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
1196 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
1197 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
1198 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
1199 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
1200 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
1201 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
1202 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
1203
1204 \b Value in the Event Recorder shows:
1205   - \b mutex_id : mutex ID.
1206   - \b status : execution status code.
1207 */
1208
1209 /**
1210 \fn void EvrRtxMutexNew (const osMutexAttr_t *attr)
1211 \details
1212 The event \b MutexNew is generated when the function \ref osMutexNew is called.
1213
1214 \b Value in the Event Recorder shows:
1215   - \b attr : memory address of Mutex attributes or 0 when they are not specified.
1216 */
1217
1218 /**
1219 \fn void EvrRtxMutexCreated (osMutexId_t mutex_id, const char *name)
1220 \details
1221 The event \b MutexCreated is generated when the function \ref osMutexNew successfully creates a mutex object.
1222
1223 \b Value in the Event Recorder shows:
1224   - \b mutex_id : mutex ID.
1225 */
1226
1227 /**
1228 \fn void EvrRtxMutexGetName (osMutexId_t mutex_id, const char *name)
1229 \details
1230 The event \b MutexGetName is generated when the function \ref osMutexGetName is called and its execution result is known.
1231
1232 \b Value in the Event Recorder shows:
1233   - \b mutex_id : mutex ID.
1234   - \b name : retrieved memory address of name string (0 in case of a failure).
1235 */
1236
1237 /**
1238 \fn void EvrRtxMutexAcquire (osMutexId_t mutex_id, uint32_t timeout)
1239 \details
1240 The event \b MutexAcquire is generated when the function \ref osMutexAcquire is called.
1241
1242 \b Value in the Event Recorder shows:
1243   - \b mutex_id : mutex ID.
1244   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1245 */
1246
1247 /**
1248 \fn void EvrRtxMutexAcquirePending (osMutexId_t mutex_id, uint32_t timeout)
1249 \details
1250 The event \b MutexAcquirePending is generated when the function \ref osMutexAcquire blocks current running thread and waits for mutex to become available.
1251
1252 \b Value in the Event Recorder shows:
1253   - \b mutex_id : mutex ID.
1254   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1255 */
1256
1257 /**
1258 \fn void EvrRtxMutexAcquireTimeout (osMutexId_t mutex_id)
1259 \details
1260 The event \b MutexAcquireTimeout is generated when wait for mutex to become available is aborted due to expired wait timeout.
1261
1262 \b Value in the Event Recorder shows:
1263   - \b mutex_id : mutex ID.
1264 */
1265
1266 /**
1267 \fn void EvrRtxMutexAcquired (osMutexId_t mutex_id, uint32_t lock)
1268 \details
1269 The event \b MutexAcquired is generated when the function \ref osMutexAcquire successfully acquires a mutex.
1270
1271 \b Value in the Event Recorder shows:
1272   - \b mutex_id : mutex ID.
1273   - \b lock : current lock counter state.
1274 */
1275
1276 /**
1277 \fn void EvrRtxMutexNotAcquired (osMutexId_t mutex_id)
1278 \details
1279 The event \b MutexNotAcquired is generated when the function \ref osMutexAcquire returns without timeout and mutex was not acquired.
1280
1281 \b Value in the Event Recorder shows:
1282   - \b mutex_id : mutex ID.
1283 */
1284
1285 /**
1286 \fn void EvrRtxMutexRelease (osMutexId_t mutex_id)
1287 \details
1288 The event \b MutexRelease is generated when the function \ref osMutexRelease is called.
1289
1290 \b Value in the Event Recorder shows:
1291   - \b mutex_id : mutex ID.
1292 */
1293
1294 /**
1295 \fn void EvrRtxMutexReleased (osMutexId_t mutex_id, uint32_t lock)
1296 \details
1297 The event \b MutexReleased is generated when the function \ref osMutexRelease successfully releases a mutex.
1298
1299 \b Value in the Event Recorder shows:
1300   - \b mutex_id : mutex ID.
1301   - \b lock : current lock counter state.
1302 */
1303
1304 /**
1305 \fn void EvrRtxMutexGetOwner (osMutexId_t mutex_id, osThreadId_t thread_id)
1306 \details
1307 The event \b MutexGetOwner is generated when the function \ref osMutexGetOwner is called and its execution result is known.
1308
1309 \b Value in the Event Recorder shows:
1310   - \b mutex_id : mutex ID.
1311   - \b thread_id : retrieved owner thread ID (0 in case of a failure or when mutex is not locked)
1312 */
1313
1314 /**
1315 \fn void EvrRtxMutexDelete (osMutexId_t mutex_id)
1316 \details
1317 The event \b MutexDelete is generated when the function \ref osMutexDelete is called.
1318
1319 \b Value in the Event Recorder shows:
1320   - \b mutex_id : mutex ID.
1321 */
1322
1323 /**
1324 \fn void EvrRtxMutexDestroyed (osMutexId_t mutex_id)
1325 \details
1326 The event \b MutexDestroyed is generated when the function \ref osMutexDelete successfully deletes the mutex object.
1327
1328 \b Value in the Event Recorder shows:
1329   - \b mutex_id : mutex ID.
1330 */
1331
1332 /**
1333 @}
1334 */
1335
1336 /**
1337 \defgroup rtx_evr_semaphore Semaphore Functions
1338 \brief Events generated by semaphore functions 
1339 \details
1340 @{
1341 */
1342
1343 /**
1344 \fn void EvrRtxSemaphoreError (osSemaphoreId_t semaphore_id, int32_t status)
1345 \details
1346 The event \b SemaphoreError is generated when \ref CMSIS_RTOS_SemaphoreMgmt routines complete their execution due to an error.
1347
1348 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
1349 of the extended execution status codes which are summarized in the table below.
1350
1351 |      Extended Status Code     | Description |
1352 |:------------------------------|:------------|
1353 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
1354 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
1355 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
1356 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
1357 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
1358 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
1359 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
1360 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
1361 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
1362 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
1363 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
1364 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
1365 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
1366 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
1367 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
1368 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
1369
1370 \b Value in the Event Recorder shows:
1371   - \b semaphore_id : semaphore ID.
1372   - \b status : execution status code.
1373 */
1374
1375 /**
1376 \fn void EvrRtxSemaphoreNew (uint32_t max_count, uint32_t initial_count, const osSemaphoreAttr_t *attr)
1377 \details
1378 The event \b SemaphoreNew is generated when the function \ref osSemaphoreNew is called.
1379
1380 \b Value in the Event Recorder shows:
1381   - \b max_count : maximum number of available tokens. 
1382   - \b initial_count : initial number of available tokens.
1383   - \b attr : memory address of Semaphore attributes or 0 when they are not specified.
1384 */
1385
1386 /**
1387 \fn void EvrRtxSemaphoreCreated (osSemaphoreId_t semaphore_id, const char *name)
1388 \details
1389 The event \b SemaphoreCreated is generated when the function \ref osSemaphoreNew successfully creates a semaphore object.
1390
1391 \b Value in the Event Recorder shows:
1392   - \b semaphore_id : semaphore ID.
1393 */
1394
1395 /**
1396 \fn void EvrRtxSemaphoreGetName (osSemaphoreId_t semaphore_id, const char *name)
1397 \details
1398 The event \b SemaphoreGetName is generated when the function \ref osSemaphoreGetName is called and its execution result is known.
1399
1400 \b Value in the Event Recorder shows:
1401   - \b semaphore_id : semaphore ID.
1402   - \b name : retrieved memory address of name string (0 in case of a failure).
1403 */
1404
1405 /**
1406 \fn void EvrRtxSemaphoreAcquire (osSemaphoreId_t semaphore_id, uint32_t timeout)
1407 \details
1408 The event \b SemaphoreAcquire is generated when the function \ref osSemaphoreAcquire is called.
1409
1410 \b Value in the Event Recorder shows:
1411   - \b semaphore_id : semaphore ID.
1412   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1413 */
1414
1415 /**
1416 \fn void EvrRtxSemaphoreAcquirePending (osSemaphoreId_t semaphore_id, uint32_t timeout)
1417 \details
1418 The event \b SemaphoreAcquirePending is generated when the function \ref osSemaphoreAcquire blocks current running thread and waits for semaphore token to become available.
1419
1420 \b Value in the Event Recorder shows:
1421   - \b semaphore_id : semaphore ID.
1422   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1423 */
1424
1425 /**
1426 \fn void EvrRtxSemaphoreAcquireTimeout (osSemaphoreId_t semaphore_id)
1427 \details
1428 The event \b SemaphoreAcquireTimeout is generated when wait for semaphore to become available is aborted due to expired wait timeout.
1429
1430 \b Value in the Event Recorder shows:
1431   - \b semaphore_id : semaphore ID.
1432 */
1433
1434 /**
1435 \fn void EvrRtxSemaphoreAcquired (osSemaphoreId_t semaphore_id, uint32_t tokens)
1436 \details
1437 The event \b SemaphoreAcquired is generated when the function \ref osSemaphoreAcquire successfully acquires the semaphore token.
1438
1439 \b Value in the Event Recorder shows:
1440   - \b semaphore_id : semaphore ID.
1441   - \b tokens : available tokens.
1442 */
1443
1444 /**
1445 \fn void EvrRtxSemaphoreNotAcquired (osSemaphoreId_t semaphore_id)
1446 \details
1447 The event \b SemaphoreNotAcquired is generated when the function \ref osMutexAcquire returns without timeout and semaphore token was not acquired.
1448
1449 \b Value in the Event Recorder shows:
1450   - \b semaphore_id : semaphore ID.
1451 */
1452
1453 /**
1454 \fn void EvrRtxSemaphoreRelease (osSemaphoreId_t semaphore_id)
1455 \details
1456 The event \b SemaphoreRelease is generated when the function \ref osSemaphoreRelease is called.
1457
1458 \b Value in the Event Recorder shows:
1459   - \b semaphore_id : semaphore ID.
1460 */
1461
1462 /**
1463 \fn void EvrRtxSemaphoreReleased (osSemaphoreId_t semaphore_id, uint32_t tokens)
1464 \details
1465 The event \b SemaphoreReleased is generated when the function \ref osSemaphoreRelease successfully releases the semaphore token.
1466
1467 \b Value in the Event Recorder shows:
1468   - \b semaphore_id : semaphore ID.
1469   - \b tokens : available tokens.
1470 */
1471
1472 /**
1473 \fn void EvrRtxSemaphoreGetCount (osSemaphoreId_t semaphore_id, uint32_t count)
1474 \details
1475 The event \b SemaphoreGetCount is generated when the function \ref osSemaphoreGetCount is called and its execution result is known.
1476
1477 \b Value in the Event Recorder shows:
1478   - \b semaphore_id : semaphore ID.
1479   - \b count : retrieved current number of available tokens. 
1480 */
1481
1482 /**
1483 \fn void EvrRtxSemaphoreDelete (osSemaphoreId_t semaphore_id)
1484 \details
1485 The event \b SemaphoreDelete is generated when the function \ref osSemaphoreDelete is called.
1486
1487 \b Value in the Event Recorder shows:
1488   - \b semaphore_id : semaphore ID.
1489 */
1490
1491 /**
1492 \fn void EvrRtxSemaphoreDestroyed (osSemaphoreId_t semaphore_id)
1493 \details
1494 The event \b SemaphoreDestroyed is generated when the function \ref osSemaphoreDelete successfully deletes the semaphore object.
1495
1496 \b Value in the Event Recorder shows:
1497   - \b semaphore_id : semaphore ID.
1498 */
1499
1500 /**
1501 @}
1502 */
1503
1504 /**
1505 \defgroup rtx_evr_memory_pool Memory Pool Functions
1506 \brief Events generated by memory pool functions 
1507 \details
1508 @{
1509 */
1510
1511 /**
1512 \fn void EvrRtxMemoryPoolError (osMemoryPoolId_t mp_id, int32_t status)
1513 \details
1514 The event \b MemoryPoolError is generated when \ref CMSIS_RTOS_PoolMgmt routines complete their execution due to an error.
1515
1516 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
1517 of the extended execution status codes which are summarized in the table below.
1518
1519 |      Extended Status Code     | Description |
1520 |:------------------------------|:------------|
1521 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
1522 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
1523 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
1524 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
1525 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
1526 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
1527 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
1528 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
1529 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
1530 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
1531 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
1532 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
1533 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
1534 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
1535 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
1536 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
1537
1538 \b Value in the Event Recorder shows:
1539   - \b mp_id : memory pool ID.
1540   - \b status : execution status code.
1541 */
1542
1543 /**
1544 \fn void EvrRtxMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr)
1545 \details
1546 The event \b MemoryPoolNew is generated when the function \ref osMemoryPoolNew is called.
1547
1548 \b Value in the Event Recorder shows:
1549   - \b block_count : maximum number of memory blocks in memory pool.
1550   - \b block_size : memory block size in bytes.
1551   - \b attr : memory address of Memory Pool attributes or 0 when they are not specified.
1552 */
1553
1554 /**
1555 \fn void EvrRtxMemoryPoolCreated (osMemoryPoolId_t mp_id, const char *name)
1556 \details
1557 The event \b MemoryPoolCreated is generated when the function \ref osMemoryPoolNew successfully creates a memory pool object.
1558
1559 \b Value in the Event Recorder shows:
1560   - \b mp_id : memory pool ID.
1561 */
1562
1563 /**
1564 \fn void EvrRtxMemoryPoolGetName (osMemoryPoolId_t mp_id, const char *name)
1565 \details
1566 The event \b MemoryPoolGetName is generated when the function \ref osMemoryPoolGetName is called and its execution result is known.
1567
1568 \b Value in the Event Recorder shows:
1569   - \b mp_id : memory pool ID.
1570   - \b name : retrieved memory address of name string (0 in case of a failure).
1571 */
1572
1573 /**
1574 \fn void EvrRtxMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout)
1575 \details
1576 The event \b MemoryPoolAlloc is generated when the function \ref osMemoryPoolAlloc is called.
1577
1578 \b Value in the Event Recorder shows:
1579   - \b mp_id : memory pool ID.
1580   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1581 */
1582
1583 /**
1584 \fn void EvrRtxMemoryPoolAllocPending (osMemoryPoolId_t mp_id, uint32_t timeout)
1585 \details
1586 The event \b MemoryPoolAllocPending is generated when the function \ref osMemoryPoolAlloc blocks current running thread and waits for memory block to become available.
1587
1588 \b Value in the Event Recorder shows:
1589   - \b mp_id : memory pool ID.
1590   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1591 */
1592
1593 /**
1594 \fn void EvrRtxMemoryPoolAllocTimeout (osMemoryPoolId_t mp_id)
1595 \details
1596 The event \b MemoryPoolAllocTimeout is generated when wait for memory pool to become available is aborted due to expired wait timeout.
1597
1598 \b Value in the Event Recorder shows:
1599   - \b mp_id : memory pool ID.
1600 */
1601
1602 /**
1603 \fn void EvrRtxMemoryPoolAllocated (osMemoryPoolId_t mp_id, void *block)
1604 \details
1605 The event \b MemoryPoolAllocated is generated when the function \ref osMemoryPoolAlloc successfully allocates the memory block.
1606
1607 \b Value in the Event Recorder shows:
1608   - \b mp_id : memory pool ID.
1609   - \b block : memory address of the allocated memory block.
1610 */
1611
1612 /**
1613 \fn void EvrRtxMemoryPoolAllocFailed (osMemoryPoolId_t mp_id)
1614 \details
1615 The event \b MemoryPoolAllocFailed is generated when the function \ref osMemoryPoolAlloc fails to allocate the memory block due to out of available memory.
1616
1617 \b Value in the Event Recorder shows:
1618   - \b mp_id : memory pool ID.
1619 */
1620
1621 /**
1622 \fn void EvrRtxMemoryPoolFree (osMemoryPoolId_t mp_id, void *block)
1623 \details
1624 The event \b MemoryPoolFree is generated when the function \ref osMemoryPoolFree is called.
1625
1626 \b Value in the Event Recorder shows:
1627   - \b mp_id : memory pool ID.
1628   - \b block : memory address of the memory block to be returned to the memory pool.
1629 */
1630
1631 /**
1632 \fn void EvrRtxMemoryPoolDeallocated (osMemoryPoolId_t mp_id, void *block)
1633 \details
1634 The event \b MemoryPoolDeallocated is generated when the function \ref osMemoryPoolFree successfully deallocates the memory block.
1635
1636 \b Value in the Event Recorder shows:
1637   - \b mp_id : memory pool ID.
1638   - \b block : memory address of the memory block returned to the memory pool. 
1639 */
1640
1641 /**
1642 \fn void EvrRtxMemoryPoolFreeFailed (osMemoryPoolId_t mp_id, void *block)
1643 \details
1644 The event \b MemoryPoolFreeFailed is generated when the function \ref osMemoryPoolFree fails to deallocate the memory block.
1645
1646 \b Value in the Event Recorder shows:
1647   - \b mp_id : memory pool ID.
1648   - \b block : memory address of the memory block to be returned to the memory pool.
1649 */
1650
1651 /**
1652 \fn void EvrRtxMemoryPoolGetCapacity (osMemoryPoolId_t mp_id, uint32_t capacity)
1653 \details
1654 The event \b MemoryPoolGetCapacity is generated when the function \ref osMemoryPoolGetCapacity is called and its execution result is known.
1655
1656 \b Value in the Event Recorder shows:
1657   - \b mp_id : memory pool ID.
1658   - \b capacity : retrieved maximum number of memory blocks (0 in case of a failure). 
1659 */
1660
1661 /**
1662 \fn void EvrRtxMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id, uint32_t block_size)
1663 \details
1664 The event \b MemoryPoolGetBlockSize is generated when the function \ref osMemoryPoolGetBlockSize is called and its execution result is known.
1665
1666 \b Value in the Event Recorder shows:
1667   - \b mp_id : memory pool ID.
1668   - \b block_size : retrieved memory block size in bytes (0 in case of a failure).
1669 */
1670
1671 /**
1672 \fn void EvrRtxMemoryPoolGetCount (osMemoryPoolId_t mp_id, uint32_t count)
1673 \details
1674 The event \b MemoryPoolGetCount is generated when the function \ref osMemoryPoolGetCount is called and its execution result is known.
1675
1676 \b Value in the Event Recorder shows:
1677   - \b mp_id : memory pool ID.
1678   - \b count : retrieved number of memory block used (0 in case of a failure).
1679 */
1680
1681 /**
1682 \fn void EvrRtxMemoryPoolGetSpace (osMemoryPoolId_t mp_id, uint32_t space)
1683 \details
1684 The event \b MemoryPoolGetSpace is generated when the function \ref osMemoryPoolGetSpace is called and its execution result is known.
1685
1686 \b Value in the Event Recorder shows:
1687   - \b mp_id : memory pool ID.
1688   - \b space : retrieved number of memory blocks available (0 in case of a failure).
1689 */
1690
1691 /**
1692 \fn void EvrRtxMemoryPoolDelete (osMemoryPoolId_t mp_id)
1693 \details
1694 The event \b MemoryPoolDelete is generated when the function \ref osMemoryPoolDelete is called.
1695
1696 \b Value in the Event Recorder shows:
1697   - \b mp_id : memory pool ID.
1698 */
1699
1700 /**
1701 \fn void EvrRtxMemoryPoolDestroyed (osMemoryPoolId_t mp_id)
1702 \details
1703 The event \b MemoryPoolDestroyed is generated when the function \ref osMemoryPoolDelete successfully deletes the memory pool object.
1704
1705 \b Value in the Event Recorder shows:
1706   - \b mp_id : memory pool ID.
1707 */
1708
1709 /**
1710 @}
1711 */
1712
1713 /**
1714 \defgroup rtx_evr_message_queue Message Queue Functions
1715 \brief Events generated by message queue functions 
1716 \details
1717 @{
1718 */
1719
1720 /**
1721 \fn void EvrRtxMessageQueueError (osMessageQueueId_t mq_id, int32_t status)
1722 \details
1723 The event \b MessageQueueError is generated when \ref CMSIS_RTOS_Message routines complete their execution due to an error.
1724
1725 The status parameter indicates the execution status and can be one of the \ref osStatus_t "osStatus_t codes" or one
1726 of the extended execution status codes which are summarized in the table below.
1727
1728 |      Extended Status Code     | Description |
1729 |:------------------------------|:------------|
1730 | osRtxErrorKernelNotReady      | Kernel scheduler is not in Ready state. |
1731 | osRtxErrorKernelNotRunning    | Kernel scheduler is not executing - there is no running thread. |
1732 | osRtxErrorInvalidControlBlock | Object control block with invalid alignment or size was specified. |
1733 | osRtxErrorInvalidDataMemory   | Object data memory with invalid alignment or size was specified. |
1734 | osRtxErrorInvalidThreadStack  | Thread stack memory with invalid alignment or size was specified. |
1735 | osRtxErrorInvalidPriority     | Invalid thread priority was specified. |
1736 | osRtxErrorThreadNotJoinable   | Specified thread is not joinable. |
1737 | osRtxErrorMutexNotOwned       | Specified mutex is not owned by the current running thread. |
1738 | osRtxErrorMutexNotLocked      | Specified mutex is not locked. |
1739 | osRtxErrorMutexLockLimit      | Maximum number of recursive mutex locks reached. |
1740 | osRtxErrorSemaphoreCountLimit | Semaphore count limit reached. |
1741 | osRtxErrorTZ_InitContext_S    | Secure context memory system initialization failed. |
1742 | osRtxErrorTZ_AllocContext_S   | Secure context memory allocation failed. |
1743 | osRtxErrorTZ_FreeContext_S    | Secure context memory deallocation failed. |
1744 | osRtxErrorTZ_LoadContext_S    | Secure context load failed. |
1745 | osRtxErrorTZ_SaveContext_S    | Secure context save failed. |
1746
1747 \b Value in the Event Recorder shows:
1748   - \b mq_id : message queue ID.
1749   - \b status : execution status code.
1750 */
1751
1752 /**
1753 \fn void EvrRtxMessageQueueNew (uint32_t msg_count, uint32_t msg_size, const osMessageQueueAttr_t *attr)
1754 \details
1755 The event \b MessageQueueNew is generated when the function \ref osMessageQueueNew is called.
1756
1757 \b Value in the Event Recorder shows:
1758   - \b msg_count : maximum number of messages in queue.
1759   - \b msg_size : maximum message size in bytes.
1760   - \b attr : memory address of Message Queue attributes or 0 when they are not specified.
1761 */
1762
1763 /**
1764 \fn void EvrRtxMessageQueueCreated (osMessageQueueId_t mq_id, const char *name)
1765 \details
1766 The event \b MessageQueueCreated is generated when the function \ref osMessageQueueNew successfully creates a message queue object.
1767
1768 \b Value in the Event Recorder shows:
1769   - \b mq_id : message queue ID.
1770 */
1771
1772 /**
1773 \fn void EvrRtxMessageQueueGetName (osMessageQueueId_t mq_id, const char *name)
1774 \details
1775 The event \b MessageQueueGetName is generated when the function \ref osMessageQueueGetName is called and its execution result is known.
1776
1777 \b Value in the Event Recorder shows:
1778   - \b mq_id : message queue ID.
1779   - \b name : retrieved memory address of name string (0 in case of a failure).
1780 */
1781
1782 /**
1783 \fn void EvrRtxMessageQueuePut (osMessageQueueId_t mq_id, const void *msg_ptr, uint8_t msg_prio, uint32_t timeout)
1784 \details
1785 The event \b MessageQueuePut is generated when the function \ref osMessageQueuePut is called.
1786
1787 \b Value in the Event Recorder shows:
1788   - \b mq_id : message queue ID.
1789   - \b msg_ptr : memory address of message buffer.
1790   - \b msg_prio : message priority.
1791   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1792 */
1793
1794 /**
1795 \fn void EvrRtxMessageQueuePutPending (osMessageQueueId_t mq_id, const void *msg_ptr, uint32_t timeout)
1796 \details
1797 The event \b MessageQueuePutPending is generated when the function \ref osMessageQueuePut starts waiting to put message into the queue.
1798
1799 \b Value in the Event Recorder shows:
1800   - \b mq_id : message queue ID.
1801   - \b msg_ptr : memory address of message buffer.
1802   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1803 */
1804
1805 /**
1806 \fn void EvrRtxMessageQueuePutTimeout (osMessageQueueId_t mq_id)
1807 \details
1808 The event \b MessageQueuePutTimeout is generated when the function \ref osMessageQueuePut fails to insert a message into the queue until timeout expires.
1809
1810 \b Value in the Event Recorder shows:
1811   - \b mq_id : message queue ID.
1812 */
1813
1814 /**
1815 \fn void EvrRtxMessageQueueInsertPending (osMessageQueueId_t mq_id, const void *msg_ptr)
1816 \details
1817 The event \b MessageQueueInsertPending is generated when the function \ref osMessageQueuePut is called from ISR and message is registered to be put into the queue. 
1818
1819 \b Value in the Event Recorder shows:
1820   - \b mq_id : message queue ID.
1821   - \b msg_ptr : memory address of message buffer.
1822 */
1823
1824 /**
1825 \fn void EvrRtxMessageQueueInserted (osMessageQueueId_t mq_id, const void *msg_ptr)
1826 \details
1827 The event \b MessageQueueInserted is generated when a message is successfully inserted into the queue.
1828
1829 \b Value in the Event Recorder shows:
1830   - \b mq_id : message queue ID.
1831   - \b msg_ptr : memory address of message buffer.
1832 */
1833
1834 /**
1835 \fn void EvrRtxMessageQueueNotInserted (osMessageQueueId_t mq_id, const void *msg_ptr)
1836 \details
1837 The event \b MessageQueueNotInserted is generated when the function \ref osMessageQueuePut fails to insert a message into the queue.
1838 Usually this happens when queue is out of memory.
1839
1840 \b Value in the Event Recorder shows:
1841   - \b mq_id : message queue ID.
1842   - \b msg_ptr : memory address of message buffer.
1843 */
1844
1845 /**
1846 \fn void EvrRtxMessageQueueGet (osMessageQueueId_t mq_id, void *msg_ptr, uint8_t *msg_prio, uint32_t timeout)
1847 \details
1848 The event \b MessageQueueGet is generated when the function \ref osMessageQueueGet is called.
1849
1850 \b Value in the Event Recorder shows:
1851   - \b mq_id : message queue ID.
1852   - \b msg_ptr : memory address of buffer for message.
1853   - \b msg_prio : memory address of buffer for message priority.
1854   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1855 */
1856
1857 /**
1858 \fn void EvrRtxMessageQueueGetPending (osMessageQueueId_t mq_id, void *msg_ptr, uint32_t timeout)
1859 \details
1860 The event \b MessageQueueGetPending is generated when the function \ref osMessageQueueGet starts waiting for message to be retrieved from the queue.
1861
1862 \b Value in the Event Recorder shows:
1863   - \b mq_id : message queue ID.
1864   - \b msg_ptr : memory address of buffer for message.
1865   - \b timeout : \ref CMSIS_RTOS_TimeOutValue.
1866 */
1867
1868 /**
1869 \fn void EvrRtxMessageQueueGetTimeout (osMessageQueueId_t mq_id)
1870 \details
1871 The event \b MessageQueueGetTimeout is generated when the function \ref osMessageQueueGet is called and there is no message available in queue until timeout expires.
1872
1873 \b Value in the Event Recorder shows:
1874   - \b mq_id : message queue ID.
1875 */
1876
1877 /**
1878 \fn void EvrRtxMessageQueueRetrieved (osMessageQueueId_t mq_id, void *msg_ptr)
1879 \details
1880 The event \b MessageQueueRetrieved is generated when message is retrieved from the message queue.
1881
1882 \b Value in the Event Recorder shows:
1883   - \b mq_id : message queue ID.
1884   - \b msg_ptr : memory address of buffer for message.
1885 */
1886
1887 /**
1888 \fn void EvrRtxMessageQueueNotRetrieved (osMessageQueueId_t mq_id, void *msg_ptr)
1889 \details
1890 The event \b MessageQueueNotRetrieved is generated when the function \ref osMessageQueueGet is called without the wait timeout and there is no message available in queue.
1891
1892 \b Value in the Event Recorder shows:
1893   - \b mq_id : message queue ID.
1894   - \b msg_ptr : memory address of buffer for message.
1895 */
1896
1897 /**
1898 \fn void EvrRtxMessageQueueGetCapacity (osMessageQueueId_t mq_id, uint32_t capacity)
1899 \details
1900 The event \b MessageQueueGetCapacity is generated when the function \ref osMessageQueueGetCapacity is called and its execution result is known.
1901
1902 \b Value in the Event Recorder shows:
1903   - \b mq_id : message queue ID.
1904   - \b capacity : retrieved maximum number of messages (0 in case of a failure).
1905 */
1906
1907 /**
1908 \fn void EvrRtxMessageQueueGetMsgSize (osMessageQueueId_t mq_id, uint32_t msg_size)
1909 \details
1910 The event \b MessageQueueGetMsgSize is generated when the function \ref osMessageQueueGetMsgSize is called and its execution result is known.
1911
1912 \b Value in the Event Recorder shows:
1913   - \b mq_id : message queue ID.
1914   - \b msg_size : retrieved maximum message size in bytes (0 in case of a failure).
1915 */
1916
1917 /**
1918 \fn void EvrRtxMessageQueueGetCount (osMessageQueueId_t mq_id, uint32_t count)
1919 \details
1920 The event \b MessageQueueGetCount is generated when the function \ref osMessageQueueGetCount is called and its execution result is known.
1921
1922 \b Value in the Event Recorder shows:
1923   - \b mq_id : message queue ID.
1924   - \b count : retrieved number of queued messages (0 in case of a failure).
1925 */
1926
1927 /**
1928 \fn void EvrRtxMessageQueueGetSpace (osMessageQueueId_t mq_id, uint32_t space)
1929 \details
1930 The event \b MessageQueueGetSpace is generated when the function \ref osMessageQueueGetSpace is called and its execution result is known.
1931
1932 \b Value in the Event Recorder shows:
1933   - \b mq_id : message queue ID.
1934   - \b space : retrieved number of available slots for messages (0 in case of a failure).
1935 */
1936
1937 /**
1938 \fn void EvrRtxMessageQueueReset (osMessageQueueId_t mq_id)
1939 \details
1940 The event \b MessageQueueReset is generated when the function \ref osMessageQueueReset is called.
1941
1942 \b Value in the Event Recorder shows:
1943   - \b mq_id : message queue ID.
1944 */
1945
1946 /**
1947 \fn void EvrRtxMessageQueueResetDone (osMessageQueueId_t mq_id)
1948 \details
1949 The event \b MessageQueueResetDone is generated when the function \ref osMessageQueueReset successfully completes message queue reset.
1950
1951 \b Value in the Event Recorder shows:
1952   - \b mq_id : message queue ID.
1953 */
1954
1955 /**
1956 \fn void EvrRtxMessageQueueDelete (osMessageQueueId_t mq_id)
1957 \details
1958 The event \b MessageQueueDelete is generated when the function \ref osMessageQueueDelete is called.
1959
1960 \b Value in the Event Recorder shows:
1961   - \b mq_id : message queue ID.
1962 */
1963
1964 /**
1965 \fn void EvrRtxMessageQueueDestroyed (osMessageQueueId_t mq_id)
1966 \details
1967 The event \b MessageQueueDestroyed is generated when the function \ref osMessageQueueDelete successfully deletes the message queue object.
1968
1969 \b Value in the Event Recorder shows:
1970   - \b mq_id : message queue ID.
1971 */
1972
1973 /**
1974 @}
1975 */
1976
1977 /**
1978 @} 
1979 */
1980 // end group Event Recorder