rt-thread-official/bsp/renesas/ra6m3-hmi-board/docs/lvgl使用文档.md

# RA6M3-HMI-Board-lvgl 使用文档

## ENV 配置

首先在BSP目录下打开env工具，输入 `menuconfig` 进入配置界面

![](picture/lvgl/00.png)

## RGB 屏使用配置

在 `Hardware Drivers Config → On-chip Peripheral Drivers ` 使能 Enable LVGL demo for LCD 选项

![](picture/lvgl/22.png)

* 进入Enable LVGL demo for LCD 中使能 LVGL demo

  * Enable LVGL music demo 绑定的是LVGL8.3.x 版本
  * Enable LVGL stress demo 绑定的是LVGL9.x 版本

  ![](picture/lvgl/24.png)
* 接下来进入:  `RT-Thread online packages → multimedia packages → LVGL: powerful and easy-to-use embedded GUI library → LVGL (official): Light and Versatile Graphics Library` 中选择LVGL版本
  ![](picture/lvgl/23.png)

接下来退出菜单界面，输入 `pkgs --update` 命令手动联网获取 lvgl 的软件包到 `packages` 文件夹下

![](picture/lvgl/25.png)

接着在env 终端中输入 `scons --target=mdk5` 生成 mdk 工程

![](picture/lvgl/03.png)

### fsp 中配置 GLCDC 外设

点击 mdk 中的 `Tools->RA Smart Configurator` 进入 rasc 配置软件

![](picture/lvgl/04.png)

我们默认在fsp中使能了屏幕和Dave2d的外设

![](picture/lvgl/26.png)

点击 `Generate Project Content` 生成配置相关代码

![](picture/lvgl/10.png)

### 编译烧录

退出 rasc 后，在 mdk 中进行编译，仿真下载即可

![](picture/lvgl/11.png)

## SPI(ILI9431) 屏使用配置

### 硬件连接

硬件按照如下引脚进行连接：

![](picture/lvgl/tft-pin.png)

在 `Hardware Drivers Config → On-chip Peripheral Drivers → Enable LVGL for LCD` 中使能 `Enable LVGL for LCD_ILI9431` 选项

![](picture/lvgl/01.png)

接下来退出菜单界面，输入 `pkgs --update` 命令手动联网获取 lvgl 的软件包到 `packages` 文件夹下

![](picture/lvgl/02.png)

接着在env 终端中输入 `scons --target=mdk5` 生成 mdk 工程

![](picture/lvgl/03.png)

### fsp 中配置 SPI 外设

点击 mdk 中的 `Tools->RA Smart Configurator` 进入 rasc 配置软件

![](picture/lvgl/04.png)

点击 New Stack，选择 `Connectivity->SPI(r_spi)`，使能 SPI 外设

![](picture/lvgl/13.png)

在 `Callback` 中，设置中断回调函数，（默认使用SPI0）输入 ：`spi0_callback`

![](picture/lvgl/14.png)

接着我们配置 SPI 的引脚属性（默认使用SPI0），进入 Pins 界面按照下图进行配置：

![](picture/lvgl/15.png)

完成以上配置后，点击 `Generate Project Content` 生成配置相关代码

![](picture/lvgl/16.png)

### 编译烧录

退出 rasc 后，在 mdk 中进行编译，仿真下载即可

![](picture/lvgl/11.png)