快速安装 - Linux / OpenWrt

BG96 安装

Linux / OpenWrt 平台快速使用 BG96 LTE Cat M1 / NB-IoT Dongle

需要准备

1. 一台 Linux 设备（本文以 OpenWrt / ImmortalWrt 路由器为例）
2. Dongle BG96 及 USB 数据线
3. 一张已开通 LTE Cat M1 或 NB-IoT 的 Nano-SIM 卡
4. 路由器的 WAN 口可以正常上网（用于下载驱动）

重要提示

BG96 与 EC20/EC25/EG25 的 USB 方式不同：

• BG96 的 USB 组合是固定的，固件没有 AT+QCFG="usbnet" / AT+QCFGEXT="usbnet"（实测均返回 ERROR）
• 数据上网走 QMI（/dev/cdc-wdm0 + wwan0），需要 kmod-usb-net-qmi-wwan + uqmi
• 普通 4G SIM 卡不能用于 BG96；SIM 必须开通 Cat M1 / NB-IoT 业务，否则会一直停留在搜网状态

---

接入设备

安装 Nano-SIM 卡

1. 如设备带有 USB 保护盖，先取下保护盖（无外壳的裸板设备可跳过此步）
2. 按卡槽标识方向将 Nano-SIM 卡推入卡槽

接入路由器 USB 接口

注意：BG96 注册网络时瞬态电流较大，部分路由器 USB 口供电不足会导致模块反复重启（dmesg 中可看到连续的 USB disconnect）。建议使用带独立供电的 USB HUB。

---

配置 Dongle - 路由器部分

连接到路由器

ssh root@192.168.1.1

检查 USB 设备

root@OpenWrt:~# lsusb

预期输出：

Bus 001 Device 002: ID 2c7c:0296 Quectel Wireless Solutions Co., Ltd. BG96 CAT-M1/NB-IoT modem

如果提示 lsusb: not found：

# opkg
opkg update && opkg install usbutils

# apk
apk update && apk add usbutils

查看 USB 接口组成

root@OpenWrt:~# for i in /sys/bus/usb/devices/1-1:1.*; do echo "$i $(cat $i/bInterfaceClass)/$(cat $i/bInterfaceSubClass)/$(cat $i/bInterfaceProtocol)"; done

BG96 固定为 5 个接口：

接口	Class	用途
1-1:1.0	ff/ff/ff	DIAG
1-1:1.1	ff/ff/ff	NMEA
1-1:1.2	ff/ff/ff	AT
1-1:1.3	ff/fe/ff	AT / Modem
1-1:1.4	ff/ff/ff	QMI

安装驱动和工具

USB 串口驱动（用于 AT 指令）：

# opkg
opkg update
opkg install kmod-usb-serial-option

# apk
apk update
apk add kmod-usb-serial-option

QMI 驱动和拨号工具：

# opkg
opkg install kmod-usb-net-qmi-wwan uqmi

# apk
apk add kmod-usb-net-qmi-wwan uqmi

串口工具：

# opkg
opkg install minicom

# apk
apk add minicom

安装完成后确认：

root@OpenWrt:~# ls /dev/ttyUSB* /dev/cdc-wdm* /sys/class/net/wwan0

预期输出：

/dev/cdc-wdm0
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3
/sys/class/net/wwan0

EC20/EC25 的 ECM 网卡是 usb0；BG96 走 QMI，所以看到的是 wwan0 + /dev/cdc-wdm0。

AT 串口

root@OpenWrt:~# ls /dev/ttyUSB*

BG96 通常 /dev/ttyUSB2 和 /dev/ttyUSB3 都可以作为 AT 口，本机实测波特率为 115200。

不确定时对 /dev/ttyUSB0 ~ /dev/ttyUSB3 逐个发送 ATI，返回 Quectel / BG96 的即为 AT 口。

---

恢复出厂复位

注意

复位会清除 APN、频段、搜网模式等配置。新设备或配置混乱时建议执行。

1. 进入 AT 终端

minicom -D /dev/ttyUSB2 -b 115200

2. 恢复出厂并重启

AT&F
OK

AT+QPRTPARA=3
OK

AT+CFUN=1,1
OK

重启后 USB 会重新枚举，等待 30~60 秒。

复位后 APN、nwscanmode、iotopmode 都会恢复默认，需要重新配置。

3. 退出 minicom

按 Ctrl + A，再按 X，选择 Yes。

---

设置网络模式

BG96 支持 LTE Cat M1、NB-IoT 和 GSM/EGPRS。中国大陆的 Cat M1 / NB-IoT 主要使用 LTE 频段， 建议关闭 2G 搜网：

AT+QCFG="nwscanmode",3
OK

AT+QCFG="iotopmode",2
OK

AT+CFUN=1,1
OK

指令	参数	说明
AT+QCFG="nwscanmode"	0	自动（GSM + LTE）
	1	仅 GSM
	3	仅 LTE
AT+QCFG="iotopmode"	0	仅 Cat M1
	1	仅 NB-IoT
	2	Cat M1 + NB-IoT

NB-IoT 附着较慢，重启后可能需要 1~3 分钟才能注册，期间 +CSQ: 99,99、+CEREG: 0,2 属于正常现象。

配置 APN

AT+CGDCONT=1,"IPV4V6","ctnet"
OK

AT+CFUN=1,1

APN 以运营商要求为准。普通 4G SIM 的 APN（如 ctnet）即使填写正确，没有开通 Cat M1 / NB-IoT 业务也无法注册。

---

配置上网（QMI）

方式一：命令行（UCI）

单 WAN 场景：

uci set network.wan.proto='qmi'
uci set network.wan.device='/dev/cdc-wdm0'
uci set network.wan.apn='ctnet'

uci commit network
service network reload

多 WAN 场景（蜂窝作为备份）：

uci set network.wan3=interface
uci set network.wan3.proto='qmi'
uci set network.wan3.device='/dev/cdc-wdm0'
uci set network.wan3.apn='ctnet'
uci set network.wan3.metric='20'

uci commit network
service network reload

metric 数值越小优先级越高；主线路保持 0，蜂窝设为 20。

方式二：Web 界面

1. 打开 网络 → 接口 → 添加新接口
2. 协议选择 QMI Cellular
3. 设备选择 /dev/cdc-wdm0
4. 填写 APN
5. 点击 保存 → 保存并应用

关于 IPv6

QMI 接口的 IPv6 由 wan6 在 wwan0 上通过 DHCPv6 获取：

uci set network.wan6.proto='dhcpv6'
uci set network.wan6.device='wwan0'
uci commit network
service network reload

---

验证

查看接口状态

root@OpenWrt:~# ifstatus wan

确认 "up": true 并获取到 10.x.x.x 或运营商分配的地址。

查看路由

root@OpenWrt:~# ip route

测试上网

root@OpenWrt:~# ping -I wwan0 -c 3 223.5.5.5

用 QMI 查看注册状态

root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-serving-system

{
        "registration": "registered",
        "plmn_mcc": 460,
        "plmn_mnc": 11,
        "radio_interface": [
                "lte"
        ]
}

"registration": "searching" 表示尚未注册；"radio_interface": ["none"] 表示没有驻留任何网络。

---

本机实测结论

在 ImmortalWrt 25.12.2（MT7981，内核 6.12）上实测：

• 模块 BG96，固件 BG96MAR03A06M1G_01.005.01.005
• USB ID 2c7c:0296，固定 5 个接口，识别出 /dev/ttyUSB0 ~ /dev/ttyUSB3、/dev/cdc-wdm0、wwan0
• 固件不支持 AT+QCFG="usbnet" / AT+QCFGEXT="usbnet"（均返回 ERROR），无法切换到 ECM/RNDIS
• 恢复出厂后 usbnet 相关配置不存在，数据只能走 QMI
• 使用中国电信普通 4G SIM（ctnet）测试：SIM 可识别（+CPIN: READY）
  • nwscanmode=3 + iotopmode=1（仅 NB-IoT）时，模块曾驻留 CAT-NB1（46011，LTE BAND 5，EARFCN 2405），但信号很弱（+CSQ: 5,99），注册被拒绝：+CEREG: 0,3
  • iotopmode=0（仅 Cat M1）时完全无服务：+QNWINFO: No Service
  • 自动模式（nwscanmode=0）下可扫描到 GSM 900（46000，中国移动），但电信 SIM 无法注册该网络
• 因此未能完成数据拨号验证
• 在 NB-IoT 搜网、注册被拒阶段，模块出现约每 60~100 秒一次的 USB 重枚举（USB disconnect → 重新枚举），AT 口随之短暂消失

结论：BG96 必须使用已开通 Cat M1 / NB-IoT 的 SIM 卡；普通 4G SIM 会被网络拒绝（+CEREG: 0,3）。本文的数据配置流程待有对应 SIM 时复测。

弱信号或搜网失败时出现 USB 反复重连，建议使用带独立供电的 USB HUB。

另外：执行 AT+COPS=? 在无服务环境下可能长时间无响应，并导致 AT 口不再响应，需要断电/重新插拔模块恢复。

---

常见问题

现象	原因	处理
lsusb 无 2c7c:0296	USB 未识别/供电不足	更换 USB 口或使用带供电 HUB
无 /dev/ttyUSB*	未安装串口驱动	安装 kmod-usb-serial-option
无 /dev/cdc-wdm0 / wwan0	未安装 QMI 驱动	安装 kmod-usb-net-qmi-wwan
有 wwan0 但无 IP	未注册 / APN 错误	用 uqmi --get-serving-system 检查注册状态
一直 +CEREG: 0,2	SIM 未开通 Cat M1/NB-IoT 或无覆盖	更换对应 SIM，确认 nwscanmode=3、iotopmode=2
+CEREG: 0,3 注册被拒绝	SIM 未开通对应业务 / 被运营商拒绝	换已开通 NB-IoT / Cat M1 的 SIM
AT 口突然无响应	AT+COPS=? 扫描阻塞	重新插拔模块上电恢复
模块反复重连	USB 供电不足 / 搜网异常	使用带供电 HUB，确认 SIM 业务是否开通

AT 指令与注册检查见 设备调试。