qpi-config¶
Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.
qpi-config 是用于配置Quectel Pi H1智能主控板的工具，支持以下功能：
配置板载LED的工作模式和亮度；
配置风扇接口的工作模式和风扇转速；
配置40-Pin接口的工作模式；
查询系统各模块温度；
配置Wi-Fi。
板载LED配置¶
执行以下命令配置LED工作模式：
sudo qpi-config led mode {blue | green | red} {heartbeat | none}
执行以下命令配置LED亮度（0-511：对应最暗到最亮）：
sudo qpi-config led brightness <blue|green|red> <0-511>
风扇配置¶
工作模式¶
风扇默认工作模式为温控自动模式，可通过以下命令改为手动模式：
sudo systemctl stop fan_ctrl
可通过以下命令恢复为温控自动模式：
sudo systemctl start fan_ctrl
风扇转速¶
手动模式下，可执行以下命令配置风扇转速（0-255：对应转速最慢到最快，0：彻底停转，255：满转速）：
sudo qpi-config fan set speed <0-255>
40-Pin接口工作模式配置¶
先修改配置文件 /etc/qpi-config/qpi-config.ini，如下图所示，可配置选项：¶
i2c9/ spi10/ uart12_2w/ pwm1/ uart4/ i2c13/ spi14，一些低速总线，可配置为 enable/ disable，分别对应使能和禁用，其中使能 spi14 前需要将 gpio47 拉高。
led_red_trigger/led_blue_trigger/led_green_trigger，红蓝绿led灯，可配置为 none/ heartbeat，分别代表手动模式和心跳模式。
led_red_brightness/led_blue_brightness/led_green_brightness，红蓝绿led灯亮度，可配置为 0~511：对应最暗到最亮。
fan_speed，风扇转速，可配置为 0~255：对应转速最慢到最快，0：彻底停转，255：满转速。
dumpenable，dump使能开关，可配置为 0/ 1，分别对应dump功能的禁用/ 使能。
lsm6dsoenable，IMU使能开关，可配置为 0/ 1，分别对应IMU功能的禁用/ 使能。
再执行以下命令并重启使配置生效：¶
sudo qpi-config 40pin set
sudo reboot
备注
配置在智能主控板重启后生效，重启前请务必保存好相关文件。
查询系统各模块温度¶
执行以下命令查询模块温度：
sudo qpi-config dump temperature
配置Wi-Fi¶
执行以下命令扫描Wi-Fi网络：
sudo qpi-config wifi scan
执行以下命令连接Wi-Fi：
sudo qpi-config wifi connect <ssid> <password>
连接成功后，相应无线网络状态显示为Connected，右上角会出现Wi-Fi连接图标。
执行以下命令查看已有的Wi-Fi连接：
sudo qpi-config wifi show
执行以下命令查看Wi-Fi连接配置详情：
sudo qpi-config wifi dump <connection_uuid>
执行以下命令删除Wi-Fi连接：
sudo qpi-config wifi remove <connection_uuid>