嵌入式 Linux 与 RTOS / 系统课时

适配时钟、复位与电源资源

适配时钟、复位与电源资源

很多“驱动已经 probe,却读不到寄存器”或“设备完全没有响应”的根因,并不在总线协议,而在外设依赖的时钟、复位或供电没有进入可用状态。本篇把这三类资源放进同一条探测链路,建立设备树表达、驱动获取、启用顺序和失败回滚之间的对应关系。

学习目标

  • 能用 clocks、resets 和 <name>-supply 属性表达设备依赖。
  • 能按供电、时钟、复位的约束组织 probe,并按相反顺序释放资源。
  • 能根据内核日志和 debugfs 区分“资源不存在”“provider 尚未就绪”和“资源已获取但未启用”。

先把三类资源看成访问门槛

regulator 决定器件或电压域是否供电,clock 决定逻辑是否获得工作节拍,reset 决定模块是否仍被保持在复位状态。很多 MMIO 外设只有在这些前提满足后,寄存器访问才有意义。

设备树只负责描述依赖关系,并不等于“写了属性就自动开资源”。驱动仍要通过 regulator、common clock framework 和 reset controller API 获取句柄并完成 enable、deassert 等动作。provider 尚未注册时,consumer 还可能返回 -EPROBE_DEFER,稍后重新 probe。

在设备树中表达依赖

下面是片段示例,展示一个 MMIO 外设依赖 3.3 V 电源、核心时钟和复位线。#clock-cells、#reset-cells 的参数数量由 provider binding 决定,因此 <12>、<7> 只是板级示意值。

dts
peripheral@12340000 {
    compatible = "vendor,demo-peripheral";
    reg = <0x12340000 0x1000>;

    vdd-supply = <&vdd_3v3>;

    clocks = <&clkctrl 12>;
    clock-names = "core";

    resets = <&rstctrl 7>;
    reset-names = "core";

    status = "okay";
};

驱动调用 devm_regulator_get(dev, "vdd") 时,对应的是设备树属性 vdd-supply;调用 devm_clk_get(dev, "core") 和 devm_reset_control_get_exclusive(dev, "core") 时,则分别通过 clock-names 和 reset-names 找到对应资源。名字不一致时,资源本身存在也可能获取失败。

按依赖顺序完成 probe

多数外设都适合遵循“先供电,再开时钟,再撤复位,最后访问寄存器”的思路;真正顺序仍应以芯片手册为准。下面是片段示例,依赖平台驱动上下文和一个含 vdd、clk、rst 字段的私有结构体。

c
static int demo_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;
    struct demo_priv *priv;
    int ret;

    priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
    if (!priv)
        return -ENOMEM;

    priv->vdd = devm_regulator_get(dev, "vdd");
    if (IS_ERR(priv->vdd))
        return dev_err_probe(dev, PTR_ERR(priv->vdd), "get vdd failed\n");

    ret = regulator_enable(priv->vdd);
    if (ret)
        return dev_err_probe(dev, ret, "enable vdd failed\n");

    priv->clk = devm_clk_get(dev, "core");
    if (IS_ERR(priv->clk)) {
        ret = dev_err_probe(dev, PTR_ERR(priv->clk), "get core clock failed\n");
        goto err_power;
    }

    ret = clk_prepare_enable(priv->clk);
    if (ret)
        goto err_power;

    priv->rst = devm_reset_control_get_exclusive(dev, "core");
    if (IS_ERR(priv->rst)) {
        ret = dev_err_probe(dev, PTR_ERR(priv->rst), "get reset failed\n");
        goto err_clock;
    }

    ret = reset_control_deassert(priv->rst);
    if (ret)
        goto err_clock;

    platform_set_drvdata(pdev, priv);
    return 0;

err_clock:
    clk_disable_unprepare(priv->clk);
err_power:
    regulator_disable(priv->vdd);
    return ret;
}

这段代码的关键不是固定 API 模板,而是成功路径按依赖正向打开,失败路径按相反顺序回滚。如果驱动在撤复位后还有更多可能失败的初始化步骤,还应在对应错误路径重新 assert reset,避免卸载或重试时把硬件留在半初始化状态。

外设 probe 的资源依赖与回滚顺序

用日志和 debugfs 判断卡在哪一层

先看 probe 日志,再看时钟和 regulator 的实际状态。下面命令中的 <DRIVER>、<CLOCK> 按实际名称替换;debugfs 节点是否存在取决于内核配置。

bash
dmesg | grep -Ei '<DRIVER>|probe|clock|reset|regulator'
grep -w '<CLOCK>' /sys/kernel/debug/clk/clk_summary
cat /sys/kernel/debug/regulator/regulator_summary

预期结果不是固定数值,而是能看到目标资源的存在性与启用状态;时钟频率、引用计数和 regulator 名称会随平台变化。

text
<CLOCK> ... enable_count <N> ... rate <FREQ>
<REGULATOR> ... <STATE> ... <VOLTAGE>

如果日志反复出现 deferred probe,优先确认 clock/reset/regulator provider 自己是否已成功 probe,以及设备树 phandle 是否指向正确节点;如果资源能获取但 enable_count 仍为 0,检查驱动是否真正执行了 enable 路径;如果时钟已开、复位仍未撤销,则继续查 reset 名称、极性和芯片手册要求。

验收资源链路

完成适配后,不要只以“驱动没有报错”作为通过标准。至少确认设备节点成功绑定、目标时钟进入预期频率、必要电源 rail 已启用,并在驱动允许的情况下确认 reset 已退出。随后再读设备 ID、状态寄存器或执行一次真实总线事务,才能证明资源链路已经支撑起外设访问。

当外设表现为“偶发可用”“冷启动失败但重启正常”时,更要回到这条依赖链检查时序和回滚,而不是先修改总线超时。时钟、复位和电源是驱动访问硬件之前的前置条件,只有它们的状态与数据手册一致,后续寄存器调试才有意义。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

适配时钟、复位与电源资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通