Преглед на файлове

RTOS2: Functions osXxxGetName allowed to be called from Interrupt Service Routines

Robert Rostohar преди 2 години
родител
ревизия
2a65576408

+ 18 - 14
CMSIS/DoxyGen/RTOS2/src/cmsis_os2.txt

@@ -615,13 +615,15 @@ Examples:
 The following CMSIS-RTOS2 functions can be called from threads and Interrupt Service Routines (ISR):
   - \ref osKernelGetInfo, \ref osKernelGetState,
     \ref osKernelGetTickCount, \ref osKernelGetTickFreq, \ref osKernelGetSysTimerCount, \ref osKernelGetSysTimerFreq
-  - \ref osThreadGetId, \ref osThreadFlagsSet
-  - \ref osEventFlagsSet, \ref osEventFlagsClear, \ref osEventFlagsGet, \ref osEventFlagsWait
-  - \ref osSemaphoreAcquire, \ref osSemaphoreRelease, \ref osSemaphoreGetCount
-  - \ref osMemoryPoolAlloc, \ref osMemoryPoolFree, \ref osMemoryPoolGetCapacity, \ref osMemoryPoolGetBlockSize,
-    \ref osMemoryPoolGetCount, \ref osMemoryPoolGetSpace
-  - \ref osMessageQueuePut, \ref osMessageQueueGet, \ref osMessageQueueGetCapacity, \ref osMessageQueueGetMsgSize,
-    \ref osMessageQueueGetCount, \ref osMessageQueueGetSpace
+  - \ref osThreadGetName, \ref osThreadGetId, \ref osThreadFlagsSet
+  - \ref osTimerGetName
+  - \ref osEventFlagsGetName, \ref osEventFlagsSet, \ref osEventFlagsClear, \ref osEventFlagsGet, \ref osEventFlagsWait
+  - \ref osMutexGetName
+  - \ref osSemaphoreGetName, \ref osSemaphoreAcquire, \ref osSemaphoreRelease, \ref osSemaphoreGetCount
+  - \ref osMemoryPoolGetName, \ref osMemoryPoolAlloc, \ref osMemoryPoolFree,
+    \ref osMemoryPoolGetCapacity, \ref osMemoryPoolGetBlockSize, \ref osMemoryPoolGetCount, \ref osMemoryPoolGetSpace
+  - \ref osMessageQueueGetName, \ref osMessageQueuePut, \ref osMessageQueueGet, \ref osMessageQueueGetCapacity,
+    \ref osMessageQueueGetMsgSize, \ref osMessageQueueGetCount, \ref osMessageQueueGetSpace
 
 Functions that cannot be called from an ISR are verifying the interrupt status and return the status code \b osErrorISR, in
 case they are called from an ISR context. In some implementations, this condition might be caught using the HARD_FAULT
@@ -2233,13 +2235,15 @@ The following CMSIS-RTOS C API v2 functions can be called from threads and \ref
 (ISR):
    - \ref osKernelGetInfo, \ref osKernelGetState,
      \ref osKernelGetTickCount, \ref osKernelGetTickFreq, \ref osKernelGetSysTimerCount, \ref osKernelGetSysTimerFreq
-   - \ref osThreadGetId, \ref osThreadFlagsSet
-   - \ref osEventFlagsSet, \ref osEventFlagsClear, \ref osEventFlagsGet, \ref osEventFlagsWait
-   - \ref osSemaphoreAcquire, \ref osSemaphoreRelease, \ref osSemaphoreGetCount
-   - \ref osMemoryPoolAlloc, \ref osMemoryPoolFree, \ref osMemoryPoolGetCapacity, \ref osMemoryPoolGetBlockSize,
-     \ref osMemoryPoolGetCount, \ref osMemoryPoolGetSpace
-   - \ref osMessageQueuePut, \ref osMessageQueueGet, \ref osMessageQueueGetCapacity, \ref osMessageQueueGetMsgSize,
-     \ref osMessageQueueGetCount, \ref osMessageQueueGetSpace
+   - \ref osThreadGetName, \ref osThreadGetId, \ref osThreadFlagsSet
+   - \ref osTimerGetName
+   - \ref osEventFlagsGetName, \ref osEventFlagsSet, \ref osEventFlagsClear, \ref osEventFlagsGet, \ref osEventFlagsWait
+   - \ref osMutexGetName
+   - \ref osSemaphoreGetName, \ref osSemaphoreAcquire, \ref osSemaphoreRelease, \ref osSemaphoreGetCount
+   - \ref osMemoryPoolGetName, \ref osMemoryPoolAlloc, \ref osMemoryPoolFree,
+     \ref osMemoryPoolGetCapacity, \ref osMemoryPoolGetBlockSize, \ref osMemoryPoolGetCount, \ref osMemoryPoolGetSpace
+   - \ref osMessageQueueGetName, \ref osMessageQueuePut, \ref osMessageQueueGet, \ref osMessageQueueGetCapacity,
+     \ref osMessageQueueGetMsgSize, \ref osMessageQueueGetCount, \ref osMessageQueueGetSpace
 */
 
 

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Event.txt

@@ -295,7 +295,7 @@ Possible \ref osStatus_t return values:
 The function \b osEventFlagsGetName returns the pointer to the name string of the event flags object identified by parameter
 \a ef_id or \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 
 <b>Code Example</b>
 \code

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_MemPool.txt

@@ -136,7 +136,7 @@ void Thread_MemPool (void *argument) {
 The function \b osMemoryPoolGetName returns the pointer to the name string of the memory pool identified by parameter \a
 mp_id or \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 */
 
 /*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Message.txt

@@ -66,7 +66,7 @@ Refer to \ref osMessageQueuePut
 The function \b osMessageQueueGetName returns the pointer to the name string of the message queue identified by parameter \a
 mq_id or \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 */
 
 /*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Mutex.txt

@@ -241,7 +241,7 @@ void CreateMutex (void)  {
 The function \b osMutexGetName returns the pointer to the name string of the mutex identified by parameter \a mutex_id or
 \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 */
 
 /*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_ProcessIsolation.txt

@@ -297,4 +297,4 @@ Following CMSIS-RTOS2 functions and macros support fault handling:
 // @}
 
 */
-// end
+// end

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Sema.txt

@@ -187,7 +187,7 @@ void Thread_Semaphore (void *argument) {
 The function \b osSemaphoreGetName returns the pointer to the name string of the semaphore identified by parameter \a
 semaphore_id or \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 */
 
 /*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Thread.txt

@@ -377,7 +377,7 @@ Refer to the \ref thread_examples "Thread Examples" section.
 The function \b osThreadGetName returns the pointer to the name string of the thread identified by parameter \a thread_id or
 \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 
 <b>Code Example</b>
 \code

+ 1 - 1
CMSIS/DoxyGen/RTOS2/src/cmsis_os2_Timer.txt

@@ -157,7 +157,7 @@ void TimerCreate_example (void)  {
 The function \b osTimerGetName returns the pointer to the name string of the timer identified by parameter \a timer_id or
 \token{NULL} in case of an error.
 
-\note This function \b cannot be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
+\note This function may be called from \ref CMSIS_RTOS_ISR_Calls "Interrupt Service Routines".
 */
 
 /*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/

+ 3 - 0
CMSIS/DoxyGen/RTOS2/src/history.txt

@@ -21,6 +21,9 @@
          - Handler functions: \ref osWatchdogAlarm_Handler
          - Zone Management: \ref osZoneSetup_Callback
          - Exception Faults: \ref osFaultResume
+
+        Additional functions allowed to be called from Interrupt Service Routines:
+         - \ref osThreadGetName, \ref osEventFlagsGetName, \ref osTimerGetName, \ref osMutexGetName, \ref osSemaphoreGetName, \ref osMemoryPoolGetName, \ref osMessageQueueGetName
       </td>
     </tr>
     <tr>

+ 3 - 0
CMSIS/RTOS2/Include/cmsis_os2.h

@@ -36,6 +36,9 @@
  *    - Handler functions: osWatchdogAlarm_Handler
  *    - Zone Management: osZoneSetup_Callback
  *    - Exception Faults: osFaultResume
+ *    Additional functions allowed to be called from Interrupt Service Routines:
+ *    - osThreadGetName, osTimerGetName, osEventFlagsGetName, osMutexGetName,
+ *      osSemaphoreGetName, osMemoryPoolGetName, osMessageQueueGetName
  * Version 2.1.3
  *    Additional functions allowed to be called from Interrupt Service Routines:
  *    - osThreadGetId