参考：
www.wowotech.net/linux_kenrel/suspend_and_resume.html
www.wowotech.net/linux_kenrel/pm_interface.html
一、基本介绍
1.Window下的睡眠就是Suspend to RAM, 休眠就是Suspend to Disk，Ubuntu中Suspend就是Stand by(没有实现Suspend to RAM），Hibernate就是Suspend to Disk。
2.设备驱动若是关注睡眠和唤醒功能就要实现suspend和resume函数，是整个系统的睡眠，电源管理，而不是单独的某个设备的。
3.Linux系统Suspend实现：
cat /sys/power/state 打印支持的电源管理方式，echo 的时候会让内核进入某中休眠模式, eg: echo mem > /sys/power/state 对应的内核函数在/sys/power/state中的读写方法在kernel/power/main.c中.
power_attr(state);展开：
static struct kobj_attribute state_attr = {
.attr = {
.name = "state",
.mode = ,
},
.show = state_show,
.store = state_store,
} struct kobj_attribute state_attr --> struct attribute * g[] --> struct attribute_group attr_group --> pm_init()
power_kobj = kobject_create_and_add("power", NULL); //在/sys目录下创建了一个power目录
sysfs_create_group(power_kobj, &attr_group); //在power目录中创建了这个state文件
二、suspend/resume流程分析
//include\linux\suspend.h
typedef int __bitwise suspend_state_t; #define PM_SUSPEND_ON ((__force suspend_state_t) 0)
#define PM_SUSPEND_TO_IDLE ((__force suspend_state_t) 1)
#define PM_SUSPEND_STANDBY ((__force suspend_state_t) 2)
#define PM_SUSPEND_MEM ((__force suspend_state_t) 3)
#define PM_SUSPEND_MIN PM_SUSPEND_TO_IDLE
#define PM_SUSPEND_MAX ((__force suspend_state_t) 4) enum suspend_stat_step {
SUSPEND_FREEZE = ,
SUSPEND_PREPARE,
SUSPEND_SUSPEND,
SUSPEND_SUSPEND_LATE,
SUSPEND_SUSPEND_NOIRQ,
SUSPEND_RESUME_NOIRQ,
SUSPEND_RESUME_EARLY,
SUSPEND_RESUME
}; //kernel/power/suspend.c
const char * const pm_labels[] = {
[PM_SUSPEND_TO_IDLE] = "freeze", //.[1]="freeze"
[PM_SUSPEND_STANDBY] = "standby",//.[2]="standby"
[PM_SUSPEND_MEM] = "mem",//.[3]="mem"
};
const char *pm_states[PM_SUSPEND_MAX];
void __init pm_states_init(void)
{
/* "mem" and "freeze" are always present in /sys/power/state. */
pm_states[PM_SUSPEND_MEM] = pm_labels[PM_SUSPEND_MEM]; /*.[3]="mem"*/
pm_states[PM_SUSPEND_TO_IDLE] = pm_labels[PM_SUSPEND_TO_IDLE];/*.[1]="freeze"*/
/*
* Suspend-to-idle should be supported even without any suspend_ops,
* initialize mem_sleep_states[] accordingly here.
*/
mem_sleep_states[PM_SUSPEND_TO_IDLE] = mem_sleep_labels[PM_SUSPEND_TO_IDLE]; /*.[1]="s2idle"*/
}
static const char * const mem_sleep_labels[] = {
[PM_SUSPEND_TO_IDLE] = "s2idle", /*.[1]="s2idle"*/
[PM_SUSPEND_STANDBY] = "shallow",/*.[2]="s2idle"*/
[PM_SUSPEND_MEM] = "deep",/*.[3]="mem"*/
};
const char *mem_sleep_states[PM_SUSPEND_MAX];//
suspend_state_t mem_sleep_current = PM_SUSPEND_TO_IDLE; //
suspend_state_t mem_sleep_default = PM_SUSPEND_MAX;//
state_store //(kernel/power/main.c)
pm_suspend //(kernel/power/suspend.c)
enter_state //(kernel/power/suspend.c)
valid_state //(kernel/power/suspend.c) 检查单板是否支持电源管理，就是全局suspend_ops有没有被赋值，并调用其suspend_ops->valid()
suspend_prepare //(kernel/power/suspend.c)
pm_prepare_console //(kernel/power/console.c)
pm_notifier_call_chain(PM_SUSPEND_PREPARE) //(kernel/power/main.c) 通知所有关心这个消息的驱动程序！依次调用静态全局链表pm_chain_head中的每一个函数
suspend_freeze_processes //(kernel/power/power.h) 冻结App和内核线程
suspend_devices_and_enter //(kernel/power/suspend.c) 让设备进入suspend状态
suspend_ops->begin 如果平台相关的代码有begin函数就去调用它，例如Renesas的平台进入suspend时需要一些预先准备工作，就可以实现这个begin函数
suspend_console //(kernel/printk/printk.c) 串口suspend状态，此时串口就用不了了
dpm_suspend_start //(drivers/base/power/main.c)
dpm_prepare //(drivers/base/power/main.c)
对全局链表dpm_list(drivers/base/power/power.c)中的每一个设备都调用其prepare函数，在这里面可以做一些准备工作
dev->pm_domain->ops.prepare 或 [struct dev_pm_ops ops]
dev->type->pm->prepare 或 [struct dev_pm_ops *pm]
dev->class->pm->prepare 或 [struct dev_pm_ops *pm]
dev->bus->pm->prepare 或 [struct dev_pm_ops *pm]
dev->driver->pm->prepare [struct dev_pm_ops *pm] [struct device_driver中的在这，优先级最低]
dpm_suspend //(drivers/base/power/main.c)
对全局链表dpm_prepared_list中的每一个设备都调用device_suspend()
device_suspend //(drivers/base/power/main.c)
dpm_wait_for_children //(drivers/base/power/main.c) 等待其每一个孩子进入suspend状态
dev->pm_domain->ops->suspend 或
dev->type->pm->suspend 或
dev->class->pm->suspend 或
dev->bus->pm->suspend 或
因此自己在写驱动的时候可以在其pm_domain中或type->pm中或class->pm中或bus->pm中加入suspend函数
suspend_enter //(kernel/power/suspend.c) 设备都进入suspend状态了接下来就是CPU了
suspend_ops->prepare 单板的prepare函数若存在就调用
dpm_suspend_end //(drivers/base/power/main.c)
dpm_suspend_late //(drivers/base/power/main.c) 对全局静态链表dpm_suspended_list中的每一个条目都调用device_suspend_late()
device_suspend_late() //(drivers/base/power/main.c) 调用此设备的
dev->pm_domain->ops->suspend_late 或
dev->type->pm->suspend_late 或
dev->class->pm->suspend_late 或
dev->bus->pm->suspend_late 或
dev->driver->pm->suspend_late 或
suspend_ops->prepare_late 调用单板相关的函数，可以做一些清理，若单板不需要也可以不实现它
disable_nonboot_cpus //(kernel/cpu.c) 多核Soc中非用于启动内核的CPU叫做nonboot_cpu，停止non-boot CPU
arch_suspend_disable_irqs //(include/linux/suspend.h)//关闭中断，extern的，Renesas上没有实现
syscore_suspend 关闭核心模块
suspend_ops->enter 调用单板相关的函数，这里真正进入suspend状态了，如三星的是s3c_pm_enter(),里面通过any_allowed()检测有没有设置唤醒源
若没有设置是不允许睡眠的。这个函数下面单独列出
===================================上面是休眠，下面就是唤醒操作了==================================
当我们按下某个按键并且这个按键是唤醒源的话，就会唤醒CPU，从Uboot开始执行
按键唤醒源 --> Uboot --> 读寄存器GSTATUS3 --> 就会执行s3c_cpu_resume()
syscore_resume //(drivers/base/syscore.c) 对全局链表syscore_ops_list中的每一个node都调用其resume()
arch_suspend_enable_irqs //(include/linux/suspend.h)
enable_nonboot_cpus //(kernel/cpu.c)
suspend_ops->wake 如果单板有对应的wake()就调用
dpm_resume_start(PMSG_RESUME) //(drivers/base/power/main.c)
dpm_resume_noirq(state); //(drivers/base/power/main.c) 对全局链表dpm_noirq_list中的每一个设备都执行device_resume_noirq
device_resume_noirq //(drivers/base/power/main.c) 对每一个设备都调用
dev->pm_domain->ops->resume_noirq 或
dev->type->pm->resume_noirq 或
dev->class->pm->resume_noirq 或
dev->bus->pm->resume_noirq 或
dev->driver->pm->resume_noirq 或
执行完resume_noirq的所有设备都会被放在全局链表dpm_late_early_list中
resume_device_irqs //(kernel/irq/pm.c)
resume_irqs //(kernel/irq/pm.c)
__enable_irq //(kernel/irq/pm.c) 对全局数组irq_desc中的每一个irq都调用__enable_irq，但是Renesas的BSP没有实现，里面还有一个野指针 dpm_resume_early(state); //(drivers/base/power/main.c) 对全局链表dpm_late_early_list中的每一个元素都执行device_resume_early
device_resume_early //(drivers/base/power/main.c)
dev->pm_domain->ops->resume_early 或
dev->type->pm->resume_early 或
dev->class->pm->resume_early 或
dev->bus->pm->resume_early 或
dev->driver->pm->resume_early 或
suspend_ops->finish() 如果单板有对应的finish()就调用,三星的对应下面
suspend_test_start //(kernel/power/suspend_test.c)
dpm_resume_end(PMSG_RESUME); //(drivers/base/power/main.c)
dpm_resume //(drivers/base/power/main.c) 对全局链表dpm_suspended_list中的每一个dev都调用device_resume()
device_resume //(drivers/base/power/main.c)
dev->pm_domain->ops->resume 或
dev->type->pm->resume 或
dev->class->pm->resume 或
dev->bus->pm->resume 或
dev->driver->pm->resume 或
然后将所有的设备移动到全局链表dpm_prepared_list中
dpm_complete //(drivers/base/power/main.c) 对全局链表dpm_prepared_list中的每一个设备都调用device_complete()
device_complete //(drivers/base/power/main.c)
dev->pm_domain->ops.complete 或
dev->type->pm.complete 或
dev->class->pm.complete 或
dev->bus->pm.complete 或
dev->driver->pm.complete 或
suspend_test_finish //(kernel/power/suspend_test.c) 打印一些log出来
resume_console //(kernel/printk.c)
console_unlock //(kernel/printk.c)
call_console_drivers //(kernel/printk.c) 关闭本地中断获取spin锁后调用控制台打印函数以poll方式打印内核log
suspend_ops->end() 如果单板有对应的end()就调用
suspend_ops->recover() 如果dpm_suspend_start失败或者suspend_test失败，单板有对应的recover()就调用
suspend_finish //(kernel/power/suspend.c)
suspend_thaw_processes(); //(kernel/power/power.h)唤醒应用程序
pm_notifier_call_chain(PM_POST_SUSPEND); //(kernel/power/main.c) 通知关注这个事件的App程序，对全局pm_chain_head->head中的每一个都调用其notifier_call()
pm_restore_console(); //(kernel/power/console.c)
返回用户空间
s3c_pm_enter 展开：
any_allowed 检测有没有设置唤醒源
samsung_pm_save_gpios(); 保存一些状态，gpio uart状态
samsung_pm_saved_gpios();
s3c_pm_save_uarts();
s3c_pm_save_core();
s3c_pm_configure_extint 配置一下唤醒源
pm_cpu_prep s3c2410_pm_add()中对这个函数指针赋值
s3c2410_pm_prepare 这个函数中将s3c_cpu_resume()这个函数的物理地址写入了GSTATUS3寄存器中
GSTATUS3 = s3c_cpu_resume() 当系统被唤醒的时候会去执行Uboot,Uboot中会去读GSTATUS3得到一个函数的地址然后去执行它
s3c_pm_arch_stop_clocks 关闭时钟
cpu_suspend(, pm_cpu_sleep) 这个是最重要的suspend函数了，参数2 pm_cpu_sleep 作为回调函数
__cpu_suspend(arg, pm_cpu_sleep) arch/arm/kernel/sleep.S 中是个汇编代码,pm_cpu_sleep作为第二个参数传入，就保存在r1里面
stmfd sp!, {r0, r1} @ save suspend func arg and pointer
ldmfd sp!, {r0, pc} @ call suspend fn 恢复的时候把r1里面的值恢复到pc指针中! 相当于执行了pm_cpu_sleep
pm_cpu_sleep = ENTRY(s3c2410_cpu_suspend) /arch/arm/mach-s3c24xx/s3c2410.S
先读一遍这几个寄存器，读的原因：休眠的时候通过写这个REFRESH寄存器把SDRAM给关掉，关闭掉后还要通过写寄存器CLKCON把
CPU给停掉，但是当内核去访问这些寄存器的时候，内核需要使用虚拟地址，就要使用到SDRAM上的页表，但是现在已经要先关闭SDRAM了，
就不能再访问SDRAM上的页表了，因此需要先读取一下那些寄存器，缓存这些寄存器的页表到TLB里面，之后通过TLB得到翻译后的这些寄存
器的物理地址。
ldr r4, =S3C2410_REFRESH
ldr r5, =S3C24XX_MISCCR
ldr r6, =S3C2410_CLKCON
下面先去dummy执行一遍，pc指针肯定也不等于0，目前先把这些指令缓存在I cache里面。
teq pc, # @ first as a trial-run to load cache
bl s3c2410_do_sleep
这里就可以从Icache中获取这些指令，执行SDRAM的关闭和CPU的睡眠操作了
s3c2410_do_sleep:
streq r7, [ r4 ] @ SDRAM sleep command
streq r8, [ r5 ] @ SDRAM power-down config
streq r9, [ r6 ] @ CPU sleep
========================上面是休眠，下面就是唤醒操作了===========================
s3c_pm_restore_core();
s3c_pm_restore_uarts();
samsung_pm_restore_gpios();
s3c_pm_restored_gpios();
流程分析结论：
1.PM Core会依次调用“prepare-->suspend-->suspend_late-->suspend_noirq-------wakeup--------->resume_noirq-->resume_early-->resume-->complete”
总体流程就是先让你准备一下，然后再让你休眠，休眠和唤醒是反着来的。在suspend之前可以做一些准备工作，suspend之后可以做一些清理函数，若是认
2.为没有什么好准备或清理的，设备驱动中可以不实现prepare函数和suspend_late函数，只实现suspend函数。
3.可以参考函数dpm_show_time()里面的实现来在内核中打印时间
struct device *dev;
list_for_each_entry(dev, &dpm_suspended_list, power.entry)
4.list_for_each_entry：dummy dev的power.entry实体挂载在链表dpm_suspended_list上，返回dev实体
三、查看三星单板suspend功能实现
/arch/arm/plat-samsung/pm.c 中的struct platform_suspend_ops s3c_pm_ops
s3c_pm_init
suspend_set_ops(&s3c_pm_ops);
设置唤醒源：配置GPIO引脚工作于中断模式，设置它的触发方式
s3c_pm_enter --> s3c_pm_configure_extint()
使用哪个交叉编译工具链只需要在PATH中设置其路径即可！有多个不同版本的话设置一个自己想要的版本的路径到PATH中，就选用了这个交叉工具链。
是make uImage
修改按键驱动在request_irq()之后调用irq_set_irq_wake()来指定此中断为唤醒源(没有唤醒源是不允许进入睡眠模式的)
四、修改驱动支持电源管理
a.通知notifier
①由上流程分析可知在冻结App之前，使用pm_notifier_call_chain(PM_SUSPEND_PREPARE)来通知应用程序
②由上流程分析可知在重启App之后，使用pm_notifier_call_chain(PM_POST_SUSPEND);
如果驱动在冻结App之前之后有些事情要做，可以使用register_pm_notifier()注册这两个notifier
一般驱动进入休眠是在冻结进程之后进行休眠的，以免驱动休眠之后还有App访问到它！
b.添加suspend,resume函数,可以参考s3c2410fb.c
1.若在struct platform_driver里面加的话只有suspend和resume两个选项,但是这里是内核即将遗弃的，平台(一般)设备没有pm_domain、type、class，但是有总线bus
static struct platform_driver s3c2412fb_driver = {
.probe = s3c2412fb_probe,
.remove = s3c2410fb_remove,
.suspend = s3c2410fb_suspend,
.resume = s3c2410fb_resume,
.driver = { /*若此内部有.pm域，优先调用driver.pm，而不是platform_driver.suspend*/
.name = "s3c2412-lcd",
},
};
平台驱动struct platform_driver中注册了suspend,resume函数何时被调用：
dev->pm_domain->ops.suspend
dev->type->pm->suspend
dev->class->pm->suspend
dev->bus->pm->suspend
dev->driver->pm->suspend
__platform_driver_register()中drv->driver.bus = &platform_bus_type;[全局]
由上面的调用逻辑dev->bus->pm->suspend会被调用，而platform_bus_type;[全局]有.pm = &platform_dev_pm_ops,
platform_pm_suspend() --> platform_legacy_suspend() --> platform_driver.suspend.
2.添加suspend,resume函数
老方法：在platform_driver中实现suspend/resume方法
新方法：在platform_driver.driver.pm中实现suspend/resume方法，[可参考ac97c.c]
3.实验现象
实现中休眠之前LCD上的图像在休眠后LCD上的图像不见了，因为在唤醒时
LCD做串口控制台被清理了，在menuconfig中将<*> Framebuffer Console support去掉即可！让LCD不做控制台
五、代码附录
1.notifier
static int lcd_suspend_notifier(struct notifier_block *nb, unsigned long event, void *dummy)
{
switch (event) {
case PM_SUSPEND_PREPARE:
printk("lcd suspend notifiler test: PM_SUSPEND_PREPARE\n");
return NOTIFY_OK;
case PM_POST_SUSPEND:
printk("lcd suspend notifiler test: PM_POST_SUSPEND\n");
return NOTIFY_OK; default:
return NOTIFY_DONE;
}
} static struct notifier_block lcd_pm_notif_block = {
.notifier_call = lcd_suspend_notifier,
}; static int lcd_init(void)
{
......
register_pm_notifier(&lcd_pm_notif_block); //由上流程可知在pm_notifier_call_chain时会传入不同的参数调用这个函数。
......
return ;
} static void lcd_exit(void)
{
......
unregister_pm_notifier(&lcd_pm_notif_block);
......
} module_init(lcd_init);
module_exit(lcd_exit);
2.suspend/resume实现
static int lcd_suspend(struct device *dev)
{
/*1.保存LCD相关寄存器状态*/ /*2.关闭时钟，断电进入suspend状态*/ return ;
} static int lcd_resume(struct device *dev)
{
/*1.还原LCD相关寄存器状态*/ /*2.使能时钟，上电进入suspend状态*/ return ;
} static struct dev_pm_ops lcd_pm = {
.suspend = lcd_suspend,
.resume = lcd_resume,
}; struct platform_driver lcd_drv = {
.probe = lcd_probe,
.remove = lcd_remove,
.driver = {
.name = "mylcd",
.pm = &lcd_pm,
}
}; static int lcd_init(void)
{
register_pm_notifier(&lcd_pm_notif_block);
platform_driver_register(&lcd_drv);
return ;
} static void lcd_exit(void)
{
unregister_pm_notifier(&lcd_pm_notif_block);
platform_device_unregister(&lcd_dev);
platform_driver_unregister(&lcd_drv);
} module_init(lcd_init);
module_exit(lcd_exit);
MODULE_LICENSE("GPL");