Linux clock子系統(tǒng)及驅(qū)動(dòng)實(shí)例

在Linux驅(qū)動(dòng)中，操作時(shí)鐘只需要簡(jiǎn)單調(diào)用內(nèi)核提供的通用接口即可，clock驅(qū)動(dòng)通常是由芯片廠商開(kāi)發(fā)的，在Linux啟動(dòng)時(shí)clock驅(qū)動(dòng)就已經(jīng)初始化完成。

本篇介紹Linux clock子系統(tǒng)以及clock驅(qū)動(dòng)的實(shí)現(xiàn)。

基本概念

晶振 ：晶源振蕩器，提供時(shí)鐘。

PLL ：Phase lock loop，鎖相環(huán)。 用于提升頻率。

OSC ：oscillator的簡(jiǎn)寫，振蕩器。

clock子系統(tǒng)

Linux的時(shí)鐘子系統(tǒng)由CCF（common clock framework）框架管理， CCF向上給用戶提供了通用的時(shí)鐘接口，向下給驅(qū)動(dòng)開(kāi)發(fā)者提供硬件操作的接口 。 各結(jié)構(gòu)體關(guān)系如下：

CCF框架比較簡(jiǎn)單，只有這幾個(gè)結(jié)構(gòu)體。 CCF框架分為了consumer、ccf和provider三部分。

consumer ：

時(shí)鐘的使用者，clock子系統(tǒng)向consumer的提供通用的時(shí)鐘API接口，使其可以屏蔽底層硬件差異。 提供給consumer操作的API如下：

struct clk *clk_get(struct device *dev, const char *id);
struct clk *devm_clk_get(struct device *dev, const char *id);
int clk_enable(struct clk *clk);//使能時(shí)鐘，不會(huì)睡眠
void clk_disable(struct clk *clk);//使能時(shí)鐘，不會(huì)睡眠
unsigned long clk_get_rate(struct clk *clk);
void clk_put(struct clk *clk);
long clk_round_rate(struct clk *clk, unsigned long rate);
int clk_set_rate(struct clk *clk, unsigned long rate);
int clk_set_parent(struct clk *clk, struct clk *parent);
struct clk *clk_get_parent(struct clk *clk);
int clk_prepare(struct clk *clk);
void clk_unprepare(struct clk *clk);
int clk_prepare_enable(struct clk *clk) //使能時(shí)鐘，可能會(huì)睡眠
void clk_disable_unprepare(struct clk *clk) //禁止時(shí)鐘，可能會(huì)睡眠
unsigned long clk_get_rate(struct clk *clk) //獲取時(shí)鐘頻率

consumer在使用這些API時(shí)，必須先調(diào)用devm_clk_get()或clk_get()獲取一個(gè)struct clk *指針句柄，后續(xù)都通過(guò)傳入該句柄來(lái)操作，struct clk相當(dāng)于實(shí)例化一個(gè)時(shí)鐘。

ccf ：

clock子系統(tǒng)的核心，用一個(gè)struct clk_core結(jié)構(gòu)體表示，每個(gè)注冊(cè)設(shè)備都對(duì)應(yīng)一個(gè)struct clk_core。

provider（時(shí)鐘的提供者） ：

struct clk_hw：表示一個(gè)具體的硬件時(shí)鐘。

struct clk_init_data：struct clk_hw結(jié)構(gòu)體成員，用于表示該時(shí)鐘下的初始化數(shù)據(jù)，如時(shí)鐘名字name、操作函數(shù)ops等。

// include/linux/clk-provider.h
struct clk_hw{
 struct clk_core *core;
 struct clk *clk;
 const struct clk_init_data *init;
}

struct clk_init_data{
 const char *name;     //時(shí)鐘名字
 const struct clk_ops *ops;   //時(shí)鐘硬件操作函數(shù)集合
 const char *const *parent_names; //父時(shí)鐘名字
 const struct clk_parent_data *parent_data;
 const struct clk_hw **parent_hws;
 u8 num_parents;
 unsigned long flags;
}

struct clk_ops：時(shí)鐘硬件操作的函數(shù)集合，定義了操作硬件的回調(diào)函數(shù)，consumer在調(diào)用clk_set_rate()等API時(shí)會(huì)調(diào)用到struct clk_ops具體指向的函數(shù)，這個(gè)需要芯片廠商開(kāi)發(fā)clock驅(qū)動(dòng)時(shí)去實(shí)現(xiàn)。

//include/linux/clk-provider.h

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);
 int  (*save_context)(struct clk_hw *hw);
 void  (*restore_context)(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);
 int  (*get_duty_cycle)(struct clk_hw *hw,
       struct clk_duty *duty);
 int  (*set_duty_cycle)(struct clk_hw *hw,
       struct clk_duty *duty);
 int  (*init)(struct clk_hw *hw);
 void  (*terminate)(struct clk_hw *hw);
 void  (*debug_init)(struct clk_hw *hw, struct dentry *dentry);
};

struct clk_ops中每個(gè)函數(shù)功能在include/linux/clk-provider.h都有具體的說(shuō)明，在開(kāi)發(fā)clock驅(qū)動(dòng)時(shí)，這些函數(shù)并不需要全部實(shí)現(xiàn)。下面列舉幾個(gè)最常用，也是經(jīng)常需要實(shí)現(xiàn)的函數(shù)。

時(shí)鐘API的使用

對(duì)于一般的驅(qū)動(dòng)開(kāi)發(fā)（非clock驅(qū)動(dòng)），我們只需要在dts中配置時(shí)鐘，然后在驅(qū)動(dòng)調(diào)用通用的時(shí)鐘API接口即可。

1、設(shè)備樹(shù)中配置時(shí)鐘

mmc0:mmc0@0x12345678{
  compatible = "xx,xx-mmc0";
  ......
  clocks = ;//指定mmc0的時(shí)鐘來(lái)自PERI_MCI0，PERI_MCI0的父時(shí)鐘是peri
  clocks-names = "mmc0"; //時(shí)鐘名，調(diào)用devm_clk_get獲取時(shí)鐘時(shí)，可以傳入該名字
        ......
 };

以mmc的設(shè)備節(jié)點(diǎn)為例，上述mmc0指定了時(shí)鐘來(lái)自PERI_MCI0，PERI_MCI0的父時(shí)鐘是peri，并將所指定的時(shí)鐘給它命名為"mmc0"。

2、驅(qū)動(dòng)中使用API接口

簡(jiǎn)單的使用：

/* 1、獲取時(shí)鐘 */
host-?>clk = devm_clk_get(&pdev-?>dev, NULL); //或者devm_clk_get(&pdev-?>dev, "mmc0")
 if (IS_ERR(host-?>clk)) {
  dev_err(dev, "failed to find clock source\\n");
  ret = PTR_ERR(host-?>clk);
  goto probe_out_free_dev;
 }

/* 2、使能時(shí)鐘 */
ret = clk_prepare_enable(host-?>clk);
if (ret) {
 dev_err(dev, "failed to enable clock source.\\n");
 goto probe_out_free_dev;
}

probe_out_free_dev:
 kfree(host);

在驅(qū)動(dòng)中操作時(shí)鐘，第一步需要獲取struct clk指針句柄，后續(xù)都通過(guò)該指針進(jìn)行操作，例如：設(shè)置頻率：

ret = clk_set_rate(host- >clk, 300000);

獲得頻率：

ret = clk_get_rate(host- >clk);

注意：devm_clk_get()的兩個(gè)參數(shù)是二選一，可以都傳入，也可以只傳入一個(gè)參數(shù)。

像i2c、mmc等這些外設(shè)驅(qū)動(dòng)，通常只需要使能門控即可，因?yàn)檫@些外設(shè)并不是時(shí)鐘源，它們只有開(kāi)關(guān)。如果直接調(diào)用clk_ser_rate函數(shù)設(shè)置頻率，clk_set_rate會(huì)向上傳遞，即設(shè)置它的父時(shí)鐘頻率。例如在該例子中直接調(diào)用clk_set_rate函數(shù)，最終設(shè)置的是時(shí)鐘源peri的頻率。

clock驅(qū)動(dòng)實(shí)例

clock驅(qū)動(dòng)在時(shí)鐘子系統(tǒng)中屬于provider，provider是時(shí)鐘的提供者，即具體的clock驅(qū)動(dòng)。

clock驅(qū)動(dòng)在Linux剛啟動(dòng)的時(shí)候就要完成，比initcall都要早期，因此clock驅(qū)動(dòng)是在內(nèi)核中進(jìn)行實(shí)現(xiàn)。 在內(nèi)核的drivers/clk目錄下，可以看到各個(gè)芯片廠商對(duì)各自芯片clock驅(qū)動(dòng)的實(shí)現(xiàn)：

下面以一個(gè)簡(jiǎn)單的時(shí)鐘樹(shù)，舉例說(shuō)明一個(gè)芯片的時(shí)鐘驅(qū)動(dòng)的大致實(shí)現(xiàn)過(guò)程：

1、時(shí)鐘樹(shù)

通常來(lái)說(shuō)，一個(gè)芯片的時(shí)鐘樹(shù)是比較固定的，例如，以下時(shí)鐘樹(shù)：

時(shí)鐘樹(shù)的 根節(jié)點(diǎn)一般是晶振時(shí)鐘 ，上圖根節(jié)點(diǎn)為24M晶振時(shí)鐘。根節(jié)點(diǎn)下面是PLL，PLL用于提升頻率。PPL0下又分頻給PERI、DSP和ISP。PLL1分頻給DDR和ENC。

對(duì)于PLL來(lái)說(shuō)，PLL的頻率可以通過(guò)寄存器設(shè)置，但通常是固定的，所以PLL屬于 固定時(shí)鐘 。

對(duì)PERI、DSP等模塊來(lái)說(shuō)，它們的頻率來(lái)自于PLL的分頻，因此這些模塊的時(shí)鐘屬于 分頻時(shí)鐘 。

2、設(shè)備樹(shù)

設(shè)備樹(shù)中表示一個(gè)時(shí)鐘源，應(yīng)有如下屬性，例如24M晶振時(shí)鐘：

clocks{
 osc24M:osc24M{
  compatible = "fixed-clock";
  #clock-cells = 0?>;
  clock-output-name = "osc24M";
  clock-frequency = 24000000?>;
 };
};

3、驅(qū)動(dòng)實(shí)現(xiàn)

clock驅(qū)動(dòng)編寫的基本步驟：

1. 實(shí)現(xiàn)struct clk_ops相關(guān)成員函數(shù)
2. 定義分配struct clk_onecell_data結(jié)構(gòu)體，初始化相關(guān)數(shù)據(jù)
3. 定義分配struct clk_init_data結(jié)構(gòu)體，初始化相關(guān)數(shù)據(jù)
4. 調(diào)用clk_register將時(shí)鐘注冊(cè)進(jìn)框架
5. 調(diào)用clk_register_clkdev注冊(cè)時(shí)鐘設(shè)備
6. 調(diào)用of_clk_add_provider，將clk provider存放到of_clk_provider鏈表中管理
7. 調(diào)用CLK_OF_DECLARE聲明驅(qū)動(dòng)

fixed_clk固定時(shí)鐘實(shí)現(xiàn)

fixed_clk針對(duì)像PLL這種具有固定頻率的時(shí)鐘，對(duì)于PLL，我們只需要實(shí)現(xiàn).recalc_rate函數(shù)。

設(shè)備樹(shù)：

#define PLL0_CLK 0

clocks{
 osc24M:osc24M{
  compatible = "fixed-clock";
  #clock-cells = 0?>;
  clock-output-names = "osc24M";
  clock-frequency = 24000000?>;
 };
 pll0:pll0{
  compatible = "xx, choogle-fixed-clk";
  #clock-cells = 0?>;
  clock-id = ;
  clock-frequency = 1000000000?>;
  clock-output-names = "pll0";
  clocks = ;
 };
};

驅(qū)動(dòng)：

#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 

#define CLOCK_BASE 0X12340000
#define CLOCK_SIZE 0X1000

struct xx_fixed_clk{
    void __iomem *reg;//保存映射后寄存器基址
    unsigned long fixed_rate;//頻率
    int id;//clock id
    struct clk_hw*;
}；
static unsigned long xx_pll0_fixed_clk_recalc_rate(struct clk_hw *hw, unsigned long parent_rate)
{
 unsigned long recalc_rate;
 //硬件操作：查詢寄存器，獲得分頻系數(shù)，計(jì)算頻率然后返回
 return recalc_rate;
}

static struct clk_ops xx_pll0_fixed_clk_ops = {
 .recalc_rate  =   xx_pll0_fixed_clk_recalc_rate,
};

struct clk_ops *xx_fixed_clk_ops[] = {
 &xx_pll0_fixed_clk_ops,
};

struct clk * __init xx_register_fixed_clk(const char *name, const char *parent_name,
       void __iomem *res_reg, u32 fixed_rate, int id, 
       const struct clk_ops *ops)
{
 struct xx_fixed_clk *fixed_clk;
 struct clk *clk;
 struct clk_init_data init = {};

 fixed_clk = kzalloc(sizeof(*fixed_clk), GFP_KERNEL);
 if (!fixed_clk)
  return ERR_PTR(-ENOMEM);

    //初始化struct clk_init_data數(shù)據(jù)
 init.name = name;
 init.flags = CLK_IS_BASIC;
 init.parent_names = parent_name ? &parent_name : NULL;
 init.num_parents = parent_name ? 1 : 0;

 fixed_clk-?>reg = res_reg;//保存映射后的基址
 fixed_clk-?>fixed_rate = fixed_rate;//保存頻率
 fixed_clk-?>id = id;//保存clock id

 fixed_clk-?>hw.init = &init;

    //時(shí)鐘注冊(cè)
 clk = clk_register(NULL, &fixed_clk-?>hw);
 if (IS_ERR(clk))
  kfree(fixed_clk);

 return clk;
}

static void __init of_xx_fixed_clk_init(struct device_node *np)
{
 struct clk_onecell_data *clk_data;
 const char *clk_name = np-?>name;
 
 const char *parent_name = of_clk_get_parent_name(np, 0);
 void __iomem *res_reg = ioremap(CLOCK_BASE, CLOCK_SIZE);//寄存器基址映射

 u32 rate = -1;
 int clock_id, index, number;

 clk_data = kmalloc(sizeof(struct clk_onecell_data), GFP_KERNEL);
 if (!clk_data )
  return;

 number = of_property_count_u32_elems(np, "clock-id");
 clk_data-?>clks = kcalloc(number, sizeof(struct clk*), GFP_KERNEL);
 if (!clk_data-?>clks)
  goto err_free_data;

 of_property_read_u32(np, "clock-frequency", &rate);


 /**
 * 操作寄存器：初始化PLL時(shí)鐘頻率
 * ......
 */

 for (index=0; index"clock-output-names", index, &clk_name);
  of_property_read_u32_index(np, "clock-id", index, &clock_id);

  clk_data-?>clks[index] = xx_register_fixed_clk(clk_name, parent_name, 
       res_reg, rate, clock_id, ak_fixed_clk_ops[pll_id]);
  if (IS_ERR(clk_data-?>clks[index])) {
   pr_err("%s register fixed clk failed: clk_name:%s, index = %d\\n",
     __func__, clk_name, index);
   WARN_ON(true);
   continue;
  }
  clk_register_clkdev(clk_data-?>clks[index], clk_name, NULL);//注冊(cè)時(shí)鐘設(shè)備
 }

 clk_data-?>clk_num = number;
 if (number == 1) {
  of_clk_add_provider(np, of_clk_src_simple_get, clk_data-?>clks[0]);
 } else {
  of_clk_add_provider(np, of_clk_src_onecell_get, clk_data);
 }
 return;

err_free_data:
 kfree(clk_data);

}

CLK_OF_DECLARE(xx_fixed_clk, "xx,xx-fixed-clk", of_xx_fixed_clk_init);

每個(gè)芯片廠商在clock驅(qū)動(dòng)的實(shí)現(xiàn)上都有很大的差異，上述只是對(duì)clock驅(qū)動(dòng)實(shí)現(xiàn)的簡(jiǎn)單舉例，作為參考。 對(duì)于一般的驅(qū)動(dòng)，只需要會(huì)簡(jiǎn)單的使用內(nèi)核提供的時(shí)鐘API接口即可。