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