嵌入式Linux驱动笔记(十四)------详解clock时钟(CCF)框架及clk_get函数

你好!这里是风筝的博客,

欢迎和我一起交流。

我在找资料的时候,发现网上大部分文章都是说:
在s3c244x_init_clocks函数里:

void __init s3c244x_init_clocks(int xtal)
{
    s3c24xx_register_baseclocks(xtal); //完成祖宗级别时钟的注册  
    s3c244x_setup_clocks();//填充祖宗级别时钟结构,方便以后调用
    s3c2410_baseclk_add();//添加一些外设时钟结构到list中,并且关闭它们方便省电
}

可是我在我的kernel4.8.17里面,
已经没有了s3c24xx_register_baseclocks函数,
没有了s3c244x_setup_clocks函数,
没有了s3c2410_baseclk_add函数,,,,,,
而且arch\arm\plat-samsung\目录下也没用了clock.c文件…………

好像说是从Linux3.10内核开始就没有了吧,然后正式的使用CCF(Common Clock Framewrok)框架了。

在以前Clock部分,虽然也提供了相应的API根据名字去获取Clock,设置频率,获取父时钟,设置父时钟的函数,但是这些API都是由每个SoC单独实现,导致了代码的差异很大,于是就引入了一个新的通用的时钟框架来解决这个问题。由TI的工程师Mike Turquette提供了Common Clock Framewrok,让具体SoC实现clk_ops成员函数并通过clk_register、clk_register_clkdev注册时钟源以及源与设备对应关系,具体的clock驱动都统一迁移到drivers/clk目录。因此现在的时钟框架就采用CCF方式,使用CCF前提是内核配置了CONFIG_COMMON_CLK。

所以,以kernel4.8.17为例,我们重新看下clock注册部分,分析它的框架:
在mach-smdk2440.c文件里,调用关系为:

smdk2440_init_time
    ->s3c2440_init_clocks(12000000)
        ->s3c2410_common_clk_init(NULL, xtal, 1, S3C24XX_VA_CLKPWR)

看下s3c2410_common_clk_init函数,重点分析:

void __init s3c2410_common_clk_init(struct device_node *np, unsigned long xti_f,
                    int current_soc,
                    void __iomem *base)
{
    struct samsung_clk_provider *ctx;
    reg_base = base;

    if (np) {
        reg_base = of_iomap(np, 0);
        if (!reg_base)
            panic("%s: failed to map registers\n", __func__);
    }

    ctx = samsung_clk_init(np, reg_base, NR_CLKS);

    /* Register external clocks only in non-dt cases */
    if (!np)
        s3c2410_common_clk_register_fixed_ext(ctx, xti_f);

    if (current_soc == S3C2410) {
        if (_get_rate("xti") == 12 * MHZ) {
            s3c2410_plls[mpll].rate_table = pll_s3c2410_12mhz_tbl;
            s3c2410_plls[upll].rate_table = pll_s3c2410_12mhz_tbl;
        }

        /* Register PLLs. */
        samsung_clk_register_pll(ctx, s3c2410_plls,
                ARRAY_SIZE(s3c2410_plls), reg_base);//专门用于锁相环的注册

    } else { /* S3C2440, S3C2442 */
        if (_get_rate("xti") == 12 * MHZ) {
            /*
             * plls follow different calculation schemes, with the
             * upll following the same scheme as the s3c2410 plls
             */
            s3c244x_common_plls[mpll].rate_table =
                            pll_s3c244x_12mhz_tbl;
            s3c244x_common_plls[upll].rate_table =
                            pll_s3c2410_12mhz_tbl;
        }

        /* Register PLLs. */
        samsung_clk_register_pll(ctx, s3c244x_common_plls,
                ARRAY_SIZE(s3c244x_common_plls), reg_base);
    }

    /* Register common internal clocks. */
    samsung_clk_register_mux(ctx, s3c2410_common_muxes,
            ARRAY_SIZE(s3c2410_common_muxes));
    samsung_clk_register_div(ctx, s3c2410_common_dividers,
            ARRAY_SIZE(s3c2410_common_dividers));
    samsung_clk_register_gate(ctx, s3c2410_common_gates,
        ARRAY_SIZE(s3c2410_common_gates));

    if (current_soc == S3C2440 || current_soc == S3C2442) {
        samsung_clk_register_div(ctx, s3c244x_common_dividers,
                ARRAY_SIZE(s3c244x_common_dividers));
        samsung_clk_register_gate(ctx, s3c244x_common_gates,
                ARRAY_SIZE(s3c244x_common_gates));
        samsung_clk_register_mux(ctx, s3c244x_common_muxes,
                ARRAY_SIZE(s3c244x_common_muxes));
        samsung_clk_register_fixed_factor(ctx, s3c244x_common_ffactor,
                ARRAY_SIZE(s3c244x_common_ffactor));
    }

    /* Register SoC-specific clocks. */
    switch (current_soc) {
    case S3C2410:
        samsung_clk_register_div(ctx, s3c2410_dividers,
                ARRAY_SIZE(s3c2410_dividers));
        samsung_clk_register_fixed_factor(ctx, s3c2410_ffactor,
                ARRAY_SIZE(s3c2410_ffactor));
        samsung_clk_register_alias(ctx, s3c2410_aliases,
            ARRAY_SIZE(s3c2410_aliases));
        break;
    case S3C2440:
        samsung_clk_register_mux(ctx, s3c2440_muxes,
                ARRAY_SIZE(s3c2440_muxes));
        samsung_clk_register_gate(ctx, s3c2440_gates,
                ARRAY_SIZE(s3c2440_gates));
        break;
    case S3C2442:
        samsung_clk_register_mux(ctx, s3c2442_muxes,
                ARRAY_SIZE(s3c2442_muxes));
        samsung_clk_register_fixed_factor(ctx, s3c2442_ffactor,
                ARRAY_SIZE(s3c2442_ffactor));
        break;
    }

    /*
     * Register common aliases at the end, as some of the aliased clocks
     * are SoC specific.
     */
    samsung_clk_register_alias(ctx, s3c2410_common_aliases,
        ARRAY_SIZE(s3c2410_common_aliases));

    if (current_soc == S3C2440 || current_soc == S3C2442) {
        samsung_clk_register_alias(ctx, s3c244x_common_aliases,
            ARRAY_SIZE(s3c244x_common_aliases));
    }

    s3c2410_clk_sleep_init();

    samsung_clk_of_add_provider(np, ctx);
}

这里我们传入的参数np为NULL,xti_f为12000000,current_soc为1。
进入这个函数,分析:
第8行:条件不成立。
第14行:初始化时钟,主要就是给ctx分配空间和填充一些数据,如寄存器基地址。
第18行:注册通用的外部固定时钟,调用关系为:

s3c2410_common_clk_register_fixed_ext
    ->samsung_clk_register_fixed_rate
        ->clk_register_fixed_rate
            ->clk_register_fixed_rate_with_accuracy[注1]
                ->clk_hw_register_fixed_rate_with_accuracy
                    ->clk_hw_register
                        ->clk_register[注2]
        ->clk_register_clkdev
            ->__clk_register_clkdev
                ->vclkdev_create
                    ->__clkdev_add[注3]
    ->samsung_clk_register_alias[注4]
        ->clk_register_clkdev

[注1]:在clk_hw_register_fixed_rate_with_accuracy主要就是设置一些参数,如name、flags、parent_names、num_parents之类的。
[注2]:在clk_register函数里就会初始化core->clks哈希链表,创建一个hw->clk链接到core->clks上,并将hw->clk返回到clk_register_fixed_rate函数上,注意,hw->clk有两个要注意的成员变量:dev_id(device ID)和con_id(connection ID)。
[注3]:在__clkdev_add函数里就会:list_add_tail(&cl->node, &clocks);
将cl->node链接到clocks,注意,cl上同样有dev_id和con_id,同时注意clocks这个链表!
[注4]:在samsung_clk_register_alias函数,注册时钟的别名(比如别名spi,他是挂在PCLK上),同样调用到clk_register_clkdev,最终进入[注3],将list->alias作为con_id,链接到clocks上。

继续:
第20行:我们current_soc为1,S3C2410为0,if不成立。
第43行:专门用于锁相环的注册。
第48~52行:
samsung_clk_register_mux:时钟选择
samsung_clk_register_div:时钟分频
samsung_clk_register_gate:时钟门控,注册的时钟只可以开关,通过.enable/.disable回调

其实这些函数都大同小异,我们以samsung_clk_register_gate来看:
samsung_clk_register_gate(ctx, s3c2410_common_gates , ARRAY_SIZE(s3c2410_common_gates));
看下s3c2410_common_gates数组:

struct samsung_gate_clock s3c2410_common_gates[] __initdata = {
    GATE(PCLK_SPI, "spi", "pclk", CLKCON, 18, 0, 0),
    GATE(PCLK_I2S, "i2s", "pclk", CLKCON, 17, 0, 0),
    GATE(PCLK_I2C, "i2c", "pclk", CLKCON, 16, 0, 0),
    GATE(PCLK_ADC, "adc", "pclk", CLKCON, 15, 0, 0),
    GATE(PCLK_RTC, "rtc", "pclk", CLKCON, 14, 0, 0),
    GATE(PCLK_GPIO, "gpio", "pclk", CLKCON, 13, CLK_IGNORE_UNUSED, 0),
    GATE(PCLK_UART2, "uart2", "pclk", CLKCON, 12, 0, 0),
    GATE(PCLK_UART1, "uart1", "pclk", CLKCON, 11, 0, 0),
    GATE(PCLK_UART0, "uart0", "pclk", CLKCON, 10, 0, 0),
    GATE(PCLK_SDI, "sdi", "pclk", CLKCON, 9, 0, 0),
    GATE(PCLK_PWM, "pwm", "pclk", CLKCON, 8, 0, 0),
    GATE(HCLK_USBD, "usb-device", "hclk", CLKCON, 7, 0, 0),
    GATE(HCLK_USBH, "usb-host", "hclk", CLKCON, 6, 0, 0),
    GATE(HCLK_LCD, "lcd", "hclk", CLKCON, 5, 0, 0),
    GATE(HCLK_NAND, "nand", "hclk", CLKCON, 4, 0, 0),
};//格式:id、name、parent_name、offset、bit_idx、flags、gate_flags

这些就是注册的时钟源了。
samsung_clk_register_gate函数的调用关系如下:

samsung_clk_register_gate
    ->clk_register_gate
        ->clk_hw_register_gate[注5]
            ->clk_hw_register
                ->clk_register[注2]

[注5]:在clk_hw_register_gate函数,同样是设置一些参数,如name、flags、parent_names、num_parents之类的以及填充:init.ops = &clk_gate_ops。

const struct clk_ops clk_gate_ops = {
    .enable = clk_gate_enable,
    .disable = clk_gate_disable,
    .is_enabled = clk_gate_is_enabled,
};

这里就是填充回调函数了,在clk_enable/clk_disable时会调用到。
[注2]:在上面提到过。

继续:
第56~62行:
因为2440和2410是相似的,这是在2410的基础上对2440进行补充。
第94行:注册时钟别名,这就比较重要了:
samsung_clk_register_alias(ctx, s3c2410_common_aliases , ARRAY_SIZE(s3c2410_common_aliases));
看下s3c2410_common_aliases数组:

struct samsung_clock_alias s3c2410_common_aliases[] __initdata = {
    ALIAS(PCLK_I2C, "s3c2410-i2c.0", "i2c"),
    ALIAS(PCLK_ADC, NULL, "adc"),
    ALIAS(PCLK_RTC, NULL, "rtc"),
    ALIAS(PCLK_PWM, NULL, "timers"),
    ALIAS(HCLK_LCD, NULL, "lcd"),
    ALIAS(HCLK_USBD, NULL, "usb-device"),
    ALIAS(HCLK_USBH, NULL, "usb-host"),
    ALIAS(UCLK, NULL, "usb-bus-host"),
    ALIAS(UCLK, NULL, "usb-bus-gadget"),
    ALIAS(ARMCLK, NULL, "armclk"),
    ALIAS(UCLK, NULL, "uclk"),
    ALIAS(HCLK, NULL, "hclk"),
    ALIAS(MPLL, NULL, "mpll"),
    ALIAS(FCLK, NULL, "fclk"),
    ALIAS(PCLK, NULL, "watchdog"),
    ALIAS(PCLK_SDI, NULL, "sdi"),
    ALIAS(HCLK_NAND, NULL, "nand"),
    ALIAS(PCLK_I2S, NULL, "iis"),
    ALIAS(PCLK_I2C, NULL, "i2c"),
};//格式:id、dev_name、alias

samsung_clk_register_alias函数在之前[注4]说过,就是将con_id(这里即是alias)链接到clocks上

好了,到这就分析结束了,那我们怎么获取时钟呢?

当然是非常大众化的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) {
        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);
}

通常来说,第一个参数设置为NULL即可。
__of_clk_get_by_name是关于dts设备树的API。
进入clk_get_sys函数看看:

struct clk *clk_get_sys(const char *dev_id, const char *con_id)
{
    struct clk_lookup *cl;
    struct clk *clk = NULL;

    mutex_lock(&clocks_mutex);

    cl = clk_find(dev_id, con_id);
    if (!cl)
        goto out;

    clk = __clk_create_clk(cl->clk_hw, dev_id, con_id);
    if (IS_ERR(clk))
        goto out;

    if (!__clk_get(clk)) {
        __clk_free_clk(clk);
        cl = NULL;
        goto out;
    }

out:
    mutex_unlock(&clocks_mutex);

    return cl ? clk : ERR_PTR(-ENOENT);
}

这里有两个函数:clk_find和__clk_create_clk
看下clk_find函数:

static struct clk_lookup *clk_find(const char *dev_id, const char *con_id)
{
    struct clk_lookup *p, *cl = NULL;
    int match, best_found = 0, best_possible = 0;

    if (dev_id)
        best_possible += 2;
    if (con_id)
        best_possible += 1;

    list_for_each_entry(p, &clocks, node) {
        match = 0;
        if (p->dev_id) {
            if (!dev_id || strcmp(p->dev_id, dev_id))
                continue;
            match += 2;
        }
        if (p->con_id) {
            if (!con_id || strcmp(p->con_id, con_id))
                continue;
            match += 1;
        }

        if (match > best_found) {
            cl = p;
            if (match != best_possible)
                best_found = match;
            else
                break;
        }
    }
    return cl;
}

里面的list_for_each_entry就是遍历clocks这条链表
可以看下这篇:Linux下链表的使用及探究
然后比较clocks这条链表上的名字和dev_id以及con_id,如果dev_id匹配,那么match+=2,如果con_id匹配,那么match+=1,当match > best_found说明找到了这个clock的结构体,当然,找到了并不意味着最优解,当match == best_possible才是最完美的情况。
这里可以看出:匹配的优先程度是:dev+con > dev only > con only
之后这个clock结构体会给与到__clk_create_clk函数使用:

struct clk *__clk_create_clk(struct clk_hw *hw, const char *dev_id,
                 const char *con_id)
{
    struct clk *clk;

    /* This is to allow this function to be chained to others */
    if (IS_ERR_OR_NULL(hw))
        return (struct clk *) hw;

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

    clk->core = hw->core;
    clk->dev_id = dev_id;
    clk->con_id = con_id;
    clk->max_rate = ULONG_MAX;

    clk_prepare_lock();
    hlist_add_head(&clk->clks_node, &hw->core->clks);
    clk_prepare_unlock();

    return clk;
}

将之添加到哈希表上进行管理。

最后看下得到clk结构体后是怎么使能时钟的:clk_enable函数:
调用关系为:

clk_enable
    ->clk_core_enable_lock
        ->clk_core_enable   
static int clk_core_enable(struct clk_core *core)
{
    int ret = 0;

    lockdep_assert_held(&enable_lock);

    if (!core)
        return 0;

    if (WARN_ON(core->prepare_count == 0))
        return -ESHUTDOWN;

    if (core->enable_count == 0) {
        ret = clk_core_enable(core->parent);

        if (ret)
            return ret;

        trace_clk_enable_rcuidle(core);

        if (core->ops->enable)
            ret = core->ops->enable(core->hw);

        trace_clk_enable_complete_rcuidle(core);

        if (ret) {
            clk_core_disable(core->parent);
            return ret;
        }
    }

    core->enable_count++;
    return 0;
}

在里面,一开始先判断core的有效性, 然后继续调用自己进行进行递归处理,传入的参数为core->parent,要知道,使能一个设备的clock,一定要保定它父设备的clock是使能的。
之后就掉调用core->ops->enable回调函数进行使能了!

最后的最后,给出一些API函数:
struct clk *__clk_lookup(const char *name) 通过时钟名找到时钟
static inline int clk_enable(struct clk *clk) 使能时钟,不会睡眠
static inline void clk_disable(struct clk *clk) 禁止时钟,不会睡眠
static inline int clk_prepare_enable(struct clk *clk) 使能时钟,可能会睡眠
static inline void clk_disable_unprepare(struct clk *clk) 禁止时钟,可能会睡眠
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) 获取最接近的时钟频率
static inline int clk_set_parent(struct clk *clk, struct clk *parent) 设置时钟的父时钟
static inline struct clk *clk_get_parent(struct clk *clk) 获取时钟的父时钟

  • 7
    点赞
  • 22
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值