# MS-RTOS 电源管理

本章将介绍 MS-RTOS 电源管理 PM 的使用。

# PM 相关数据类型

# ms_pm_sleep_mode_t

CPU 休眠模式类型，可取的值为以下的宏：

# ms_pm_run_mode_t

CPU 运行模式类型，可取的值为以下的宏：

# ms_pm_boot_mode_t

CPU 启动模式类型，可取的值为以下的宏：

# ms_pm_event_t

电源管理事件类型，可取的值为以下的宏：

# PM 相关 API

下表展示了电源管理相关的 API 在两个权限空间下是否可用：

用户空间不能使用电源管理相关的 API，只能通过对 /dev/pm 设备操作达到电源管理的目的。如果 APP 没有对 /dev/pm 设备的访问权限，则 APP 不能进行电源管理相关的操作。

# ms_pm_request_sleep_mode()

• 描述 请求进入指定的 CPU 休眠模式

• 函数原型

ms_err_t ms_pm_request_sleep_mode(ms_pm_sleep_mode_t sleep_mode);

• 参数

• 返回值 MS-RTOS 内核错误码

• 注意事项 无

• 示例 无

# ms_pm_release_sleep_mode()

• 描述 取消请求指定的 CPU 休眠模式

• 函数原型

ms_err_t ms_pm_release_sleep_mode(ms_pm_sleep_mode_t sleep_mode);

• 参数

• 返回值 MS-RTOS 内核错误码

• 注意事项 无

• 示例 无

# ms_pm_set_default_sleep_mode()

• 描述 设置默认的 CPU 休眠模式

• 函数原型

ms_err_t ms_pm_set_default_sleep_mode(ms_pm_sleep_mode_t sleep_mode);

• 参数

• 返回值 MS-RTOS 内核错误码

• 注意事项 无

• 示例 无

# ms_pm_set_run_mode()

• 描述 设置 CPU 运行模式

• 函数原型

ms_err_t ms_pm_set_run_mode(ms_pm_run_mode_t run_mode);

• 参数

• 返回值 MS-RTOS 内核错误码

• 注意事项 无

• 示例 无

# ms_pm_get_run_mode()

• 描述 获得当前的 CPU 运行模式

• 函数原型

ms_pm_run_mode_t ms_pm_get_run_mode(void);

• 参数 无

• 返回值 当前的 CPU 运行模式

• 注意事项 无

• 示例 无

# ms_pm_set_boot_mode()

• 描述 设置 CPU 启动模式

• 函数原型

ms_err_t ms_pm_set_boot_mode(ms_pm_boot_mode_t boot_mode);

• 参数

• 返回值 MS-RTOS 内核错误码

• 注意事项 无

• 示例 无

# ms_pm_get_boot_mode()

• 描述 获得 CPU 启动模式

• 函数原型

ms_pm_boot_mode_t ms_pm_get_boot_mode(void);

• 参数 无

• 返回值 CPU 的启动模式

• 注意事项 无

• 示例 无

# /dev/pm 设备 ioctl 命令

ioctl 命令及相关说明如下表所示：