RK3506 DSMC CS2 与 MIPI-DSI 快速上手
本文面向 RK3506G EVB1 V10,说明如何应用 DSMC+DSI 三补丁、选择 master DTS、构建镜像、验证 MIPI-DSI 显示以及验证高云 FPGA 的 DSMC CS2 四窗口访问。
1. 适用范围和限制
- SoC 和板卡:RK3506G EVB1 V10。
- 外设:高云 FPGA 连接到 DSMC CS2;DSI 面板使用 EVB 显示连接。
- 内核:Rockchip Linux 6.1,DTS 位于
arch/arm/boot/dts/。 - 交付包:
/home/user/workspace/RK3506-DSMC-DSI/release/RK3506-DSMC-DSI-PATCH.tar.gz。 - DSI 用户态 Demo 包:
/home/user/workspace/RK3506-DSMC-DSI/release/dsi/RK3506-MIPI-DSI-Demo-20260917.tar.gz。
三个补丁和 master DTS 只适用于上述硬件连接。不同 SoC、不同 CS、不同 FPGA 时序或不同面板连接必须先重新核对 DTS、pinctrl 和硬件时序。
2. 交付内容
解压核心补丁包后,包含以下内容:
| 文件 | 内容 |
|---|---|
patches/0001-*.patch | DSMC test、memtester 和测试所需内核配置。 |
patches/0002-*.patch | DSMC host/slave 引脚驱动强度设置为 level 4。 |
patches/0003-*.patch | CS2/DMA/pinctrl、4 region、50MHz、DQS、CMA、DSI。 |
config/RK_KERNEL_DTS_NAME.fragment | master DTS 选择配置。 |
第 3 补丁已修改 rk3506g-evb1-v10-dsmc-master.dts,不需要额外复制 DTS 文件。
3. 应用三补丁
进入目标 SDK 的 kernel 目录前,先检查是否存在未确认改动:
cd kernel-6.1-rk3506-dsmc
git status --short
确认工作区可修改后,按顺序应用三个补丁:
git am ../RK3506-DSMC-DSI-Master-20260917/patches/0001-memory-rockchip-dsmc-add-dsmc-test-driver-and-memtes.patch
git am ../RK3506-DSMC-DSI-Master-20260917/patches/0002-ARM-dts-rockchip-rk3506-set-dsmc-pins-drive-strength.patch
git am ../RK3506-DSMC-DSI-Master-20260917/patches/0003-ARM-dts-rockchip-rk3506g-evb1-switch-dsmc-master-to-.patch
如果补丁目录与 SDK 不在同级目录,请把命令中的相对路径替换为实际解压路径。补丁冲突时不要强行覆盖,应先确认 SDK 基线、SoC 和 DTS 版本是否一致。
4. 选择 master DTS
在 SDK 的 output/defconfig 中设置如下目标:
RK_KERNEL_DTS_NAME="rk3506g-evb1-v10-dsmc-master"
该设置会替换当前选择的 DTS 名称。若当前 SDK 使用 customer DTS,保存原始值,以便需要时恢复。
master DTS 的关键配置如下:
- DSMC master 工作在 CS2。
- 时钟配置为 50 MHz,DQS DLL 参数为
0x90。 - 启用 region0、region1、region2、region3,对应窗口为
0xd0000000、0xd2000000、0xd4000000、0xd6000000。 - CS2 使用 GPIO1_D2;不再申请 CSN1 GPIO1_B1,避免与 UART3 冲突。
- 启用
dsi、dsi_dphy、dsi_in_vop、route_dsi和 panel 电源配置。 - CMA 设置为 32 MiB,供 DRM/VOP 扫描输出使用。
5. 构建和部署
按当前 SDK 的标准流程构建 kernel 和 boot 镜像。例如:
./build.sh kernel
构建日志必须出现:
rk3506g-evb1-v10-dsmc-master.dtb
使用项目既有的烧录流程将生成的 boot 镜像写入板端,然后重启板卡。刷写、擦除和分区写入必须遵循项目的量产或调试流程。
6. 启动后先验证 driver
未完成以下检查前,禁止访问 FPGA 窗口或直接写 DSMC 控制器寄存器。
dmesg | grep -Ei 'dsmc|localbus|dll'
ls -l /dev/dsmc/cs2/
cat /sys/kernel/debug/clk/clk_summary | grep -i dsmc
io -4 -l 0x100 0xff8b3000
预期结果:
- 存在
/dev/dsmc/cs2/region0至region3。 clk_dsmc、aclk_dsmc和pclk_dsmc的 enable-count 非零。0xff8b3010的 MCR2 初始读取值通常为0x00010013。0xff8b3050至0xff8b305c可看到 four-region 的 dummy clock 配置。
若 /dev/dsmc 不存在,优先检查 DTS、pinctrl、dmesg 和时钟状态,不能直接使用 io 写入 FPGA 地址。
7. DSMC CS2 四窗口访问
以下地址由当前 FPGA 设计定义:
| 地址 | 功能 |
|---|---|
0xd0000000 | merge FIFO。 |
0xd2000000 | no-merge FIFO。 |
0xd4000000 | DPRAM。 |
0xd6000000 | FPGA register。 |
先读取四个窗口:
io -4 -l 0x10 0xd0000000
io -4 -l 0x10 0xd2000000
io -4 -l 0x10 0xd4000000
io -4 -l 0x10 0xd6000000
按 FPGA 测试要求设置 dummy clock:
io -4 0xff8b3050 0x43
io -4 0xff8b3054 0x42
io -4 0xff8b3058 0x41
io -4 0xff8b305c 0x40
merge FIFO 写读示例:
io -4 0xd0000000 0x00112233
io -4 0xd0000004 0x44556677
io -4 0xd0000008 0x8899aabb
io -4 0xd000000c 0xccddeeff
io -4 -l 0x10 0xd0000000
no-merge FIFO 写读示例:
io -4 0xd2000000 0x00112233
io -4 0xd2000004 0x44556677
io -4 0xd2000008 0x8899aabb
io -4 0xd200000c 0xccddeeff
io -4 -l 0x10 0xd2000000
FIFO 窗口具有消费或状态语义,回读结果不一定与写入值逐字一致。DPRAM 一致性测试需要使用 FPGA 侧确认的地址和访问协议。
8. X8 和 X16 模式切换
先查询当前 MCR2:
io -4 0xff8b3010
X16 模式前,先使能 FPGA register 的 cmn_con3[0]:
io -4 0xd600000c 0x000011
X8 模式:
io -4 0xff8b3010 0x00010013
X16 模式:
io -4 0xff8b3010 0x0001001b
切换后再次读取 0xff8b3010 确认实际值。若无明确的 FPGA X16 支持和寄存器配置,不要保持在 X16 模式。
9. MIPI-DSI Demo 部署和启动
解压 DSI Demo 包,使用其中的二进制、脚本和源文件。将程序部署到板端:
adb push build/dsi_lvgl_colorbar /userdata/bin/
adb push scripts/run_dsi_lvgl_colorbar.sh \
/userdata/bin/run_dsi_lvgl_colorbar
adb shell chmod +x /userdata/bin/dsi_lvgl_colorbar \
/userdata/bin/run_dsi_lvgl_colorbar
如果系统默认 rk_demo 占用 DRM plane,先停止它:
adb shell killall rk_demo
adb shell /userdata/bin/run_dsi_lvgl_colorbar
正常情况下,面板应显示 LVGL DRM 色条。dsi_image_demo 用于直接
DRM/KMS 静态图像和梯度验证;动态帧更新优先使用 LVGL DRM 路径。
10. 已验证结果
| 项目 | 结果 |
|---|---|
| DSMC probe | 成功创建 CS2 的 region0 至 region3。 |
| DSMC 时钟 | clk_dsmc、aclk_dsmc、pclk_dsmc 已由 ff8b0000.dsmc 使能。 |
| MCR2 | X8 为 0x00010013;X16 切换后为 0x0001001b。 |
| 四窗口读取 | 四个 CS2 地址均可访问,未发生 kernel panic。 |
| FIFO 写读 | 写入命令完成;回读为 FPGA FIFO/状态数据。 |
| DSI | DRM/LVGL 色条和直接 DRM/KMS 图像显示已验证。 |
11. 常见问题
11.1 DSMC 未创建 /dev/dsmc/cs2
现象:DSMC 时钟 enable-count 为 0,/dev/dsmc 不存在。
检查 dmesg 是否出现 pinctrl 冲突。该板的 UART3 占用 GPIO1_B1,
而通用 DSMC CS group 会申请 CSN1。必须使用第 3 补丁提供的
CS2 专用 pinctrl。
11.2 写 DSMC 寄存器后卡死
现象:执行 io 写入后出现 watchdog hard lockup。
原因通常是 DSMC 尚未完成 probe、时钟未打开,或 FPGA/总线配置未就绪。 恢复板卡后必须先完成第 6 节的只读检查,确认 driver、时钟和节点正常。
11.3 DSI 无显示或色条程序无法显示
检查 route_dsi 是否为 okay,确认 DTS 已选择 master profile。若 DRM
plane 被 rk_demo 占用,先执行 killall rk_demo 再启动 DSI Demo。
12. DLL training 说明
已验证的高云 FPGA 调试源码曾在 dsmc_dll_training_method() 中临时加入
return 0;,用于跳过 DLL training。该临时改动不属于三核心补丁,也不建议
直接用于量产。量产配置必须恢复 DLL training,并根据实际 FPGA 时序重新完成
训练和稳定性验证。