CMSIS-RTOS2 文档翻译 之 从 API v1 迁移到 API v2

从 API v1 迁移到 API v2

要使用 API 版本 2 功能,请遵循以下步骤中描述的步骤:

  • RTX 迁移指南 - 从 API 版本 1 迁移到 API 版本 2 的步骤
  • 详细的 API 函数差异 - 功能差异列表
RTX 迁移指南

RTX5 提供两个 API 层:CMSIS-RTOS v1 和 CMSIS-RTOS v2 。这允许从 v1 到 v2 的梯度转换。修改的 v1 头文件和特殊的 v1 兼容性模块使现有代码可以在几乎不做任何修改的情况下在 v2 实现上运行。

只有少数不兼容和局限性存在:

  • 内核启动
    osKernelRunning 函数已被弃用。“main” 通常是 v1 实现中的一个正在运行的线程,而 v2 中不再是这种情况。也可能不初始化和启动内核,而只是假设 “main” 是一个正在运行的线程。可移植代码通常会初始化内核(osKernelInitialize),然后启动内核(osKernelStart)或如果osKernelRunning 表明它已在运行,则跳过该部分。
    下面的示例代码显示了如何克服这种情况。
  • OS 滴答
    RTX5 使用 OS Tick API 配置滴答中断。间隔计算通常基于 SystemCoreClock 变量。因此必须在调用 osKernelStart 之前确保该变量已正确设置。
  • osWait 函数已被弃用。
  • 错误代码不兼容
    CMSIS-RTOS v1 针对无效参数使用了两个不同的错误代码:osErrorParameter 和 osErrorValue 。新版本只使用通用的 osErrorParameter 代码。因此,依赖 osErrorValue 的代码不兼容。以下功能受到影响:
    • 当优先级超出范围时,osThreadSetPriority 将返回 osErrorParameter 而不是 osErrorValue
    • 当返回的块无效时,osMemoryPoolFree(以前的 osPoolFree)返回 osErrorParameter 而不是 osErrorValue
  • osDelay 返回码已经从 osErrorTimeout 更改为 osOK 。

迁移等级取决于项目在其生命周期中的阶段:

  • 第一级迁移是在不改变 API 级别的情况下迁移到 RTX5 。
  • 转换的第二个层次是使用 v2 API 函数和 v1 API 函数的混合变体。
  • 第三个层次是完全转换到 API v2 。这不是微不足道的,需要一些额外的开发工作才能将所有 API v1 调用迁移到 v2。

1 级迁移 - 在 API v1 上升级到 RTX5

使用 API v1 兼容层从任何 4.x 版本升级到 RTX 版本 5 。按如下所示配置现有项目:

  • 打开 Manage Run-Time Environment 窗口。
  • 展开 CMSIS 软件组件。
  • 展开 RTOS (API) , 取消 Keil RTX , 然后选择 Keil RTX5
  • 展开 RTOS2 (API) 并选择 Keil RTX5
  • 解决缺少的组件。
CMSIS-RTOS2 文档翻译 之 从 API v1 迁移到 API v2_第1张图片
RTX5 的组件选择
  • 点击确定。
  • Project 窗口中展开 CMSIS 组:
  • 打开 RTX_Config.h 并调整配置以适应包括(参考配置 RTX v5)在内的应用程序:
    • 系统配置 -> 全局动态内存大小
    • 内核节拍频率
    • 线程配置 -> 默认线程堆栈大小
  • 将函数 int main(void)重命名为 void app_main(void * arg)。
  • 创建一个新的函数 int main(void),它至少实现:
    • 系统初始化和配置
    • 更新 SystemCoreClock
    • 初始化 CMSIS-RTOS 内核
    • 创建新的线程 app_main
    • 启动 RTOS 调度程序

示例 - 应用程序主线程

#include "RTE_Components.h"
#include CMSIS_device_header
/* Renamed main() function */
void app_main ( void const *argument) {
// contents of old "main"
}
osThreadDef(app_main, osPriorityNormal, 1, 0);
int main ( void) {
// System Initialization
SystemCoreClockUpdate();
// ...
osKernelInitialize();
osThreadCreate(osThread(app_main), NULL);
osKernelStart();
for (;;);
}
注意
在 RTOS API v1 中,所有时序均以毫秒为单位指定。RTX5 定义了内核滴答中的所有时间。为了与两者匹配,建议在系统配置中将内核节拍频率设置为 1000Hz 。

为了在迁移后验证 RTOS 的正确操作,您可以暂时将 RTOS 验证组件集成到您的项目中。

2 级迁移 - 在 RTX5 中使用 API v2 和 v1

在您的项目中实现新功能最好使用新的 API 来完成。这两个 API 版本都在 RTX5 中提供,并且可以一起存在。

组件选择与迁移级别 1 相同。

在需要访问 API v2 函数的所有模块中包含 “cmsis_os2.h” 。

#include "cmsis_os.h" // ARM::CMSIS:RTOS:Keil RTX5
#include "cmsis_os2.h" // ARM::CMSIS:RTOS2:Keil RTX5

以下片段显示了如何使用两个 API 版本创建的线程同时存在:

/*----------------------------------------------------------------------------
* Thread 4 'phaseD': Phase D output - API v2 thread
*---------------------------------------------------------------------------*/
void phaseD ( void *argument) {
for (;;) {
osThreadFlagsWait(0x0001, osFlagsWaitAny, osWaitForever); /* wait for an event flag 0x0001 */
Switch_On (LED_D);
signal_func(tid_phaseA); /* call common signal function */
Switch_Off(LED_D);
}
}
/*----------------------------------------------------------------------------
* Thread 5 'clock': Signal Clock - API v1 thread
*---------------------------------------------------------------------------*/
void clock ( void const *argument) {
for (;;) {
osSignalWait(0x0100, osWaitForever); /* Wait for event send by API v2 function osThreadFlagsSet() */
Switch_On (LED_CLK);
osDelay(80); /* delay ticks */
Switch_Off(LED_CLK);
}
}
/* Define the API v1 thread */
osThreadDef(clock, osPriorityNormal, 1, 0);
/*----------------------------------------------------------------------------
* Main: Initialize and start RTX Kernel
*---------------------------------------------------------------------------*/
void app_main ( void *argument) {
; //...
/* Create the API v2 thread */
tid_phaseD = osThreadNew(phaseD, NULL, NULL);
/* Create the API v1 thread */
tid_clock = osThreadCreate(osThread(clock), NULL);
osThreadFlagsSet(tid_phaseA, 0x0001); /* set signal to phaseA thread */
osDelay( osWaitForever);
while(1);
}

完整的示例 “RTX5 迁移” 是 CMSIS5 包的一部分,可从包安装程序中获取。

3 级迁移 - 完全转换到 API v2

完全迁移到 API v2 可以减少翻译层的开销并简化项目。有一些努力来替换和重新测试所有 API v1 调用。建议采用以下步骤作为粗略指导:

  • 打开管理运行环境窗口:
  • 展开 CMSIS 软件组件:
  • 展开 RTOS(API)软件组件并取消 Keil RTX5
  • 点击确定
  • 交换所有的
    #include "cmsis_os.h"

    #include "cmsis_os2.h"
  • 确定所有对 API v1 的引用,并用 v2 中的相应调用进行替换。您可能想要使用 uVision 中的错误列表窗口快速识别相关的代码段落。
注意
有关详细信息,请参阅 详细的 API 函数差异

通常不再有 os * Def 宏来声明 OS 对象。

注意
  • 信号事件已被替换。改为使用 “线程标志” 和 “事件标志” 下列出的功能。
  • 邮件队列 RTOS v1 功能已被弃用。改为使用消息队列的功能。差异在消息队列下列出。
详细的 API 函数差异

本节列出 CMSIS-RTOS API v1 和 API v2 函数以及功能差异。该列表按照 API v2 函数名称的字母顺序进行排序,结构如下:

  • RTOS API v2 函数原型。
  • RTOS API v1 函数原型相当于或提供了类似的功能。
  • RTOS v2 功能简述。
  • 差别的描述。

背景颜色表示:

  • 绿色:API v2 中的新功能在 API v1 中不可用
  • 琥珀色:与 API v1 相比,在 API v2 中修改或替换的功能
  • 红色:在 API v2 中弃用的 API v1 中的函数

内核信息和控制


osStatus_t osKernelGetInfo (osVersion_t* version, char* id_buf, uint32_t id_size)
没有

获取 RTOS 内核信息。
新功能 osKernelGetInfo 。

osKernelState_t osKernelGetState (void)
int32_t         osKernelRunning (void)

获取当前的 RTOS 内核状态。
  • 函数 osKernelGetState 替换了 RTOS v1 函数 osKernelRunning
  • 返回类型更改为 osKernelState_t 。

uint32_t osKernelGetTickCount (void)
没有

获取 RTOS 内核计数。
新功能。

uint32_t osKernelGetTickFreq (void)
没有

获取 RTOS 内核滴答频率。
  • 函数 osKernelGetTickFreq 替换了 RTOS v1 宏 osKernelTickMicroSec

uint32_t osKernelGetSysTimerCount (void)
uint32_t osKernelSysTick (void)

获取 RTOS 内核系统计时器计数。
  • 函数 osKernelGetSysTimerCount 替换了 RTOS v1 函数 osKernelSysTick

uint64_t osKernelGetSysTimerFreq (void)
没有

获取 RTOS 内核系统定时器频率。
新功能。

osStatus_t osKernelInitialize (void)
osStatus   osKernelInitialize (void)

初始化 RTOS 内核。
  • 返回类型更改为 osStatus_t 。

uint32_t osKernelLock (void)
没有

锁定 RTOS 内核调度程序。
新功能。

int32_t osKernelUnlock (void)
没有

解锁 RTOS 内核调度程序。
新功能。

void osKernelRestoreLock (void)
没有

恢复 RTOS 内核调度程序锁定状态。
新功能。

osStatus_t osKernelStart (void)
osStatus   osKernelStart (void)

启动 RTOS 内核调度程序。
  • 返回类型更改为 osStatus_t 。

uint32_t osKernelSuspend (void)
没有

挂起 RTOS 内核调度程序。
新功能。

void osKernelResume (uint32_t sleep_time)
没有

恢复 RTOS 内核调度程序。
新功能。

线程管理


osStatus_t osThreadDetach (osThreadId_t thread_id)
没有

分离一个线程(当线程终止时线程存储可以被回收)。
新功能。

uint32_t osThreadEnumerate (osThreadId_t *thread_array, uint32_t array_items)
没有

枚举活动线程。
新功能。

__NO_RETURN void osThreadExit (void)
没有

终止当前正在运行的线程。
新功能。

uint32_t osThreadGetCount (osThreadId_t thread_id)
没有

获取活动线程的数量。
新功能。

const char *osThreadGetName (osThreadId_t thread_id)
没有

获取线程的名称。
新功能。

osThreadId_t osThreadGetId (void)
osThreadId   osThreadGetId (void)

返回当前正在运行的线程的线程 ID 。
  • 返回类型更改为 osThreadId_t 。

osPriority_t osThreadGetPriority (osThreadId_t thread_id)
osPriority   osThreadGetPriority (osThreadId thread_id)

获取线程的当前优先级。
  • 返回类型更改为 osPriority_t 。
  • 参数类型更改为 osThreadId_t 。

uint32_t osThreadGetStackSize (osThreadId_t thread_id)
没有

获取线程的堆栈大小。
新功能。

uint32_t osThreadGetStackSpace (osThreadId_t thread_id)
没有

在执行期间基于堆栈水印记录获取线程的可用堆栈空间。
新功能。

osThreadState_t osThreadGetState (osThreadId_t thread_id)
没有

获取线程的当前线程状态。
新功能。

osStatus_t osThreadJoin (osThreadId_t thread_id)
没有

等待指定的线程终止。
新功能。

osThreadId_t osThreadNew (osThreadFunc_t function, void *argument, const osThreadAttr_t *attr)
osThreadId   osThreadCreate (const osThreadDef_t *thread_def, void *argument)

创建一个线程并将其添加到活动线程。
  • 函数 osThreadNew 替换了 RTOS v1 函数 osThreadCreate
  • 现在使用 osThreadAttr_t 结构体传递项目, 取代 osThreadDef 宏。
  • 新的函数原型是 void func (void *arg), 之前是: void func (const void *arg)

osStatus_t osThreadResume (osThreadId_t thread_id)
没有

恢复线程的执行。
新功能。

osStatus_t osThreadSetPriority (osThreadId_t thread_id, osPriority_t priority)
osStatus   osThreadSetPriority (osThreadId thread_id, osPriority priority)

更改线程的优先级。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osThreadId_t 和 osPriority_t 。

osStatus_t osThreadSuspend (osThreadId_t thread_id)
没有

暂停执行一个线程。
新功能。

osStatus_t osThreadTerminate (osThreadId_t thread_id)
osStatus   osThreadTerminate (osThreadId thread_id)

终止线程的执行。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osThreadId_t 。

osStatus_t osThreadYield (void)
osStatus   osThreadYield (void)

将控制权交给状态为 READY 的下一个线程。
  • 返回类型更改为 osStatus_t 。

线程标志

新部分使用标志同步线程。线程标志和更灵活的事件标志取代了 RTOS v1 信号事件。请参阅信号事件以获取不推荐使用的功能列表。有关详细信息,请参阅线程标记。


uint32_t osThreadFlagsSet (osThreadId_t thread_id, uint32_t flags)
没有

设置线程的指定线程标志。
新功能。

uint32_t osThreadFlagsClear (uint32_t flags)
没有

清除当前运行线程的指定线程标志。
新功能。

uint32_t osThreadFlagsGet (void)
没有

获取当前正在运行的线程的当前线程标志。
新功能。

uint32_t osThreadFlagsWait (uint32_t flags, uint32_t options, uint32_t timeout)
没有

等待当前正在运行的线程的一个或多个线程标志发出信号。
新功能。

事件标志

新部分使用标志同步事件。事件标志和线程标志取代了 RTOS v1 信号事件。RTOS v1 信号事件中列出的所有功能已被弃用。请参阅信号事件以获取不推荐使用的功能列表。 有关新功能的详细信息,请参阅事件标志。


uint32_t osEventFlagsClear (osEventFlagsId_t ef_id, uint32_t flags)
没有

清除指定的事件标志。
新功能。

const char *osEventFlagsGetName ((osEventFlagsId_t ef_id)
没有

获取事件标志对象的名称。
新功能。

osStatus_t osEventFlagsDelete (osEventFlagsId_t ef_id)
没有

删除事件标志对象。
新功能。

uint32_t osEventFlagsGet (osEventFlagsId_t ef_id)
没有

获取当前的事件标志。
新功能。

osEventFlagsId_t osEventFlagsNew (const osEventFlagsAttr_t *attr)
没有

创建并初始化事件标志对象。
新功能。

uint32_t osEventFlagsSet (osEventFlagsId_t ef_id, uint32_t flags)
没有

设置指定的事件标志。
新功能。

uint32_t osEventFlagsWait (osEventFlagsId_t ef_id, uint32_t flags, uint32_t options, uint32_t timeout)
没有

等待一个或多个事件标志发出信号。
新功能。

通用等待函数

详情请参阅通用等待功能。


osStatus_t osDelay (uint32_t ticks)
osStatus   osDelay (uint32_t timeout)

等待超时(时间延迟)。
  • 返回类型更改为 osStatus_t 。

osStatus_t osDelayUntil (uint32_t ticks)
没有

等到指定的时间。
新功能。

没有
osEvent osWait (uint32_t millisec)

已过时。

定时器管理

详情请参阅定时器管理。


osStatus_t osTimerDelete (osTimerId_t timer_id)
osStatus   osTimerDelete (osTimerId timer_id)

删除一个定时器。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osTimerId_t 。

const char *osTimerGetName (osTimerId_t timer_id)
没有

获取定时器的名称。
新功能。

uint32_t osTimerIsRunning (osTimerId_t timer_id)
没有

检查定时器是否正在运行。
新功能。

osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr)
osTimerId   osTimerCreate (const osTimerDef_t *timer_def, os_timer_type type, void *argument)

创建并初始化一个定时器。
  • 函数 osTimerNew 替换了 RTOS v1 函数 osTimerCreate
  • 返回类型更改为 osTimerId_t 。
  • 参数列表和类型已更改。

osStatus_t osTimerStart (osTimerId_t timer_id, uint32_t ticks)
osStatus   osTimerStart (osTimerId timer_id, uint32_t timeout)

启动或重新启动定时器。
  • 返回类型更改为 osStatus_t 。
  • 第一个参数类型更改为 osTimerId_t 。

osStatus_t osTimerStop (osTimerId_t timer_id)
osStatus   osTimerStop (osTimerId timer_id)

停止一个定时器。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osTimerId_t 。

互斥管理

有关详细信息,请参阅互斥管理。


osStatus_t osMutexAcquire (osMutexId_t mutex_id, uint32_t timeout)
osStatus   osMutexWait (osMutexId mutex_id, uint32_t timeout)

如果它被锁定,则获取互斥锁或超时值。
  • 函数 osMutexAcquire 替换了 RTOS v1 函数 osMutexWait
  • 返回类型更改为 osStatus_t 。
  • 第一个参数类型更改为 osMutexId_t 。

osStatus_t osMutexDelete (osMutexId_t mutex_id)
osStatus   osMutexDelete (osMutexId mutex_id)

删除互斥对象。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osMutexId_t 。

const char *osMutexGetName ((osMutexId_t mutex_id)
没有

获取互斥对象的名称。
新功能。

osThreadId_t osMutexGetOwner (osMutexId_t mutex_id)
没有

获取拥有互斥对象的线程。
新功能。

osMutexId_t osMutexNew (const osMutexAttr_t *attr)
osMutexId   osMutexCreate (const osMutexDef_t *mutex_def)

创建并初始化一个互斥对象。
  • 函数 osMutexNew 替换了 RTOS v1 函数 osMutexCreate
  • 返回类型更改为 osMutexId_t 。
  • 参数类型更改为 osMutexAttr_t 。

osStatus_t osMutexRelease (osMutexId_t mutex_id)
osStatus   osMutexRelease (osMutexId mutex_id)

释放由 osMutexAcquire 获取的互斥锁。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osMutexId_t 。

信号量

有关详细信息,请参阅信号量。


osStatus_t osSemaphoreAcquire (osSemaphoreId_t semaphore_id, uint32_t timeout)
没有

如果没有令牌可用,则获取信号标记或超时。
新功能。取代 osSemaphoreWait

osStatus_t osSemaphoreDelete (osSemaphoreId_t semaphore_id)
osStatus   osSemaphoreDelete (osSemaphoreId semaphore_id)

删除一个信号量对象。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osSemaphoreId_t 。

uint32_t osSemaphoreGetCount (osSemaphoreId_t semaphore_id)
没有

获取当前的信号量令牌计数。
新功能。

const char *osSemaphoreGetName ((osSemaphoreId_t semaphore_id)
没有

获取信号量对象的名称。
新功能。

osSemaphoreId_t osSemaphoreNew (uint32_t max_count, uint32_t initial_count, const osSemaphoreAttr_t *attr)
osSemaphoreId   osSemaphoreCreate (const osSemaphoreDef_t *semaphore_def, int32_t count)

创建并初始化信号量对象。
  • 函数 osSemaphoreNew 替换了 RTOS v1 函数 osSemaphoreCreate
  • 返回类型更改为 osSemaphoreId_t 。
  • 参数列表和类型已更改。

osStatus_t osSemaphoreRelease (osSemaphoreId_t semaphore_id)
osStatus   osSemaphoreRelease (osSemaphoreId semaphore_id)

释放一个信号量令牌直到最初的最大数量。
  • 返回类型更改为 osStatus_t 。
  • 参数类型更改为 osSemaphoreId_t 。

没有
int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t timeout)

已过时。取而代之 osSemaphoreAcquire 。

内存池


void * osMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout)
void * osPoolAlloc  (osPoolId pool_id)

从内存池中分配内存块。
  • 函数 osMemoryPoolAlloc 替换了 RTOS v1 函数 osPoolAlloc
  • 参数列表和类型已更改。

osStatus_t osMemoryPoolDelete (osMemoryPoolId_t mp_id)
没有

删除一个内存池对象。
新功能。

osStatus_t osMemoryPoolFree (osMemoryPoolId_t mp_id, void * block)
osStatus   osPoolFree (osPoolId pool_id, void * block)

将分配的内存块返回到内存池。
  • 函数 osMemoryPoolFree 替换了 RTOS v1 函数 osPoolFree
  • 第一个参数类型 osMemoryPoolId_t 替换了 ROTS v1 类型 osPoolId

uint32_t osMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id)
没有

获取内存池中的内存块大小。
新功能。

uint32_t osMemoryPoolGetCapacity (osMemoryPoolId_t mp_id)
没有

获取内存池中的最大内存块数。
新功能。

uint32_t osMemoryPoolGetCount (osMemoryPoolId_t mp_id)
没有

获取内存池中使用的内存块数量。
新功能。

const char *osMemoryPoolGetName ((osMemoryPoolId_t mp_id)
没有

获取内存池对象的名称。
新功能。

uint32_t osMemoryPoolGetSpace (osMemoryPoolId_t mp_id)
没有

获取内存池中可用的内存块数量。
新功能。

osMemoryPoolId_t osMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr)
osPoolId         osPoolCreate (const osPoolDef_t * pool_def)

获取内存池中可用的内存块数量。
  • 函数 osMemoryPoolNew 替换了 RTOS v1 函数 osPoolCreate
  • 返回类型更改为 osMemoryPoolId_t 。
  • 参数列表和参数类型已更改。

消息队列

通常,消息现在使用固定大小的内存,而不是32位值。有关详细信息,请参阅消息队列。


osStatus_t osMessageQueueDelete (osMessageQueueId_t mq_id)
没有

删除一个消息队列对象。
新函数。

osStatus_t osMessageQueueGet (osMessageQueueId_t mq_id, void *msg_ptr, uint8_t *msg_prio, uint32_t timeout)
osEvent    osMessageGet (osMessageQId queue_id, uint32_t timeout)

如果队列为空,则从队列获取消息或超时。
  • 函数 osMessageQueueGet 替换了 RTOS v1 函数 osMessageGet
  • 返回类型更改为 osStatus_t 。
  • 参数列表和参数类型已更改。

uint32_t osMessageQueueGetCapacity (osMessageQueueId_t mq_id)
没有

在消息队列中获取最大数量的消息。
新功能。

uint32_t osMessageQueueGetCount (osMessageQueueId_t mq_id)
没有

获取消息队列中排队的消息数量。
新功能。

uint32_t osMessageQueueGetMsgSize (osMessageQueueId_t mq_id)
没有

获取内存池中的最大消息大小。
新功能。

const char *osMessageQueueGetName ((osMessageQueueId_t mq_id)
没有

获取消息队列对象的名称。
新功能。

uint32_t osMessageQueueGetSpace (osMessageQueueId_t mq_id)
没有

获取消息队列中消息的可用插槽数量。
新功能。

osMessageQueueId_t osMessageQueueNew (uint32_t msg_count, uint32_t msg_size, const osMessageQueueAttr_t *attr)
osMessageQId       osMessageCreate (const osMessageQDef_t *queue_def, osThreadId thread_id)

创建并初始化消息队列对象。
  • 函数 osMessageQueueNew 替换了 RTOS v1 函数 osMessageCreate
  • 返回类型更改为 osMessageQueueId_t 。
  • 参数列表和参数类型已更改。

osStatus_t osMessageQueuePut (osMessageQueueId_t mq_id, const void *msg_ptr, uint8_t msg_prio, uint32_t timeout)
osStatus   osMessagePut (osMessageQId queue_id, uint32_t info, uint32_t timeout)

如果队列已满,请将消息放入队列或超时。
  • 函数 osMessageQueuePut 替换了 RTOS v1 函数 osMessagePut
  • 返回类型更改为 osStatus_t 。
  • 参数列表和参数类型已更改。

osStatus_t osMessageQueueReset (osMessageQueueId_t mq_id)
没有

将消息队列重置为初始空状态。
新功能。

邮件队列

邮件队列 RTOS v1 功能已被弃用。改为使用 Message Queue 的功能。差异在 Message Queue 下列出。


没有
void * osMailAlloc (osMailQId queue_id, uint32_t timeout)

已过时。

没有
void * osMailCAlloc (osMailQId queue_id, uint32_t timeout)

已过时。

没有
osMailQId osMailCreate (const osMailQDef_t *queue_def, osThreadId thread_id)

已过时。

没有
osStatus osMailFree (osMailQId queue_id, void *mail)

已过时。

没有
osEvent osMailGet (osMailQId queue_id, uint32_t timeout)

已过时。

没有
osStatus osMailPut (osMailQId queue_id, void *mail)

已过时。

信号事件

RTOS v1 信号事件部分已被弃用。改用线程标志下面列出的功能。


没有
int32_t osSignalClear (osThreadId thread_id, int32_t signals)

已过时。

没有
int32_t osSignalSet (osThreadId thread_id, int32_t signals)

已过时。

没有
osEvent osSignalWait (int32_t signals, uint32_t timeout)

已过时。

你可能感兴趣的:(CMSIS,CMSIS-RTOS2,文档翻译)