param工具
=======

param是为开发人员提供用于操作系统参数的工具，该工具只支持标准系统。

#### 环境要求

*   获取hdc工具，执行hdc shell。
*   正常连接设备。

#### param工具命令列表

| 选项 | 说明 |
| :-- | :-- |
| \-h | 获取param支持的命令。 |
| ls \[-r\] \[name\] | 显示匹配name的系统参数信息。带"-r"则根据参数权限获取信息，不带"-r"则直接获取参数信息。 |
| get \[name\] | 获取指定name系统参数的值；若不指定任何name，则返回所有系统参数。 |
| set name value | 设置指定name系统参数的值为value。 |
| wait name \[value\] \[timeout\] | 同步等待指定name系统参数与指定值value匹配。value支持模糊匹配，如"\*"表示任何值，"val\*"表示只匹配前三个val字符。timeout为等待时间（单位：s），不设置则默认为30s。 |
| save | 保存persist参数到工作空间。 |

#### 获取param支持的命令

*   获取param支持的命令，命令格式如下：
    
    param -h
    

#### 获取系统参数信息

*   显示匹配name的系统参数信息，命令格式如下：
    
    param ls \[-r\] \[name\]
    
    **示例**
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3d/v3/STYwooiwSTmTzqAAXyw9SA/zh-cn_image_0000002594668764.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=BA776B945CB7575183DEABB438A1091F17B63F77169A42A042A74F63AF1B414D)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fa/v3/iKUmMx9_TSeMLMFkEC8-RA/zh-cn_image_0000002594828692.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=5B558ED11C3F28017CC17B70EC65CEC3EDCACA27E1AE26CF97FBE042D6416B70)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e7/v3/XeZ7TplfTU6W5KHFzivO8A/zh-cn_image_0000002625188139.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=5F94E95F552BD38433B74484923F02956CAE9863BFA73A656928EF98184B8602)
    

#### 获取系统参数的值

*   获取指定name系统参数的值，命令格式如下：
    
    param get \[name\]
    
    **示例**
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3e/v3/XIG3n-6ORq-t7aGdMaF0cA/zh-cn_image_0000002625108283.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=6CD76CE128A2592FBB4845BE1F5B856F5A81B227E21DD267AD5D74A8E5F01BFC)
    

#### 设置系统参数的值

*   设置指定name系统参数的值为value，命令格式如下：
    
    param set name value
    
    **示例**
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/86/v3/58YKhSe8SWecFaHnO430cQ/zh-cn_image_0000002594668766.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=35C27319106B7114FECA637A289F48D26192FE9E50C896ECEBD5CE6C9CBED433)
    

#### 等待系统参数值匹配

*   同步等待指定name系统参数与指定值value匹配，命令格式如下：
    
    param wait name \[value\] \[timeout\]
    
    **示例**
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/75/v3/lL0-LyY1RsmZZW19pYDU1w/zh-cn_image_0000002594828694.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=3B30361209FD3350910CFF473B45D9AF7914BB0D0B43F3860CBBCE198F3FDFB8)
    

#### 保存persist(可持久化)参数

*   保存persist(可持久化)参数到工作空间，命令格式如下：
    
    param save
    
    **示例**
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/43/v3/5G4YsJjRTUamEPG_jCvTkQ/zh-cn_image_0000002625188141.png?HW-CC-KV=V1&HW-CC-Date=20260612T073500Z&HW-CC-Expire=86400&HW-CC-Sign=397F86E70EE0338C2CA9F14E9B43DAA04C7934AB4C9F5D45E9B4B40557F62CEC)
    

#### 系统参数错误码说明

**错误码说明**

错误码详情参考[系统参数](https://gitcode.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-boot-init-sysparam.md#系统参数错误码说明)文档描述