• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 内存信息统计
2
3
4## 基础概念
5
6内存信息包括内存池大小、内存使用量、剩余内存大小、最大空闲内存、内存水线、内存节点数统计、碎片率等。
7
8- 内存水线：即内存池的最大使用量，每次申请和释放时，都会更新水线值，实际业务可根据该值，优化内存池大小；
9
10- 碎片率：衡量内存池的碎片化程度，碎片率高表现为内存池剩余内存很多，但是最大空闲内存块很小，可以用公式（fragment=100-100\*最大空闲内存块大小/剩余内存大小）来度量；
11
12- 其他统计信息：调用接口LOS_MemInfoGet时，会扫描内存池的节点信息，统计出相关信息。
13
14
15## 功能配置
16
17LOSCFG_MEM_WATERLINE：开关宏，默认关闭；若需要打开这个功能，可以在配置项中开启“Debug-> Enable MEM Debug-> Enable memory pool waterline or not”。如需获取内存水线，需要打开该配置。
18
19
20## 开发指导
21
22
23### 开发流程
24
25关键结构体介绍：
26
27
28```c
29typedef struct {
30    UINT32 totalUsedSize;       // 内存池的内存使用量
31    UINT32 totalFreeSize;       // 内存池的剩余内存大小
32    UINT32 maxFreeNodeSize;     // 内存池的最大空闲内存块大小
33    UINT32 usedNodeNum;         // 内存池的非空闲内存块个数
34    UINT32 freeNodeNum;         // 内存池的空闲内存块个数
35#if (LOSCFG_MEM_WATERLINE == 1)     // 默认关闭，可以通过menuconfig配置工具打开
36    UINT32 usageWaterLine;      // 内存池的水线值
37#endif
38} LOS_MEM_POOL_STATUS;
39```
40
41- 内存水线获取：调用 LOS_MemInfoGet(VOID *pool,  LOS_MEM_POOL_STATUS *poolStatus)接口，第1个参数是内存池首地址，第2个参数是LOS_MEM_POOL_STATUS类型的句柄，其中字段usageWaterLine即水线值。
42
43- 内存碎片率计算：同样调用LOS_MemInfoGet接口，可以获取内存池的剩余内存大小和最大空闲内存块大小，然后根据公式（fragment=100-100\*最大空闲内存块大小/剩余内存大小）得出此时的动态内存池碎片率。
44
45
46### 编程实例
47
48本实例实现如下功能：
49
501. 创建一个监控任务，用于获取内存池的信息；
51
522. 调用LOS_MemInfoGet接口，获取内存池的基础信息；
53
543. 利用公式算出使用率及碎片率。
55
56**示例代码**
57
58本演示代码在 . kernel /liteos_a/testsuites /kernel /src /osTest.c中编译验证，在TestTaskEntry中调用验证入口函数MemTest。
59
60代码实现如下：
61
62```c
63#include <stdio.h>
64#include <string.h>
65#include "los_task.h"
66#include "los_memory.h"
67#include "los_config.h"
68
69void MemInfoTaskFunc(void)
70{
71    LOS_MEM_POOL_STATUS poolStatus = {0};
72
73    /* pool为要统计信息的内存地址，此处以OS_SYS_MEM_ADDR为例 */
74    void *pool = OS_SYS_MEM_ADDR;
75    LOS_MemInfoGet(pool, &poolStatus);
76    /* 算出内存池当前的碎片率百分比 */
77    unsigned char fragment = 100 - poolStatus.maxFreeNodeSize * 100 / poolStatus.totalFreeSize;
78    /* 算出内存池当前的使用率百分比 */
79    unsigned char usage = LOS_MemTotalUsedGet(pool) * 100 / LOS_MemPoolSizeGet(pool);
80    dprintf("usage = %d, fragment = %d, maxFreeSize = %d, totalFreeSize = %d, waterLine = %d\n", usage, fragment,                            poolStatus.maxFreeNodeSize, poolStatus.totalFreeSize, poolStatus.usageWaterLine);
81}
82
83int MemTest(void)
84{
85    unsigned int ret;
86    unsigned int taskID;
87    TSK_INIT_PARAM_S taskStatus = {0};
88    taskStatus.pfnTaskEntry = (TSK_ENTRY_FUNC)MemInfoTaskFunc;
89    taskStatus.uwStackSize  = 0x1000;
90    taskStatus.pcName       = "memInfo";
91    taskStatus.usTaskPrio   = 10;
92    ret = LOS_TaskCreate(&taskID, &taskStatus);
93    if (ret != LOS_OK) {
94        dprintf("task create failed\n");
95        return LOS_NOK;
96    }
97    return LOS_OK;
98}
99```
100
101
102**结果验证**
103
104
105编译运行输出的结果如下：
106
107根据实际运行环境，数据会有差异
108
109```
110usage = 22, fragment = 3, maxFreeSize = 49056, totalFreeSize = 50132, waterLine = 1414
111```
112