目录
一、引言
二、电源管理
------> 2.1、电源管理的两种模型
三、系统Suspend
------> 3.1、系统睡眠模型Suspend
------> 3.2、开启suspend
------> 3.3、驱动支持Suspend
四、runtime
------> 4.1、runtime_PM 框架
------> 4.2、使用Runtime功能
------> 4.3、驱动支持Suspend
------> 4.4、实例
------> 4.5、异步（ASYNC）和同步（SYNC）
一、引言
这篇文件简单的来介绍一下linux下的电源管理框架-PM
二、电源管理
1、电源管理的两种模型
以往接触的Linux驱动，没遇到使用电池供电的情况，因此几乎没关注电源的管理。
然而实际中，不少使用电池供电的硬件平台，例如手机、POS机等，就需要对电源进行管理，比如在不使用设备的时候，休眠屏幕省电。
Linux电源管理模型有两种：系统睡眠模型suspend和Runtime电源管理模型。
三、系统Suspend
1、系统睡眠模型Suspend
| 名称 | 含义 |
|---|---|
| On (on) | S0 - Working |
| Standby (standby） | S1 - CPU and RAM are powered but not executed |
| Suspend to RAM (mem) | S3 - RAM is powered and the running content is saved to RAM |
| Suspend to Disk, Hibernation (disk) | S4 - All content is saved to Disk and power down |
其中
S3 aka STR(suspend to ram),挂起到内存，简称待机。计算机将目前的运行状态等数据存放在内存，关闭硬盘、外设等设备，进入等待状态。此时内存仍然需要电力维持其数据，但整机耗电很少。恢复时计算机从内存读出数据，回到挂起前的状态，恢复速度较快。对DDR的耗电情况进行优化是S3性能的关键，大多数手持设备都是用S3待机。
S4 aka STD(suspend to disk),挂起到硬盘，简称休眠。把运行状态等数据存放在硬盘上某个文件或者某个特定的区域，关闭硬盘、外设等设备，进入关机状态。此时计算机完全关闭，不耗电。恢复时计算机从休眠文件/分区中读出数据，回到休眠前的状态，恢复速度较慢。
系统休眠模型给我的感觉是以整机角度进行省电。
S3类似电脑的睡眠，在教长时间不使用电脑后，电脑黑屏，再次敲击键盘迅速显示桌面，原来的工作内容仍不变。
S4类似电脑的休眠，在长时间不使用电脑后，电脑黑屏，再次敲击键盘无反应，按下电源键，开机，原来的工作内容仍不变。
对于嵌入式设备，更多的是使用S3，将数据暂时放在内存里，以实现快速恢复，就像手机的电源键按下黑屏，再次按下迅速亮屏。
在Linux中，通过cat /sys/power/state可以得知当前设备支持的节能模式，一般情况有如下选项：
standby:前面的S1状态，CPU处于浅睡眠模式，主要针对CPU功耗；
mem:前面的S3状态，Suspend to RAM；
disk:前面的S4状态，Suspend to Disk；
需要设置以上模式，只需echo mem > /sys/power/state即可。下面来用我们的虚拟机试验一下
~$ cat /sys/power/state
freeze standby mem disk
echo standby > /sys/power/state //进入待机
echo mem > /sys/power/state //进入待机
echo disk > /sys/power/state //进入休眠
睡眠可能有两种方式：mem和standby，这两种方式都是suspend to RAM，简称STR，只是standby耗电更多一些，返回到正常工作方式时间更短一些而已。
2、开启suspend
首先将suspend功能加入内核：
Power management options --->
[*] Suspend to RAM and standby
设置唤醒源
要进入休眠，必须要有唤醒源，没有唤醒源，休眠也没有意义，唤醒源最常见的就是按键中断，就如同手机进入锁屏状态下，按下电源键唤醒一样
3、驱动支持Suspend
电源管理是在冻结APP之后和重启APP之前对驱动的电源进行控制
需要suspend和resume来实现
a.在platform_driver里的driver里添加pm结构体:
static struct platform_driver lcd_driver =
{
.driver = {
.name = "lcd_s702",
.pm = &lcd_pm,
.of_match_table = of_match_ptr(lcd_dt_ids),
},
.probe = lcd_probe,
.remove = lcd_remove,
};
其中pm支持的操作接口有如下
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);
};
b.设置pm成员函数：
static struct dev_pm_ops lcd_pm = {
.suspend = s702_lcd_suspend,
.resume = s702_lcd_resume,
};
c.编写成员函数:
这个根据需求来编写了
随便来看一个内核中驱动的例子
static int gmux_suspend(struct device *dev)
{
struct pnp_dev *pnp = to_pnp_dev(dev);
struct apple_gmux_data *gmux_data = pnp_get_drvdata(pnp);
gmux_data->resume_client_id = gmux_active_client(gmux_data);
gmux_disable_interrupts(gmux_data);
return 0;
}
static int gmux_resume(struct device *dev)
{
struct pnp_dev *pnp = to_pnp_dev(dev);
struct apple_gmux_data *gmux_data = pnp_get_drvdata(pnp);
gmux_enable_interrupts(gmux_data);
gmux_switchto(gmux_data->resume_client_id);
if (gmux_data->power_state == VGA_SWITCHEROO_OFF)
gmux_set_discrete_state(gmux_data, gmux_data->power_state);
return 0;
}
static const struct dev_pm_ops gmux_dev_pm_ops = {
.suspend = gmux_suspend,
.resume = gmux_resume,
};
static struct pnp_driver gmux_pnp_driver = {
.name = "apple-gmux",
.probe = gmux_probe,
.remove = gmux_remove,
.id_table = gmux_device_ids,
.driver = {
.pm = &gmux_dev_pm_ops,
},
};
可以看到，在suspend和resume中有开关中断等操作
如果驱动中没有填充pm结构体，则该设备在系统休眠或恢复时无法正确保存和恢复其状态。这可能导致设备在恢复后无法正常工作，出现功能失常或完全不可用的情况
四、runtime
1、runtime_PM 框架
前面的suspend系统睡眠模型是将整个系统进行休眠，但如果需要在系统运行时，单独对某个模块进行休眠 ，就需要Runtime电源管理模型，这两个模型互相协作，才能最大的发挥电源管理的效果。
Runtime电源管理模型的原理比较简单，就是计数，
当该设备驱动被使用时就加1，放弃使用时就减1，
计数大于1时，就打开该设备的电源，等于0时就关闭电源。调用我们注册的回调函数
Runtime PM相关的函数：
a. 使能/禁止 Runtime PM：pm_runtime_enable / pm_runtime_disable (修改disable_depth变量)，这个变量的初始化值是1，默认是disable的状态
b. 增加计数/减少计数：pm_runtime_get_sync / pm_runtime_put_sync (修改usage_count变量)，并判断是否进入suspend/resume
c. 回调函数 暂停/恢复/空闲：runtime_suspend / runtime_resume / runtime_idle
上面4个函数不会直接导致runtime_suspend，runtime_resume，runtime_idle被调用，只是使能和修改计数值，当引用计数减为0，调用suspend,从0变为大于0调用resume。
对于runtime PM，默认状态下设备的状态是suspend，如果硬件上它是运行状态，需要调用pm_runtime_set_active()来修改它的状态，然后调用pm_runtime_enable()来使能runtime PM。一般是在probe()的结尾处使用，以为它可能导致runtime的suspend/resume函数立即调用。一般在驱动remove中调用pm_runtime_disable()
在open()/release()接口中可以调用pm_runtime_get_sync/pm_runtime_put_sync
2、使用Runtime功能
调用方式一：
驱动程序提供接口, APP来调用。
在驱动函数的open()、close()里，增加和减少引用计数。
APP调用驱动的时候就能相应的恢复、暂停设备。
调用方式二：
直接操作应用层文件：
恢复：
echo on > /sys/devices/.../power/control
暂停：
echo auto > /sys/devices/.../power/control
3、使驱动支持Runtime
a.在platform_driver里的driver里添加pm结构体:(和前面的一样，这里就无需操作)
static struct platform_driver lcd_driver =
{
.driver = {
.name = "lcd_s702",
.pm = &lcd_pm,
.of_match_table = of_match_ptr(lcd_dt_ids),
},
.probe = lcd_probe,
.remove = lcd_remove,
};
b.设置pm成员函数：
static struct dev_pm_ops lcd_pm =
{
.suspend = s702_lcd_suspend,
.resume = s702_lcd_resume,
.runtime_suspend = s702_lcd_suspend,
.runtime_resume = s702_lcd_resume,
};
c.编写成员函数:也是根据需求来
d.使能Runtime:
对于Runtime PM,默认状态下设备的状态是Suspended,
如果硬件上它是运行状态,需要调用pm_runtime_set_active()来修改它的状态,
然后调用pm_runtime_enable()来使能Runtime PM。
在probe()函数的后面添加：
pm_runtime_set_active(&pdev->dev);
pm_runtime_enable(&pdev->dev);
反之，还要在remove()里禁止：
pm_runtime_disable(&pdev->dev);
e.修改计数:
一般在open()和release()里面增加和减少引用计数：
4、实例
1、定义
static const struct dev_pm_ops rtl8169_pm_ops = {
.suspend = rtl8169_suspend,
.resume = rtl8169_resume,
.freeze = rtl8169_suspend,
.thaw = rtl8169_resume,
.poweroff = rtl8169_suspend,
.restore = rtl8169_resume,
.runtime_suspend = rtl8169_runtime_suspend,
.runtime_resume = rtl8169_runtime_resume,
.runtime_idle = rtl8169_runtime_idle,
};
#define RTL8169_PM_OPS (&rtl8169_pm_ops)
static struct pci_driver rtl8169_pci_driver = {
.name = MODULENAME,
.id_table = rtl8169_pci_tbl,
.probe = rtl_init_one,
.remove = rtl_remove_one,
.shutdown = rtl_shutdown,
.driver.pm = RTL8169_PM_OPS,
};
可以看到，这个驱动注册了runtime机制，下面就来看一下这个计数是如何执行的
rtl_init_one
rtl_open
pm_runtime_get_sync(&pdev->dev);
pm_runtime_put_noidle(&pdev->dev); //only put，只减少计数器
rtl8169_close
pm_runtime_get_sync(&pdev->dev); //增加计数
...... //释放内存的去初始化工作
pm_runtime_put_sync(&pdev->dev);
rtl_shutdown
pm_runtime_get_sync(d);
pm_runtime_put_noidle(d);
rtl_remove_one
pm_runtime_get_noresume(&pdev->dev);
pm_runtime_put_noidle(&pdev->dev);
5、异步（ASYNC）和同步（SYNC）
设备驱动代码可在进程和中断两种上下文执行，因此put和get等接口，要么是由用户进程调用，要么是由中断处理函数调用。由于这些接口可能会执行device的.runtime_xxx回调函数，而这些接口的执行时间是不确定的，有些可能还会睡眠等待。这对用户进程或者中断处理函数来说，是不能接受的。
因此，RPM core提供的默认接口（pm_runtime_get/pm_runtime_put等），采用异步调用的方式（由ASYNC flag表示），启动一个work queue，在单独的线程中，调用.runtime_xxx回调函数，这可以保证设备驱动之外的其它模块正常运行。
另外，如果设备驱动清楚地知道自己要做什么，也可以使用同步接口（pm_runtime_get_sync/pm_runtime_put_sync等），它们会直接调用.runtime_xxx回调函数，不过，后果自负！
1063
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
