2、LVGL内存配置核心：LV_MEM_SIZE、LV_MEM_POOL、LV_MEM_CUSTOM

好，咱们正式开始聊LVGL的内存配置。说实话，我见过太多工程师在项目初期随便设个内存大小，结果后期疯狂改代码。你想想看，一个GUI框架跑不起来，十有八九是内存没配好。

LVGL默认自带一个内存分配器。它不依赖标准库的malloc/free，而是自己管理一块静态内存池。这样做的好处很明显——嵌入式环境里，标准库的堆管理往往不可控，碎片化严重。LVGL自己管，心里有底。

这块内存池的核心配置，就三个东西：LV_MEM_SIZE、LV_MEM_POOL、LV_MEM_CUSTOM。搞懂它们，你就掌握了LVGL内存的命门。

2.1 LV_MEM_SIZE：给LVGL划多大地盘？

说白了，这就是你给LVGL分配的总内存大小。单位是字节。默认值在 lv_conf.h 里定义：

#define LV_MEM_SIZE (32U * 1024U)    // 默认32KB

这个值怎么定？我个人的经验是：先按最坏情况估算，再留余量。

控件数量：每个按钮、标签、滑块都要占内存。一个基础控件大约100-300字节。
显示缓冲区：LVGL需要至少一个屏幕缓冲区。比如320x240分辨率、16位色深，一个缓冲区就是320*240*2 = 150KB。
字体和图片：内嵌字体、图片解码临时缓冲区，这些是大头。

经验公式（我常用的）：

LV_MEM_SIZE = 显示缓冲区大小 × 2 + 控件预估内存 × 1.5 + 字体/图片临时缓冲区

举个例子：320x240 RGB565屏幕，20个控件，一个中文字体：

150KB × 2 + 20 × 200B × 1.5 + 10KB ≈ 316KB

我一般直接取整到384KB或512KB。

注意：LV_MEM_SIZE 设太大不一定好。如果你的MCU总共只有512KB RAM，你给LVGL分了480KB，那系统其他部分就危险了。我曾经在一个项目里把内存分得太满，结果WiFi协议栈初始化直接崩了——因为没地方建连接缓冲区。

2.2 LV_MEM_POOL：内存池到底在哪？

默认情况下，LVGL会在内部定义一个全局数组作为内存池：

static uint8_t mem_pool[LV_MEM_SIZE];

这个数组放在哪里？取决于你的链接脚本和编译器。通常是在BSS段或者DATA段。如果你不干预，它就在RAM里。

但有些场景下，你可能想手动指定内存池的位置。比如：

你的MCU有多个RAM区域（如DTCM、SRAM、SDRAM），你想把LVGL内存放在特定区域。
你想在外部SDRAM里跑GUI，把内部RAM留给实时任务。

这时候就需要 LV_MEM_POOL 出场。不过要注意，这个宏在标准LVGL里不是直接暴露的。你需要通过自定义内存分配器来实现。

我习惯的做法是：

// 在外部SDRAM定义内存池
#define LVGL_MEM_ADDR   0xC0000000
#define LVGL_MEM_SIZE   (512 * 1024)

// 初始化时告诉LVGL
lv_mem_init_builtin((void*)LVGL_MEM_ADDR, LVGL_MEM_SIZE);

嗯，这里要注意：外部SDRAM的访问速度通常比内部RAM慢。如果你的GUI刷新率要求高，建议把频繁访问的控件数据放在内部RAM，把图片帧缓冲放在SDRAM。

2.3 LV_MEM_CUSTOM：什么时候自己管内存？

LV_MEM_CUSTOM 是一个开关。默认是0，表示用LVGL内置的内存分配器。设为1之后，你就得自己提供 malloc、free、realloc 的实现。

#define LV_MEM_CUSTOM 1

为什么要自己管？我遇到过几种情况：

使用RTOS的堆管理：比如FreeRTOS的pvPortMalloc/vPortFree，可以统一管理。
使用第三方内存库：比如TLSF、rpmalloc，碎片化更少。
需要内存统计和调试：自己接管后可以加钩子函数，监控内存泄漏。

当你开启 LV_MEM_CUSTOM 后，需要实现这几个函数：

void * lv_mem_alloc(size_t size);
void * lv_mem_realloc(void * ptr, size_t new_size);
void   lv_mem_free(void * ptr);

我的建议：除非你有明确的理由（比如RTOS强制要求统一堆管理），否则先用内置分配器。LVGL内置的分配器做了很多优化，比如内存对齐、小块内存合并。我自己踩过坑——换成标准malloc后，碎片化反而更严重了。

2.4 三种配置的对比

我把它们整理成一张表，方便你对照：

配置项	作用	典型值	适用场景
LV_MEM_SIZE	定义内存池总大小	32KB ~ 512KB	所有项目，根据屏幕和控件数调整
LV_MEM_POOL	指定内存池的物理地址	自定义地址（如SDRAM基址）	多RAM区域、外部存储器
LV_MEM_CUSTOM	启用自定义内存分配器	0 或 1	RTOS环境、特殊内存管理需求

2.5 知识结构图

下面这张图帮你理清这三个配置的关系：

2.6 避坑指南

最后，分享几个我踩过的坑：

LV_MEM_SIZE 设太小：LVGL会报 "lv_mem_alloc: out of memory"。别慌，先看日志里当前用了多少，然后加30%余量。
LV_MEM_CUSTOM 和 RTOS 堆冲突：如果你同时用了 FreeRTOS 的 heap_4 和 LVGL 自定义分配器，两个堆会互相覆盖。一定要确保它们指向不同的内存区域。
内存池对齐问题：有些MCU要求DMA缓冲区对齐到32字节或64字节。LVGL默认是8字节对齐，如果你要用DMA传输帧缓冲，记得手动对齐。

调试小技巧：在 lv_conf.h 里开启 LV_MEM_MONITOR，可以实时查看内存使用率。我习惯在调试阶段一直开着，上线前再关掉。

好了，这一章的核心就这些。记住：内存配置是LVGL优化的第一步，也是最重要的一步。配好了，后面事半功倍；配不好，后面全是坑。

📚 课程目录

2、LVGL内存配置核心：LV_MEM_SIZE、LV_MEM_POOL、LV_MEM_CUSTOM

2.1 LV_MEM_SIZE：给LVGL划多大地盘？

2.2 LV_MEM_POOL：内存池到底在哪？

2.3 LV_MEM_CUSTOM：什么时候自己管内存？

2.4 三种配置的对比

2.5 知识结构图

2.6 避坑指南