Linux 内核学习(1) --- 时钟子系统

标题

      • 时钟系统说明
      • 时钟树
      • Clock Provider
        • 时钟通用数据结构
        • clock_device 的注册
        • clock_provider DTS配置和注册
        • clock consumer
        • 时钟系统总结

时钟系统说明

时钟就是 SoC 中的脉搏,由它来控制各个部件按各自的节奏跳动。比如,CPU主频设置,串口的波特率设置,I2S的采样率设置,I2C的速率设置等等。这些不同的 clock 设置,都需要从某个或某几个时钟源头而来,最终开枝散叶,形成一棵时钟树。

Linux的时钟子系统由CCF(common clock framework) 框架管理,CCF向上给其他使用时钟的 IP 提供了通用的时钟接口,向下给驱动开发者提供硬件操作的接口。

这个也是一个consumer、framework、provider的模式。
Provider 是时钟的模块的具体实现者,系统开机时,需要通过驱动的时钟框架向系统注册不同的时钟。Provider,其他需要时钟的模块通过通用接口获取,使能,设置时钟。
Framework 是内核提供的一套通用时钟实现框架,包含了注册和使用的通用接口。
Consumer 是时钟模块的使用者,比如上面提到的 I2C 模块,Uart 模块的等等。

电源管理的两大主要方面就是时钟和电压

时钟树

在SoC上的模块很多,为了适应不同模块的时钟要求,会形成一课时钟树,如下所示:

根节点一般是 Oscillator(有源振荡器)或者 Crystal(无源振荡器),表示从芯片外部输入的基准时钟,
中间节点有很多种,包括 PLL(锁相环,用于提升频率的),Divider(分频器,用于降频的),Mux(从多个clock path中选择一个),Gate(只能被控制ON/OFF的)。Soc 上的时钟树
根据不同时钟的特点,clock framework 将 clock 分为 **Fixed rate、gate、Divider、Mux、Fixed factor、composite **六类,这六类的含义如下:

  • Fixed rate clock
    固定频率时钟,提供恒定的时钟信号,适用于需要固定频率的硬件,如PWM(脉宽调制)或定时器。
  • Gated clock
    门控时钟,只可以被开启或关闭,适用于可以被动态开启或者关闭的硬件,以节约电源
  • Divider clock
    分频时钟,可以将输入的时钟信号分频,产生一个较低频率的时钟信号,适用于需要降低时钟频率适应设备需要的设备
  • Muxed clock:
    复用时钟,时钟信号可以选择不同的时钟源
  • Fixed factor clock
    固定系数时钟,可以将输入时钟信号乘以一个固定的系数,产生一个更高或者更低的时钟信号
  • Composite clock
  • 组合时钟,可以由多个时钟实体组成,每个时钟实体都有特定的功能,适用于复杂时钟控制策略的硬件,比如复杂时钟路径和时钟管理

Linux 下 cat /sys/kernel/debug/clk/clk_summary 可以查看当前 Soc 的时钟树

Clock Provider

时钟通用数据结构

Linux 内核将上面六类设备特点抽象出来,用 struct clk_hw 表示

struct clk_hw {//指向CCF模块中对应 clock device 实例struct clk_core *core;//clk是访问clk_core的实例 每当consumer通过clk_get对CCF中的clock device(也就是clk_core)发起访问的时候都需要获取一个句柄,也就是clkstruct clk *clk;//clock provider driver初始化时的数据,数据被用来初始化clk_hw对应的clk_core数据结构。const struct clk_init_data *init;
};struct clk_init_data {//该clock设备的名字const char  *name;//clock provider driver 进行的具体的 HW 操作const struct clk_ops *ops;//描述该clk_hw的拓扑结构const char  * const *parent_names;const struct clk_parent_data *parent_data;const struct clk_hw  **parent_hws;u8   num_parents;unsigned long  flags;
};

Fixed rate clockgate clock 为例,它就包含一个 struct clk_hw 结构作为核心:

struct clk_fixed_rate {// 包含的 clk_hw 结构struct		clk_hw hw;unsigned long	fixed_rate;unsigned long	fixed_accuracy;u8		flags;
};struct clk_gate {struct clk_hw hw;void __iomem	*reg;u8		bit_idx;u8		flags;spinlock_t	*lock;
};

由此可以知道:

  1. 每次注册进入内核的 clock device 设备,都会包含一个 struct clk_hw 结构
  2. strutc clk_hw 包含一个重要的结构体成员 const struct clk_init_data *init,里面包含了注册进入内核的时钟的具体操作方法

struct clk_init_data 包含一个重要成员 clk_ops,里面就是时钟设备的具体操作方法函数:

struct clk_ops {int		(*prepare)(struct clk_hw *hw);void		(*unprepare)(struct clk_hw *hw);int		(*is_prepared)(struct clk_hw *hw);void		(*unprepare_unused)(struct clk_hw *hw);int		(*enable)(struct clk_hw *hw);void		(*disable)(struct clk_hw *hw);int		(*is_enabled)(struct clk_hw *hw);void		(*disable_unused)(struct clk_hw *hw);unsigned long	(*recalc_rate)(struct clk_hw *hw,unsigned long parent_rate);long		(*round_rate)(struct clk_hw *hw, unsigned long rate,unsigned long *parent_rate);int		(*determine_rate)(struct clk_hw *hw,struct clk_rate_request *req);int		(*set_parent)(struct clk_hw *hw, u8 index);u8		(*get_parent)(struct clk_hw *hw);int		(*set_rate)(struct clk_hw *hw, unsigned long rate,unsigned long parent_rate);int		(*set_rate_and_parent)(struct clk_hw *hw,unsigned long rate,unsigned long parent_rate, u8 index);unsigned long	(*recalc_accuracy)(struct clk_hw *hw,unsigned long parent_accuracy);int		(*get_phase)(struct clk_hw *hw);int		(*set_phase)(struct clk_hw *hw, int degrees);void		(*init)(struct clk_hw *hw);int		(*debug_init)(struct clk_hw *hw, struct dentry *dentry);
};struct clk_init_data {const char		*name;const struct clk_ops	*ops;const char		* const *parent_names;u8			num_parents;unsigned long		flags;
};
clock_device 的注册

clock_provider 注册的流程如下图:
clock_provider_framework
这里的注册是指将不同的 clock_device 注册到内核的 CCF 框架中,具体时钟驱动的匹配和注册在下面讲介绍:

  • 首先 Linux 内核会读取设备树中定义的不同的 clock_device 节点,匹配到不同的 clock_init 函数
  • clock_init 函数中,根据设备树的配置,注册不同类型的 clock_device到 CCF 中

不同的 clock_device 都会提供 register 函数用于注册,举例如下:

// include/linux/clock-provider.h
struct clk *clk_register_gate(struct device *dev, const char *name,const char *parent_name, unsigned long flags,void __iomem *reg, u8 bit_idx,u8 clk_gate_flags, spinlock_t *lock);struct clk *clk_register_divider(struct device *dev, const char *name,const char *parent_name, unsigned long flags,void __iomem *reg, u8 shift, u8 width,u8 clk_divider_flags, spinlock_t *lock);struct clk *clk_register_divider_table(struct device *dev, const char *name,const char *parent_name, unsigned long flags,void __iomem *reg, u8 shift, u8 width,u8 clk_divider_flags, const struct clk_div_table *table,spinlock_t *lock);		
...
clk_register_mux(...);
clk_register_mux_table(...);
clk_register_fixed_factor(...);
clk_register_composite(...);

这些注册函数最终都会通过函数 clk_register 注册到 Common Clock Framework 中,返回为 struct clk 指针。如下所示:
clock_device_regsiter
在这里插入图片描述
在内核的drivers/clk目录下,可以看到各个芯片厂商对各自芯片 clock 驱动的实现

clock_provider DTS配置和注册

在设备数中,需要首先定义 clock_provider 的特性节点,以 rk3399 为例,下面的 cru(clock reset unit) 的配置如下:

cru: clock-controller@ff760000 {compatible = "rockchip,rk3399-cru";reg = <0x0 0xff760000 0x0 0x1000>;rockchip,grf = <&grf>;#clock-cells = <1>;#reset-cells = <1>;assigned-clocks =<&cru PLL_GPLL>, <&cru PLL_CPLL>,<&cru PLL_NPLL>,<&cru ACLK_PERIHP>, <&cru HCLK_PERIHP>,<&cru PCLK_PERIHP>,<&cru ACLK_PERILP0>, <&cru HCLK_PERILP0>,<&cru PCLK_PERILP0>, <&cru ACLK_CCI>,<&cru HCLK_PERILP1>, <&cru PCLK_PERILP1>;assigned-clock-rates =<594000000>,  <800000000>,<1000000000>,<150000000>,   <75000000>,<37500000>,<100000000>,  <100000000>,<50000000>, <600000000>,<100000000>,   <50000000>;
};

不同属性的的含义如下:

属性含义
compatible驱动的匹配名称,内核通过字段匹配到不同的初始化函数
clock-output-names输出时钟的名字,当consumer 使用此时钟时,使用该属性的值
clock-frequency输出时钟的频率
clock-cells输出的时钟的路数,当#clock-cells为0时,代表仅输出1路时钟,若大于等于1,则代表输出多路时钟,Clock consumers通过编号索引使用。
assigned-clocks表示该设备需要使用时钟信号,这个属性的值是一个整数数组,每一个元素对应一个时钟信号
assigned-clock-rates和 assigned-clocks 成对使用,表述输入时钟的频率

在 Linux 内核代码中,还需要声明相匹配的时钟驱动,这样在初始化阶段,内核就可以自动匹配 DTS 中的 compatible 字段,向系统注册时钟设备
CLK_OF_DECLARE 宏用于声明与设备树(DeviceTree)绑定的时钟控制器驱动
CLK_OF_DECLARE 宏的定义如下:

#define CLK_OF_DECLARE(name, compat, fn) \OF_DECLARE_1(clk_of_match, name, compat, fn)//name:时钟提供者的名称,通常是一个结构体的实例。
//compat:与设备树中兼容性字段匹配的字符串,用于识别时钟控制器。
//fn:一个函数指针,指向用于初始化时钟控制器的函数。
//当内核解析设备树时,它会查找与compat参数匹配的节点,并调用fn参数指定的函数来初始化时钟控制器。这样,内核就可以通过设备树来配置和管理设备的时钟

继续跟踪 CLK_OF_DECLARE 的代码可以看到

#define CLK_OF_DECLARE(name, compat, fn) OF_DECLARE_1(clk, name, compat, fn)#define OF_DECLARE_1(table, name, compat, fn) \_OF_DECLARE(table, name, compat, fn, of_init_fn_1)#define _OF_DECLARE(table, name, compat, fn, fn_type)			\static const struct of_device_id __of_table_##name		\__used __section(__##table##_of_table)			\= { .compatible = compat,				\.data = (fn == (fn_type)NULL) ? fn : fn  }// 如果将 fn 传入参数 hi6220_clk_media,那么展开后可以看到下面的一个实例:
static const struct of_device_id __of_table_hi6220_clk_media__used __section(__clk_of_table)	= {.compatible = compat;.data = fn; // check fn type __init 函数}		

本质上定义了 struct of_device_id 结构,使用 compatible 字段进行匹配

所以 clock 驱动编写的一般步骤是:

  1. 实现 struct clk_ops 相关成员函数
  2. 定义分配 struct clk_onecell_data 结构体,初始化相关数据
  3. 定义分配 struct clk_init_data 结构体,初始化相关数据
  4. 调用 clk_register 将时钟注册进框架
  5. 调用 clk_register_clkdev 注册时钟设备
  6. 调用 of_clk_add_provider,将 clk provider 存放到 of_clk_provider 链表中管理
  7. 调用 CLK_OF_DECLARE 声明驱动

其中的第二步,struct clk_onecell_data 是在 clk-provider.h 中定义,结构如下:

struct clk_onecell_data {struct clk **clks;unsigned int clk_num;
};

一般用于保存 clk_register 函数的返回值 struct clk 结构,并将其作为私有数据参数,通过 of_clk_add_provider 注册到 of_clk_provider 链表中

	struct clk_onecell_data *clk_data;clk_data = kzalloc(sizeof(struct clk_onecell_data), GFP_KERNEL);......clk_data->clks = kzalloc(qty * sizeof(struct clk *), GFP_KERNEL);.....clk_data->clks[i] = clk_register_gate(NULL, clk_name,clk_parent, clkflags,reg_idx, reg_bit,flags,&clk_lock);clk_data->clk_num = qty;of_clk_add_provider(node, of_clk_src_onecell_get, clk_data);
clock consumer

Clock consumers意为时钟使用者,通常是CPU核心部件或者其他外设。
下面是一个 clock consumer 的配置:

	i2c8: i2c@ff3e0000 {compatible = "rockchip,rk3399-i2c";reg = <0x0 0xff3e0000 0x0 0x1000>;assigned-clocks = <&pmucru SCLK_I2C8_PMU>;assigned-clock-rates = <200000000>;clocks = <&pmucru SCLK_I2C8_PMU>, <&pmucru PCLK_I2C8_PMU>;clock-names = "i2c", "pclk";interrupts = <GIC_SPI 58 IRQ_TYPE_LEVEL_HIGH 0>;pinctrl-names = "default";pinctrl-0 = <&i2c8_xfer>;#address-cells = <1>;#size-cells = <0>;status = "disabled";};

clocks 属性:它代表了设备的时钟源,通常以 phandle + specifier 组合进行引用,比如在本例中使用的时钟是pmcru 中的 SCLK_I2C8_PMU 和 PCLK_I2C8_PMU 作为时钟源

clock-names:这代表了Clock consumers中使用的时钟名字,方便设备驱动代码进行相应的时钟解析
比如使用下面的代码进行解析:

	mdev->aclk = devm_clk_get(dev, "aclk");if (IS_ERR(mdev->aclk)) {DRM_ERROR("Get engine clk failed.\n");err = PTR_ERR(mdev->aclk);mdev->aclk = NULL;goto err_cleanup;}clk_prepare_enable(mdev->aclk);

clock comsumer 的架构如下所示:
clock_consumer
主要就是获取和操作 clk,即通过 clock 名称获取 struct clk 指针的过程,由 clk_get、devm_clk_get、clk_get_sys、of_clk_get、of_clk_get_by_name、of_clk_get_from_provider 等接口负责实现,

//启动clock前的准备工作/停止clock后的善后工作。可能会睡眠。
int clk_prepare(struct clk *clk)
void clk_unprepare(struct clk *clk)//启动/停止clock。不会睡眠。
static inline int clk_enable(struct clk *clk)
static inline void clk_disable(struct clk *clk)//clock频率的获取和设置
static inline unsigned long clk_get_rate(struct clk *clk)
static inline int clk_set_rate(struct clk *clk, unsigned long rate)
static inline long clk_round_rate(struct clk *clk, unsigned long rate)//获取/选择clock的parent clock
static inline int clk_set_parent(struct clk *clk, struct clk *parent)
static inline struct clk *clk_get_parent(struct clk *clk)//将clk_prepare和clk_enable组合起来,一起调用。将clk_disable和clk_unprepare组合起来,一起调用
static inline int clk_prepare_enable(struct clk *clk)
static inline void clk_disable_unprepare(struct clk *clk)

注意 clk_prepare()clk_enable() 是两个不同的函数

  1. clk_prepare() 函数的作用是准备时钟,它执行时钟的初始化操作,但并不立即启用时钟。这个函数的主要目的是为了确保时钟在启用之前所有的准备工作都已经完成,比如分配必要的资源、设置初始参数等。调用clk_prepare后,时钟处于“已准备”状态,但还没有开始运行。

  2. clk_enable函数的作用是启用时钟,它使得时钟开始运行,并提供时钟信号给相关的硬件。在调用clk_enable之前,必须先调用clk_prepare来确保时钟已经准备好。一旦时钟被启用,它就可以被硬件设备使用。

这里分析一下 clk_get 函数的实现过程:

struct clk *clk_get(struct device *dev, const char *con_id)
{const char *dev_id = dev ? dev_name(dev) : NULL;struct clk *clk;if (dev) {// 通过扫描所有 "clock-names" 中的值,和传入的 name 比较,如果相同,获得它的 index(即 clock-names 中的第几个),调用 of_clk_get,取得 clock指针。clk = __of_clk_get_by_name(dev->of_node, dev_id, con_id);if (!IS_ERR(clk) || PTR_ERR(clk) == -EPROBE_DEFER)return clk;}return clk_get_sys(dev_id, con_id);
}
时钟系统总结

Linux 的时钟框架的简要关系可以用下图来说明:
Linux common clock framweork

  • clock provider 使用 clk_hw 结构向 CCF 框架注册一个时钟设备,返回一个 struct clk 结构,其中 clk_hw 结构中 包含了 struct clk_inid_data 结构, struct clk_init_data 结构包含对时钟操作的具体函数集合 struct clk_ops
  • 为了简化操作,CCF 将 clock 设备抽象为六中不同的类型,并且做了相应的接口封装,比如,对于 gate 类型的设备,直接使用 clk_register_gate 等类型的函数就可以进行注册
  • CCF 框架会为每个注册的 clock_device 都分配一个 struct clk_core 结构,其中包含了操作函数的结构体
    struct clk_ops 结构,本质就是关联到 init_data 中的 clk_ops
  • consumer 通过 clk_get 等函数 获取的 struct clk 结构,其中包含了重要结构就是 struct clk_core,通过操作里面的 struct clk_ops 就可以关联到注册进入 CCF 框架的 clk_ops 结构,实现对时钟硬件设备操作的目的

文件中的关键代码路径

include/linux/clk.h
include/linux/clk.c
include/linux/clk-provider.hdriver/clk/clk-gate.c
driver/clk/clk-mux.c
driver/clk/clk-divider.c

参考网址:
Linux kernel中的CPU时钟管理

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/615562.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

基于 FPGA 的 DE1-SoC 功率估算器

Introduction 功耗是当今许多技术都要考虑的重要因素。例如&#xff0c;手机生产商总是谈论他们在电源管理方面的改进&#xff0c;以及如何延长电池的使用寿命。功能与功耗之间的平衡是许多人都在研究的有趣课题。然而&#xff0c;当我们做实验时&#xff0c;我们很少会考虑我…

前端vue: 使用ElementUI适配国际化

i18n介绍 i18n&#xff08;其来源是英文单词 internationalization的首末字符i和n&#xff0c;18为中间的字符数&#xff09;是“国际化”的简称。 前端国际化步骤 1、安装i18n插件 安装插件时候&#xff0c;注意必须指定版本号&#xff0c;不然安装会报错。 npm i vue-i1…

vue3 依赖-组件tablepage-vue3说明文档,列表页快速开发,使用思路及范例-汇总

github求⭐ vue3 依赖-组件tablepage-vue3说明文档,列表页快速开发,使用思路及范例(Ⅰ)配置项文档 vue3 依赖-组件tablepage-vue3说明文档,列表页快速开发,使用思路及范例(Ⅱ)搜索及数据获取配置项 vue3 依赖-组件tablepage-vue3说明文档,列表页快速开发,使用思路…

lv_micropython for ESP32-C3

一、开发平台说明 硬件&#xff1a;立创实战派ESP32-C3开发板。处理器ESP32-C3&#xff08;内置400KB SRAM&#xff09;&#xff0c;无内置FLASH&#xff0c;2.0寸液晶&#xff08;液晶驱动IC:ST7789&#xff0c;触屏驱动IC:FT6336&#xff09;&#xff0c;下载口UART0。 ESP…

AUTOSAR-COMStack-002_Update-Bit 机制

最近在工作中第一次使用了AUTOSAR COM Update-Bit功能&#xff0c;对使用了Update-Bit功能信号的使用&#xff0c;不能得心应手&#xff0c;发送信号比较顺利&#xff1b;测试接收信号功能时&#xff0c;对应的RTE接口始终不能接收到对应的模拟发送的信号值&#xff0c;后来翻阅…

掌握现代 C++:Lambda 在 C++14、C++17 和 C++20 中的演变

深入研究Lambda 在 C14、C17 和 C20 中的演变 一、背景二、C14 中的 Lambda2.1、默认参数2.2、模板参数2.3、广义捕获2.4、从函数返回 lambda 三、C17 中的 Lambda四、C20 中的 Lambda总结 一、背景 Lambda 是现代 C 最受欢迎的功能之一。自从在 C 11 中引入以来&#xff0c;它…

MySQL 嵌套查询

嵌套查询 是指在一个完整的查询语句之中&#xff0c;包含若干个不同功能的小查询&#xff1b;从而一起完成复杂查询的一种编写形式。包含的查询放在&#xff08;&#xff09;里 &#xff0c; 包含的查询出现的位置&#xff1a; 位置含义SELECT之后把查询结果作为表头使用FROM…

聊一下HashMap的底层原理

HashMap作为我们熟悉的一种集合&#xff0c;今天就来聊一下它的原理、数据结构。 1.HashMap的数据结构 JDK1.7的数据结构是数组链表&#xff0c;JDK1.7还有人在用&#xff1f;不会吧…… 说一下JDK1.8的数据结构吧&#xff1a; JDK1.8的数据结构是数组链表红黑树。 数据结…

Android 14.0 SystemUI修改状态栏电池图标样式为横屏显示

1.概述 在14.0的系统rom产品定制化开发中,对于原生系统中SystemUId 状态栏的电池图标是竖着显示的,一般手机的电池图标都是横屏显示的 可以觉得样式挺不错的,所以由于产品开发要求电池图标横着显示和手机的样式一样,所以就得重新更换SystemUI状态栏的电池样式了 如图: 2.S…

Boost之date_time

Boost.Date_Time库是一个功能丰富的时间日期处理库&#xff0c;它提供了多种用于日期和时间计算、格式化、转换和输入输出的功能。以下是该库的一些详细介绍&#xff1a; 1、日期处理&#xff1a; Boost.Date_Time库中的date类基于格里高利历&#xff08;Gregorian calendar&…

MySQL基础知识——MySQL日志

一条查询语句的执行过程一般是经过连接器、 分析器、 优化器、 执行器等功能模块&#xff0c; 最后到达存储引擎。 那么&#xff0c; 一条更新语句的执行流程又是怎样的呢&#xff1f; 下面我们从一个表的一条更新语句进行具体介绍&#xff1a; 假设这个表有一个主键ID和一个…

在视频号变现,你还停留在只能自己直播的时代吗?现在新玩法来了

大家好&#xff0c;我是电商笨笨熊 在很多人的固有印象里&#xff0c;视频号当下变现的方式还只有自己开直播带货或者是短视频带货&#xff1b;这种方式虽然变现快&#xff0c;但是对于更多的普通玩家来说相对困难&#xff0c;需要直播经验&#xff0c;自身还要具备足够的粉丝…