SylixOS电源管理概述以及接口介绍
时间：2018-09-28 来源：未知
1. 概述
电源管理是操作系统中重要的一部分。要实现电源管理功能，首先需要设备本身支持电源管理操作，其次是操作系统支持电源管理操作。
SylixOS支持电源管理功能，电源管理分为两大部分：CPU功耗管理和外设功耗管理。
1.1 CPU功耗管理
SylixOS中，CPU功耗管理分为三个能级：
1.正常运行(Running)：CPU正常执行指令。
2.省电模式(PowerSaving)：所有具有电源管理功能的设备进入 PowerSaving 模式，同时CPU主频降低，多核CPU仅保留一个CPU运行。
3.休眠模式(Sleep)：系统休眠所有具有电源管理功能的设备进入 Suspend 模式，系统需要通过指定事件唤醒休眠模式系统，会从复位向量处恢复，需要 bootloader/BIOS 程序配合。
需要的注意的是，在SMP多核中，可以动态调整CPU运行的核心数。
1.2 外设功耗管理
SylixOS中，外设功耗管理分为四个状态：
1.正常运行状态：设备被打开，驱动程序请求电源管理适配器连通设备电源与时钟，开始工作。
2.设备关闭状态：设备被关闭，驱动程序请求电源管理适配器断开设备电源与时钟，停止工作。
3.省电模式状态：系统进入省电模式，请求高能耗设备进入省电模式。
4.设备空闲状态：设备功耗管理单元具有看门狗功能，一旦空闲时间超过设置,系统会将设备变为空闲状态。
1.3 系统框架
SylixOS下电源管理结构
每个电源管理适配器(PM Adapter)可以管理多个设备（由相应的通道号区分），电源管理适配器管理的通道号总数决定这个适配器可以管理多少个设备。应用层可以对支持电源管理的设备进行进入休眠模式、进入省电模式、恢复正常模式等电源管理操作。
2. 系统接口及实现
2.1 系统接口概述
SylixOS中，电源管理部分提供了下面6个函数接口供应用层使用，如表2-1所示。
2-1 电源管理系统接口
系统接口 功能
API_PowerMSuspend 系统休眠
API_PowerMResume 系统唤醒
API_PowerMCpuSet 设置CPU节电参数
API_PowerMCpuGet 获取CPU节电参数
API_PowerMSavingEnter 系统进入省电模式
API_PowerMSavingExit 系统退出省电模式
2.1.1 系统休眠
控制所有支持休眠功能的外设进入休眠状态，同时内核进入休眠状态。
[html] view plain copy print?
1. VOID Lw_PowerM_Suspend(VOID);
2.1.2 系统唤醒
控制所有支持休眠功能的外设从休眠状态恢复正常状态，同时内核恢复正常状态。
[html] view plain copy print?
1. VOID Lw_PowerM_Resume(VOID);
2.1.3 设置CPU节能参数
设置多核系统中运行的CPU核数目以及CPU能耗级别，系统根据参数关闭或打开CPU核，同时设置CPU能耗级别，设置CPU以不同的主频运行，进入节能模式时降低主频，反之则升高主频。本函数还会将CPU参数的改变通知到所有支持电源管理的外设。
[html] view plain copy print?
1. VOID Lw_PowerM_CpuSet(ULONG ulNCpus, UINT uiPowerLevel);
其中参数：参数 ulNCpus是运行态的CPU核个数；
参数 uiPowerLevel是CPU能耗级别。
2.1.4 获取CPU节能参数
该函数获得当前运行的CPU个数和CPU能耗级别。
[html] view plain copy print?
1. VOID Lw_PowerM_CpuGet(ULONG *pulNCpus, UINT *puiPowerLevel);
其中参数：参数 pulNCpus返回运行态的CPU核个数；
参数 puiPowerLevel返回CPU能耗级别。
2.1.5 系统进入省电模式
使系统进入省电模式。控制所有支持电源管理的设备进入省电模式，同时设置运行的CPU核数目以及能耗级别。
[html] view plain copy print?
1. VOID Lw_PowerM_SavingEnter(ULONG ulNCpus, UINT uiPowerLevel);
其中参数：参数 ulNCpus是运行态的CPU核个数；
参数 uiPowerLevel是CPU能耗级别。
2.1.6 系统退出省电模式
控制系统退出省电模式，控制所有支持电源管理的设备退出省电模式，同时设置运行的CPU核数目以及能耗级别。
[html] view plain copy print?
1. VOID Lw_PowerM_SavingExit(ULONG ulNCpus, UINT uiPowerLevel);
其中参数：参数 ulNCpus是运行态的CPU核个数；
参数 uiPowerLevel是CPU能耗级别。
2.2 系统接口实现
2.2.1 系统休眠和唤醒
统在进行休眠或者唤醒操作时，首先遍历电源设备管理链表，对链表中支持电源管理的设备进行休眠或者唤醒操作，然后对系统内核进行休眠或唤醒操作。系统接口实现流程
1. 系统休眠
对系统进行休眠操作，需调用API_PowerMSuspend系统接口，实现外设和系统内核进入休眠状态。函数原型如程序清单 2 - 1所示。
程序清单2 - 1 系统休眠
[html] view plain copy print?
1. VOID API_PowerMSuspend (VOID)
2. {
3. PLW_LIST_LINE plineTemp;
4. PLW_PM_DEV pmdev;
5.
6. __POWERM_LOCK();
7. /*
8. * 遍历电源管理链表，对链表中设备进行休眠处理
9. */
10. for (plineTemp = _G_plinePMDev;
11. plineTemp != LW_NULL;
12. plineTemp = _list_line_get_next(plineTemp)) {
13. pmdev = _LIST_ENTRY(plineTemp, LW_PM_DEV, PMD_lineManage);
14. if (pmdev->PMD_pmdfunc &&
15. pmdev->PMD_pmdfunc->PMDF_pfuncSuspend) {
16. pmdev->PMD_pmdfunc->PMDF_pfuncSuspend(pmdev);
17. }
18. }
19.
20. __POWERM_UNLOCK();
21.
22. API_KernelSuspend(); /* 内核休眠处理 */
23. }
该函数实现以下功能：
1.
遍历电源设备管理链表中支持电源管理的设备；
2.
3.
调用PMDF_pfuncSuspend函数，对加入电源管理链表中的外设依次进行休眠处理；
4.
5.
调用API_KernelSuspend函数，使内核进入休眠状态。
6.
2. 系统唤醒
系统从休眠状态唤醒，需调用API_PowerMResume系统接口，实现外设和内核从休眠状态唤醒，函数原型如程序清单2- 2所示。
程序清单2 - 2 系统唤醒
[cpp] view plain copy print?
1. VOID API_PowerMResume (VOID)
2. {
3. PLW_LIST_LINE plineTemp;
4. PLW_PM_DEV pmdev;
5.
6. __POWERM_LOCK();
7.
8. /*
9. * 遍历电源管理链表，对链表中设备进行唤醒处理
10. */
11. for (plineTemp = _G_plinePMDev;
12. plineTemp != LW_NULL;
13. plineTemp = _list_line_get_next(plineTemp)) {
14.
15. pmdev = _LIST_ENTRY(plineTemp, LW_PM_DEV, PMD_lineManage);
16. if (pmdev->PMD_pmdfunc &&
17. pmdev->PMD_pmdfunc->PMDF_pfuncResume) {
18. pmdev->PMD_pmdfunc->PMDF_pfuncResume(pmdev);
19. }
20. }
21. __POWERM_UNLOCK();
22.
23. API_KernelResume(); /* 内核唤醒处理 */
24. }
该函数实现以下功能：
1.遍历电源设备管理链表中支持电源管理的设备；
2.调用PMDF_pfuncResume函数，对加入电源管理链表中的外设进行唤醒处理；
3.调用API_KernelResume函数，使内核从休眠中唤醒。
2.2.2 CPU节电参数设置和获取
CPU节电参数的设置，根据传入参数对CPU核进行关闭和打开，然后设置CPU能耗等级。获取CPU节电参数，首先获取当前系统运行CPU核个数，然后获取CPU能耗等级。系统接口实现流程
1. 设置CPU节电参数
设置CPU节电参数，需调用API_PowerMCpuSet系统接口，函数原型如程序清单2-3所示。
程序清单2 - 3 设置CPU节电参数
[html] view plain copy print?
1. VOID API_PowerMCpuSet (ULONG ulNCpus, UINT uiPowerLevel)
2. {
3. PLW_LIST_LINE plineTemp;
4. PLW_PM_DEV pmdev;
5. UINT uiOldPowerLevel;
6.
7. #if LW_CFG_SMP_EN > 0
8. ULONG i;
9. ULONG ulActCnt = 0;
10. #endif /* LW_CFG_SMP_EN > 0 */
11. if (ulNCpus == 0) {
12. _ErrorHandle(EINVAL);
13. return;
14. }
15. if (ulNCpus > LW_NCPUS) {
16. ulNCpus = LW_NCPUS;
17. }
18.
19. #if LW_CFG_SMP_EN > 0
20. for (i = 0; i < LW_NCPUS; i++) { /* 获取当前系统运行CPU数 */
21. if (API_CpuIsUp(i)) {
22. ulActCnt++;
23. }
24. }
25.
26. if (ulActCnt > ulNCpus) { /* 需要关闭一些 CPU */
27. #if LW_CFG_SMP_CPU_DOWN_EN > 0
28. ULONG ulDownCnt = ulActCnt - ulNCpus;
29. for (i = 1; i < LW_NCPUS; i++) {
30. if (API_CpuIsUp(i)) {
31. API_CpuDown(i);
32. ulDownCnt--;
33. }
34. if (ulDownCnt == 0) {
35. break;
36. }
37. }
38. #endif /* LW_CFG_SMP_CPU_DOWN_EN > 0 */
39.
40. } else if (ulActCnt < ulNCpus) { /* 需要打开一些 CPU */
41. ULONG ulUpCnt = ulNCpus - ulActCnt;
42. for (i = 1; i < LW_NCPUS; i++) {
43. if (!API_CpuIsUp(i)) {
44. API_CpuUp(i);
45. ulUpCnt--;
46. }
47.
48. if (ulUpCnt == 0) {
49. break;
50. }
51. }
52. }
53. #endif /* LW_CFG_SMP_EN > 0 */
54.
55. API_CpuPowerGet(&uiOldPowerLevel); /* 获得CPU运行能级 */
56. if (uiOldPowerLevel != uiPowerLevel) {
57. API_CpuPowerSet(uiPowerLevel); /* 设置CPU运行能级 */
58. __POWERM_LOCK();
59. /*
60. * 遍历电源管理链表，将节电参数通知支持电源管理的外设
61. */
62. for (plineTemp = _G_plinePMDev;
63. plineTemp != LW_NULL;
64. plineTemp = _list_line_get_next(plineTemp)) {
65. pmdev = _LIST_ENTRY(plineTemp, LW_PM_DEV, PMD_lineManage);
66. if (pmdev->PMD_pmdfunc &&
67. pmdev->PMD_pmdfunc->PMDF_pfuncCpuPower) {
68. pmdev->PMD_pmdfunc->PMDF_pfuncCpuPower(pmdev);
69. }
70. }
71.
72. __POWERM_UNLOCK();
73. }
74. }
该函数实现以下功能：
1.
获取当前系统运行的CPU核数；
2.
3.
若传入参数小于当前系统运行CPU核数，则关闭一些CPU核；
4.
5.
若传入参数大于当前系统运行CPU核数，则打开一些CPU核；
6.
获取当前CPU能耗等级，根据传入参数设置CPU能耗等级；
7.
8.
遍历电源管理设备链表，将CPU节电参数通知所有支持电源管理的外设。
9.
2. 获取CPU节电参数
获取CPU节电参数，需调用API_PowerMCpuGet系统接口，函数原型如程序清单2-4所示。
程序清单2-4 获取CPU节电参数
[html] view plain copy print?
1. VOID API_PowerMCpuGet (ULONG *pulNCpus, UINT *puiPowerLevel)
2. {
3. #if LW_CFG_SMP_EN > 0
4. ULONG i;
5. ULONG ulActCnt = 0;
6. /*
7. * 获取CPU运行核数
8. */
9. if (pulNCpus) {
10. for (i = 0; i < LW_NCPUS; i++) {
11. if (API_CpuIsUp(i)) {
12. ulActCnt++;
13. }
14. }
15. *pulNCpus = ulActCnt;
16. }
17. #else
18. if (pulNCpus) {
19. *pulNCpus = 1ul;
20. }
21. #endif /* LW_CFG_SMP_EN > 0 */
22. if (puiPowerLevel) {
23. API_CpuPowerGet(puiPowerLevel); /* 获取CPU运行能级 */
24. }
25. }
该函数实现以下功能：
1.
获取当前系统CPU核数；
2.
3.
获取当前系统CPU运行能级。
4.
2.2.3 系统省电模式进入和退出
系统进入或退出省电模式，首先通知所有支持电源管理的外设进入或者退出省电模式，然后根据传入参数设置CPU节电参数。系统接口实现流程
1. 进入省电模式
系统进入省电模式，需调用API_PowerMSavingEnter系统接口，函数原型如程序清单2 - 5所示。
程序清单2 - 5 进入省电模式
[html] view plain copy print?
1. VOID API_PowerMSavingEnter (ULONG ulNCpus, UINT uiPowerLevel)
2. {
3. PLW_LIST_LINE plineTemp;
4. PLW_PM_DEV pmdev;
5.
6. if (ulNCpus == 0) {
7. _ErrorHandle(EINVAL);
8. return;
9. }
10. __POWERM_LOCK();
11. /*
12. * 遍历电源管理链表，使外设进入省电模式
13. */
14. for (plineTemp = _G_plinePMDev;
15. plineTemp != LW_NULL;
16. plineTemp = _list_line_get_next(plineTemp)) {
17. pmdev = _LIST_ENTRY(plineTemp, LW_PM_DEV, PMD_lineManage);
18. if (pmdev->PMD_pmdfunc &&
19. pmdev->PMD_pmdfunc->PMDF_pfuncPowerSavingEnter) {
20. pmdev->PMD_pmdfunc->PMDF_pfuncPowerSavingEnter(pmdev);
21. }
22. }
23.
24. _G_bPowerSavingMode = LW_TRUE;
25. __POWERM_UNLOCK();
26.
27. API_PowerMCpuSet(ulNCpus, uiPowerLevel); /* CPU节电参数设置 */
28. }
该函数实现以下功能：
1.
遍历电源管理链表，把电源管理链表中所有支持电源管理的设备设置为省电模式；
2.
3.
设置CPU节电参数，根据传入参数，对CPU节电参数进行设置，调用2.2.2节中API_PowerMCpuSet接口函数。
4.
2. 退出省电模式
系统退出省电模式，需调用API_PowerMSavingExit系统接口，函数原型如程序清单2 - 6所示。
程序清单2 - 6 退出省电模式
[html] view plain copy print?
1. VOID API_PowerMSavingExit (ULONG ulNCpus, UINT uiPowerLevel)
2. {
3. PLW_LIST_LINE plineTemp;
4. PLW_PM_DEV pmdev;
5.
6. if (ulNCpus == 0) {
7. _ErrorHandle(EINVAL);
8. return;
9. }
10. __POWERM_LOCK();
11. /*
12. * 遍历电源管理链表，使外设外设省电模式
13. */
14. for (plineTemp = _G_plinePMDev;
15. plineTemp != LW_NULL;
16. plineTemp = _list_line_get_next(plineTemp)) {
17. pmdev = _LIST_ENTRY(plineTemp, LW_PM_DEV, PMD_lineManage);
18. if (pmdev->PMD_pmdfunc &&
19. pmdev->PMD_pmdfunc->PMDF_pfuncPowerSavingExit) {
20. pmdev->PMD_pmdfunc->PMDF_pfuncPowerSavingExit(pmdev);
21. }
22. }
23. _G_bPowerSavingMode = LW_FALSE;
24. __POWERM_UNLOCK();
25.
26. API_PowerMCpuSet(ulNCpus, uiPowerLevel); /* CPU节电参数设置 */
27. }
该函数实现以下功能：
1.
遍历电源管理链表，把电源管理链表中所有支持电源管理的设备退出省电模式；
2.
3.
设置CPU节电参数，根据传入参数，对CPU节电参数进行设置，调用2.2.2节中API_PowerMCpuSet接口函数。
4.
3. 小结
本文档介绍了SylixOS向应用层提供的电源管理系统接口，以及接口的实现流程。应用层可以调用这些系统接口，实现系统的电源管理工作。
