RK3506 DSMC 测试命令
本文适用于当前 RK3506G EVB1 + DSMC LocalBus CS2 + FPGA 从机配置。目标是按“驱动与训练门禁 → PIO → DMA”的顺序验证。所有命令均在目标板 shell执行,不依赖 hadb。
安全规则:训练失败时,不得执行任何
/dev/dsmc/...窗口读写、io窗口读写或 DMA 测试。当前已验证案例中,训练失败后访问窗口可能使 CPU 卡在未完成的 LocalBus 事务中并触发 watchdog。
已知配置
| 项目 | 当前值 |
|---|---|
| DSMC 控制器寄存器 | 0xff8b0000,长度 0x10000 |
| LocalBus 从机寄存器 | 0xff880000,长度 0x10000 |
| 片选 | CS2 |
| 用户态设备节点 | /dev/dsmc/cs2/region0 |
| 已验证 PIO 窗口物理地址 | 0xc8000000(只适用于当前 region0/region3 启用布局) |
| DSMC 时钟 | DTS 请求 25 MHz;当前实测 CRU 输出 50 MHz |
| DMA 测试接口 | /sys/kernel/rk_dsmc_test/plc_test |
更换片选、启用 region 数量或变更 rockchip,ranges 后,窗口物理地址会变化。先核对 DTS 和设备节点,不可照搬 0xc8000000。
1. 纯只读检查
以下命令不主动访问 FPGA 的 LocalBus 数据窗口,可用于首次上电和故障定位。
1.1 驱动、设备节点和测试接口
ls -l /dev/dsmc/
ls -l /dev/dsmc/cs2/
ls -l /sys/kernel/rk_dsmc_test/
# 目标内核若导出配置,确认 DSMC 选项
zcat /proc/config.gz 2>/dev/null | grep -E 'CONFIG_ROCKCHIP_DSMC|CONFIG_ROCKCHIP_DSMC_SLAVE'
当前配置中应看到 /dev/dsmc/cs2/region0,以及 plc_test、dsmc_speed_t、memtester、psram_test 等 sysfs 测试接口。缺少节点时,先检查 DTS 的 &dsmc、&dsmc_slave、lb-slave2 和对应 region 的 status = "okay"。
1.2 Probe、时钟和训练日志
# DSMC probe、训练窗口和错误日志
dmesg | grep -Ei 'dsmc|dll.*(training|window)|training failed|timeout|error'
# DSMC 实际时钟
cat /sys/kernel/debug/clk/clk_summary | grep -E 'clk_dsmc|aclk_dsmc|pclk_dsmc'
# 当前设备树 model 与内存/CMA
cat /proc/device-tree/model
grep -E 'CmaTotal|CmaFree' /proc/meminfo
门禁判定:日志必须出现有效的 DLL window [0x..-0x..],且没有 training failed,才允许进入 PIO 或 DMA 测试。当前已验证 CS2 训练窗口为 [0x3d-0xff],工作值为 0x9e;这是本板 FPGA 的结果,不是其他 FPGA 的通用标准。
若训练日志因 ring buffer 已覆盖而不可见,重新冷启动后优先保存启动日志;不要在训练状态不明时访问数据窗口。
1.3 控制器寄存器只读查看
目标 rootfs 有 io 工具时,可只读查看寄存器。控制器寄存器中的状态位可能具有读清语义,调试前应先查寄存器定义;以下命令只用于确认映射可见。
io -4 0xff8b0000
io -4 0xff880000
不要向 0xff8b0000 或 0xff880000 写值。它们是 DSMC 控制器/从机寄存器,不是通用数据缓冲。
2. PIO 测试
先编译并部署本工程的 PIO 工具:
# 主机编译后将 build/dsmc_demo 传到板端;以下在板端执行
chmod 0755 /userdata/bin/dsmc_demo
2.1 PIO 单点读取
以下命令会向 FPGA 发起真实读事务。它不会改写数据,但不是“纯只读安全检查”;仅在训练门禁通过后执行。
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 info
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 read 0x0
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 read 0x4
预期是显示设备映射信息及对应 32 位值。读值由 FPGA 逻辑决定;没有约定固定寄存器值时,不能用数值本身判断通路成功。
2.2 PIO 单点写读
以下命令会改写 FPGA 地址 0x0 的 32 位内容。必须确认该地址是可安全覆盖的测试 RAM,不能是控制寄存器、FIFO 或客户业务数据。
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 write 0x0 0x5aa5f00f
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 read 0x0
期望回读 0x5aa5f00f。再对多个已确认安全的偏移重复,例如 0x4、0x1000 和 0x100000。不要跨越 region 边界。
2.3 PIO 图案写读
pattern 会连续改写从 offset 0 开始的测试区域,仅能用于专用测试 RAM。
# 连续 64 个 32 位字的写读校验
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 pa
ttern 64 0x0
预期输出 pattern 64 words: 0 mismatch。
3. 使用 io 命令访问 FPGA 数据窗口
io 适合单地址人工验证;它绕开 DSMC 字符设备,直接以物理地址访问窗口。仅在训练通过、地址已确认且 FPGA 允许该访问属性时使用。
# 只读:真实 LocalBus 读事务
io -4 0xc8000000
# 写入测试 RAM 后回读:会改写 FPGA 数据
io -4 0xc8000000 0x5aa5f00f
io -4 0xc8000000
0xc8000000 只对应本文“已知配置”中的 CS2 region0。若 FPGA 地址宽度、region 数量、CS 或 DTS 映射不同,必须按当前驱动窗口公式重新计算地址。
4. DMA 往返测试
plc_test 会执行约 4 MiB 的 DDR → FPGA → DDR DMA 往返,并对回读数据比较。它会写 FPGA 测试窗口,即使触发命令是 cat,也不是只读命令。
执行前确认:
- DLL 训练门禁通过;
- FPGA 已准备至少 4 MiB 可覆盖测试 RAM;
- CS2 DMA 通道复用配置与当前 DTS/驱动匹配;
- 当前不存在与 FPGA 测试窗口冲突的业务访问。
# 触发 DMA 往返;终端输出不完整,结果以 dmesg 为准
cat /sys/kernel/rk_dsmc_test/plc_test
# 检查阶段日志、超时和 compare 错误
dmesg | grep -E 'plc_simple_test|phase ?[12]|copy_to|cpu_compare_test|mismatch|error|timeout'
通过标准:日志包含 DDR → slave、slave → DDR 两个阶段,cpu_compare_test done 正常结束,且无 mismatch、error、timeout 或 kernel panic。
5. 推荐测试顺序
# A. 驱动与训练,只读
ls -l /dev/dsmc/cs2/ /sys/kernel/rk_dsmc_test/
dmesg | grep -Ei 'dsmc|dll.*(training|window)|training failed'
cat /sys/kernel/debug/clk/clk_summary | grep -E 'clk_dsmc|aclk_dsmc|pclk_dsmc'
# B. 训练通过后,单点 PIO 读
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 read 0x0
# C. 确认测试 RAM 后,PIO 写读
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 write 0x0 0x5aa5f00f
/userdata/bin/dsmc_demo /dev/dsmc/cs2/region0 read 0x0
# D. 确认 4 MiB 专用测试区后,DMA 往返
cat /sys/kernel/rk_dsmc_test/plc_test
dmesg | grep -E 'plc|compare|mismatch|error|timeout'
常见现象
| 现象 | 最可能层 | 下一步 |
|---|---|---|
没有 /dev/dsmc/cs2/region0 | DTS/驱动 probe | 检查节点状态、CS 节点名、dmesg probe 日志。 |
无训练窗口或出现 training failed | FPGA 握手、DQS、时钟、IO 电平 | 停止窗口访问,检查供电、RDYN/等待态、DQS DLL、引脚和时钟。 |
| PIO 读写错误 | 地址、位宽、region 属性或 FPGA RAM | 先单点读,再复核 CS、窗口公式、X8/X16 和 FPGA 地址译码。 |
| DMA compare 失败 | DMA 通道、CMA、缓存或 FPGA 数据一致性 | 保留 dmesg,确认 CMA、DMA 通道和 FPGA 4 MiB 测试区。 |
| PIO/DMA 卡死 | 未过训练门禁或 FPGA 总线事务未完成 | 不再访问窗口,采集 ramoops/dmesg 并检查 FPGA 握手。 |