设备调试

通过 USB 串口和 QMI 查看 BG96 状态、切换网络模式、恢复出厂设置。

---

串口连接

查看串口

root@OpenWrt:~# ls /dev/ttyUSB*
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3

端口	用途
/dev/ttyUSB0	诊断（DM）
/dev/ttyUSB1	NMEA
/dev/ttyUSB2	AT 指令
/dev/ttyUSB3	AT / Modem

本机实测 ttyUSB2、ttyUSB3 均可作为 AT 口。 不确定时对 ttyUSB0 ~ ttyUSB3 逐个发送 ATI，返回 Quectel / BG96 的即为 AT 口。

进入 minicom

minicom -D /dev/ttyUSB2 -b 115200

发送 AT，返回 OK 即通信正常：

AT
OK

退出：Ctrl + A，再按 X，选择 Yes。

提示

本机实测 AT 口波特率为 115200；若使用其他固件无返回，可尝试 9600。

---

常用 AT 指令

基础信息

指令	说明	示例返回
AT	测试通信	OK
ATI	模块型号与固件版本	Quectel / BG96 / Revision: BG96MAR03A06M1G
AT+QGMR	固件完整版本	BG96MAR03A06M1G_01.005.01.005
AT+CPIN?	SIM 卡状态	+CPIN: READY
AT+CSQ	信号质量	+CSQ: 19,99
AT+QCSQ	信号强度明细	+QCSQ: "GSM",-76
AT+CFUN?	射频状态	+CFUN: 1

AT+CSQ 第一个值为信号强度（0~31，越大越好，99 表示未知）。

网络模式

AT+QCFG="nwscanmode"
+QCFG: "nwscanmode",0

AT+QCFG="iotopmode"
+QCFG: "iotopmode",0

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

设置后需要重启模块：

AT+QCFG="nwscanmode",3
OK

AT+QCFG="iotopmode",2
OK

AT+CFUN=1,1
OK

NB-IoT 附着较慢，注册可能需要 1~3 分钟。

USB 模式

AT+QCFG="usbnet"
ERROR

AT+QCFGEXT="usbnet"
ERROR

BG96 当前固件不支持 USB 组合切换，USB 接口固定为 DIAG / NMEA / AT / AT-Modem / QMI 五个。 数据上网必须使用 QMI（/dev/cdc-wdm0）。

注册与数据状态

指令	说明
AT+CEREG?	LTE（Cat M1 / NB-IoT）注册状态
AT+CGREG?	GPRS 注册状态
AT+COPS?	当前运营商
AT+QNWINFO	当前网络制式、频段
AT+CGDCONT?	APN 配置
AT+CGATT?	附着状态

注册状态含义：

返回	含义
+CEREG: 0,1	已注册（本地网）
+CEREG: 0,5	已注册（漫游）
+CEREG: 0,2	正在搜索
+CEREG: 0,3	注册被拒绝
+CEREG: 0,0	未注册，且未搜索

注意

在无服务环境下执行 AT+COPS=? 可能长时间无响应，并导致 AT 口被阻塞（本机实测 AT 不再返回）。 此时需要断电或重新插拔模块恢复，不要反复发送指令。

复位与重启

指令	功能	说明
AT+CFUN=1,1	软件重启	最常用，重启后自动重新注册网络
AT&F	恢复 AT 指令默认设置	不影响用户数据
AT+QPRTPARA=3	恢复 NV 出厂配置	会清除 APN、网络模式等配置
AT+QPOWD=1	关机	需重新上电才能启动

注意

AT+QPRTPARA=3 为恢复出厂操作，执行后需要 AT+CFUN=1,1 重启； 重启后 APN、nwscanmode、iotopmode 均恢复默认，需要重新配置。

---

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"
        ]
}

查看信号

root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-signal-info

查看 / 修改工作模式

root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-device-mode
root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --set-device-mode low-power

常规调试不需要手动 --start-network，OpenWrt 的 proto qmi 会自动拨号。

---

完整检查流程

AT
OK

ATI
Quectel
BG96
Revision: BG96MAR03A06M1G

OK

AT+CPIN?
+CPIN: READY

OK

AT+CSQ
+CSQ: 19,99

OK

AT+CEREG?
+CEREG: 0,1

OK

AT+QNWINFO
+QNWINFO: "CAT-NB1","46011","LTE BAND 5",2405

OK

AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","ctnet",...

OK

+CEREG: 0,1 且 +CSQ 不为 99，说明模块已成功注册。

---

完整复位流程

AT
OK

AT&F
OK

AT+QPRTPARA=3
OK

AT+CFUN=1,1
OK

等待 30~60 秒，模块重新枚举后，再按 快速安装 - Linux / OpenWrt 配置网络模式和 QMI 上网。

---

常见问题

现象	排查
发送 AT 无返回	确认端口与波特率；尝试 ttyUSB2 / ttyUSB3、115200 / 9600
执行 AT+COPS=? 后 AT 全部无响应	扫描阻塞，重新插拔模块上电
AT 无响应且串口时有时无	模块在反复 USB 重枚举，dmesg 可见 USB disconnect；换带供电 HUB / 确认 SIM 业务
+CSQ: 99,99 持续较久	模块正在搜网；检查天线与 SIM 是否开通 Cat M1/NB-IoT
+CEREG: 0,3	注册被拒绝，多为 SIM 业务/套餐限制
无 wwan0	未安装 kmod-usb-net-qmi-wwan
有 wwan0 但无 IP	uqmi --get-serving-system 确认注册状态，再检查 APN