1# param工具
2
3param是为开发人员提供用于操作系统参数的工具，该工具只支持标准系统。
4
5## 环境要求
6
7* 获取<!--Del-->[<!--DelEnd-->hdc工具<!--Del-->](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)<!--DelEnd-->，执行hdc shell。
8* 正常连接设备。
9
10## param工具命令列表
11
12  | 选项 | 说明 |
13  | ----------------- | ------------------------------------------ |
14  | -h | 获取param支持的命令。 |
15  | ls [-r] [name] | 显示匹配name的系统参数信息。带"-r"则根据参数权限获取信息，不带"-r"则直接获取参数信息。 |
16  | get [name] | 获取指定name系统参数的值；若不指定任何name，则返回所有系统参数。 |
17  | set name value | 设置指定name系统参数的值为value。 |
18  | wait name [value] [timeout] | 同步等待指定name系统参数与指定值value匹配。value支持模糊匹配，如"\*"表示任何值，"val\*"表示只匹配前三个val字符。timeout为等待时间（单位：s），不设置则默认为30s。 |
19  | save | 保存persist参数到工作空间。 |
20
21## 获取param支持的命令
22
23* 获取param支持的命令，命令格式如下：
24
25  ```bash
26  param -h
27  ```
28
29## 获取系统参数信息
30
31* 显示匹配name的系统参数信息，命令格式如下：
32
33  ```bash
34  param ls [-r] [name]
35  ```
36  **示例**<br>
37  ![ls-integrity](figures/param-ls-integrity.png)
38  ![ls-part](figures/param-ls-part.png)
39  ![ls](figures/param-ls.png)
40
41## 获取系统参数的值
42
43* 获取指定name系统参数的值，命令格式如下：
44
45  ```bash
46  param get [name]
47  ```
48  **示例**<br>
49  ![get](figures/param-get.png)
50
51## 设置系统参数的值
52
53* 设置指定name系统参数的值为value，命令格式如下：
54
55  ```bash
56  param set name value
57  ```
58  **示例**<br>
59  ![set](figures/param-set.png)
60
61## 等待系统参数值匹配
62
63* 同步等待指定name系统参数与指定值value匹配，命令格式如下：
64
65  ```bash
66  param wait name [value] [timeout]
67  ```
68  **示例**<br>
69  ![wait](figures/param-wait.png)
70
71## 保存persist(可持久化)参数
72
73* 保存persist(可持久化)参数到工作空间，命令格式如下：
74
75  ```bash
76  param save
77  ```
78  **示例**<br>
79  ![save](figures/param-save.png)
80