从零点亮RV1126屏幕：RKMEDIA VO模块实战指南
刚拿到RV1126开发板时，最让人兴奋的莫过于看到屏幕亮起的那一刻。但当你兴冲冲接好排线、上电开机，却发现屏幕一片漆黑时，那种挫败感也格外强烈。本文将带你一步步排查问题，从硬件连接到软件配置，最终用RKMEDIA的VO模块点亮屏幕。
1. 硬件连接：排除最基础的错误
在开始任何软件调试前，硬件连接的正确性是第一道门槛。根据经验，约40%的"屏幕不亮"问题都源于硬件连接不当。
检查清单：
- 确认屏幕型号与开发板兼容（RV1126 EVB通常配720x1280 MIPI屏）
- 检查FPC排线是否完全插入且锁扣扣紧
- 测量背光电压（通常为5V-21V，取决于屏幕规格）
- 确认电源供电充足（建议使用官方适配器）
常见陷阱：某些屏幕需要跳线帽设置电压，而开发板丝印层可能标注不清。建议对照原理图二次确认。
若硬件检查无误，但屏幕仍无反应，可尝试以下命令强制开启背光：
# 通过sysfs控制背光（数值范围0-255） echo 128 > /sys/class/backlight/backlight/brightness2. DRM调试：用modetest验证显示通路
Rockchip芯片使用DRM（Direct Rendering Manager）驱动显示系统。modetest是DRM自带的测试工具，能绕过上层框架直接测试显示通路。
2.1 解读modetest输出
执行基础检测命令：
modetest -M rockchip典型输出包含四个关键部分：
Connectors（连接器）：
id encoder status name size (mm) modes encoders 56 55 connected DSI-1 68x121 1 55status应为connected- 注意记录id号（此处为56）
Modes（显示模式）：
name refresh hdisp hss hse htot vdisp vss vse vtot 720x1280 60 720 768 776 828 1280 1296 1302 1317这组时序参数必须与屏幕规格书一致
CRTCs（显示控制器）：
id fb pos size 53 0 (0,0) 720x1280确保分辨率与实际屏幕匹配
Planes（显示图层）：
id crtc fb CRTC x,y x,y gamma size possible crtcs 52 0 0 0,0 0,0 0 0x00000001注意支持的像素格式（如NV12、RGB888）
2.2 实际输出测试
通过connector id和分辨率参数发送测试图案：
modetest -M rockchip -s 56@53:720x1280成功时屏幕应显示彩色条纹。若失败，可能遇到以下情况：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无任何显示 | 时序参数错误 | 核对屏幕规格书 |
| 画面撕裂 | 刷新率不匹配 | 调整modetest的-v参数 |
| 颜色异常 | 像素格式错误 | 尝试RGB888/NV12等不同格式 |
3. RKMEDIA VO模块深度配置
当modetest验证通过后，即可使用RKMEDIA的VO（Video Output）模块进行更灵活的显示控制。VO本质是对DRM的封装，提供两种图层：
| 图层类型 | 支持格式 | 典型用途 | Z轴顺序 |
|---|---|---|---|
| PRIMARY | RGB888, RGB565 | UI界面 | 底层(0) |
| OVERLAY | NV12, NV16 | 视频流 | 上层(1) |
3.1 基础配置示例
初始化PRIMARY图层显示RGB图像：
#include <rkmedia/rkmedia_vo.h> VO_CHN_ATTR_S stVoAttr = { .pcDevNode = "/dev/dri/card0", .emPlaneType = VO_PLANE_PRIMARY, // 使用主图层 .enImgType = IMAGE_TYPE_RGB888, // RGB888格式 .u16Zpos = 0, // 底层显示 .stDispRect = { .s32X = 0, // 起始坐标X .s32Y = 0, // 起始坐标Y .u32Width = 720, // 显示宽度 .u32Height = 1280 // 显示高度 } }; int ret = RK_MPI_VO_CreateChn(0, &stVoAttr); if (ret) { printf("Create VO channel failed! ret=%d\n", ret); return -1; }3.2 双图层叠加实战
实现视频（OVERLAY）与UI（PRIMARY）叠加显示：
// 配置PRIMARY图层（背景） VO_CHN_ATTR_S stVoPrimary = { .pcDevNode = "/dev/dri/card0", .emPlaneType = VO_PLANE_PRIMARY, .enImgType = IMAGE_TYPE_ARGB8888, .u16Zpos = 0, // 底层 /* 其他参数同上 */ }; // 配置OVERLAY图层（前景） VO_CHN_ATTR_S stVoOverlay = { .pcDevNode = "/dev/dri/card0", .emPlaneType = VO_PLANE_OVERLAY, .enImgType = IMAGE_TYPE_NV12, .u16Zpos = 1, // 上层 /* 其他参数同上 */ }; // 创建两个显示通道 RK_MPI_VO_CreateChn(0, &stVoPrimary); RK_MPI_VO_CreateChn(1, &stVoOverlay);关键细节：
u16Zpos决定图层叠加顺序（0=底层，1=上层）- PRIMARY图层不支持YUV格式，需提前转换
- 内存对齐要求：RGB图像宽度需16字节对齐，NV12需32字节对齐
4. 高频问题排查指南
即使按照流程操作，仍可能遇到各种显示异常。以下是几个经典案例：
案例1：画面偏移或缩放
症状：图像只显示在屏幕一角或明显被拉伸 解决方法： 1. 检查stDispRect是否与屏幕原生分辨率一致 2. 确认vo属性与modetest输出的mode参数匹配 3. 在设备树中检查vop的缩放配置案例2：颜色失真
// 常见于格式不匹配，可尝试强制指定格式 stVoAttr.enImgType = IMAGE_TYPE_RGB888; // 或IMAGE_TYPE_NV12案例3：多层显示错乱
调试技巧： cat /sys/kernel/debug/dri/0/summary 关注各winX-X状态及zpos值对于更复杂的问题，建议按以下步骤收集信息：
- 保存当前DRM状态：
cat /sys/kernel/debug/dri/0/state > drm_state.log - 检查时钟与电源：
cat /sys/kernel/debug/clk/clk_summary cat /sys/kernel/debug/regulator/regulator_summary - 捕捉内核日志：
dmesg | grep -iE "drm|vop|vo"
最后，别忘了RKMEDIA自带的测试工具能快速验证VO功能：
rkmedia_vo_display_test -i /userdata/test.rgb -w 720 -h 1280 -f rgb888
