ILI9341 LCD Controller driver（ILI9341液晶控制器驱动程序）
Overview（概览）
显示原文
The ILI9341 is a 262,144-color single-chip SOC driver for a-TFT liquid crystal display with resolution of 240RGBx320 dots, comprising a 720-channel source driver, a 320-channel gate driver, 172,800 bytes GRAM for graphic display data of 240RGBx320 dots, and power supply circuit. ILI9341 supports parallel 8-/9-/16-/18-bit data bus MCU interface, 6-/16-/18-bit data bus RGB interface and 3-/4-line serial peripheral interface (SPI).
The ILI9341 LCD controller driver is a platform-agnostic driver, based on the generic MIPI driver. It implements display initialization, supports display rotation and implements the display flush callback. The user needs to implement only two platform-specific functions to send a command or pixel data to the controller via SPI or parallel bus. Typically these are implemented by calling the appropriate SDK library functions on the given platform.
ILI9341 是一款262,144色单芯片SOC驱动器，用于分辨率为240RGBx320点的a-TFT液晶显示器，包括720通道源驱动器、320通道栅极驱动器、240RGBx320点的图形显示数据的172,800字节GRAM和电源电路。 ILI9341支持并行的8-/9-/16-/18-bit数据总线MCU接口，6-/16-/18-bit数据总线RGB接口和3-/4线串行外设接口（SPI）。
ILI9341 LCD控制器 driver is a platform-agnostic driver, based on the generic MIPI driver 是一款平台无关的驱动器，基于通用MIPI驱动器。它实现了显示初始化，支持显示旋转并实现了显示刷新回调。用户只需实现两个特定于平台的功能，通过SPI或并行总线向控制器发送命令或像素数据。通常情况下，这些是通过调用给定平台上的适当SDK库函数来实现的。
Prerequisites（先决条件）
显示原文
There are no prerequisites.
没有先决条件。
Configuring the driver（配置驱动程序）
显示原文
Enable the ILI9341 driver support in lv_conf.h, by cmake compiler define or by KConfig
#define LV_USE_ILI9341 1
通过CMake编译器定义或KConfig，在lv_conf.h中启用ILI9341驱动程序支持。
#define LV_USE_ILI9341 1
Usage（用法）
显示原文
You need to implement two platform-dependent functions:
/* Send short command to the LCD. This function shall wait until the transaction finishes. */
int32_t my_lcd_send_cmd(lv_display_t *disp, const uint8_t *cmd, size_t cmd_size, const uint8_t *param, size_t param_size)
{
...
}
/* Send large array of pixel data to the LCD. If necessary, this function has to do the byte-swapping. This function can do the transfer in the background. */
int32_t my_lcd_send_color(lv_display_t *disp, const uint8_t *cmd, size_t cmd_size, uint8_t *param, size_t param_size)
{
...
}
To create an ILI9341-based display use the function
/**
* Create an LCD display with ILI9341 driver
* @param hor_res horizontal resolution
* @param ver_res vertical resolution
* @param flags default configuration settings (mirror, RGB ordering, etc.)
* @param send_cmd platform-dependent function to send a command to the LCD controller (usually uses polling transfer)
* @param send_color platform-dependent function to send pixel data to the LCD controller (usually uses DMA transfer: must implement a 'ready' callback)
* @return pointer to the created display
*/
lv_display_t * lv_ili9341_create(uint32_t hor_res, uint32_t ver_res, lv_lcd_flag_t flags,
lv_ili9341_send_cmd_cb_t send_cmd_cb, lv_ili9341_send_color_cb_t send_color_cb);
For additional details and a working example see the generic MIPI driver documentation.
备注
You can find a step-by-step guide and the actual implementation of the callbacks on an STM32F746 using STM32CubeIDE and the ST HAL libraries here: Step-by-step Guide: How to use the LVGL v9 LCD drivers with STM32 devices（分步指南：如何将LVGL v9 LCD驱动程序与STM32设备一起使用）
您需要实现两个与平台相关的函数：
/* Send short command to the LCD. This function shall wait until the transaction finishes. */
int32_t my_lcd_send_cmd(lv_display_t *disp, const uint8_t *cmd, size_t cmd_size, const uint8_t *param, size_t param_size)
{
...
}
/* Send large array of pixel data to the LCD. If necessary, this function has to do the byte-swapping. This function can do the transfer in the background. */
int32_t my_lcd_send_color(lv_display_t *disp, const uint8_t *cmd, size_t cmd_size, uint8_t *param, size_t param_size)
{
...
}
要创建基于ILI9341驱动的显示器，请使用以下函数：
/**
* Create an LCD display with ILI9341 driver
* @param hor_res horizontal resolution
* @param ver_res vertical resolution
* @param flags default configuration settings (mirror, RGB ordering, etc.)
* @param send_cmd platform-dependent function to send a command to the LCD controller (usually uses polling transfer)
* @param send_color platform-dependent function to send pixel data to the LCD controller (usually uses DMA transfer: must implement a 'ready' callback)
* @return pointer to the created display
*/
lv_display_t * lv_ili9341_create(uint32_t hor_res, uint32_t ver_res, lv_lcd_flag_t flags,
lv_ili9341_send_cmd_cb_t send_cmd_cb, lv_ili9341_send_color_cb_t send_color_cb);
有关更多详细信息和工作示例，请参阅`通用MIPI驱动程序文档 https://github.com/lvgl/lvgl/doc/integration/drivers/display/gen_mipi.rst.
您可以在以下位置找到使用STM32CubIDE和ST HAL库的STM32F746上回调的分步指南和实际实现这里：Step-by-step Guide: How to use the LVGL v9 LCD drivers with STM32 devices（分步指南：如何将LVGL v9 LCD驱动程序与STM32设备一起使用）