【翻译CMSIS_RTOS2 API v2】鸿蒙CMSIS-RTOS2接口之任务（线程）管理

已于 2022-01-29 10:17:24 修改
阅读量1.5k 收藏 11
点赞数
分类专栏： Linux 文章标签： harmonyos 华为 rtos
于 2022-01-25 23:56:51 首次发布
原文链接：https://arm-software.github.io/CMSIS_5/RTOS2/html/group__CMSIS__RTOS.html
版权

文章目录

鸿蒙在CMSIS-RTOS2接口中封装了LiteOS-M的内核代码。因此当需要使用CMSIS-RTOS2接口时，只需要调用相应接口就行了。本篇文章将会记录官网API的使用方法以及使用案例，记录自己学习的想法和使用技巧会保持持续更新哟！！！

CMSIS-RTOS API v2

接口顺序将会按照小熊派官网视频讲解的顺序记录以便自己学习和使用。

任务（线程）管理

外文名称：Thread Management
源接口地址：Thread Management
HarmonyOS_PPT：HarmonyOS内核开发-任务管理.pdf

任务管理可以规划函数的运行次序，非常方便地对任务运行的状态进行掌控。

结构体（数据类型）

osThreadAttr_t

所属函数：osThreadNew

数据类型属性名称描述默认值备注
const char *name任务名称NULL
uint32_tattr_bits设置 osThreadJoin0U
void *cb_mem任务块指针NULL
uint32_tcb_size任务块指针大小0U
void *stack_mem任务栈指针NULL
uint32_tstack_size任务栈指针大小0U
osPriority_tpriority任务优先级osPriorityNormal
TZ_ModuleId_ttz_moduleTrustZone模块标识0U
uint32_treserved保留字段0U
osThreadJoinable

所属结构体：osThreadAttr_t

通过属性名称attr_bits设置，attr_bits = 1U

任务与资源的关联

osThreadDetached

所属结构体：osThreadAttr_t

属性名称attr_bits的默认值，attr_bits = 0U

断开任务与资源的关联，并在任务Terminated后资源将会重新归还系统给其他任务使用。

osPriority_t

所属结构体：osThreadAttr_t

属性名称priority，默认值osPriorityNormal

优先级描述
osPriorityNone无
osPriorityIdle预留给空闲任务（不可使用）
osPriorityLow8个低级优先级
osPriorityBelowNormal8个低于正常优先级
osPriorityNormal8个正常优先级
osPriorityAboveNormal8个高于正常优先级
osPriorityHigh8个高级优先级
osPriorityRealtime8个实时优先级
osPriorityISR预留给ISR延迟任务（不可使用）
osPriorityError优先级错误
osPriorityReserved保留字段

osThreadFunc_t

所属函数：osThreadNew

任务入口函数，即任务去执行的函数。

如果函数不是osThreadFunc_t类型，使用时需要给函数转换类型为osThreadFunc_t。

osThreadId_t

所属函数：[ osThreadTerminate | osThreadSuspend | osThreadResume ]

所属函数返回值：[ osThreadNew | osThreadGetId | osThreadEnumerate | osMutexGetOwner ]

任务ID，即线程号。

可以定位到一个具体任务上面。

osThreadState_t

所属函数返回值：osThreadGetState_t

状态描述
osThreadInactive任务未工作
osThreadReady任务就绪，随时准备工作
osThreadRunning任务开始运行
osThreadBlocked任务阻塞，任务等待中
osThreadTerminated任务终止，任务停止运行
osThreadError任务出错，任务不存在或没有scheduled
osThreadReserved保留字段

功能（函数）

osThreadNew：新建任务（线程）

参数名称数据类型描述
funcosThreadFunc_t任务入口函数
argumentvoid *任务入口函数的参数
attrconst osThreadAttr_t任务的属性
返回值osThreadId_t任务ID

将任务添加到active任务列表中，将任务状态设置为READY。

osThreadTerminate：终止任务（线程）

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osStatus_t操作结果

将任务从active任务列表中移除掉。

如果任务当前状态为RUNNING时被该函数终止，这让下一个任务状态为READY的任务开始RUNNING。

如果任务不存在则不会终止该任务，而是返回osErrorResource。

osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效或没有其他任务存在
osErrorISR任务不能被终止

osThreadSuspend：挂起任务（线程）

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osStatus_t操作结果

如果当前作用域下有一个任务状态设置为BLOCKED，那么下一个任务状态为READY的任务开始RUNNING。

如果任务状态为BLOCKED的任务通过 osThreadResume 函数将其恢复，那么任务状态改为READY。

osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效或没有其他任务存在
osErrorISR任务不能被终止

osThreadResume：恢复任务（线程）

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osStatus_t操作结果

将状态变为BLOCKED的任务重新回到READY状态。

通过该函数恢复的任务在当前作用域下，如果其优先级高于某个状态为RUNNING的任务，那么其任务状态直接切换为RUNNIG。

建议：不提倡将不是通过osThreadSuspend函数终止的任务，直接通过该函数进行恢复。

osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效或没有其他任务存在
osErrorISR任务不能被终止

osThreadGetName：获取任务名

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值name任务名称，默认值为 " "

osThreadGetId：获取当前任务状态为RUNNING的任务ID（线程号）

参数名称数据类型描述
返回值osThreadId_t任务ID

osThreadGetState：获取任务状态

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osThreadState_t任务状态

如果任务被ISR调用则会返回osThreadError。

osThreadState_t

所属函数返回值：osThreadGetState_t

状态描述
osThreadInactive任务未工作
osThreadReady任务就绪，随时准备工作
osThreadRunning任务开始运行
osThreadBlocked任务阻塞，任务等待中
osThreadTerminated任务终止，任务停止运行
osThreadError任务出错，任务不存在或没有scheduled
osThreadReserved保留字段

osThreadSetPriority：设置或改变任务优先级

参数名称数据类型描述
thread_idosThreadId_t任务ID
priorityosPriority_t任务优先级
返回值osStatus_t操作结果
osPriority_t

所属结构体：osThreadAttr_t

属性名称priority，默认值osPriorityNormal

优先级描述
osPriorityNone无
osPriorityIdle预留给空闲任务（不可使用）
osPriorityLow8个低级优先级
osPriorityBelowNormal8个低于正常优先级
osPriorityNormal8个正常优先级
osPriorityAboveNormal8个高于正常优先级
osPriorityHigh8个高级优先级
osPriorityRealtime8个实时优先级
osPriorityISR预留给ISR延迟任务（不可使用）
osPriorityError优先级错误
osPriorityReserved保留字段
osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效或没有其他任务存在
osErrorISR任务不能被终止

osThreadGetPriority：获取任务优先级

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osPriority_t任务优先级
osPriority_t

所属结构体：osThreadAttr_t

属性名称priority，默认值osPriorityNormal

优先级描述
osPriorityNone无
osPriorityIdle预留给空闲任务（不可使用）
osPriorityLow8个低级优先级
osPriorityBelowNormal8个低于正常优先级
osPriorityNormal8个正常优先级
osPriorityAboveNormal8个高于正常优先级
osPriorityHigh8个高级优先级
osPriorityRealtime8个实时优先级
osPriorityISR预留给ISR延迟任务（不可使用）
osPriorityError优先级错误
osPriorityReserved保留字段

osThreadYield：切换任务流

如果由相同优先级的READY状态的任务，那么就开始执行它；如果没有那么继续执行当前任务。

注意事项

  • 被切换的任务状态不会设置为BLOCKED状态
  • 低优先级的READY状态的任务不会被切换到
osStatus_t
参数名称描述
osOK操作成功
osError未知错误
osErrorISR任务不能被终止

osThreadDetach：将任务改变为osThreadDetached

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osPriority_t任务优先级

当某个任务该函数执行，那么该任务状态为TERMINATED时将会归还所有资源给系统。

任务定义为osThreadDetached时，将不会有任何改变。

osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效状态
osErrorISR任务不能被终止

osThreadJoin：任务已经运行完成的信号

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值osPriority_t任务优先级

注意事项

  • 任务状态不为TERMINATED时，会一直等待结果
  • 任务状态为TERMINATED时，立马返回结果
osStatus_t
参数名称描述
osOK操作成功
osErrorParameter任务ID为NULL或无效
osErrorResource任务无效状态
osErrorISR任务不能被终止

osThreadExit：终止调用任务

不是很懂，应该是可以将结果同步到 osThreadJoin

osThreadGetStackSize：获取任务栈大小

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值uint32_t任务栈大小，Bytes

osThreadGetStackSpace：获取剩余任务栈空间

参数名称数据类型描述
thread_idosThreadId_t任务ID
返回值uint32_t任务栈大小，Bytes

注意事项

  • 出错会返回0
  • 似乎只能在Stack watermark recording期间才能使用（参考 Thread Configuration）

osThreadGetCount：获取active任务数量

注意事项

  • 出错会返回0

osThreadEnumerate：枚举任务数

参数名称数据类型描述
thread_arrayosThreadId_t任务数组
array_itemsuint32_t接收任务ID的数量
返回值uint32_t枚举的任务数

注意事项

  • 出错会返回0

问题

哪些因素影响任务变为BLOCKED状态？

hjhcos
关注
  • 0
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
STM32F1与STM32CubeIDE编程实例-CMSIS-RTOS V2配置(基于FreeRTOS)
视觉与物联智能
05-05 1737
CMSIS-RTOS v2 (CMSIS-RTOS2) 为基于 Arm® Cortex® 处理器的设备提供通用 RTOS 接口。 本文将介绍如何在STM32CubeIDE中配置CMSIS-RTOS 2。
CMSIS-RTOS V2 API 接口翻译
保持每天的清醒
11-24 946
函数参考 内核信息和控制 osKernelGetInfo: 获取 RTOS 内核信息。 osKernelGetState: 获取当前的 RTOS 内核状态。 osKernelGetSysTimerCount: 获取 RTOS 内核系统定时器计数。 osKernelGetSysTimerFreq: 获取 RTOS 内核系统定时器频率。 osKernelInitialize: 初始化 RTOS 内核。 osKernelLock: 锁定 RTOS 内核调度程序。 osKe...
【BES2500x系列 -- RTX5操作系统】深入探索CMSIS-RTOS RTX -- 配置篇 -- flash的使用 --（八）
最新发布
JMFive的博客
07-18 1380
大家好，又见面了，我是夜阑的狗🐶，本文是专栏【BES2500x系列】专栏的第8篇文章;今天开始学习BES2500x系列的一天💖💖💖，开启新的征程，记录最美好的时刻🎉，每天进步一点点。【BES2500x系列】， 此专栏是我是夜阑的狗对BES2500x系列开发过程的总结，希望能够加深自己的印象，以及帮助到其他的小伙伴😉😉。如果文章有什么需要改进的地方还请大佬不吝赐教👏👏。前面已经介绍了GPIO配置之后。接下来就来讲解一下flash的使用吧。
HI3861学习笔记（5）——LiteOS(CMSIS-RTOS2)任务管理
Leung的博客
06-06 1659
一、简介 从系统的角度看，任务是竞争系统资源的最小运行单元。任务可以使用或等待CPU、使用内存空间等系统资源，并独立于其它任务运行。 LiteOS的任务模块可以给用户提供多个任务，实现了任务之间的切换和通信，帮助用户管理业务程序流程。这样用户可以将更多的精力投入到业务功能的实现中。 LiteOS中的任务是抢占式调度机制，高优先级的任务可打断低优先级任务，低优先级任务必须在高优先级任务阻塞或结束后才能得到调度，同时支持时间片轮转调度方式。 LiteOS的任务默认有32个优先级(0-31)，最高优先级为0，
CMSIS-RTOS2简介
propor的专栏
06-17 999
CMSIS-RTOS2
CMSIS-RTOS2 RTX5移植到GD32L233
freemote的博客
03-17 3436
CMSIS-RTOS2 RTX5移植
CMSIS-RTOS API参考手册
06-23
CMSIS-RTOS API参考手册 V1.02 ，根据Keil官方网站文档整理，方便使用FreeRTOS、uc/os等底层操作系统的
CMSIS-RTOS_Presentation-pdf_rtos_CMSISRTOS_CMSIS-RTOS_
10-03
2. CMSIS-RTOS API的详细说明，如何创建和管理任务、信号量、互斥锁等。 3. 实例代码展示，演示如何在实际项目中应用CMSIS-RTOS。 4. CMSIS-RTOS与其他RTOS的对比，突出其优势和适用场景。 5. 故障处理和调试技巧，...
CMSIS_RTOS_Tutorial.zip
03-16
7. **线程安全（Thread Safety）**：CMSIS-RTOS保证了API函数在多任务环境下的线程安全，避免了数据竞争和死锁等问题。 学习CMSIS-RTOS不仅有助于理解实时操作系统的工作原理，还能提升开发效率，因为同一套API可以...
Hitex.CMSIS_RTOS_Tutorial.1.1.0
09-11
通过这个教程，开发者可以学习如何使用CMSIS-RTOS API来创建和管理线程、信号量、互斥锁、队列等关键的RTOS功能。 `Examples`目录下包含了多个示例程序，这些实例展示了CMSIS-RTOS API的实际应用。例如，可能包含...
CMSIS_RTOS消息队列例程
12-07
CMSIS_RTOS消息队列实现于STM32F103RBT6例程,可用串口监控。使用STM32MX+IAR开发
KEIL CMSIS RTOS
04-18
KEIL CMSIS RTOS使用
CMSIS-RTOS 简介
小时候挺菜的博客
08-20 1282
CMSIS-RTOS API是基于Arm®Cortex®-M处理器的设备的通用RTOS接口。CMSIS-RTOS为需要RTOS功能的软件组件提供标准化API，从而为用户和软件行业带来了巨大的好处。 CMSIS-RTOS提供许多应用程序或技术（如UML或Java（JVM））所需的基本功能。 CMSIS-RTOS API的统一功能集简化了软件组件的共享，减少了学习工作量。 使用CMSIS-RTO...
CMSIS-RTOS
guoqx的专栏
05-29 561
CMSIS是ARM的为Cortex系列处理器提供的硬件抽象层，为了屏蔽各个芯片厂商的差异从而方便开发人员。 当前版本是5.7.0，英文表示：Software Interface Standard for Arm Cortex-based Microcontrollers。
【翻译CMSIS_RTOS2 API v2】鸿蒙CMSIS-RTOS2接口之互斥锁
hjh_cos
01-26 532
RTOS互斥锁接口的使用以及问题
STM32F1与STM32CubeIDE编程实例-CMSIS-RTOS V2-互斥(Mutex)管理
视觉与物联智能
05-09 822
CMSIS-RTOS v2 (CMSIS-RTOS2) 为基于 Arm® Cortex® 处理器的设备提供通用 RTOS 接口。 它为需要 RTOS 功能的软件组件提供标准化 API，从而为用户和软件行业带来巨大的好处。 本文将详细介绍，在CMSIS-RTOS V2中如何使用Mutex。
CMSIS-RTOS2 使用笔记 : 资料整理
藏镜人
07-12 740
官方文档：https://arm-software.github.io/CMSIS_5/RTOS2/html/index.html 中文翻译：https://blog.csdn.net/u012325601/category_9274156.html RTOS的一些系统概念解释：https://www.cnblogs.com/horal/p/7841148.html 移植操作：http://www.stmcu.org.cn/module/forum/thread-621965-1-2.html .
CMSIS-RTOS2 入门教程 [2]——RTX_Config.h配置
早上好！
03-18 3291
RTX_Config.h配置配置RTX v5系统配置 System Configuration轮询线程切换 Round-Robin Thread Switching线程配置 Thread Configuration配置线程数和堆栈空间 Configuration of Thread Count and Stack Space栈溢出检查 Stack Overflow Checking堆栈使用水印...
CMSIS-RTOS2 文档翻译 之 参考（CMSIS-RTOS2 API 之 简介）
XinLiBK的博客
04-27 2236
CMSIS-RTOS2 API 介绍 CMSIS-RTOS API v2 的 C 函数接口。更多...内容 内存管理 关于内存管理可能性的信息  内核信息和控制 提供版本/系统信息并启动/控制 RTOS 内核。  线程管理 定义，创建和控制线程函数。  线程标志 使用标志同步线程。  事件标志 使用事件标志同步线程。   通用延时函数 等待一段时间。   定时器管理 创建和控制定时器和定时器回调...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值