一、CMSIS-RTOS v2 官方优先级等级定义

CMSIS-RTOS v2 是 ARM 定义的通用 RTOS API 标准，任务优先级通过osPriority_t枚举类型统一规范，核心规则：优先级数值越大，逻辑优先级越高（与 FreeRTOS 原生规则一致，与 Cortex-M 中断优先级规则相反）。

ARM 官方完整优先级枚举定义如下：

主优先级宏定义	基准数值	细分档位范围	官方定位与典型用途
osPriorityNone	0	无	系统保留，无优先级，不用于用户任务创建
osPriorityIdle	1	无	空闲任务专用优先级，系统自动创建的空闲任务使用，用户任务禁止使用
osPriorityLow	8	9~15 (Low1~Low7)	低优先级，用于非关键后台任务，如日志打印、非实时状态上报、低优先级数据处理
osPriorityBelowNormal	16	17~23 (BelowNormal1~7)	次正常优先级，用于次要常规任务，优先级高于 Low、低于 Normal
osPriorityNormal	24	25~31 (Normal1~7)	系统默认优先级，推荐用于大部分无强实时要求的常规业务逻辑
osPriorityAboveNormal	32	33~39 (AboveNormal1~7)	超正常优先级，用于对响应有一定要求的任务，优先级高于 Normal、低于 High
osPriorityHigh	40	41~47 (High1~7)	高优先级，用于关键控制任务，如设备闭环控制、紧急事件处理
osPriorityRealtime	48	49~55 (Realtime1~7)	系统最高用户优先级，用于硬实时任务，如高精度时序控制、紧急中断兜底处理
osPriorityISR	56	无	中断服务专用优先级，系统保留，用户任务不可使用
osPriorityError	-1	无	优先级错误标识

官方设计逻辑

每个主优先级等级之间预留 8 个数值的连续区间，主等级基准值间隔 8，每个主等级内提供 7 个细分档位，既保证了不同 RTOS 实现之间的 API 可移植性，又满足用户对优先级的精细化控制需求。

二、CMSIS-RTOS v2 与 FreeRTOS 原生优先级的官方映射规则

CMSIS-RTOS v2 是抽象 API 封装层，最终的任务调度由底层 FreeRTOS 内核执行，二者的优先级映射关系是理解所有优先级行为的核心。

1. 官方映射公式

根据 ARM CMSIS-FreeRTOS 官方发行版说明，映射规则分为两个版本：

• v11.0.1 及以上版本（修正后）：FreeRTOS原生优先级 = osPriority_t 数值 - 1
• v10.5.1 及以下版本：将 CMSIS 的 0~56 优先级区间，线性映射到 FreeRTOS 的0 ~ configMAX_PRIORITIES-1区间

2. FreeRTOS 原生优先级核心约束

FreeRTOS 内核的优先级规则：

• 原生优先级数值范围：0（最低，空闲任务专用） ~ configMAX_PRIORITIES-1（最高）
• 优先级数值越大，逻辑优先级越高，与 CMSIS-RTOS v2 规则一致
• 系统能支持的最高优先级，完全由FreeRTOSConfig.h中的configMAX_PRIORITIES宏决定

3. 典型映射示例与致命坑点

正确配置场景

当configMAX_PRIORITIES=56（完整支持 CMSIS 全优先级范围）时：

• osPriorityLow (8) → FreeRTOS 优先级 7
• osPriorityNormal (24) → FreeRTOS 优先级 23
• osPriorityHigh (40) → FreeRTOS 优先级 39
• osPriorityRealtime (48) → FreeRTOS 优先级 47
• 最高原生优先级 55，对应 osPriorityRealtime7 (55)

此时优先级层级完全生效，Realtime 任务优先级远高于 Low 任务，可正常抢占。

错误配置场景（90% 异常的根源）

若configMAX_PRIORITIES配置过小（如 STM32CubeMX 默认值 32，甚至更低的 8）：

• 当configMAX_PRIORITIES=32时，osPriorityRealtime (48) 映射后的原生优先级 47，远大于系统最高优先级 31，封装层会自动将其截断为 31
• 当configMAX_PRIORITIES=8时，所有≥8 的 CMSIS 优先级，都会被截断为系统最高优先级 7
• 极端结果：Realtime 和 Low 任务的 FreeRTOS 原生优先级完全相同，内核不会触发任何抢占行为！

三、CMSIS-RTOS v2 官方抢占式调度规则

根据 ARM CMSIS-RTOS v2 官方规范，调度器核心抢占规则如下：

1. 核心抢占规则：当一个更高优先级的任务进入READY 就绪态时，会立即抢占当前正在运行的低优先级任务，CPU 立刻切换到高优先级任务执行，无需等待时间片或低优先级任务主动让出 CPU。
2. 抢占禁止的唯一合法场景：
   • 调度器被锁定（调用osKernelLock()）
   • 系统处于临界区（关中断 / 关调度）
   • 高优先级任务处于BLOCKED 阻塞态（等待延迟、信号量、队列、事件标志等）
3. 同优先级调度规则：同优先级的就绪任务，默认采用时间片轮转调度（configUSE_TIME_SLICING=1），每个任务执行一个系统时钟节拍后切换；若关闭时间片，同优先级任务必须主动调用osThreadYield()让出 CPU 才会切换。
4. 优先级继承机制：CMSIS-RTOS v2 的互斥量（osMutexNew()）默认实现优先级继承，用于解决优先级反转问题：当高优先级任务等待低优先级任务持有的互斥量时，低优先级任务的优先级会被临时提升到高优先级任务的级别，避免被中间优先级任务抢占，确保快速释放资源。

四、官方最佳实践建议

1. 优先级配置：configMAX_PRIORITIES必须设置为 56，完整支持 CMSIS-RTOS v2 的全部优先级档位，避免优先级截断导致的异常。
2. 优先级使用原则：
   • Realtime 等级仅用于硬实时任务，数量尽可能少，且必须保证能快速进入阻塞态，严禁死循环占用 CPU
   • 关键控制任务使用 High 等级，常规业务使用 Normal 等级，后台非关键任务使用 Low 等级
3. 资源保护：必须使用互斥量保护共享资源，严禁用二值信号量替代，避免优先级反转问题。
4. 调试手段：通过osThreadGetPriority()、uxTaskPriorityGet()、osThreadGetState()三个核心接口，确认任务的优先级映射和运行状态是否符合预期。