1. 课程导学与开发环境搭建
大家好，我是你们这趟移植之旅的向导。做嵌入式UI这些年，从最早的裸机画点，到后来用uCGUI，再到现在的LVGL，我踩过的坑还真不少。今天咱们先不急着写代码，把地基打牢了，后面才能盖高楼。
1.1 LVGL到底是什么？
LVGL，全称Light and Versatile Graphics Library。说白了，就是一套专门给嵌入式设备用的图形界面库。你想想看，MCU资源那么紧张，跑不了Qt，更别提Android了。LVGL就是为这个场景生的——它用C语言写的，内存占用小，但功能一点不含糊。
我最早接触LVGL是在一个温控器项目上。当时老板要求界面要“像手机一样流畅”，我第一反应是“这不可能”。结果用LVGL的动画框架，配合双缓冲，还真做到了。从那以后，我就成了LVGL的忠实用户。
核心特点：
- 轻量级： 最低只需16KB RAM + 64KB Flash就能跑起来
- 丰富的控件： 按钮、滑块、图表、键盘……30多种开箱即用
- 内置样式系统： 支持CSS-like的样式设置，改个圆角、阴影不用重绘
- 硬件加速： 支持DMA2D、GPU等硬件加速接口
1.2 为什么需要外部存储加载图片？
这个问题，我估计很多新手都遇到过。LVGL默认把图片资源编译进固件里，也就是用LV_IMG_DECLARE声明，然后直接当数组用。这在图片少、分辨率低的时候没问题。但一旦你开始做真正的产品——
- 开机Logo要高清吧？一张800×480的24位BMP，算下来800×480×3 ≈ 1.1MB
- 菜单图标要漂亮吧？一套图标包下来，少说几百KB
- 多语言界面要切图吧？每个语言一套背景图
全部塞进Flash？不现实。STM32F4系列内部Flash也就1MB，ESP32虽然有16MB Flash，但还要放固件、放WiFi协议栈。这时候，外部存储（SD卡、SPI Flash、USB盘）就成了唯一出路。
注意： 直接从外部存储读取图片，速度会比内部Flash慢很多。如果不做优化，界面切换时会出现明显的“刷图”延迟。这个坑我在第一个项目里就踩过——客户拿着样机说“你这界面怎么一卡一卡的？”后来加了缓存和异步加载才解决。后面章节我会详细讲怎么优化。
1.3 STM32与ESP32平台对比
为什么选这两个平台做对比？因为它们是当前嵌入式UI开发的两大主流阵营。我个人的经验是：STM32适合对实时性要求高的工业场景，ESP32则更适合需要联网的消费类产品。
| 对比项 | STM32（以F429为例） | ESP32（以ESP32-WROOM-32为例） |
|---|---|---|
| CPU架构 | Cortex-M4F，单核 | Xtensa LX6，双核 |
| 主频 | 180MHz | 240MHz |
| SRAM | 256KB（+外部SDRAM扩展） | 520KB（+PSRAM扩展） |
| Flash | 2MB内部Flash | 16MB外部SPI Flash |
| 硬件外设 | LTDC、DMA2D、FMC | SPI、I2S、SDMMC |
| LVGL移植难度 | 中等（需配置LTDC/DMA2D） | 较低（SPI屏驱动成熟） |
| 外部存储接口 | SDIO、SPI、FMC | SPI、SDMMC |
你看这个表就明白了：STM32有专门的LTDC（液晶控制器）和DMA2D（2D图形加速器），刷屏效率极高。但它的内部Flash太小，外部存储几乎是必须的。ESP32虽然Flash大，但它的SPI Flash速度有限，而且没有专用的显示控制器，全靠CPU刷屏。
所以，我们的课程会分别讲解这两个平台的适配方案。你学会了，以后换任何MCU都能举一反三。
1.4 开发板选型与硬件准备
工欲善其事，必先利其器。我建议你准备以下硬件：
- STM32开发板： 推荐正点原子阿波罗F429或野火F429挑战者。自带LCD接口和SDRAM，省去很多飞线麻烦。
- ESP32开发板： 推荐ESP32-WROOM-32模组 + 3.5寸SPI触摸屏（ILI9488驱动）。便宜又好用。
- 外部存储： 一张MicroSD卡（FAT32格式）+ SD卡模块，或者W25Q64 SPI Flash模块。
- 调试工具： J-Link（STM32用）、USB转TTL（ESP32用）、逻辑分析仪（抓时序用）。
我的建议： 如果你预算有限，可以先买ESP32的板子。它便宜（几十块钱），而且LVGL的生态支持非常好。等把LVGL的基本流程跑通了，再上手STM32，会轻松很多。
1.5 开发环境搭建
环境搭建这块，我踩过不少坑。尤其是ESP32的LVGL移植，早期资料少，全靠自己摸索。现在好多了，官方文档很全。我按平台分别说。
1.5.1 STM32开发环境
- IDE： 我习惯用Keil MDK v5.38，也可以用STM32CubeIDE（免费）。
- 工具链： ARMCC（Keil自带）或GCC（CubeIDE自带）。
- LVGL源码： 从GitHub下载v8.3.x版本（v9.x改动较大，建议先学v8）。
- 显示驱动： 使用正点原子或野火提供的LCD驱动库，或者自己写寄存器版。
// LVGL源码目录结构（建议保持）
lvgl/
├── src/ // 核心源码
├── examples/ // 示例程序
├── demos/ // 演示应用
├── lv_conf.h // 配置文件（需要从lv_conf_template.h复制）
└── lvgl.h // 主头文件1.5.2 ESP32开发环境
- IDE： 推荐VS Code + PlatformIO插件，或者直接用ESP-IDF命令行。
- 工具链： ESP-IDF v4.4或v5.0（注意版本兼容性）。
- LVGL组件： 在PlatformIO的库管理中搜索“lvgl”，或者用ESP-IDF的组件管理器。
- 显示驱动： 推荐TFT_eSPI库（Bodmer大神写的，支持上百种SPI屏）。
版本兼容性警告： 我曾经在ESP32上用了LVGL v9.0 + ESP-IDF v5.1，结果编译报了一堆类型不匹配的错误。后来发现是LVGL的配置宏和ESP-IDF的FreeRTOS版本冲突。建议你严格按照我给的版本组合来：LVGL v8.3.x + ESP-IDF v4.4，这是经过大量项目验证的稳定组合。
1.6 本章知识体系
下面这张图，是我自己总结的本章知识结构。你可以把它当作整个课程的“导航地图”。
1.7 小结
这一章我们聊了LVGL是什么、为什么需要外部存储、两个主流平台的差异，以及怎么搭建开发环境。内容看起来多，但都是后面实战的基础。
我个人建议你先把环境搭好，跑一个“Hello World”级别的LVGL例程——哪怕只是在屏幕上显示一个按钮。这一步走通了，后面所有关于图片加载、文件系统、缓存优化的内容，你才有地方验证。