1# power-shell工具
2
3
4power-shell是实现设备电源状态转换等功能的工具，为开发者提供基本的设备电源状态调试能力，例如：熄屏、唤醒、设置电源模式等。
5
6## 环境要求
7<!--RP1-->
8在使用本工具前，开发者需要先获取[hdc工具](../dfx/hdc.md)，执行hdc shell。
9<!--RP1End-->
10
11## 命令列表
12
13  **表1** power-shell工具命令列表
14
15| 命令 | 描述 |
16| -------- | -------- |
17| help | 帮助命令，显示power-shell支持的命令信息。 |
18| setmode | 设置电源模式命令，用来设置当前设备的电源模式。 |
19| wakeup | 亮屏命令，用来唤醒系统并亮屏。 |
20| suspend | 熄屏命令，用来暂停系统并熄屏。|
21| timeout | 自动熄屏命令，用来覆盖或恢复系统设置中自动熄屏时间。 |
22
23
24## 帮助命令
25
26```bash
27power-shell help
28```
29
30  **表2** help命令列表
31
32| 命令    | 描述       |
33| ------- | ---------- |
34| power-shell help | 显示power-shell工具能够支持的命令信息。 |
35
36示例：
37
38
39```bash
40# 显示帮助信息
41power-shell help
42```
43
44
45## 设置电源模式命令
46
47```bash
48power-shell setmode
49```
50
51  **表3** 设置电源模式命令列表
52
53| 命令                                | 描述                       |
54| ----------------------------------- | -------------------------- |
55| power-shell setmode -h | 显示setmode支持的命令信息。 |
56| power-shell setmode 600 | 正常模式。 |
57| power-shell setmode 601 | 省电模式。 |
58| power-shell setmode 602 | 性能模式。 |
59| power-shell setmode 603 | 超级省电模式。 |
60
61示例：
62```bash
63# 设置设备电源状态为正常模式
64power-shell setmode 600
65# 设置设备电源状态为省电模式
66power-shell setmode 601
67# 设置设备电源状态为性能模式
68power-shell setmode 602
69# 设置设备电源状态为超级省电模式
70power-shell setmode 603
71```
72
73
74## 亮屏命令
75
76```bash
77power-shell wakeup
78```
79
80  **表4** 亮屏命令列表
81
82| 命令                          | 描述                     |
83| ----------------------------- | ------------------------ |
84| power-shell wakeup | 亮屏。 |
85
86
87示例：
88
89```bash
90# shell命令亮屏
91power-shell wakeup
92```
93
94
95## 熄屏命令
96
97```bash
98power-shell suspend
99```
100
101
102  **表5** 熄屏命令列表
103
104| 命令       | 描述                       |
105| ---------- | -------------------------- |
106| power-shell suspend  | 熄屏。 |
107
108
109示例：
110
111```bash
112# shell命令熄屏
113power-shell suspend
114```
115
116## 自动熄屏命令
117
118```bash
119power-shell timeout
120```
121
122  **表6** 自动熄屏命令列表
123| 命令       | 描述                       |
124| ---------- | -------------------------- |
125| power-shell timeout -o [time] | 设置自动熄屏时间。[time]单位为毫秒。 |
126| power-shell timeout -r | 恢复到当前系统设置中的自动熄屏时间。 |
127
128示例：
129
130```bash
131# 当前系统设置中自动熄屏时间为30秒
132# shell命令设置自动熄屏时间为15000毫秒
133power-shell timeout -o 15000
134# 恢复系统设置的自动熄屏时间，此时自动熄屏时间为30秒
135power-shell timeout -r
136```
137