本文转载自:http://www.wowotech.net/pm_subsystem/pm_interface.html

1. 前言

Linux电源管理中,相当多的部分是在处理Hibernate、Suspend、Runtime PM等功能。而这些功能都基于一套相似的逻辑,即“Power management interface”。该Interface的代码实现于“include/linux/pm.h”、“drivers/base/power/main.c”等文件中。主要功能是:对下,定义Device PM相关的回调函数,让各个Driver实现;对上,实现统一的PM操作函数,供PM核心逻辑调用。

因此在对Hibernate、Suspend、Runtime PM等功能解析之前,有必要先熟悉一下PM Interface,这就是本文的主要目的。

2. device PM callbacks

在一个系统中,数量最多的是设备,耗电最多的也是设备,因此设备的电源管理是Linux电源管理的核心内容。而设备电源管理最核心的操作就是:在合适的时机(如不再使用,如暂停使用),将设备置为合理的状态(如关闭,如睡眠)。这就是device PM callbacks的目的:定义一套统一的方式,让设备在特定的时机,步调一致的进入类似的状态(可以想象一下军训时的“一二一”口令)。

在旧版本的内核中,这些PM callbacks分布在设备模型的大型数据结构中,如struct bus_type中的suspend、suspend_late、resume、resume_late,如struct device_driver/struct class/struct device_type中的suspend、resume。很显然这样不具备良好的封装特性,因为随着设备复杂度的增加,简单的suspend、resume已经不能满足电源管理的需求,就需要扩充PM callbacks,就会不可避免的改动这些数据结构。

于是新版本的内核,就将这些Callbacks统一封装为一个数据结构----struct dev_pm_ops,上层的数据结构只需要包含这个结构即可。这样如果需要增加或者修改PM callbacks,就不用改动上层结构了(这就是软件设计中抽象和封装的生动体现,像艺术一样优雅)。当然,内核为了兼容旧的设计,也保留了上述的suspend/resume类型的callbacks,只是已不建议使用,本文就不再介绍它们了。

相信每一个熟悉了旧版本内核的Linux工程师,看到struct dev_pm_ops时都会虎躯一震,这玩意也太复杂了吧!不信您请看:

: /* include/linux/pm.h, line 276 in linux-3.10.29 */
: struct dev_pm_ops {
: int (*prepare)(struct device *dev);
: void (*complete)(struct device *dev);
: int (*suspend)(struct device *dev);
: int (*resume)(struct device *dev);
: int (*freeze)(struct device *dev);
: int (*thaw)(struct device *dev);
: int (*poweroff)(struct device *dev);
: int (*restore)(struct device *dev);
: int (*suspend_late)(struct device *dev);
: int (*resume_early)(struct device *dev);
: int (*freeze_late)(struct device *dev);
: int (*thaw_early)(struct device *dev);
: int (*poweroff_late)(struct device *dev);
: int (*restore_early)(struct device *dev);
: int (*suspend_noirq)(struct device *dev);
: int (*resume_noirq)(struct device *dev);
: int (*freeze_noirq)(struct device *dev);
: int (*thaw_noirq)(struct device *dev);
: int (*poweroff_noirq)(struct device *dev);
: int (*restore_noirq)(struct device *dev);
: int (*runtime_suspend)(struct device *dev);
: int (*runtime_resume)(struct device *dev);
: int (*runtime_idle)(struct device *dev);
: };

从Linux PM Core的角度来说,这些callbacks并不复杂,因为PM Core要做的就是在特定的电源管理阶段,调用相应的callbacks,例如在suspend/resume的过程中,PM Core会依次调用“prepare—>suspend—>suspend_late—>suspend_noirq-------wakeup-

-------->resume_noirq—>resume_early—>resume-->complete”。

但由于这些callbacks需要由具体的设备Driver实现,这就要求驱动工程师在设计每个Driver时,清晰的知道这些callbacks的使用场景、是否需要实现、怎么实现,这才是struct dev_pm_ops的复杂之处。

Linux kernel对struct dev_pm_ops的注释已经非常详细了,但要弄清楚每个callback的使用场景、背后的思考,并不是一件容易的事情。因此蜗蜗不准备在本文对它们进行过多的解释,而打算结合具体的电源管理行为,基于具体的场景,再进行解释。

3. device PM callbacks在设备模型中的体现

我们在介绍“Linux设备模型”时,曾多次提及电源管理相关的内容,那时蜗蜗采取忽略的方式,暂不说明。现在是时候回过头再去看看了。

Linux设备模型中的很多数据结构,都会包含struct dev_pm_ops变量,具体如下:

: struct bus_type {
: ...
: const struct dev_pm_ops *pm;
: ...
: };
:
: struct device_driver {
: ...
: const struct dev_pm_ops *pm;
: ...
: };
:
: struct class {
: ...
: const struct dev_pm_ops *pm;
: ...
: };
:
: struct device_type {
: ...
: const struct dev_pm_ops *pm;
: };
:
: struct device {
: ...
: struct dev_pm_info power;
: struct dev_pm_domain *pm_domain;
: ...
: };

bus_type、device_driver、class、device_type等结构中的pm指针,比较容易理解,和旧的suspend/resume callbacks类似。我们重点关注一下device结构中的power和pm_domain变量。

◆power变量

power是一个struct dev_pm_info类型的变量,也在“include/linux/pm.h”中定义。从蜗蜗一直工作于的Linux-2.6.23内核,到写这篇文章所用的Linux-3.10.29内核,这个数据结构可是一路发展壮大,从那时的只有4个字段,到现在有40多个字段,简直是想起来什么就放什么啊!

power变量主要保存PM相关的状态,如当前的power_state、是否可以被唤醒、是否已经prepare完成、是否已经suspend完成等等。由于涉及的内容非常多,我们在具体使用的时候,顺便说明。

◆pm_domain指针

在当前的内核中,struct dev_pm_domain结构只包含了一个struct dev_pm_ops ops。蜗蜗猜测这是从可扩展性方面考虑的,后续随着内核的进化,可能会在该结构中添加其他内容。

所谓的PM Domain(电源域),是针对“device”来说的。bus_type、device_driver、class、device_type等结构,本质上代表的是设备驱动,电源管理的操作,由设备驱动负责,是理所应当的。但在内核中,由于各种原因,是允许没有driver的device存在的,那么怎么处理这些设备的电源管理呢?就是通过设备的电源域实现的。

4. device PM callbacks的操作函数

内核在定义device PM callbacks数据结构的同时,为了方便使用该数据结构,也定义了大量的操作API,这些API分为两类。

◆通用的辅助性质的API,直接调用指定设备所绑定的driver的、pm指针的、相应的callback,如下

 : extern int pm_generic_prepare(struct device *dev);
: extern int pm_generic_suspend_late(struct device *dev);
: extern int pm_generic_suspend_noirq(struct device *dev);
: extern int pm_generic_suspend(struct device *dev);
: extern int pm_generic_resume_early(struct device *dev);
: extern int pm_generic_resume_noirq(struct device *dev);
: extern int pm_generic_resume(struct device *dev);
: extern int pm_generic_freeze_noirq(struct device *dev);
: extern int pm_generic_freeze_late(struct device *dev);
: extern int pm_generic_freeze(struct device *dev);
: extern int pm_generic_thaw_noirq(struct device *dev);
: extern int pm_generic_thaw_early(struct device *dev);
: extern int pm_generic_thaw(struct device *dev);
: extern int pm_generic_restore_noirq(struct device *dev);
: extern int pm_generic_restore_early(struct device *dev);
: extern int pm_generic_restore(struct device *dev);
: extern int pm_generic_poweroff_noirq(struct device *dev);
: extern int pm_generic_poweroff_late(struct device *dev);
: extern int pm_generic_poweroff(struct device *dev);
: extern void pm_generic_complete(struct device *dev);

以pm_generic_prepare为例,就是查看dev->driver->pm->prepare接口是否存在,如果存在,直接调用并返回结果。

◆和整体电源管理行为相关的API,目的是将各个独立的电源管理行为组合起来,组成一个较为简单的功能,如下

 : #ifdef CONFIG_PM_SLEEP
: extern void device_pm_lock(void);
: extern void dpm_resume_start(pm_message_t state);
: extern void dpm_resume_end(pm_message_t state);
: extern void dpm_resume(pm_message_t state);
: extern void dpm_complete(pm_message_t state);
:
: extern void device_pm_unlock(void);
: extern int dpm_suspend_end(pm_message_t state);
: extern int dpm_suspend_start(pm_message_t state);
: extern int dpm_suspend(pm_message_t state);
: extern int dpm_prepare(pm_message_t state);
:
: extern void __suspend_report_result(const char *function, void *fn, int ret);
:
: #define suspend_report_result(fn, ret) \
: do { \
: __suspend_report_result(__func__, fn, ret); \
: } while ()
:
: extern int device_pm_wait_for_dev(struct device *sub, struct device *dev);
: extern void dpm_for_each_dev(void *data, void (*fn)(struct device *, void *));

这些API的功能和动作解析如下。

dpm_prepare,执行所有设备的“->prepare() callback(s)”,内部动作为:

)遍历dpm_list,依次取出挂在该list中的device指针。
【注1:设备模型在添加设备(device_add)时,会调用device_pm_add接口,将该设备添加到全局链表dpm_list中,以方便后续的遍历操作。】
)调用内部接口device_prepare,执行实际的prepare动作。该接口会返回执行的结果。
)如果执行失败,打印错误信息。
)如果执行成功,将dev->power.is_prepared(就是上面我们提到的struct dev_pm_info类型的变量)设为TRUE,表示设备已经prepared了。同时,将该设备添加到dpm_prepared_list中(该链表保存了所有已经处于prepared状态的设备)。 内部接口device_prepare的执行动作为:
)根据dev->power.syscore,断该设备是否为syscore设备。如果是,则直接返回(因为syscore设备会单独处理)。
)在prepare时期,调用pm_runtime_get_noresume接口,关闭Runtime suspend功能。以避免由Runtime suspend造成的不能正常唤醒的Issue。该功能会在complete时被重新开启。
【注2:pm_runtime_get_noresume的实现很简单,就是增加该设备power变量的引用计数(dev->power.usage_count),Runtime PM会根据该计数是否大于零,判断是否开启Runtime PM功能。】
)调用device_may_wakeup接口,根据当前设备是否有wakeup source(dev->power.wakeup)以及是否允许wakeup(dev->power.can_wakeup),判定该设备是否是一个wakeup path(记录在dev->power.wakeup_path中)。
【注3:设备的wake up功能,是指系统在低功耗状态下(如suspend、hibernate),某些设备具备唤醒系统的功能。这是电源管理过程的一部分。】
)根据优先顺序,获得用于prepare的callback函数。由于设备模型有bus、driver、device等多个层级,而prepare接口可能由任意一个层级实现。这里的优先顺序是指,只要优先级高的层级注册了prepare,就会优先使用它,而不会使用优先级低的prepare。
优先顺序为:dev->pm_domain->ops、dev->type->pm、dev->class->pm、dev->bus->pm、dev->driver->pm(这个优先顺序同样适用于其它callbacks)。
)如果得到有限的prepare函数,调用并返回结果。

dpm_suspend,执行所有设备的“->suspend() callback(s)”,其内部动作和dpm_prepare类似:

)遍历dpm_list,依次取出挂在该list中的device指针。
)调用内部接口device_suspend,执行实际的prepare动作。该接口会返回执行的结果。
)如果suspend失败,将该设备的信息记录在一个struct suspend_stats类型的数组中,并打印错误错误信息。
)最后将设备从其它链表(如dpm_prepared_list),转移到dpm_suspended_list链表中。
内部接口device_suspend的动作和device_prepare类似,这里不再描述了。

dpm_suspend_start,依次执行dpm_prepare和dpm_suspend两个动作。

dpm_suspend_end,依次执行所有设备的“->suspend_late() callback(s)”以及所有设备的“->suspend_noirq() callback(s)”。动作和上面描述的类似,这里不再说明了。

dpm_resume、dpm_complete、dpm_resume_start、dpm_resume_end,是电源管理过程的唤醒动作,和dpm_suspend_xxx系列的接口类似。不再说明了。

Linux电源管理(4)-Power Manager Interface【转】的更多相关文章

  1. linux电源管理系列(一)

    本系列将逐步介绍linux电源管理相关的知识,涉及到常见电源管理机制.linux电源管理机制.linux驱动中有关电源管理的相关接口.内核文档中关于Linux电源管理架构文档的分析.以下将以此来介绍相 ...

  2. Linux电源管理(9)_wakelocks【转】

    1. 前言 wakelocks是一个有故事的功能. wakelocks最初出现在Android为linux kernel打的一个补丁集上,该补丁集实现了一个名称为"wakelocks&quo ...

  3. Linux电源管理(7)_Wakeup events framework【转】

    转自:http://www.wowotech.net/pm_subsystem/wakeup_events_framework.html 1.  前言 本文继续“Linux电源管理(6)_Generi ...

  4. Linux电源管理_autosleep--(五)【转】

    本文转载自:https://blog.csdn.net/wlsfling/article/details/46005409 1. 前言 Autosleep也是从Android wakelocks补丁集 ...

  5. Linux电源管理(2)-Generic PM基本概念和软件架构【转】

    本文转载自:http://www.wowotech.net/pm_subsystem/generic_pm_architecture.html 1. 前言 这里的Generic PM,是蜗蜗自己起的名 ...

  6. Linux电源管理(1)-整体架构【转】

    本文转载自:http://www.wowotech.net/pm_subsystem/pm_architecture.html 1. 前言 在这个世界中,任何系统的运转都需要能量.如树木依靠光能生长, ...

  7. Linux电源管理(5)_Hibernate和Sleep功能介绍【转】

    本文转载自:http://www.wowotech.net/pm_subsystem/std_str_func.html 1. 前言 Hibernate和Sleep两个功能是Linux Generic ...

  8. Linux电源管理(7)_Wakeup events framework

    1. 前言 本文继续"Linux电源管理(6)_Generic PM之Suspend功能"中有关suspend同步以及PM wakeup的话题.这个话题,是近几年Linux ker ...

  9. ARM linux电源管理——Cortex A系列CPU(32位)睡眠和唤醒的底层汇编实现

    ARM linux电源管理——Cortex A系列CPU(32位)睡眠和唤醒的底层汇编实现 承接 http://www.wowotech.net/pm_subsystem/suspend_and_re ...

随机推荐

  1. IOS开发准备 资料集锦

    1 http://blog.csdn.net/column/details/xfzl-kykhd.html 2

  2. Python---copy()、deepcopy()与赋值的区别

    copy()与deepcopy()之间的主要区别是python对数据的存储方式. 首先直接上结论: —–深复制,即将被复制对象完全再复制一遍作为独立的新个体单独存在.所以改变原有被复制对象不会对已经复 ...

  3. linux内核参数分析

    这是原来在51cto写的,现在都转到博客园来了 1.time_wait连接数过多,需要调整内核参数 http://blog.renhao.org/2010/07/setup-linux-kernel- ...

  4. CSS 温故而知新 断句失败

    设置了一定的宽度和高度.但无论是下面哪句都无效. word-break: break-word; word-wrap: break-word; 原因竟然是因为 /* white-space: nowr ...

  5. 为php添加pcntl扩展,多线程

    前言: pcntl 介绍 pcntl扩展可以支持 PHP 的多线程操作.(非Unix类系统不支持此模块) phpize 介绍 phpize 可以用来给 PHP 动态的添加扩展.比如编译 PHP 时忘记 ...

  6. [译]GLUT教程 - 笔划字体

    Lighthouse3d.com >> GLUT Tutorial >> Fonts >> Stroke Fonts 笔划字体是用线条生成的.跟位图字体相反,笔划字 ...

  7. PHP性能:序——谈ab(Apache Bench)压力测试工具

    PHP性能:序——谈ab(Apache Bench)压力测试工具 ab(Apache  Bench)是啥? ab是Apache自带的一个压力测试软件,可以通过ab命令和选项对某个URL进行压力测试.a ...

  8. 【转】【Mac系统】之Python版本切换、谷歌浏览器取消自动升级

    都是很有用的文章,本文都是转载文章,以便后续查阅: Mac Chrome浏览器取消自动升级(看这一篇就够了) <Mac修改默认python版本> <mac设置python版本切换,和 ...

  9. Android ijkplayer 强大的视频播放器框架教程 -- 导入demo运行(一)

    首先介绍下这个开源项目,这个开源项目是BiliBli 开源的,首先感谢他们的团队. 这是开源的地址: https://github.com/Bilibili/ijkplayer 首先我为什么要选这个, ...

  10. ubuntu 查看服务列表

    查看服务列表代码 sudo service --status-allsudo initctl list from: http://zhidao.baidu.com/link?url=hLMXGocC2 ...