services/portability/cmsis_rtos_v2.html · services/portability/cmsis_rtos_v2.rst 공식 원문 ↗

Zephyr 3.7.0 · Portability · CMSIS

CMSIS RTOS v2

CMSIS-RTOS2 compatibility layer를 사용할 때 Zephyr가 제공하지 않는 기능과 error contract를 확인합니다.

Official pathservices/portability/cmsis_rtos_v2.html
Source fileservices/portability/cmsis_rtos_v2.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

Kernel·mutex 제한과 semaphore, timer, queue, memory pool, event/thread flags, delay API의 미지원 반환값을 정리합니다.

Kernel

Five calls unsupported

Mutex

Inheritance · recursive defaults

Errors

Unsupported return cases

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 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 반환을 지원하지 않습니다.
osSemaphoreDelete
semaphore_id가 invalid semaphore state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osMutexDelete
mutex_id가 invalid mutex state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osTimerDelete
timer_id가 invalid timer state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osMessageQueueReset
msgq_id가 invalid message queue state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osMessageQueueDelete
msgq_id가 invalid message queue state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osMemoryPoolFree
mp_id가 invalid memory pool state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osMemoryPoolDelete
mp_id가 invalid memory pool state임을 뜻하는 osErrorResource를 지원하지 않습니다.
osEventFlagsSet, osEventFlagsClear
Unspecified error인 osFlagsErrorUnknown과 ef_id event flags object가 아직 사용할 준비가 되지 않았음을 뜻하는 osFlagsErrorResource를 지원하지 않습니다.
osEventFlagsDelete
ef_id parameter가 잘못됐음을 뜻하는 osErrorParameter를 지원하지 않습니다.
osThreadFlagsSet
Unspecified error인 osFlagsErrorUnknown과 thread_id thread가 flag를 받을 active state가 아님을 뜻하는 osFlagsErrorResource를 지원하지 않습니다.
osThreadFlagsClear
실행 중인 thread가 flag를 받을 active state가 아님을 뜻하는 osFlagsErrorResource를 지원하지 않습니다.
osDelayUntil
지정 시간을 처리할 수 없음을 뜻하는 osParameter 반환을 지원하지 않습니다.

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.