跳到主要内容

设备调试

导航栏

通过 USB 串口查看 EC25-AF 状态、SIM 卡槽、切换工作模式、恢复出厂设置。


串口连接​

查看串口​

root@OpenWrt:~# ls /dev/ttyUSB*
/dev/ttyUSB0 /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3
端口用途
/dev/ttyUSB0诊断(DM)
/dev/ttyUSB1NMEA
/dev/ttyUSB2AT 指令(通常)
/dev/ttyUSB3AT 指令 / 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: READYSIM 卡已识别
+CME ERROR: 10SIM not inserted(未插卡或卡槽未接通)
+QSIMSTAT: 0,1检测功能关闭,当前已插卡
+QSIMDET: 0,0SIM 卡检测功能未启用

查看卡内信息​

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
参数模式系统侧驱动
0QMI / RMNETkmod-usb-net-qmi-wwan + uqmi(出厂默认)
1ECMkmod-usb-net-cdc-ether
2MBIMkmod-usb-net-cdc-mbim + umbim
3RNDISkmod-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+CGPADDRPDP 分配的 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" 确认驻留状态