参考：
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 = 0644, }, .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流程分析
//includelinuxsuspend.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 = 1, 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];//4 suspend_state_t mem_sleep_current = PM_SUSPEND_TO_IDLE; //1 suspend_state_t mem_sleep_default = PM_SUSPEND_MAX;//4
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(0, 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, #0 @ 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 "); return NOTIFY_OK; case PM_POST_SUSPEND: printk("lcd suspend notifiler test: PM_POST_SUSPEND "); 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 0; } 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 0; } static int lcd_resume(struct device *dev) { /*1.还原LCD相关寄存器状态*/ /*2.使能时钟，上电进入suspend状态*/ return 0; } 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 0; } 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");