学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--06-RK3576-DSMC-Driver

01_Learning · 第 17 / 23 篇

第 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
新的用户可映射 regiondsmc-lb-device.c,并审查安全边界
slave 侧 IRQ/DMA 交互dsmc-lb-slave.c

第一项训练应是:不改变频率,仅启用已定义且原理图确认的 TEST1 region,完成 host probe、region 映射和固定模式读写校验。第二项才是 DMA;第三项才是提高时钟或改 timing。

6. DSMC 的必经调试路线

  1. 确认实际运行的是 TEST1 DTB,且 CONFIG_ROCKCHIP_DSMC=y。
  2. 读取 probe 日志,定位失败在 DT、GRF、clock/reset、DMA、dsmc_init、remap、training 还是 status check。
  3. 保持 25 MHz,不做性能优化;检查 CLK、CS、DQS、DQ、INT、RDYN 波形和电平。
  4. 用小范围、固定 pattern 验证 CPU PIO 读写;再验证地址 pattern。
  5. PIO 稳定后,用现有 dsmc-test.c 的 DMA 流程验证 DDR→DSMC、DSMC→DDR、DSMC→DSMC。
  6. 最后才修改 timing 或引入新 region。每次改动都保留可回退的 DTS diff 与原始错误日志。
01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--05-RK3576-RS485-Driver下一篇RK3576-Industrial-Bus-Driver-Course--07-Kernel-Mechanisms-for-Bus-Drivers