3、内部RAM缓存：LVGL内部图像缓存机制、LV_IMG_CACHE_DEF_SIZE配置
好，咱们接着聊图像缓存。前面讲了外部存储和文件系统，现在该聊聊LVGL内部那块RAM缓存了。
说白了，LVGL内部图像缓存就是一块预先分配好的内存区域。它专门用来存放解码后的图像数据。你想想看，每次从外部存储读一张图，都要重新解码一遍，这得多慢？有了缓存，解码一次，后面直接用，效率就上来了。
LVGL内部图像缓存机制
LVGL的图像缓存机制，核心思路其实很简单——空间换时间。它维护了一个缓存池，里面存着最近用过的图像。下次再要用同一张图，直接从缓存里拿，不用重新解码。
这个机制有几个关键点：
- 缓存对象：每个缓存项都是一个
lv_img_cache_entry_t结构体，里面存了图像的句柄、解码后的数据指针、最近使用时间戳等信息。 - LRU淘汰策略：当缓存满了，新图像要进来，就得踢掉一个旧的。LVGL用的是最近最少使用（LRU）算法。哪个图像最久没被访问，就优先淘汰它。
- 自动管理：你不需要手动去操作缓存。LVGL在
lv_img_set_src()或者绘制图像的时候，会自动检查缓存。命中就直接用，没命中就解码并加入缓存。
我记得有一次做智能家居面板，界面里要频繁切换几个背景图。一开始没开缓存，每次切换都卡一下，大概200多毫秒。后来把缓存打开，切换时间直接降到10毫秒以内。效果立竿见影。
核心要点：LVGL内部缓存是自动管理的，你只需要配置好缓存大小，剩下的交给它。
LV_IMG_CACHE_DEF_SIZE 配置
这个宏定义在 lv_conf.h 里。它决定了缓存能存多少个图像条目。
/* 在 lv_conf.h 中配置 */
#define LV_IMG_CACHE_DEF_SIZE 1 /* 默认值：1，表示缓存1张图像 */默认值是1。什么意思？就是只缓存最近用过的那一张图。如果你的界面很简单，只有一两张图来回切换，那1就够了。但如果你有多个图像轮播，或者频繁切换界面，1就不够用了。
我个人习惯，会根据实际项目来调整这个值。怎么调？我一般遵循这几个原则：
- 看图像数量：界面里同时出现的不同图像有多少张？比如一个相册应用，一屏显示9张缩略图，那缓存至少得9起步。
- 看RAM余量：每张图解码后占多少内存？一张800x480的RGB565图像，解码后需要800*480*2 ≈ 768KB。如果你有9张，那就是将近7MB。MCU的RAM够不够？
- 看切换频率：如果图像切换很频繁，缓存大一点能减少解码次数。如果只是偶尔切换，缓存小一点也无所谓。
我的经验：对于大多数嵌入式UI，LV_IMG_CACHE_DEF_SIZE 设置在 2 到 8 之间比较合适。太小了缓存命中率低，太大了浪费RAM。你可以先设个4，跑起来看看效果，再微调。
缓存的工作原理
咱们来走一遍流程，看看缓存到底怎么工作的：
- 应用层调用
lv_img_set_src(img_obj, "path/to/image.png")。 - LVGL先去缓存里找，看有没有这张图的缓存记录。
- 如果找到了（缓存命中），直接返回缓存里的解码数据，跳过解码步骤。
- 如果没找到（缓存未命中），就去文件系统读图，解码，然后把解码后的数据存入缓存。
- 如果缓存满了，就按照LRU策略，淘汰掉最久没用的那张图，腾出空间给新图。
嗯，这里要注意一点：缓存的是解码后的数据，不是原始文件数据。比如你加载一张JPEG，缓存里存的是解码后的RGB565像素数据。这样下次再用，直接拿像素数据去绘制，省去了JPEG解码这个最耗时的步骤。
实际项目中的配置建议
我曾经在一个项目里踩过坑。当时做的是一个智能手表，界面有十几个页面，每个页面都有背景图。我把 LV_IMG_CACHE_DEF_SIZE 设成了16，想着多缓存一些，切换更流畅。结果呢？RAM爆了，系统直接崩溃。
后来我仔细算了一下：每张背景图是240x240的RGB565，解码后需要240*240*2 ≈ 115KB。16张就是1.8MB。而那颗MCU总共才512KB RAM，不崩才怪。
所以，配置缓存大小的时候，一定要算清楚：
| 图像分辨率 | 色彩格式 | 单张解码后大小 | 缓存8张所需RAM |
|---|---|---|---|
| 240x240 | RGB565 | 115KB | 920KB |
| 320x240 | RGB565 | 150KB | 1.2MB |
| 480x272 | RGB565 | 255KB | 2.0MB |
| 800x480 | RGB565 | 768KB | 6.1MB |
警告：别把缓存设得太大。RAM是嵌入式系统最宝贵的资源之一。缓存占多了，其他功能就没得用了。建议先设一个保守的值，比如2或4，然后通过性能分析工具观察缓存命中率，再逐步调大。
如何查看缓存命中率
LVGL提供了一个调试函数，可以查看缓存的状态：
/* 在代码中调用，查看缓存统计信息 */
lv_img_cache_set_draw_info_cb(my_callback);
/* 回调函数示例 */
static void my_callback(lv_img_cache_entry_t *entry, bool hit)
{
if (hit) {
LV_LOG_USER("缓存命中: %s", entry->src);
} else {
LV_LOG_USER("缓存未命中: %s", entry->src);
}
}通过这个回调，你可以统计出缓存命中率。如果命中率低于80%，说明缓存太小了，可以考虑调大。如果命中率超过95%，说明缓存够用，甚至可能有点浪费。
我个人习惯，在开发阶段会把这个回调打开，观察一段时间。等缓存命中率稳定了，再关掉它，省点性能开销。
小结
内部RAM缓存是LVGL图像显示性能的关键。配置得当，能让你的UI流畅如丝。配置不当，要么卡顿，要么内存溢出。
记住三点：
- 缓存大小要根据实际图像数量和RAM余量来定
- 默认值1通常不够，建议从2或4开始试
- 用调试工具观察命中率，用数据说话
下一章，咱们聊聊更高级的缓存策略——外部RAM缓存和DMA加速。到时候你会发现，内部缓存只是第一步，真正的性能优化还在后面。