Part 1
요약·해설
Kernel·mutex 제한과 semaphore, timer, queue, memory pool, event/thread flags, delay API의 미지원 반환값을 정리합니다.
Five calls unsupported
Inheritance · recursive defaults
Unsupported return cases
Part 2
접을 수 있는 영어 원문 전체
영어 원문 전체 펼치기
DF303A92D2D127D3B7349EEFD4EAECEFB06F1A2CF67BFDB8577315BE006B91AD
.. _cmsis_rtos_v2:
CMSIS RTOS v2
##########################
Cortex-M Software Interface Standard (CMSIS) RTOS is a vendor-independent
hardware abstraction layer for the ARM Cortex-M processor series and defines
generic tool interfaces. Though it was originally defined for ARM Cortex-M
microcontrollers alone, it could be easily extended to other microcontrollers
making it generic. For more information on CMSIS RTOS v2, please refer to the
`CMSIS-RTOS2 Documentation <http://www.keil.com/pack/doc/CMSIS/RTOS2/html/index.html>`_.
Features not supported in Zephyr implementation
***********************************************
Kernel
``osKernelGetState``, ``osKernelSuspend``, ``osKernelResume``, ``osKernelInitialize``
and ``osKernelStart`` are not supported.
Mutex
``osMutexPrioInherit`` is supported by default and is not configurable,
you cannot select/unselect this attribute.
``osMutexRecursive`` is also supported by default. If this attribute is
not set, an error is thrown when the same thread tries to acquire
it the second time.
``osMutexRobust`` is not supported in Zephyr.
Return values not supported in the Zephyr implementation
********************************************************
``osKernelUnlock``, ``osKernelLock``, ``osKernelRestoreLock``
``osError`` (Unspecified error) is not supported.
``osSemaphoreDelete``
``osErrorResource`` (the semaphore specified by parameter
semaphore_id is in an invalid semaphore state) is not supported.
``osMutexDelete``
``osErrorResource`` (mutex specified by parameter mutex_id
is in an invalid mutex state) is not supported.
``osTimerDelete``
``osErrorResource`` (the timer specified by parameter timer_id
is in an invalid timer state) is not supported.
``osMessageQueueReset``
``osErrorResource`` (the message queue specified by
parameter msgq_id is in an invalid message queue state)
is not supported.
``osMessageQueueDelete``
``osErrorResource`` (the message queue specified by
parameter msgq_id is in an invalid message queue state)
is not supported.
``osMemoryPoolFree``
``osErrorResource`` (the memory pool specified by
parameter mp_id is in an invalid memory pool state) is
not supported.
``osMemoryPoolDelete``
``osErrorResource`` (the memory pool specified by
parameter mp_id is in an invalid memory pool state) is
not supported.
``osEventFlagsSet``, ``osEventFlagsClear``
``osFlagsErrorUnknown`` (Unspecified error)
and osFlagsErrorResource (Event flags object specified by
parameter ef_id is not ready to be used) are not supported.
``osEventFlagsDelete``
``osErrorParameter`` (the value of the parameter ef_id is
incorrect) is not supported.
``osThreadFlagsSet``
``osFlagsErrorUnknown`` (Unspecified error) and
``osFlagsErrorResource`` (Thread specified by parameter
thread_id is not active to receive flags) are not supported.
``osThreadFlagsClear``
``osFlagsErrorResource`` (Running thread is not active to
receive flags) is not supported.
``osDelayUntil``
``osParameter`` (the time cannot be handled) is not supported.
Part 3
한국어 전문 번역
Cortex-M Software Interface Standard(CMSIS) RTOS는 ARM Cortex-M processor series용 vendor-independent hardware abstraction layer이며 공통 tool interface를 정의합니다. 원래 Cortex-M microcontroller용이지만 다른 microcontroller에도 확장 가능한 generic interface입니다. 자세한 표준 API는 CMSIS-RTOS2 Documentation에 있습니다.
Zephyr 구현에서 지원하지 않는 기능
- Kernel
osKernelGetState,osKernelSuspend,osKernelResume,osKernelInitialize,osKernelStart는 지원하지 않습니다.- Mutex ·
osMutexPrioInherit - Priority inheritance는 기본 지원되며 설정으로 선택하거나 해제할 수 없습니다.
- Mutex ·
osMutexRecursive - Recursive mutex도 기본 지원됩니다. 이 attribute를 설정하지 않았는데 같은 thread가 두 번째로 acquire하면 error가 발생합니다.
- Mutex ·
osMutexRobust - Zephyr에서는 지원하지 않습니다.
Zephyr 구현에서 지원하지 않는 반환값
osKernelUnlock,osKernelLock,osKernelRestoreLock- Unspecified error인
osError반환을 지원하지 않습니다. osSemaphoreDeletesemaphore_id가 invalid semaphore state임을 뜻하는osErrorResource를 지원하지 않습니다.osMutexDeletemutex_id가 invalid mutex state임을 뜻하는osErrorResource를 지원하지 않습니다.osTimerDeletetimer_id가 invalid timer state임을 뜻하는osErrorResource를 지원하지 않습니다.osMessageQueueResetmsgq_id가 invalid message queue state임을 뜻하는osErrorResource를 지원하지 않습니다.osMessageQueueDeletemsgq_id가 invalid message queue state임을 뜻하는osErrorResource를 지원하지 않습니다.osMemoryPoolFreemp_id가 invalid memory pool state임을 뜻하는osErrorResource를 지원하지 않습니다.osMemoryPoolDeletemp_id가 invalid memory pool state임을 뜻하는osErrorResource를 지원하지 않습니다.osEventFlagsSet,osEventFlagsClear- Unspecified error인
osFlagsErrorUnknown과ef_idevent flags object가 아직 사용할 준비가 되지 않았음을 뜻하는osFlagsErrorResource를 지원하지 않습니다. osEventFlagsDeleteef_idparameter가 잘못됐음을 뜻하는osErrorParameter를 지원하지 않습니다.osThreadFlagsSet- Unspecified error인
osFlagsErrorUnknown과thread_idthread가 flag를 받을 active state가 아님을 뜻하는osFlagsErrorResource를 지원하지 않습니다. osThreadFlagsClear- 실행 중인 thread가 flag를 받을 active state가 아님을 뜻하는
osFlagsErrorResource를 지원하지 않습니다. osDelayUntil- 지정 시간을 처리할 수 없음을 뜻하는
osParameter반환을 지원하지 않습니다.
Source
출처
영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.