CMSIS-RTOS2 文档翻译之参考（CMSIS-RTOS2 API 之内存池）

最新推荐文章于 2024-08-11 19:47:39 发布

XinLiBK

最新推荐文章于 2024-08-11 19:47:39 发布

阅读量2.3k

点赞数 3

分类专栏： CMSIS CMSIS-RTOS2 文档翻译文章标签： ARM CMSIS RTOS RTOS2 RTX

CMSIS 同时被 2 个专栏收录

42 篇文章 31 订阅

订阅专栏

CMSIS-RTOS2 文档翻译

42 篇文章 102 订阅

订阅专栏

管理线程安全的固定大小的动态内存块。更多...

数据结构
struct	osMemoryPoolAttr_t
	内存池的属性结构体。更多...

类型定义
typedef void *	osMemoryPoolId_t

函数
osMemoryPoolId_t	osMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr)
	创建并初始化一个内存池对象。更多...

const char *	osMemoryPoolGetName (osMemoryPoolId_t mp_id)
	获取内存池对象的名称。更多...

void *	osMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout)
	从内存池中分配内存块。更多...

osStatus_t	osMemoryPoolFree (osMemoryPoolId_t mp_id, void *block)
	将分配的内存块返回到内存池。更多...

uint32_t	osMemoryPoolGetCapacity (osMemoryPoolId_t mp_id)
	获取内存池中的最大内存块数。更多...

uint32_t	osMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id)
	获取内存池中的内存块大小。更多...

uint32_t	osMemoryPoolGetCount (osMemoryPoolId_t mp_id)
	获取内存池中使用的内存块数量。更多...

uint32_t	osMemoryPoolGetSpace (osMemoryPoolId_t mp_id)
	获取内存池中可用的内存块数量。更多...

osStatus_t	osMemoryPoolDelete (osMemoryPoolId_t mp_id)
	删除一个内存池对象。更多...

描述

内存池是线程安全的固定大小内存块。它们的运行速度比动态分配的堆快得多，并且不会遭受碎片化。线程安全的，他们可以通过线程和ISR来访问。

内存池可以看作固定和相同大小的可用（未使用）内存块的链表。从池中分配内存（使用 osMemoryPoolAlloc）只需从列表中取消链接，并将控制权移交给用户。释放内存到池（使用 osMemoryPoolFree）只需将块重新链接到列表中。

CMSIS-RTOS Memory Pools

注意

一个人不得写入释放块。实现将未使用的块的存储器重用于内部控制数据，即链接列表指针。

共享内存是线程之间交换信息的基本模型之一。使用内存池交换数据，与消息队列相比，您可以在线程之间共享更复杂的对象。内存池管理功能用于定义和管理这种固定大小的内存池。

注意

可以从中断服务例程调用osMemoryPoolAlloc，osMemoryPoolFree，osMemoryPoolGetCapacity，osMemoryPoolGetBlockSize，osMemoryPoolGetCount，osMemoryPoolGetSpace 函数。

有关 RTX5 配置选项，请参阅内存池配置。

数据结构文档

struct osMemoryPoolAttr_t

用于配置内存池的属性。

有关使用的详细信息，请参阅内存管理

osMemoryPoolAttr_t::cb_mem
osMemoryPoolAttr_t::cb_size
osMemoryPoolAttr_t::mp_mem
osMemoryPoolAttr_t::mp_size

数据字段
const char *	name	内存池的名称指向具有人类可读内存池对象名称的字符串。默认值：NULL 。
uint32_t	attr_bits	属性位保留以供将来使用（设为 '0'）。默认值：0 。
void *	cb_mem	内存控制块指向内存池控制块对象的内存位置。这可以选择用于定制内存管理系统。默认值：NULL（使用内核内存管理）。
uint32_t	cb_size	为控制块提供的内存大小内存块的大小与 cb_mem 一起传递。必须是内存池控制块对象的大小或更大。
void *	mp_mem	内存数据存储指向内存池对象数据的内存位置。默认值：NULL 。
uint32_t	mp_size	为数据存储提供的内存大小通过 mp_mem 传递的内存大小。

类型定义文档

osMemoryPoolId_t

内存池 ID 标识内存池。

返回者：

osMemoryPoolNew

函数文档

osMemoryPoolId_t osMemoryPoolNew	(	uint32_t	block_count,
		uint32_t	block_size,
		const osMemoryPoolAttr_t *	attr
	)

参数

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

内存池 ID 以供其他函数参考，或者在发生错误时为 NULL 。

函数 osMemoryPoolNew 创建并初始化一个内存池对象，并返回指向内存池对象标识符的指针，或者在发生错误时返回 NULL 。它可以在 RTOS 启动之前（调用 osKernelStart）安全地调用，但不能在它初始化之前（调用 osKernelInitialize）调用。

所需的内存总量至少为 block_count * block_size 。内存池中的内存只能在 block_size 的固定部分分配/释放。

注意

该函数不能从中断服务程序调用。

代码示例

 
    #include "cmsis_os2.h" 
    // CMSIS RTOS header file 
   
    /*---------------------------------------------------------------------------- 
   
     * Memory Pool creation & usage 
   
     *---------------------------------------------------------------------------*/ 
   
    #define MEMPOOL_OBJECTS 16 // number of Memory Pool Objects 
   
    typedef 
    struct { 
    // object data type 
   
     uint8_t Buf[32]; 
   
     uint8_t Idx; 
   
     } MEM_BLOCK_t; 
   
    void Thread_MemPool ( 
    void *argument); 
    // thread function 
   
    osThreadId_t tid_Thread_MemPool; 
    // thread id 
   
    osMemoryPoolId_t mpid_MemPool; 
    // memory pool id 
   
    int Init_MemPool ( 
    void) 
   
     { 
   
     mpid_MemPool = 
    osMemoryPoolNew(MEMPOOL_OBJECTS, 
    sizeof(MEM_BLOCK_t), NULL); 
   
    if (mpid_MemPool == NULL) { 
   
     ; 
    // MemPool object not created, handle failure 
   
     } 
   
     tid_Thread_MemPool = 
    osThreadNew (Thread_MemPool,NULL , NULL); 
   
    if (tid_Thread_MemPool == NULL) { 
   
    return(-1); 
   
     } 
   
    return(0); 
   
     } 
   
    void Thread_MemPool ( 
    void *argument) 
   
     { 
   
     osStatus_t status; 
   
     MEM_BLOCK_t *pMem = 0; 
   
    while (1) { 
   
     ; 
    // Insert thread code here... 
   
     pMem = (MEM_BLOCK_t *) 
    osMemoryPoolAlloc (mpid_MemPool, NULL); 
    // get Mem Block 
   
    if (pMem) { 
    // Mem Block was available 
   
     pMem->Buf[0] = 0x55; 
    // do some work... 
   
     pMem->Idx = 0; 
   
     status = 
    osMemoryPoolFree (mpid_MemPool, pMem); 
    // free mem block 
   
    switch (status) { 
   
    case 
    osOK: 
   
    break; 
   
    case 
    osErrorParameter: 
   
    break; 
   
    case 
    osErrorNoMemory: 
   
    break; 
   
    default: 
   
    break; 
   
     } 
   
     } 
   
    osThreadYield (); 
    // suspend thread 
   
     } 
   
     }