工程 / TSENGCHEN BLOG

RK3506-DSMC-Test-Commands

09_Engineering · 第 6 / 14 篇

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,也不是只读命令。

执行前确认:

  1. DLL 训练门禁通过;
  2. FPGA 已准备至少 4 MiB 可覆盖测试 RAM;
  3. CS2 DMA 通道复用配置与当前 DTS/驱动匹配;
  4. 当前不存在与 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/region0DTS/驱动 probe检查节点状态、CS 节点名、dmesg probe 日志。
无训练窗口或出现 training failedFPGA 握手、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 握手。
09_Engineering · 文档目录
上一篇RK3506-Customer-64MB-Kernel-Trim-Measurement下一篇RK3576-Industrial-Minimal-Buildroot-Guide