快速开始 / TSENGCHEN BLOG

RK3506-DSMC-DSI-Quickstart

08_QuickStart · 第 5 / 13 篇

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-*.patchDSMC test、memtester 和测试所需内核配置。
patches/0002-*.patchDSMC host/slave 引脚驱动强度设置为 level 4。
patches/0003-*.patchCS2/DMA/pinctrl、4 region、50MHz、DQS、CMA、DSI。
config/RK_KERNEL_DTS_NAME.fragmentmaster 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 设计定义:

地址功能
0xd0000000merge FIFO。
0xd2000000no-merge FIFO。
0xd4000000DPRAM。
0xd6000000FPGA 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 使能。
MCR2X8 为 0x00010013;X16 切换后为 0x0001001b。
四窗口读取四个 CS2 地址均可访问,未发生 kernel panic。
FIFO 写读写入命令完成;回读为 FPGA FIFO/状态数据。
DSIDRM/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 时序重新完成 训练和稳定性验证。

08_QuickStart · 文档目录
上一篇RK3506_RK3576_RS485_Quick_Start下一篇RK3506G-RT-Kernel-CODESYS-Quickstart