esp32 lvgl freetype

### ESP32 使用 LVGL 和 FreeType 进行显示开发

#### 安装依赖项
为了在 ESP32 上使用 LVGL 图形库并集成 FreeType 字体引擎，需先安装必要的软件包。确保已配置好 VSCode 及 PlatformIO 开发环境[^1]。

pip install platformio
pio lib install "lvgl"

对于 FreeType 的支持，则需要额外下载其源码文件，并将其添加至项目中。可以从官方 GitHub 仓库获取最新版本的 FreeType 库[^2]。

#### 配置 `platformio.ini` 文件
编辑项目的 `platformio.ini` 文件来指定所需的平台和库：

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
    lvgl
build_flags =
    -D LV_CONF_INCLUDE_SIMPLE=1
    -I ${PROJECT_DIR}/libs/freetype/include/
upload_speed = 921600
monitor_speed = 115200

此设置指定了编译选项 `-D LV_CONF_INCLUDE_SIMPLE=1` 来简化 LVGL 的配置过程；并通过 `-I` 参数引入了 FreeType 头文件路径。

#### 初始化 LVGL 并加载自定义字体
下面是一个简单的初始化函数示例，在其中设置了屏幕分辨率以及注册了一个由 FreeType 渲染出来的中文字符集作为全局默认字体。

#include <Arduino.h>
#include "lvgl/lvgl.h"

// 假设已经完成了硬件接口层(HAL)实现, 如 SPI 或 I2C 屏幕驱动程序.
extern void my_disp_flush(lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p);

void setup() {
  Serial.begin(115200);
  
  // Initialize the display driver with flush callback function
  static lv_disp_buf_t disp_buf;
  static lv_color_t buf[LV_HOR_RES_MAX * 10];
  lv_disp_buf_init(&disp_buf, buf, NULL, LV_HOR_RES_MAX * 10);
  
  lv_disp_drv_t disp_drv;
  lv_disp_drv_init(&disp_drv);
  disp_drv.flush_cb = my_disp_flush;     /* 设置刷新回调 */
  disp_drv.buffer = &disp_buf;

  lv_disp_t* disp = lv_disp_drv_register(&disp_drv);  

  // Load custom font using freetype (假设 ft_font 已经被正确创建)
  extern const lv_font_t* ft_font;
  lv_font_add(ft_font, "ft");            /* 添加新字体 */

  // Set global default font to our newly added one
  lv_theme_default_init(disp, lv_theme_material_init(NULL), LV_COLOR_MAKE(0x3b, 0x59, 0x98), LV_THEME_MATERIAL_FLAG_DARKER, ft_font);
}

void loop() { 
  lv_task_handler();                     /* 让LVGL处理事件 */
}

上述代码片段展示了如何通过调用 `lv_font_add()` 方法向系统中加入一个新的字体资源，并把它设定成应用程序内的标准样式。

请注意，实际应用时还需要完成具体的 HAL 实现部分（即 `my_disp_flush` 函数），这取决于所使用的显示屏控制器型号及其通信协议（SPI/I2C 等）[^3]。