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