设备调试

通过 USB 串口查看 EC25-AF 状态、SIM 卡槽、切换工作模式、恢复出厂设置。
串口连接
查看串口
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(备用) |
EC25 切换到 ECM 模式后串口依然存在,无需切换 USB 组合即可调试。
实测注意:AT 口常见为
/dev/ttyUSB2,但重新插拔模块后可能变为/dev/ttyUSB3。 不确定时对ttyUSB0~ttyUSB3逐个发送ATI,返回Quectel的即为 AT 口。
进入 minicom
minicom -D /dev/ttyUSB2 -b 115200
若 AT 口实际为
/dev/ttyUSB3,把命令中的端口替换即可。
发送 AT,返回 OK 即通信正常:
AT
OK
退出:Ctrl + A,再按 X,选择 Yes。
- 本机实测 AT 口波特率为
115200;若使用其他固件无返回,可尝试9600。 - 指令以回车结尾,minicom 中直接按回车即可。
SIM 卡槽检查
查看 SIM 插入状态
AT+CPIN?
+CPIN: READY
AT+QSIMSTAT?
+QSIMSTAT: 0,1
AT+QSIMDET?
+QSIMDET: 0,0
| 返回 | 含义 |
|---|---|
+CPIN: READY | SIM 卡已识别 |
+CME ERROR: 10 | SIM not inserted(未插卡或卡槽未接通) |
+QSIMSTAT: 0,1 | 检测功能关闭,当前已插卡 |
+QSIMDET: 0,0 | SIM 卡检测功能未启用 |
查看卡内信息
AT+CIMI
460001234567890
AT+QCCID
+QCCID: 89860012345678901234
AT+CNUM
+CNUM: "My Number","+8613800000000",145
能读到 IMSI / CCID / 本机号码,说明 SIM 卡与卡槽链路正常。
逻辑 SIM 通道
AT+QUIMSLOT?
ERROR
AT+QCFG="simslot"
ERROR
EC25-AF 当前固件不支持上述指令,无法通过软件切换 SIM1 / SIM2。 实测模块本体卡槽与 USB 底座卡槽均能识别同一张 SIM 卡(IMSI / CCID 一致), 两个卡座对应同一路 USIM(SIM1),详见 快速安装 - Linux / OpenWrt。
常用 AT 指令
基础信息
| 指令 | 说明 | 示例返回 |
|---|---|---|
AT | 测试通信 | OK |
ATI | 模块型号与固件版本 | Quectel / EC25-AF(D) / Revision: EC25AFFDR07A08M4G |
AT+QGMR | 固件完整版本 | EC25AFFDR07A08M4G_01.002.01.002 |
AT+CPIN? | SIM 卡状态 | +CPIN: READY |
AT+CSQ | 信号质量 | +CSQ: 24,99 |
AT+CFUN? | 射频状态 | +CFUN: 1 |
AT+QTEMP | 模块温度 | +QTEMP: 38,36,35 |
AT+CSQ第一个值为信号强度(0~31,越大越好,99 表示未知)。复位重启后模块需要 1~2 分钟重新搜网,期间
+CSQ: 99,99、+CEREG: 0,2属于正常现象。
USB 工作模式
AT+QCFG="usbnet"
+QCFG: "usbnet",0
OK
| 参数 | 模式 | 系统侧驱动 |
|---|---|---|
| 0 | QMI / RMNET | kmod-usb-net-qmi-wwan + uqmi(出厂默认) |
| 1 | ECM | kmod-usb-net-cdc-ether |
| 2 | MBIM | kmod-usb-net-cdc-mbim + umbim |
| 3 | RNDIS | kmod-usb-net-rndis |
切换模式(以 ECM 为例):
AT+QCFG="usbnet",1
OK
AT+CFUN=1,1
修改后必须重启模块,USB 会重新枚举。
APN 配置
AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","ctnet",...
+CGDCONT: 2,"IPV4V6","ims",...
+CGDCONT: 3,"IPV4V6","",...
AT+CGDCONT=1,"IPV4V6","cmnet"
OK
AT+CFUN=1,1
恢复出厂后
cid=1的 APN 为空,必须重新设置;ECM 模式下模块使用cid=1自动拨号。
注册与数据状态
| 指令 | 说明 |
|---|---|
AT+CEREG? | EPS 注册状态 |
AT+CGREG? | GPRS 注册状态 |
AT+COPS? | 当前运营商 |
AT+QNWINFO | 当前网络制式、频段 |
AT+QCSQ | 信号强度明细 |
AT+QENG="servingcell" | 当前驻留小区信息 |
AT+CGACT? | PDP 激活状态 |
AT+CGPADDR | PDP 分配的 IP 地址 |
注册状态含义:
| 返回 | 含义 |
|---|---|
+CEREG: 0,1 | 已注册(本地网) |
+CEREG: 0,5 | 已注册(漫游) |
+CEREG: 0,2 | 正在搜索 |
+CEREG: 0,3 | 注册被拒绝 |
+CEREG: 0,0 | 未注册,且未搜索 |
复位与重启
| 指令 | 功能 | 说明 |
|---|---|---|
AT+CFUN=1,1 | 软件重启 | 最常用,重启后自动重新注册网络 |
AT&F | 恢复 AT 指令默认设置 | 不影响用户数据 |
AT+QPRTPARA=3 | 恢复 NV 出厂配置 | 会清除 APN、USB 模式等配置 |
AT+QPOWD=1 | 关机 | 需重新上电才能启动 |
AT+QPRTPARA=3 为恢复出厂操作,执行后需要 AT+CFUN=1,1 重启;
重启后 usbnet 恢复默认 0、APN 被清空,需要重新配置。
完整检查流程
AT
OK
ATI
Quectel
EC25-AF(D)
Revision: EC25AFFDR07A08M4G
OK
AT+CPIN?
+CPIN: READY
OK
AT+CSQ
+CSQ: 24,99
OK
AT+CEREG?
+CEREG: 0,1
OK
AT+COPS?
+COPS: 0,0,"CHN-CT",7
OK
AT+QENG="servingcell"
+QENG: "servingcell","NOCONN","LTE","FDD",460,11,D103518,265,2452,5,3,3,754B,-92,-10,-65,13,27
OK
AT+CGPADDR
+CGPADDR: 1,"10.2.120.182,..."
OK
+CEREG: 0,1且+CSQ不为 99,说明模块已成功注册;AT+CGPADDR中cid=1不为0.0.0.0说明数据链路已建立。
完整复位流程
AT
OK
AT&F
OK
AT+QPRTPARA=3
OK
AT+CFUN=1,1
OK
等待 30~60 秒,模块重新枚举后,再按 快速安装 - Linux / OpenWrt 配置 ECM 模式与 APN。
常见问题
| 现象 | 排查 |
|---|---|
| 发送 AT 无返回 | 确认端口为 /dev/ttyUSB2,波特率 115200(或 9600) |
指令返回 ERROR | 检查拼写;部分指令需要 SIM 就绪或射频开启 |
| 执行指令后 USB 消失 | 正常现象,模块正在重启,等待重新枚举 |
有 +CPIN: READY 但无 IP | 检查 usbnet 模式与接口 proto 是否为 dhcp |
| 有 IP 但无法上网 | 检查 AT+CGDCONT? 中 cid=1 的 APN 是否与 SIM 运营商匹配 |
+CSQ: 99,99 持续较久 | 模块正在搜网,检查天线;可用 AT+QENG="servingcell" 确认驻留状态 |