# 电源管理 API

# 系统休眠

下面函数控制所有支持休眠功能的外设进入休眠状态。

#include <SylixOS.h>
VOID  Lw_PowerM_Suspend(VOID);

# 系统唤醒

下面函数控制所有支持休眠功能的外设从休眠状态恢复正常状态。

#include <SylixOS.h>
VOID  Lw_PowerM_Resume(VOID);

# 设置 CPU 节能参数

下面函数设置多核系统中运行的 CPU 核数目以及能耗级别，系统根据参数关闭或打开 CPU 核，同时设置 CPU 能耗级别，不同的能耗级别，CPU 以不同的主频运行，进入节能模式时降低主频，反之则升高主频。本函数还会将 CPU 参数的改变通知到所有支持电源管理的外设。

#include <SylixOS.h>
VOID  Lw_PowerM_CpuSet(ULONG  ulNCpus, UINT  uiPowerLevel);

函数 Lw_PowerM_CpuSet 原型分析：

• 参数 ulNCpus 是运行态的 CPU 核个数。
• 参数 uiPowerLevel 是 CPU 能耗级别。

# 获取 CPU 节能参数

下面函数获得当前运行的 CPU 个数和 CPU 能耗级别。

#include <SylixOS.h>
VOID  Lw_PowerM_CpuGet(ULONG  *pulNCpus, UINT  *puiPowerLevel);

函数 Lw_PowerM_CpuGet 原型分析：

• 输出参数 p ulNCpus 返回运行态的 CPU 核个数。
• 输出参数 p uiPowerLevel 返回 CPU 能耗级别。

需要注意的是，如果 p ulNCpus 和 p uiPowerLevel 为 NULL，该函数什么也不做。

# 系统进入省电模式

调用下面函数使系统进入省电模式。控制所有支持电源管理的设备进入省电模式，同时设置运行的 CPU 核数目以及能耗级别。

#include <SylixOS.h>
VOID  Lw_PowerM_SavingEnter(ULONG  ulNCpus, UINT  uiPowerLevel);

函数 Lw_PowerM_SavingEnter 原型分析：

• 参数 ulNCpus 是运行态的 CPU 核个数。
• 参数 uiPowerLevel 是 CPU 能耗级别。

# 系统退出省电模式

下面函数控制系统退出省电模式。控制所有支持电源管理的设备退出省电模式，同时设置运行的 CPU 核数目以及能耗级别。

#include <SylixOS.h>
VOID  Lw_PowerM_SavingExit(ULONG  ulNCpus, UINT  uiPowerLevel);

函数 Lw_PowerM_SavingExit 原型分析：

• 参数 ulNCpus 是运行态的 CPU 核个数。
• 参数 uiPowerLevel 是 CPU 能耗能级。