CMSIS-RTOS2 文档翻译 之 参考（RTX5 特定的 API 之 事件功能（内存池函数））

最新推荐文章于 2025-05-29 15:26:39 发布
最新推荐文章于 2025-05-29 15:26:39 发布
阅读量1k 收藏 1
点赞数 1
分类专栏： CMSIS CMSIS-RTOS2 文档翻译 文章标签： ARM CMSIS RTOS RTOS2 RTX

内存池函数

事件功能

内存池函数生成的事件。更多...

函数

void EvrRtxMemoryPoolError (osMemoryPoolId_t mp_id, int32_t status)
 内存池错误事件（错误）更多...
 
void EvrRtxMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr)
 内存池上的事件创建和初始化（API）更多...
 
void EvrRtxMemoryPoolCreated (osMemoryPoolId_t mp_id, const char *name)
 成功的内存池创建事件（Op）更多...
 
void EvrRtxMemoryPoolGetName (osMemoryPoolId_t mp_id, const char *name)
 内存池名称检索（API）上的事件 更多...
 
void EvrRtxMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout)
 内存池分配事件（API）更多...
 
void EvrRtxMemoryPoolAllocPending (osMemoryPoolId_t mp_id, uint32_t timeout)
 待处理内存池分配事件（Op）更多...
 
void EvrRtxMemoryPoolAllocTimeout (osMemoryPoolId_t mp_id)
 内存池分配超时事件（Op）更多...
 
void EvrRtxMemoryPoolAllocated (osMemoryPoolId_t mp_id, void *block)
 内存池分配成功的事件（Op）更多...
 
void EvrRtxMemoryPoolAllocFailed (osMemoryPoolId_t mp_id)
 不成功的内存池分配事件（Op）更多...
 
void EvrRtxMemoryPoolFree (osMemoryPoolId_t mp_id, void *block)
 免费内存池事件（API）更多...
 
void EvrRtxMemoryPoolDeallocated (osMemoryPoolId_t mp_id, void *block)
 成功内存池免费活动（Op）更多...
 
void EvrRtxMemoryPoolFreeFailed (osMemoryPoolId_t mp_id, void *block)
 不成功的内存池免费事件（Op）更多...
 
void EvrRtxMemoryPoolGetCapacity (osMemoryPoolId_t mp_id, uint32_t capacity)
 内存池容量检索事件（API）更多...
 
void EvrRtxMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id, uint32_t block_size)
 内存池块大小检索事件（API）更多...
 
void EvrRtxMemoryPoolGetCount (osMemoryPoolId_t mp_id, uint32_t count)
 所使用的内存池块事件检索（API）更多...
 
void EvrRtxMemoryPoolGetSpace (osMemoryPoolId_t mp_id, uint32_t space)
 可用内存池块上的事件检索（API）更多...
 
void EvrRtxMemoryPoolDelete (osMemoryPoolId_t mp_id)
 内存池删除事件（API）更多...
 
void EvrRtxMemoryPoolDestroyed (osMemoryPoolId_t mp_id)
 成功内存池删除事件（Op）更多...
 

 

描述

函数文档

void EvrRtxMemoryPoolError(osMemoryPoolId_t mp_id,
  int32_t status 
 )  

参数

[in]mp_id通过 osMemoryPoolNew 获取的内存池 ID 或 ID 未知时的 NULL。
[in]status扩展执行状态。

当内存池例程由于错误而完成执行时，将生成事件 MemoryPoolError。

status 参数指示执行状态，可以是 osStatus_t 代码之一，也可以是下表中汇总的扩展执行状态代码之一。

扩展状态代码描述
osRtxErrorKernelNotReady内核调度程序未处于就绪状态。
osRtxErrorKernelNotRunning内核调度程序没有执行 - 没有正在运行的线程。
osRtxErrorInvalidControlBlock指定了具有无效对齐或大小的对象控制块。
osRtxErrorInvalidDataMemory指定了无效对齐或大小的对象数据存储器。
osRtxErrorInvalidThreadStack指定了无效对齐或大小的线程堆栈内存。
osRtxErrorInvalidPriority指定了无效的线程优先级。
osRtxErrorThreadNotJoinable指定的线程不可连接。
osRtxErrorMutexNotOwned指定的互斥锁不归当前运行的线程所有。
osRtxErrorMutexNotLocked指定的互斥锁未锁定。
osRtxErrorMutexLockLimit达到的最大递归互斥锁数。
osRtxErrorSemaphoreCountLimit达到了信号量计数限制。
osRtxErrorTZ_InitContext_S安全上下文内存系统初始化失败
osRtxErrorTZ_AllocContext_S安全上下文内存分配失败。
osRtxErrorTZ_FreeContext_S安全上下文内存释放失败。
osRtxErrorTZ_LoadContext_S安全上下文加载失败。
osRtxErrorTZ_SaveContext_S安全上下文保存失败。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • status : 执行状态代码。

 

void EvrRtxMemoryPoolNew(uint32_t block_count,
  uint32_t block_size,
  const osMemoryPoolAttr_t * attr 
 )  

参数

[in]block_count内存池中的最大内存块数。
[in]block_size内存块大小，以字节为单位。
[in]attr内存池属性; NULL：默认值。

调用函数 osMemoryPoolNew 时会生成事件 MemoryPoolNew。

事件记录器中的值显示：

  • block_count : 内存池中的最大内存块数。
  • block_size : 内存块大小，以字节为单位。
  • attr : 内存池属性的内存地址，如果未指定，则为 0。

如果在 API 调用中提供了内存池属性，则它们也会在事件记录器中详细说明。

 

void EvrRtxMemoryPoolCreated(osMemoryPoolId_t mp_id,
  const char * name 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]name指向内存池对象名称的指针。

当函数 osMemoryPoolNew 成功创建内存池对象时，将生成事件 MemoryPoolCreated。

事件记录器中的值显示：

  • mp_id : 内存池 ID。

 

void EvrRtxMemoryPoolGetName(osMemoryPoolId_t mp_id,
  const char * name 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]name指向内存池对象名称的指针。

调用函数 osMemoryPoolGetName 并且其执行结果已知时，将生成事件 MemoryPoolGetName。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • name : 检索名称字符串的内存地址（如果发生故障，则为 0）。

 

void EvrRtxMemoryPoolAlloc(osMemoryPoolId_t mp_id,
  uint32_t timeout 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]timeout超时值，如果没有超时，则为 0。

调用函数 osMemoryPoolAlloc 时会生成 MemoryPoolAlloc 事件。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • timeout : 超时值。

 

void EvrRtxMemoryPoolAllocPending(osMemoryPoolId_t mp_id,
  uint32_t timeout 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]timeout超时值，如果没有超时，则为 0。

当函数 osMemoryPoolAlloc 阻塞当前正在运行的线程并等待内存块变为可用时，将生成事件 MemoryPoolAllocPending。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • timeout : 超时值。

 

void EvrRtxMemoryPoolAllocTimeout(osMemoryPoolId_t mp_id) 

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。

等待内存池变为可用时生成的事件 MemoryPoolAllocTimeout 由于等待超时过期而中止。

事件记录器中的值显示：

  • mp_id : 内存池 ID。

 

void EvrRtxMemoryPoolAllocated(osMemoryPoolId_t mp_id,
  void * block 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]block已分配内存块的地址。

当函数 osMemoryPoolAlloc 成功分配内存块时，将生成 MemoryPoolAllocated 事件。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • block : 分配的内存块的内存地址。

 

void EvrRtxMemoryPoolAllocFailed(osMemoryPoolId_t mp_id) 

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。

当函数 osMemoryPoolAlloc 由于可用内存不足而无法分配内存块时，将生成事件 MemoryPoolAllocFailed。

事件记录器中的值显示：

  • mp_id : 内存池 ID。

 

void EvrRtxMemoryPoolFree(osMemoryPoolId_t mp_id,
  void * block 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]block要返回到内存池的已分配内存块的地址。

调用函数 osMemoryPoolFree 时会生成事件 MemoryPoolFree。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • block : 要返回到内存池的内存块的内存地址。

 

void EvrRtxMemoryPoolDeallocated(osMemoryPoolId_t mp_id,
  void * block 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]block要返回到内存池的已分配内存块的地址。

当函数 osMemoryPoolFree 成功释放内存块时，将生成 MemoryPoolDeallocated 事件。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • block : 返回内存池的内存块的内存地址。

 

void EvrRtxMemoryPoolFreeFailed(osMemoryPoolId_t mp_id,
  void * block 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]block要返回到内存池的已分配内存块的地址。

当函数 osMemoryPoolFree 无法释放内存块时，将生成事件 MemoryPoolFreeFailed。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • block : 要返回到内存池的内存块的内存地址。

 

void EvrRtxMemoryPoolGetCapacity(osMemoryPoolId_t mp_id,
  uint32_t capacity 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]capacity最大内存块数。

调用函数 osMemoryPoolGetCapacity 并且其执行结果已知时，将生成事件 MemoryPoolGetCapacity。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • capacity : 检索到的最大内存块数（如果发生故障，则为 0）。

 

void EvrRtxMemoryPoolGetBlockSize(osMemoryPoolId_t mp_id,
  uint32_t block_size 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]block_size内存块大小，以字节为单位。

调用函数 osMemoryPoolGetBlockSize 并且其执行结果已知时，将生成事件 MemoryPoolGetBlockSize。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • block_size : 检索内存块大小（以字节为单位）（如果发生故障，则为 0）。

 

void EvrRtxMemoryPoolGetCount(osMemoryPoolId_t mp_id,
  uint32_t count 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]count使用的内存块数。

调用函数 osMemoryPoolGetCount 并且其执行结果已知时，将生成事件 MemoryPoolGetCount。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • count : 检索到的内存块数量（如果发生故障则为 0）。

 

void EvrRtxMemoryPoolGetSpace(osMemoryPoolId_t mp_id,
  uint32_t space 
 )  

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。
[in]space可用的内存块数。

当调用函数 osMemoryPoolGetSpace 并且其执行结果已知时，将生成事件 MemoryPoolGetSpace。

事件记录器中的值显示：

  • mp_id : 内存池 ID。
  • space : 检索到的可用内存块数（如果发生故障，则为 0）。

 

void EvrRtxMemoryPoolDelete(osMemoryPoolId_t mp_id) 

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。

调用函数 osMemoryPoolDelete 时会生成事件 MemoryPoolDelete。

事件记录器中的值显示：

  • mp_id : 内存池 ID。

 

void EvrRtxMemoryPoolDestroyed(osMemoryPoolId_t mp_id) 

参数

[in]mp_idosMemoryPoolNew 获取的内存池 ID。

当函数 osMemoryPoolDelete 成功删除内存池对象时，将生成事件 MemoryPoolDestroyed。

事件记录器中的值显示：

  • mp_id : 内存池 ID。

CMSIS-RTOS2 RTX5移植到GD32L233
freemote的博客
03-17 3837
CMSIS-RTOS2 RTX5移植
使用 CMSIS-RTOS API 定义和管理互斥锁的指南
KillCSDN666的博客
08-30 579
此方法主要用于嵌入式系统中的实时操作系统（RTOS），它通过定义和使用互斥锁来确保多线程环境下对共享资源的安全访问。每个线程在进入临界区前获取锁，在退出临界区后释放锁，从而防止数据竞争和潜在的错误。
CMSIS-RTOS API参考手册
06-23
CMSIS-RTOS API参考手册 V1.02 ，根据Keil官方网站文档整理，方便使用FreeRTOS、uc/os等底层操作系统的
【亲测免费】 探索嵌入式开发的利器：CMSIS-RTOS API参考手册
gitblog_06692的博客
10-29 1161
探索嵌入式开发的利器：CMSIS-RTOS API参考手册 【下载地址】CMSIS-RTOSAPI参考手册分享 本资源提供了CMSIS-RTOS API参考手册的V1.02版本，旨在为嵌入式系统开发者带来便捷。该手册是基于Keil官方网站的官方文档进行整理和汇总的，特别适合那些在项目中运用FreeRTOS、uC/OS等知...
【嵌入式】RTX5 (CMSIS-RTOS2) API 手册终极指南：从零玩转嵌入式实时操作系统！
qq_42367781的博客
05-29 818
🔥本文为你带来 ARM RTX5（CMSIS-RTOS2）的 API 手册指南！无论你是初学者还是进阶开发者。
CMSIS-RTOS2 文档翻译 之 参考（CMSIS-RTOS2 API 之 内存池）
XinLiBK的博客
05-04 2588
内存池CMSIS-RTOS2 API 管理线程安全的固定大小的动态内存块。更多...数据结构struct  osMemoryPoolAttr_t 内存池的属性结构体。更多... 类型定义typedef void * osMemoryPoolId_t 函数osMemoryPoolId_t osMemoryPoolNew (uint32_t block_count, uint32_t block_s...
CMSIS-RTOS2 文档翻译 之 参考（RTX5 特定的 API 之 函数）
XinLiBK的博客
05-05 2883
函数RTX5 特定的 API RTX5 函数。更多...函数uint32_t osRtxErrorNotify (uint32_t code, void *object_id) OS 错误回调函数。更多... void osRtxIdleThread (void *argument) OS 空闲线程。更多... 描述函数文档 uint32_t osRtxErrorNotify ...
CMSIS-RTOS2 文档翻译 之 参考（CMSIS-RTOS2 API 之 简介）
XinLiBK的博客
04-27 2360
CMSIS-RTOS2 API 介绍 CMSIS-RTOS API v2 的 C 函数接口。更多...内容 内存管理 关于内存管理可能性的信息  内核信息和控制 提供版本/系统信息并启动/控制 RTOS 内核。  线程管理 定义，创建和控制线程函数。  线程标志 使用标志同步线程。  事件标志 使用事件标志同步线程。   通用延时函数 等待一段时间。   定时器管理 创建和控制定时器和定时器回调...
CMSIS-RTOS_Presentation-pdf_rtos_CMSISRTOS_CMSIS-RTOS_
10-03
CMSIS-RTOS API的标准化意味着开发者可以使用相同的代码库在支持CMSIS-RTOS的不同RTOS上运行，如FreeRTOS、Keil RTX和CMSIS-RTOS2等。这大大简化了跨平台开发，降低了维护成本。 **CMSIS-RTOS_Presentation.pdf** ...
stm32407-ppp-rtx5-rl_net_ppp_stm32f407_STM32CMSIS-RTOS_stm32ppp拨
10-01
在STM32F407的RTOS应用中，STM32CMSIS-RTOS提供了与RTX5兼容的API，使开发者可以方便地在STM32平台上利用RTOS的强大功能。 RL-Net是Realtek公司开发的一套网络协议栈，它支持多种网络协议，包括PPP。在本例程中，RL...
CMSIS-RTOS API V2
09-05
CMSIS-RTOS API V2是实时操作系统(RTOS)的应用编程接口，主要针对微控制器(MCU)环境设计，用于提供任务调度、信号量、消息队列等多线程和同步功能。CMSIS（ Cortex-M 微控制器软件接口标准）RTOS API V2是该接口的第...
CMSIS-RTOS2/RTX5 内存分配方式
最新发布
07-22
RTX5作为CMSIS-RTOS2的参考实现之一，其内存分配机制设计得非常高效且灵活，旨在满足嵌入式实时系统的需求，特别是在资源受限环境下。其核心策略是**避免使用标准库的`malloc`/`free`**，转而采用**静态分配为主、...
CMSIS-RTOS手册
占毛毛
03-22 944
CUBEIDE生成的freeRTOS代码是经过CMSIS封装过的，与原版freertos有些许差异。如果用生成的代码还是得看CMSIS的手册 https://arm-software.github.io/CMSIS_5/RTOS2/html/group__CMSIS__RTOS__Message.html#gaa515fc8b956f721a8f72b2c505813bfc ...
CMSIS-RTOS2 文档翻译 之 参考（CMSIS-RTOS2 API 之 内存管理）
XinLiBK的博客
04-27 2228
内存管理CMSIS-RTOS2 API 关于内存管理可能性的信息。更多...CMSIS-RTOS2 API 提供了两种用户可以选择的内存管理选项。对于对象存储可以使用自动动态分配（完全便携），或者手动用户定义的分配（具体实施）。为了影响内存分配方案，可以根据请求创建的所有 RTOS 对象（即具有 osXxxNew 函数的那些对象）在创建时接受可选的 osXxxAttr_t attr 参数。作为经...
CMSIS-RTOS2 应用笔记 八 目录结构和文件概述
wylwws的博客
05-05 2461
目录结构和文件概述 以下部分概述了与CMSIS-RTOS RTX v5的用户相关的目录结构和文件。 以下目录引用开始于CMSIS软件包安装路径下方，例如ARM / CMSIS / version / CMSIS / RTOS2。 RTX v5 目录结构 CMSIS-RTOS RTX v5以源代码提供，并提供了几个示例。 Directory Conten
CMSIS-RTOS教程中文版
hongprove的博客
03-02 1万+
CMSIS_RTOS_Tutorial自译中文版 一.序言 本资料是Trevor Martin编写的《The Designers Guide to the Cortex-M Processor Family》的摘要，并得到Elsevier的再版许可。查询更多细节，请到本资料尾部进阶章节。 本资料着力于介绍RTX，RTX可运行在基于Cortex-M构架的微控制器上。尤其，RTX符合...
CMSIS-RTOS RTX手册阅读笔记
lxqds的博客
12-25 1217
阅读RTX手册，记录其中一些函数用法，简介，包括OsDelay,Virtual_Timer,os_idle_demon,Signals,Semaphore,Mutex,Message_queue,Mail_queue
内存池的使用
m0_37202877的博客
10-25 244
函数osMemoryPoolNew创建并初始化内存池对象，并在发生错误时返回指向内存池对象标识符或NULL的指针。内存池可以看作是固定大小和相等大小的可用（未使用）内存块的链表。将内存释放到池中（使用osMemoryPoolFree）只需将块重新锁定到列表中即可。内存池是线程安全的固定大小的内存块。由于是线程安全的，它们可以从线程和ISR访问。池中的内存只能在block_size的固定部分分配/释放。[in]block_count内存池中内存块的最大数量。[in]block_size内存块大小（字节）。
CMSIS-RTOS2 应用笔记 三 功能概述
热门推荐
wylwws的博客
05-05 1万+
CMSIS-RTOS2 概述在cmsis_os2.h头文件中实现的所有CMSIS-RTOS C API v2函数。 内核信息和控制 osKernelGetInfo：获取RTOS内核信息。osKernelGetState：获取当前的RTOS内核状态。osKernelGetSysTimerCount：获取RTOS内核系统定时器计数。osKernelGetSysTime
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值