注意

这是最新开发分支配套的文档，可能包含已发布版本中尚未提供的功能。如果您要查看特定版本的文档，请使用左侧的下拉菜单并选择所需要的版本。

RTOS Display Support List

Display / Panel 支持列表

当前 SDK 的显示相关配置位于 MPP Configuration -> Display Configuration。

注意：支持列表会随 SDK 版本演进持续更新，请以当前源码 src/rtsmart/mpp/Kconfig 为准。

显示驱动层（Display Driver）

• HDMI 显示驱动：MPP_ENABLE_DSI_HDMI

• LCD 显示驱动：MPP_ENABLE_DSI_LCD

• SPI LCD 显示驱动：MPP_ENABLE_SPI_LCD

• QSPI LCD 显示驱动：MPP_ENABLE_QSPI_LCD

• OSPI LCD 显示驱动：MPP_ENABLE_OSPI_LCD

• 虚拟显示驱动：MPP_DSI_ENABLE_VIRT

面板/桥接芯片驱动层（Panel Driver）

• HDMI 桥接：LT9611（MPP_DSI_ENABLE_HDMI_LT9611）

• LCD 面板：HX8399（MPP_DSI_ENABLE_LCD_HX8399）

• LCD 面板：ST7701（MPP_DSI_ENABLE_LCD_ST7701）

• LCD 面板：ILI9806（MPP_DSI_ENABLE_LCD_ILI9806）

• LCD 面板：ILI9881（MPP_DSI_ENABLE_LCD_ILI9881）

• LCD 面板：NT35516（MPP_DSI_ENABLE_LCD_NT35516）

• LCD 面板：NT35532（MPP_DSI_ENABLE_LCD_NT35532）

• LCD 面板：GC9503（MPP_DSI_ENABLE_LCD_GC9503）

• LCD 面板：ST7102（MPP_DSI_ENABLE_LCD_ST7102）

• LCD 面板：AML020T（MPP_DSI_ENABLE_LCD_AML020T）

• LCD 面板：JD9852（MPP_DSI_ENABLE_LCD_JD9852）

• SPI LCD 面板：ST7789（MPP_SPI_ENABLE_LCD_ST7789）

如何在固件中启用指定显示面板

1. 在 SDK 根目录执行：

make menuconfig

1. 进入：

MPP Configuration -> Display Configuration

1. 根据硬件连接启用显示驱动，并配置对应引脚：

• 走 HDMI 路径：打开 Enable HDMI Display Driver

• 走 MIPI DSI LCD 路径：打开 Enable LCD Display Driver

• 走 SPI/QSPI/OSPI LCD 路径：打开对应的 SPI/QSPI/OSPI 驱动开关

1. 根据驱动类型补齐必要配置：

• HDMI 常见需要确认 DSI-HDMI Reset GPIO 和 DSI-HDMI I2c Bus

• MIPI DSI LCD 常见需要确认 DSI-LCD Reset GPIO 和 DSI-LCD BackLight GPIO

• SPI/QSPI/OSPI LCD 还需要确认 Data/Command GPIO、Chip Select GPIO、Reset GPIO、Backlight GPIO、总线和 FPIOA 引脚

1. 在同一菜单中选择对应面板驱动：

• HDMI 常见为 Enable HDMI Display Panel Driver LT9611

• MIPI LCD 选择实际面板（如 HX8399/ST7701/ILI9881 等）

• SPI LCD 选择 Enable SPI LCD Panel Driver ST7789

1. 保存配置并重新编译镜像：

time make log

如何在 RTOS 侧验证显示配置是否生效

1) 先确认已启用并编译了 MPP 示例

在 RT-Smart UserSpace Examples Configuration 中，至少启用：

• Enable MPP examples

• 一个或多个 VO/显示相关 sample（如 sample_vo_video、sample_vo_osd）

2) 板端查找可执行示例

cd /sdcard/app/examples
find mpp -name "*.elf" | grep -Ei "vo|vicap|player" | head

3) 运行显示相关示例

./mpp/sample_vo_video.elf

若你的镜像中示例名称不同，请以 find 输出结果为准。

常见问题

1. 点亮失败（黑屏）

优先排查：

1. 驱动路径是否匹配（HDMI/MIPI LCD/SPI LCD）

2. 面板型号配置是否正确

3. Reset/Backlight GPIO、I2C 总线、SPI/QSPI/OSPI 引脚是否与硬件一致

4. 板卡供电与屏线连接是否稳定

2. 菜单里看不到某个面板选项

可能原因：

1. SDK 版本不包含该面板驱动

2. 当前板卡配置未使能对应显示路径

3. 被其他 Kconfig 依赖项限制

参考

• 显示驱动新增与接入：advanced_development_guide/how_to_add_display.md

• 示例运行说明：how_to_run_samples.md