LITTLEVGL STM32F103

在STM32F103微控制器上使用LVGL（原LittlevGL）的步骤如下及注意事项：

1. 硬件准备

STM32F103开发板（如BluePill，主频72MHz，Flash 64-128KB，RAM 20KB）
显示屏：SPI/I2C接口的LCD（如ST7735、ILI9341）或并行接口（需更多IO）
触摸屏（可选）：电阻式或电容式（如XPT2046）
存储：若资源紧张，建议使用内置Flash存储图形资源。

2. 开发环境配置

IDE：Keil MDK-ARM/STM32CubeIDE/VSCode+PlatformIO
HAL库：STM32CubeMX生成初始化代码（推荐使用SPI或FSMC驱动屏幕）
LVGL库：从官网 lvgl.io 下载最新版（v9.1+），或通过Git克隆：
```
git clone --branch v9.1.0 https://github.com/lvgl/lvgl.git
```

3. 移植LVGL

步骤3.1：添加LVGL到工程

将LVGL源码（lvgl/目录）复制到工程中。
包含头文件路径：
```
#include "lvgl/lvgl.h"
```

步骤3.2：配置LVGL

复制 lv_conf_template.h 为 lv_conf.h，启用配置：

#if 1 // 改为1启用配置
#define LV_COLOR_DEPTH 16      // 根据屏幕颜色格式设置（16位RGB565常见）
#define LV_MEM_SIZE (8 * 1024) // 根据RAM调整（建议至少8KB）
#define LV_USE_PERF_MONITOR 1  // 启用性能监控（调试用）

步骤3.3：实现显示驱动

SPI屏幕示例：

static void disp_flush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_p) {
  // 发送像素数据到屏幕（需实现SPI传输函数）
  SPI_SetCS(0);
  LCD_SetAddress(area->x1, area->y1, area->x2, area->y2);
  SPI_SendData((uint8_t *)color_p, (area->x2 - area->x1 + 1) * (area->y2 - area->y1 + 1) * 2);
  SPI_SetCS(1);
  lv_disp_flush_ready(drv); // 通知LVGL刷新完成
}

步骤3.4：定时器调用LVGL任务

在SysTick或定时器中断中周期性调用：

void SysTick_Handler(void) {
  lv_tick_inc(1); // 更新LVGL内部时钟（每1ms调用一次）
}

主循环中处理LVGL任务：

while (1) {
  lv_task_handler();
  HAL_Delay(5);
}

4. 优化技巧

内存不足：
- 减少LV_MEM_SIZE，启用LV_MEM_CUSTOM自定义内存管理。
- 使用单缓冲（lv_disp_drv_t.full_refresh = 0）。
性能优化：
- 启用DMA传输SPI数据。
- 降低屏幕刷新率（lv_disp_drv_t.refresh_period = 30 ms）。

5. 示例代码

// main.c
#include "lvgl.h"
#include "spi.h"
#include "lcd.h"

int main(void) {
    HAL_Init();
    SystemClock_Config();
    SPI_Init();
    LCD_Init();

    lv_init();
    lv_disp_drv_t disp_drv;
    lv_disp_drv_init(&disp_drv);
    disp_drv.flush_cb = disp_flush;
    disp_drv.hor_res = 240;
    disp_drv.ver_res = 320;
    lv_disp_drv_register(&disp_drv);

    lv_obj_t *label = lv_label_create(lv_scr_act());
    lv_label_set_text(label, "Hello STM32F103!");
    lv_obj_center(label);

    while (1) {
        lv_task_handler();
        HAL_Delay(5);
    }
}