【K230/K230D 新技能点亮】手把手教你在RTOS系统添加一个屏幕｜保姆级教程

上一期，我们详细讲解了K230/K230D RTOS 系统中直接适配好的 SPI 屏幕使用方法，快速上手就能点亮屏幕，https://mp.weixin.qq.com/s/Qy0gyceHgGGdeSlUKrU2IA

不少开发者反馈：项目里常用的小众型号、未适配的 SPI/QSPI/MCU 屏幕，该怎么在 K230/K230D 上驱动？别急，今天这篇保姆级教程，就来手把手教你搞定自定义屏幕适配，解锁更多低成本小屏方案！

今天就基于官方最新驱动框架，给你一篇从零到点亮的完整教程，照着做就能成功！

一、先搞懂：

K230 屏幕驱动框架长啥样？

Connector + Panel双层架构

Connector：管理 DSI/SPI/QSPI 等物理接口

Panel：管理屏幕型号、初始化序列、显示时序

一切配置从 make menuconfig 开始，代码只填必要信息

一句话：先配菜单，再补代码，最后跑 sample。

二、适配新屏第一步：menuconfig 完整配置流程

打开终端进入 SDK，直接敲：

makemenuconfig

进入路径：

MPP Configuration → Display Configuration

1

打开对应显示驱动

根据你的屏幕接口选择：

MIPI DSI 屏 → 开 Enable LCD Display Driver

SPI 屏 → 开 Enable SPI LCD Display Driver

HDMI 显示 → 开 Enable HDMI Display Driver

2

配置引脚（必做！）

以最常用的MIPI DSI 屏幕为例：

DSI-LCD Reset GPIO

DSI-LCD BackLight GPIO

SPI 屏还要额外配：

DC 脚、CS 脚、时钟脚、数据脚

3

选择面板驱动

如果库里已有你的屏幕型号，直接勾选

如果没有，先随便选一个相近的，后面我们自己加

配置完保存退出，先编译一次，确保基础链路正常。

三、适配前必须拿到

这 2 份资料

没有这两个，神仙也点不亮屏幕：

1

屏幕时序参数（厂家给）

pclk_hz=27000000fps=60lane_num=2
hactive=368hsync=8hbp=16hfp=16
vactive=552vsync=48vbp=250vfp=250

这些是点亮屏幕的核心参数。

2

屏幕初始化序列（厂家给）

类似这种：

{0xFF,5,{0x77,0x01,0x00,0x00,0x13}},{0xEF,1,{0x08}},{0x11,0,{0x00}},

后面要转换成 SDK 规定的格式。

四、手把手：代码里添加新屏幕（5步搞定）

第1步：定义屏幕类型

打开文件：

src/rtsmart/mpp/include/comm/k_connector_comm.h

新增一行，格式如下：

#defineST7701_368_552_DSI_V1 K_CONN_TYPE(ST7701, DSI, 368, 552, 1)

第2步：添加面板驱动文件

在目录下新建/复制面板文件：

src/rtsmart/mpp/kernel/connector/src/panels/

主要填写 3 块内容：

初始化序列 init_sequence

显示时序 timing

GPIO 配置（复位、背光）

staticconstk_panel_desc st7701_368_552_dsi_v1 = { .name="st7701_368_552_dsi_v1", .connector_type=ST7701_368_552_DSI_V1, .bus_type=K_CONN_BUS_DSI, .timing= { .pclk_hz=27000000, .hactive=368, .hfront_porch=16, .hback_porch=16, .hsync_len=8, .vactive=552, .vfront_porch=250, .vback_porch=250, .vsync_len=48, }, .gpio= { .reset_pin=CONFIG_MPP_DSI_LCD_RESET_PIN, .backlight_pin=CONFIG_MPP_DSI_LCD_BACKLIGHT_PIN, .reset_active_low=K_TRUE, }, .ops= &st7701_panel_ops,};

第3步：把面板挂进驱动列表

打开 connector_dev.c，把你的面板加入 panel_variants，

这样系统启动时才能识别到新屏幕。

第4步：Kconfig + Makefile 加入编译

Kconfig 添加菜单选项

Makefile 根据配置决定是否编译你的 .c 文件

这样 menuconfig 里就能看到你新加的屏幕了！

第5步：加 CanMV Python 支持

修改：

src/canmv/port/modules/modmedia_display.c

添加类型映射，Python 就能直接调用新屏幕。

五、最关键：验证是否成功

（2 条命令）

编译完成烧录后，在 shell 里输入：

1

查看当前支持的屏幕

list_connector

能看到你定义的名字，说明驱动加载成功

2

直接点亮测试

./mpp/sample_vo_osd.elf -c 你的屏幕ID

跑起来就亮了！

六、最常见 3 个坑

1

menuconfig 看不到新面板

→ 没打开上层驱动（LCD/DSI 开关）

→ Kconfig 里没写 depends

2

编译过了，但 list_connector 看不到

→ Makefile 没加源文件

→ 没挂进 panel_variants

3

屏幕有电但不亮

→ 复位/背光 GPIO 方向反了

→ 初始化序列错

→ 时序参数完全不对

→ sample 用错 connector_type