WIFI/BT
2025-12-05
Quectel Pi H1 单板电脑支持 QCA1023 SDIO Wifi。本文介绍如何使用 Network Manager 连接Wi-Fi热点。
nmcil 是一个用户空间的程序，是 Linux 系统中 NetworkManager 提供的命令行工具，用于管理网络连接，特别适用于图形界面不可用或自动化脚本环境下。可以用它来配置以太网、Wi-Fi、VLAN、桥接、代理、VPN 等连接。以下教程将演示如何通过 nmcli 连接到 Wi-Fi 热点。
WIFI功能使用
打开无线功能
使用命令来打开无线功能，相当于桌面版的 “打开 Wi-Fi 开关”。
nmcli radio wifi on
查看可用 WiFi 列表
执行命令，扫描并列出当前无线网卡探测到的 Wi-Fi 网络。该命令会显示附近的 WiFi 网络以及它们的名称（SSID）、信号强度、频道和加密方式等信息。
nmcli dev wifi list ifname wlan0
返回如下，可以看到周围的热点信息。
root@QuecPi:~# nmcli dev wifi list ifname wlan0
IN-USE BSSID SSID MODE CHAN RATE SIGNAL BARS SECURITY
64:09:80:76:42:BE Xiaomi_42BD Infra 11 130 Mbit/s 100 ▂▄▆█ WPA1 WPA2
* F8:5E:3C:01:F8:18 xiupax Infra 11 130 Mbit/s 100 ▂▄▆█ --
9C:9D:7E:F7:30:5E tdz Infra 2 130 Mbit/s 97 ▂▄▆█ WPA1 WPA2
E2:F1:E1:57:D5:C6 gms-wifi Infra 1 0 Mbit/s 95 ▂▄▆█ WPA1 WPA2
E2:F1:E1:57:D5:C8 cit-test-5g Infra 1 0 Mbit/s 94 ▂▄▆█ WPA2
48:5F:08:BB:BA:41 TP-LINK_BA41 Infra 11 270 Mbit/s 87 ▂▄▆█ --
64:09:80:76:42:BF Xiaomi_42BD_5G Infra 157 270 Mbit/s 82 ▂▄▆█ WPA1 WPA2
B4:2F:03:DA:23:B5 5G_RRO_A23B5 Infra 157 135 Mbit/s 79 ▂▄▆_ WPA1 WPA2
A2:A7:90:A7:5B:A0 LSMate30 Infra 149 270 Mbit/s 77 ▂▄▆_ WPA2
A4:00:E2:EF:F7:83 Quectel-HF Infra 1 260 Mbit/s 74 ▂▄▆_ WPA1 WPA2 802.1X
F0:2F:74:2A:41:78 odmtest Infra 1 260 Mbit/s 74 ▂▄▆_ WPA3
2C:CF:67:6B:4A:86 HW-676B4A85 Infra 36 117 Mbit/s 74 ▂▄▆_ WPA1
A4:00:E2:EF:F7:82 Quectel-HF-2.4G Infra 1 260 Mbit/s 72 ▂▄▆_ WPA1 WPA2 802.1X
A4:00:E2:EF:F7:80 Quectel-Customer-2.4G Infra 1 260 Mbit/s 72 ▂▄▆_ WPA1 WPA2
66:D6:9A:C6:6D:21 PAXWIFIAP_2.4G Infra 1 130 Mbit/s 72 ▂▄▆_ WPA2
A4:00:E2:EF:F7:90 Quectel-Customer Infra 44 540 Mbit/s 72 ▂▄▆_ WPA1 WPA2
A4:00:E2:EF:F7:92 Quectel-HF Infra 44 540 Mbit/s 72 ▂▄▆_ WPA1 WPA2 802.1X
9C:9D:7E:F7:30:5F tdz Infra 149 270 Mbit/s 70 ▂▄▆_ WPA1 WPA2
34:CE:00:09:E5:A8 SW_test Infra 6 130 Mbit/s 69 ▂▄▆_ WPA1 WPA2
E2:F1:E1:57:D5:CA gms-wifi_5G Infra 149 270 Mbit/s 69 ▂▄▆_ WPA1 WPA2
E2:F1:E1:57:D5:CE cit-test-5g Infra 149 270 Mbit/s 69 ▂▄▆_ WPA2
F0:2F:74:2A:41:7C odmtest-5G Infra 161 540 Mbit/s 65 ▂▄▆_ WPA2
A4:00:E2:EF:F8:52 Quectel-HF Infra 36 540 Mbit/s 57 ▂▄▆_ WPA1 WPA2 802.1X
A4:00:E2:EF:F8:50 Quectel-Customer Infra 36 540 Mbit/s 57 ▂▄▆_ WPA1 WPA2
3C:7C:3F:0B:94:FC HWTEST Infra 161 540 Mbit/s 52 ▂▄__ WPA2
A4:00:E2:EF:F4:50 Quectel-Customer Infra 149 540 Mbit/s 49 ▂▄__ WPA1 WPA2
A4:00:E2:EF:F4:52 Quectel-HF Infra 149 540 Mbit/s 47 ▂▄__ WPA1 WPA2 802.1X
连接 WiFi 网络
选择要连接的 WiFi 网络，并执行命令nmcli dev wifi connect "你的WiFi名称" password "你的密码"来连接到该网络。例如，nmcli dev wifi connect "MyHomeWiFi" password "12345678"。如果网络没有密码，则不需要提供password参数。
连接加密热点：
root@QuecPi:~# nmcli dev wifi connect "SSID" password "12345678" ifname wlan0
Device 'wlan0' successfully activated with 'd0ef4183-ac40-41d5-8822-2cc174107c77'.
连接开放热点：
root@QuecPi:~# nmcli dev wifi connect "SSID" ifname wlan0
Device 'wlan0' successfully activated with 'd0ef4183-ac40-41d5-8822-2cc174107c77'.
使用 ifconfig 命令查看网络接口地址：
root@qcm6490-idp:~# ifconfig
eth0 Link encap:Ethernet HWaddr 32:C0:A2:09:FE:40
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
Interrupt:167 Base address:0x1000
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:65536 Metric:1
RX packets:75 errors:0 dropped:0 overruns:0 frame:0
TX packets:75 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:6301 (6.1 KiB) TX bytes:6301 (6.1 KiB)
p2p0 Link encap:Ethernet HWaddr 02:03:7F:D6:00:01
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:3000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
wlan0 Link encap:Ethernet HWaddr 00:03:7F:50:00:01
inet addr:192.168.253.211 Bcast:192.168.253.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:3421 errors:0 dropped:0 overruns:0 frame:0
TX packets:61 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:3000
RX bytes:151273 (147.7 KiB) TX bytes:7300 (7.1 KiB)
可以发现 wlan0 口已经获取 IP。
测试网络
执行 ping 命令测试网络连接：
- 执行
ping 192.168.1.1命令，如果 ping 通则表示局域网网络连接正常【这里的目的 ip 需要修改为实际网络的网关地址】。 - 执行
ping 114.114.114.114命令，如果 ping 通则表示外网网络连接正常。 - 执行
ping baidu.com命令，如果 ping 通则表示外网网络连接正常且 DNS 解析功能正常。
蓝牙功能使用
Quectel Pi H1 单板电脑支持 QCA1023 HCI UART 蓝牙模块， 可以支持蓝牙外设连接。 接下来将介绍如何使用蓝牙模块连接键鼠进行测试。
蓝牙模块启动
蓝牙模块为 HCI UART 连接主控， 通过HCI H4协议进行通信。
首先通过设备节点给外设供电，当往节点echo 0 时，则给蓝牙外设下电。
echo 1 > /sys/devices/platform/rfkill/bt_en
通过 hciattach 命令，通过串口初始化蓝牙模块。
hciattach /dev/ttyHS1 qca 3000000 flow
通过 hciconfig 命令，查询并且启用 hci 蓝牙设备。
hciconfig hci0 up
查询 hci 设备状态，通过 hciconfig 查询，当状态为 UP RUNNING 的情况下，说明hci蓝牙设备已经启用。
root@qcm6490-idp:~# hciconfig
hci0: Type: Primary Bus: UART
BD Address: 00:00:00:00:5A:AD ACL MTU: 1024:7 SCO MTU: 60:8
UP RUNNING
RX bytes:783665 acl:1106 sco:0 events:18678 errors:0
TX bytes:4072 acl:57 sco:0 commands:305 errors:0
连接蓝牙外设
执行 bluetoothctl 命令，进入蓝牙配置工具，命令提示符变成[bluetooth]#，表示已经进入蓝牙控制模式。
root@qcm6490-idp:~# bluetoothctl
[bluetooth]#
执行 scan on 命令，此时会执行蓝牙扫描命令，会显示周边蓝牙设备信息，此时需要打开蓝牙设备的配对模式 ，放在旁边。
[bluetooth]# scan on
扫描到一定时间后，执行 scan off，停止 scan。
[bluetooth]# scan off
执行 devices 指令，列出扫描到的设备，找到你的蓝牙外设，此处以蓝牙鼠标为例。
[bluetooth]# devices
Device C3:3E:68:5E:E7:1F MX Master 2S
使用 pair 命令，进行连接，地址为你的外设地址。
[bluetooth]# pair C3:3E:68:5E:E7:1F
若 Pair 成功，终端可能弹出配对码提示。此时按照界面提示点击“配对”或在命令行输入 yes 确认，确保连接过程继续进行。
当输出 CHG 的日志时，说明pair成功。此时可以发现，我们的鼠标被注册到 input 设备下，这里是input5（根据实际注册地址为准）。
[CHG] Device C3:3E:68:5E:E7:1F Modalias: usb:v046DpB019d0006
[MX Master 2S]# [ 1157.381232][ T1737] input: MX Master 2S Keyboard as /devices/virtual/misc/uhid/0005:046D:B019.0001/input/input4
[ 1157.392409][ T1737] input: MX Master 2S Mouse as /devices/virtual/misc/uhid/0005:046D:B019.0001/input/input5
将设备添加为 trust 并且连接（可选：如果设备自动连接则可跳过）。
[MX Master 2S]# trust C3:3E:68:5E:E7:1F
Changing C3:3E:68:5E:E7:1F trust succeeded
[MX Master 2S]# connect C3:3E:68:5E:E7:1F
Attempting to connect to C3:3E:68:5E:E7:1F
Connection successful
验证外设
此时，我们可以用 evtest工具来验证外设是否可用，输入 evtest 命令，会显示可使用的 event 设备，这时我们选择我们的鼠标编号 5。
root@qcm6490-idp:~# evtest
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0: pm8xxx_vib_ffmemless
/dev/input/event1: gpio-keys
/dev/input/event2: pmic_pwrkey
/dev/input/event3: pmic_resin
/dev/input/event4: MX Master 2S Keyboard
/dev/input/event5: MX Master 2S Mouse
Select the device event number [0-5]:
当出现如下打印则大功告成，可以通过移动鼠标按键来测试是否有事件上报。
Input driver version is 1.0.1
Input device ID: bus 0x5 vendor 0x46d product 0xb019 version 0x6
Input device name: "MX Master 2S Mouse"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 272 (BTN_LEFT)
Event code 273 (BTN_RIGHT)
Event code 274 (BTN_MIDDLE)
Event code 275 (BTN_SIDE)
Event code 276 (BTN_EXTRA)
Event code 277 (BTN_FORWARD)
Event code 278 (BTN_BACK)
Event code 279 (BTN_TASK)
Event code 280 (?)
Event code 281 (?)
Event code 282 (?)
Event code 283 (?)
Event code 284 (?)
Event code 285 (?)
Event code 286 (?)
Event code 287 (?)
Event type 2 (EV_REL)
Event code 0 (REL_X)
Event code 1 (REL_Y)
Event code 6 (REL_HWHEEL)
Event code 8 (REL_WHEEL)
Event code 11 (REL_WHEEL_HI_RES)
Event code 12 (REL_HWHEEL_HI_RES)
Event type 4 (EV_MSC)
Event code 4 (MSC_SCAN)
Properties:
Testing ... (interrupt to exit)
Event: time 2618.445029, type 4 (EV_MSC), code 4 (MSC_SCAN), value 90001
Event: time 2618.445029, type 1 (EV_KEY), code 272 (BTN_LEFT), value 1
Event: time 2618.445029, -------------- SYN_REPORT ------------
Event: time 2618.610162, type 4 (EV_MSC), code 4 (MSC_SCAN), value 90001
Event: time 2618.610162, type 1 (EV_KEY), code 272 (BTN_LEFT), value 0
Event: time 2618.610162, -------------- SYN_REPORT ------------
配置蓝牙设备作为BLE外设
Quectel Pi H1 支持将蓝牙设备配置为低功耗（BLE）外设进行广播，允许其他BLE设备（如手机、平板）发现和连接。
操作步骤
启动蓝牙广告广播
bluetoothctl> advertise on开启蓝牙广告功能，创建广告实例，设备设置为可被发现状态。
配置广告参数
通过底层蓝牙管理协议配置：- 设置IO能力为
KeyboardDisplay - 配置扩展广告参数（可连接模式，广播间隔1280ms）
- 设置广告数据Flags（LE General Discoverable Mode，仅支持BLE）
- 启用广告广播
- 设置IO能力为
查看设备状态
bluetoothctl> show查看蓝牙控制器信息，包括设备名称、MAC地址、支持的角色和GATT服务等。
技术特性
- 设备角色：支持BLE外设（Peripheral）和中心设备（Central）角色
- 连接能力：可连接、可被发现
- GATT服务：支持丰富的GATT服务，包括：
- 通用属性配置文件（GATT）
- 设备信息服务
- 音频相关服务（Source、Sink、Headset等）
- 消息通知服务
- 电话簿访问（PBA）
- 厂商特定服务
系统支持
- BLE GATT via BlueZ 5：通过BlueZ 5.x支持BLE GATT协议
- 自动广播：支持自动开启广告广播
- 自动配对：支持自动配对功能
应用场景
- 蓝牙传感器网关
- 智能家居控制设备
- 蓝牙音频设备
- 消息通知中心
- 远程控制设备