4. 时钟框架入门：Linux Common Clock Framework (CCF)

在骁龙平台 MIPI CSI 调试中，时钟是保证数据链路同步的基础。Linux 内核提供了 Common Clock Framework (CCF) 来统一管理系统中所有的时钟资源。理解 CCF 的 provider/consumer 模型以及设备树中的时钟描述方法，是正确配置 CSI 接口时钟的前提。

4.1 CCF 核心概念：Provider 与 Consumer

CCF 将系统中的时钟设备抽象为两类角色：

• Clock Provider（时钟提供者）：能够产生或转发时钟信号的硬件模块，例如 SoC 内部的 PLL、晶振振荡器、时钟门控单元等。在驱动中，它们注册为 struct clk_hw 并提供操作函数。
• Clock Consumer（时钟消费者）：需要使用时钟信号才能工作的硬件模块，例如 MIPI CSI 控制器、I2C 控制器、GPU 等。它们通过 CCF 的 API 获取并控制时钟频率。

4.2 设备树中的时钟描述：clock-cells 与 clocks

设备树通过两个关键属性来描述时钟的拓扑结构：

4.3 典型设备树时钟配置示例

以下是一个骁龙平台 Camera Sensor 节点与 GCC（Global Clock Controller）的时钟绑定示例：

// Clock Provider: GCC 控制器
gcc: clock-controller@100000 {
    compatible = "qcom,gcc-sdm845";
    reg = <0x0100000 0x200000>;
    #clock-cells = <1>;          // 多输出，通过索引区分
    #reset-cells = <1>;
    #power-domain-cells = <1>;
};

// Clock Consumer: Camera Sensor
i2c0: i2c@c170000 {
    status = "okay";
    camera_sensor: camera@10 {
        compatible = "sony,imx577";
        reg = <0x1a>;
        clocks = <&gcc GCC_CAMSS_MCLK0_CLK>;
        clock-names = "camss_mclk";
        assigned-clocks = <&gcc GCC_CAMSS_MCLK0_CLK>;
        assigned-clock-rates = <24000000>;  // 24 MHz
        // ... 其他属性
    };
};

在这个例子中：

• gcc 节点通过 #clock-cells = <1> 声明它可以输出多个时钟，每个时钟由一个整数索引标识。
• camera_sensor 节点通过 clocks 属性引用 GCC 输出的 GCC_CAMSS_MCLK0_CLK 时钟。
• assigned-clock-rates 强制该时钟在启动时初始化为 24 MHz，这是 MIPI CSI 主时钟的常见频率。

4.4 驱动侧时钟操作流程

在 Camera 驱动中，典型的时钟操作步骤如下：

1. 获取时钟句柄：struct clk *mclk = devm_clk_get(dev, "camss_mclk");
2. 准备时钟：clk_prepare(mclk);（可能睡眠）
3. 设置频率：clk_set_rate(mclk, 24000000);
4. 使能时钟：clk_enable(mclk);（原子操作）
5. 使用时钟：MIPI CSI 开始传输数据。
6. 禁用时钟：clk_disable(mclk);
7. 停止时钟：clk_unprepare(mclk);

4.5 调试技巧：验证时钟配置

在系统启动后，可以通过以下方法验证时钟配置是否正确：