第 6 章:RK3576 TEST1 DSMC——架构、源码与开发路径
本章仅以 RK3576_TEST1 为 DSMC 实验平台。其 SDK defconfig 指向 rk3576-test1-v10-linux,而 rk3576-test1.dtsi 已把 DSMC 配置为 25 MHz、LocalBus、16-bit IO。不要将此配置复制到 Industry EVB。
1. 先厘清 DSMC 的角色
SDK Kconfig 将 DSMC 定义为 Double Data Rate Serial Memory Controller。现有实现分成三层:
dsmc-host.c platform driver、DT 解析、clock/reset/DMA、映射、训练
-> dsmc-controller.c 寄存器配置、PSRAM/LocalBus 控制与读写操作
-> dsmc-lb-device.c LocalBus region 的字符设备 mmap 接口
-> dsmc-lb-slave.c 特定 LocalBus slave 辅助驱动
这不是单一“读写寄存器”的小驱动。它把控制器、外部 slave、region 属性、DMA 与用户映射组合起来;因此应按现有分层扩展,不能另写一个与之竞争的 /dev/mem 方案。
2. TEST1 的现有 DTS 配置
rk3576-test1.dtsi 中关键覆盖为:
&dsmc {
clock-frequency = <25000000>;
status = "okay";
};
&dsmc_slave {
rockchip,clk-mode = <0>;
status = "okay";
lb-slave { rockchip,io-width = <16>; };
};
&dsmc_lb_slave0 {
rockchip,mtr-timing = <1 0 0 0 0 0 2 2>;
rockchip,int-en = <0>;
status = "okay";
};
25 MHz 是保守起点。mtr-timing、IO width、region 类型与 int-en 都是硬件合同,不是性能调参开关。任何修改前必须有 TEST1 的原理图、外接 local-bus slave 规格和可观察波形。
3. host probe:完整初始化顺序
源码:drivers/memory/rockchip/dsmc-host.c,函数 rk_dsmc_probe()(约 966 行)。按下面顺序阅读。
3.1 私有对象、MMIO 和 GRF
priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
platform_set_drvdata(pdev, priv);
dsmc->regs = devm_ioremap_resource(&pdev->dev, mem);
dsmc->grf = syscon_regmap_lookup_by_phandle(np, "rockchip,grf");
regs 是 DSMC 控制器 MMIO;grf 是 RK3576 的 IO mux/GRF 访问入口。RK3576 平台初始化会配置 DSMC 引脚相关 GRF,因此 rockchip,grf 缺失不能被忽略。
3.2 先解析 DT,再开硬件
ret = device_property_read_u32(dev, "clock-frequency", &dsmc->cfg.freq_hz);
dsmc->cfg.ctrl_freq_hz = dsmc->cfg.freq_hz * 2;
if (dsmc_parse_dt(pdev, dsmc))
return -ENODEV;
ret = rockchip_dsmc_platform_init(pdev);
这里先把 region、slave 类型、timing 和 DMA 配置读入内存,再做 RK3576 特有的 pin/GRF 初始化。改 DTS 属性后如果行为不符,先追踪 dsmc_parse_dt() 中读取的属性名与转换规则。
3.3 时钟、复位、DMA、训练
clk_prepare_enable(dsmc->aclk_root);
clk_prepare_enable(dsmc->aclk);
clk_prepare_enable(dsmc->pclk);
clk_prepare_enable(dsmc->clk_sys);
clk_set_rate(dsmc->aclk_root, dsmc->cfg.freq_hz);
clk_set_rate(dsmc->clk_sys, dsmc->cfg.ctrl_freq_hz);
rockchip_dsmc_dma_request(dev, dsmc);
dsmc_init(dsmc);
dsmc_mem_remap(dev, dsmc);
rockchip_dsmc_dll_training(priv);
rockchip_dsmc_status_check(priv);
顺序体现依赖:无 clock 不能访问控制器;无 DMA/region 配置无法建立完整数据路径;未完成 DLL training 前不能认为高速访问稳定。任何一步失败都会沿标签反向释放 DMA 和时钟,这是必须保留的 SDK 质量要求。
4. LocalBus 用户态接口为何只 mmap
dsmc-lb-device.c 的 file_operations 只实现 open、release、mmap。open() 用 minor 推导 CS 和 region;mmap() 用 remap_pfn_range() 映射已由 host 配置的物理 region。它刻意不提供任意 read/write ioctl。
这意味着:用户态只有在已经确认 CS/region 边界和 cache 属性后才能映射;不能为了方便绕开该接口用 /dev/mem 映射整个 DSMC 地址空间。对于有副作用的 Register region,必须由协议和访问宽度约束保护。
5. 写 DSMC 功能的正确切入点
| 需求 | 应修改的层 |
|---|---|
| TEST1 板级线宽、CS、region 启用 | rk3576-test1.dtsi 的 board override |
| 新 region 属性解析 | dsmc-host.c 的 DT parse 与配置结构 |
| LocalBus 读写/时序寄存器逻辑 | dsmc-controller.c |
| 新的用户可映射 region | dsmc-lb-device.c,并审查安全边界 |
| slave 侧 IRQ/DMA 交互 | dsmc-lb-slave.c |
第一项训练应是:不改变频率,仅启用已定义且原理图确认的 TEST1 region,完成 host probe、region 映射和固定模式读写校验。第二项才是 DMA;第三项才是提高时钟或改 timing。
6. DSMC 的必经调试路线
- 确认实际运行的是 TEST1 DTB,且
CONFIG_ROCKCHIP_DSMC=y。 - 读取 probe 日志,定位失败在 DT、GRF、clock/reset、DMA、
dsmc_init、remap、training 还是 status check。 - 保持 25 MHz,不做性能优化;检查 CLK、CS、DQS、DQ、INT、RDYN 波形和电平。
- 用小范围、固定 pattern 验证 CPU PIO 读写;再验证地址 pattern。
- PIO 稳定后,用现有
dsmc-test.c的 DMA 流程验证 DDR→DSMC、DSMC→DDR、DSMC→DSMC。 - 最后才修改 timing 或引入新 region。每次改动都保留可回退的 DTS diff 与原始错误日志。