1. 项目背景与目标
最近在调试正点原子RK3568开发板时,需要适配一款型号为WKS50HD071-WCT的5寸720P LCD屏幕,驱动芯片是ILI9881D。这是一款性价比很高的屏幕,特别适合嵌入式开发学习和项目原型验证。虽然厂家提供的资料有限,但通过查阅芯片手册和反复调试,最终成功点亮了屏幕并实现了触摸功能。
这个过程中遇到的主要挑战是:屏幕初始化时序不完整、设备树配置复杂、触摸参数需要精确匹配。下面我将详细分享整个调试过程,包括关键步骤、踩过的坑以及最终验证通过的完整配置代码。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 硬件准备与环境搭建
2.1 硬件清单
- 正点原子RK3568开发板(核心板+底板)
- WKS50HD071-WCT 5寸LCD屏幕(ILI9881D驱动)
- 40Pin FPC连接线
- 5V/2A电源适配器
- Type-C调试线
2.2 开发环境配置
调试前需要准备好以下开发环境:
- Linux SDK获取:从正点原子官网下载RK3568 Linux SDK,我使用的是V2.2版本
- 交叉编译工具链:建议使用SDK自带的prebuilt工具链
- 串口调试工具:推荐使用minicom或picocom
- ADB工具:用于文件传输和调试
提示:建议在Ubuntu 18.04/20.04 LTS系统上进行开发,避免因系统版本差异导致编译问题
3. 设备树配置详解
3.1 屏幕选择配置
首先需要在SDK中配置屏幕型号。RK3568的设备树采用了模块化设计,屏幕相关配置位于:
code复制rk3568_linux_sdk/kernel/arch/arm64/boot/dts/rockchip/rk3568-screen_choose.dtsi
在这个文件中,我们需要确保ILI9881D的宏定义被正确启用:
c复制#define LCD_ILI9881D_720P // 启用ILI9881D驱动支持
同时检查以下关键配置项:
screen-type:设置为SCREEN_MIPIlvds-format:保持默认(我们的屏幕是MIPI接口)out-face:设置为OUT_P888(24位色)
3.2 触摸屏配置
这款屏幕使用的是GT911触摸芯片,与正点原子开发板默认配置兼容,只需调整分辨率参数。配置位于:
code复制rk3568_linux_sdk/kernel/arch/arm64/boot/dts/rockchip/rk3568-atk-evb1-ddr4-v10.dtsi
关键配置项说明:
c复制&i2c1 {
dsi_touch: gt911q14 {
compatible = "
