# qpi-config

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**qpi-config** 是用于配置 **Quectel Pi H1** 智能主控板的工具，支持以下功能：

1. 配置板载 **LED** 工作模式和亮度；

2. 配置风扇接口工作模式和风扇转速；

3. 配置 **40-Pin** 接口工作模式；

4. 查询系统各模块温度；

5. 查询系统 **CPU**、内存和存储状态；

6. 配置 **Wi-Fi**。

# 板载LED配置

执行以下命令配置工作模式：

```shell
sudo qpi-config led mode <blue|green|red> <heartbeat|none>
```

执行以下命令配置亮度：

```shell
sudo qpi-config led brightness <blue|green|red> <0-511>
```

```{image} images/image_PMG4bdN4RoGXUCxRdD1c3Ltmnlc.webp
:width: 910px
:height: 508px
```

# 风扇配置

执行以下命令配置风扇转速：

```shell
sudo qpi-config fan set speed <0-255>
```

```{image} images/image_RAPRbiDC9otGs3xcWrHcz6awnfh.webp
:width: 910px
:height: 509px
```

# 40-Pin接口工作模式配置

先修改配置文件 **/etc/qpi-config/qpi-config.ini**，再运行以下命令进行配置：

```shell
sudo qpi-config 40pin set
```

- 注意：开发板在重启后生效。

```{image} images/image_R4HlbM8hio1NfKxhk66cmi3PnSh.webp
:width: 908px
:height: 507px
```

# 查询系统各模块温度

执行以下命令查询模块温度：

```shell
sudo qpi-config dump temperature
```

```{image} images/image_YKurbfJPKoLbKkx9IlrcbKKcn6f.webp
:width: 901px
:height: 513px
```

# 查询系统CPU、内存和存储状态

执行以下命令查询系统CPU、内存和存储状态：

```shell
sudo qpi-config dump systemusage
```

```{image} images/image_ZIi6biXJaocAJpxwt2fcFWA3nZe.webp
:width: 898px
:height: 334px
```

# 配置Wi-Fi

执行以下命令扫描 **Wi-Fi**：

```shell
sudo qpi-config wifi scan
```

```{image} images/image_VSPlbD8H8oYr0wxKFpZcHEEsnqg.webp
:width: 897px
:height: 560px
```

执行以下命令查看已存在的 **Wi-Fi** 连接：

```shell
sudo qpi-config wifi show
```

执行以下命令查看 **Wi-Fi** 连接状态：

```shell
sudo qpi-config wifi dump <connection uuid>
```

执行以下命令添加 **Wi-Fi** 连接：

```shell
sudo qpi-config wifi connect <ssid> <password>
```

- 连接成功后，相应无线网络状态显示为 **Connected**，右上角会出现 **Wi-Fi** 连接图标。

```{image} images/image_OgFabr3OvoKGwDxreLBcPszFn5d.webp
:width: 1407px
:height: 785px
```

执行以下命令删除 **Wi-Fi** 连接：

```shell
sudo qpi-config wifi remove <connection uuid>
```