以下内容汇总了常用的 Quectel 5G 模块RM520N系列相关 AT 指令及其作用,并提供了功能说明和使用示例。
常用工具:https://pan.tcpxy.com/Onedrive1/Vendor_docs/Quectel
提示:Quectel 模组支持一次发送多个命令,用分号
;
隔开且不需要重复写AT
。
例如:AT+QENG="servingcell";+QCAINFO
代表同时执行AT+QENG="servingcell"
和AT+QCAINFO
两条指令。
一、PCIe RC Ethernet 模式配置
1. 适用于 RM500-RM521 系列模组
AT+QETH="eth_driver","r8125",1;
+QCFG="pcie/mode",1;
+QCFG="usbnet",1;
+QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF";
+QMAP="DHCPV4DNS","disable";
+QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0;
+CFUN=1,1
功能说明:
AT+QETH="eth_driver","r8125",1
:选择 2.5G 以太网驱动r8125
并启用。+QCFG="pcie/mode",1
:启用 PCIe RC 模式。+QCFG="usbnet",1
:将 USB 网络接口配置为 ECM 模式,并设置为 AP 模式的网络连接行为。+QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF"
:开启 IP Passthrough(IPPT),将网络透传给以太网侧。+QMAP="DHCPV4DNS","disable"
:禁用板载的 DNS 代理(DNS IPPT),使客户端自行获取真实 DNS。+QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0
:强制开启 ADB 接口(并绕过 ADB 验证)。+CFUN=1,1
:重启模组,使以上配置生效。
示例用法:
-
如果需要一次性执行以上所有命令,可直接发送:
AT+QETH="eth_driver","r8125",1;+QCFG="pcie/mode",1;+QCFG="usbnet",1;+QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF";+QMAP="DHCPV4DNS","disable";+QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0;+CFUN=1,1
-
重启后即可在 PCIe RC 下使用 2.5G 以太网,并在 USB 侧表现为 ECM + ADB 接口。
2. 适用于 x70 系列模组(RM550/551)
(A) 测试固件(BETA) 的一次性命令:
AT+QCFG="pcie/mode",1;+QCFG="usbnet",1;+QCFG="usbcfg",0x2C7C,0x0122,1,1,1,1,1,2,0;+CFUN=1,1
+QCFG="pcie/mode",1
:开启 PCIe RC 模式。+QCFG="usbnet",1
:USB 侧使用 ECM 模式并进入 AP 模式网络连接行为。+QCFG="usbcfg",0x2C7C,0x0122,1,1,1,1,1,2,0
:设置 USB 接口及 ADB 模式为启用状态(“ADB value=2”的快速开启方式在 BETA 固件上依旧生效)。+CFUN=1,1
:重启模组以应用新配置。
示例用法:
- 如果当前使用测试版固件,可直接将以上命令拷贝一次性执行,即可启用 PCIe RC + ECM + ADB。
(B) 最新正式固件(非 BETA) 的命令步骤:
-
先执行:
AT+QCFG="pcie/mode",1;+QCFG="usbnet",1
- 开启 PCIe RC 模式,并将 USB 接口切换至 ECM + AP 模式。
-
解锁 ADB:
-
发送:
AT+QADBKEY?
- 返回形如
+QADBKEY: 29229988
(此为示例值)。
- 返回形如
-
打开在线生成器
https://blog.mjjman.com/quectel-unlock.php
,将上一步返回的数字如:
29229988
粘贴到 STDIN 区域并运行,得到形如:
AT+QADBKEY="mrX4zOPwdSIEjfM"
- 将上述命令
AT+QADBKEY="mrX4zOPwdSIEjfM"
发送给模组即可完成 ADB 解锁。
- 将上述命令
-
-
启用 ADB 接口:
-
查询当前
usbcfg
:
AT+QCFG="usbcfg"
- 示例返回:
+QCFG: "usbcfg",0x2C7C,0x0122,1,1,1,1,1,0,0
-
发送如下命令以开启 ADB:
AT+QCFG="usbcfg",0x2C7C,0x0122,1,1,1,1,1,1,0
-
-
重启生效:
AT+CFUN=1,1
示例用法:
- 如果运行的是最新正式版固件,需先执行
AT+QCFG="pcie/mode",1;+QCFG="usbnet",1
,然后根据获取到的 ADB code 进行解锁,再通过usbcfg
命令启用 ADB,最后重启生效。
主要效果:
- 启用 PCIe RC 模式(x70 系列固件会自动选择驱动)。
- USB 侧使用 ECM 并可开启 ADB 接口。
- 重启后生效,若自动选择到错误的 APN,需要手动配置 APN。
二、常用 AT 命令列表
以下列表为一些常用的 AT 命令,可根据需求快速配置或查询模组的状态。命令中的注释(中文)有助于理解其功能;并在每条指令后添加了简单用法示例供参考。
1. AT+CFUN=1,1
-
含义: 以重启方式使能模组的全功能状态。
-
示例:
# 重启模组 AT+CFUN=1,1
2. AT+CFUN=0;CFUN=1
-
含义: 先将模组设置为最小功能模式(断开网络),再切回全功能模式(重新连接)。
-
示例:
# 修改 APN 后,无需整机重启,仅使用最小功能->全功能 AT+CFUN=0;CFUN=1
3. AT+QMAPWAC?
-
含义: 查询当前以太网侧自动连接上网功能的启用状态(
0=禁用,1=启用
)。 -
示例:
# 获取当前自动连接状态 AT+QMAPWAC?
4. AT+QMAPWAC=1
-
含义: 启用以太网上自动连接 Internet 功能。
-
示例:
# 让以太网上电自动拨号上网 AT+QMAPWAC=1
5. AT+QMAPWAC=0
-
含义: 禁用以太网上自动连接功能,一般在需要通过 USB 上网或需要关闭 IPPT 时使用。
-
示例:
# 禁用自动拨号功能,以使用 USB 网络 AT+QMAPWAC=0
6. AT+QUIMSLOT?
-
含义: 查询当前使用的 SIM 卡槽(
1=卡槽 1,2=卡槽 2
)。 -
示例:
AT+QUIMSLOT? # 返回 +QUIMSLOT: 1 表示当前使用卡槽 1
7. AT+QUIMSLOT=1
/ AT+QUIMSLOT=2
-
含义: 切换到指定的 SIM 卡槽。
-
示例:
# 切换到 SIM 卡槽 2 AT+QUIMSLOT=2 # 建议切换后重启或拔插卡后生效
8. AT+CGDCONT?
-
含义: 获取当前所有已配置的 APN 信息(Profile 1~8)。
-
示例:
# 查看所有 APN 配置 AT+CGDCONT?
9. AT+QMBNCFG="AutoSel",0;+QMBNCFG="Deactivate"
-
含义: 禁用自动 APN 选择;如果更换 SIM 卡或者更换卡槽,需要手动设置 APN。
-
示例:
# 关闭自动 APN 并使当前 APN 配置生效 AT+QMBNCFG="AutoSel",0;+QMBNCFG="Deactivate"
10. AT+CGDCONT=1,"IPV4V6","APNHERE"
-
含义: 将 Profile 1 设置为双栈 APN(APNHERE 仅为示例),支持 IPv4 和 IPv6。
-
示例:
# 将 APN 配置为 "internet" AT+CGDCONT=1,"IPV4V6","internet"
11. AT+GSN
-
含义: 查询模组当前的 IMEI 号。
-
示例:
# 查询 IMEI AT+GSN
12. AT+EGMR=0,7
-
含义: 显示当前写入的 IMEI。
-
示例:
# 显示 IMEI AT+EGMR=0,7
13. AT+EGMR=1,7,"IMEIGOESHERE"
-
含义: 写入/修复新的 IMEI(需要特别权限和注意合规)。
-
示例:
# 写入新的 IMEI,请务必确保合规 AT+EGMR=1,7,"123456789012345"
14. AT+QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0
-
含义: 启用 ADB 接口并绕过 ADB Key 验证。
-
示例:
# 配置 usbcfg,之后可重启生效 AT+QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0
15. AT+QENG="servingcell"
-
含义: 查询当前锚点小区(Serving Cell)的频段、网络连接状态等信息。
-
示例:
AT+QENG="servingcell" # 返回当前小区信息,如频段、EARFCN、RSRP 等
16. AT+QCAINFO
-
含义: 查询当前所有的频段聚合信息(CA 信息)。
-
示例:
AT+QCAINFO # 显示连接的各个频段、聚合情况等
17. AT+QNWPREFCFG="mode_pref"
-
含义: 查询模组当前的网络搜索模式(AUTO/LTE/NR5G:LTE 等)。
-
示例:
# 查看当前优先模式 AT+QNWPREFCFG="mode_pref"
18. AT+QNWPREFCFG="mode_pref",AUTO
-
含义: 设置网络搜索模式为自动(包含 2G/3G/4G/5G 等,具体取决于固件支持)。
-
示例:
# 设置自动搜索 AT+QNWPREFCFG="mode_pref",AUTO
19. AT+QNWPREFCFG="mode_pref",NR5G:LTE
-
含义: 仅启用 4G 和 5G NR 搜索,禁用其它模式。
-
示例:
AT+QNWPREFCFG="mode_pref",NR5G:LTE
20. AT+QNWPREFCFG="mode_pref",NR5G
-
含义: 仅启用 5G NR 搜索(SA/NSA 取决于其它相关配置)。
-
示例:
AT+QNWPREFCFG="mode_pref",NR5G
21. AT+QNWPREFCFG="mode_pref",LTE
-
含义: 仅启用 4G LTE 搜索。
-
示例:
AT+QNWPREFCFG="mode_pref",LTE
22. AT+QNWPREFCFG="nr5g_disable_mode"
-
含义: 查询是否禁用了 SA 或 NSA 5G NR。
-
示例:
AT+QNWPREFCFG="nr5g_disable_mode" # 返回 0/1/2,分别代表(0=启用SA+NSA,1=禁用SA,2=禁用NSA)
23. AT+QNWPREFCFG="nr5g_disable_mode",0
-
含义: 同时启用 SA 和 NSA(默认支持 5G NR 全模式)。
-
示例:
AT+QNWPREFCFG="nr5g_disable_mode",0
24. AT+QNWPREFCFG="nr5g_disable_mode",1
-
含义: 禁用 SA 模式,仅保留 NSA(5G NR 需要锚点 4G)。
-
示例:
AT+QNWPREFCFG="nr5g_disable_mode",1
25. AT+QNWPREFCFG="nr5g_disable_mode",2
-
含义: 禁用 NSA 模式,仅保留 SA。
-
示例:
AT+QNWPREFCFG="nr5g_disable_mode",2
26. AT+QNWPREFCFG="nr5g_band"
-
含义: 查看当前 SA 5G NR 的频段锁定设置。
-
示例:
AT+QNWPREFCFG="nr5g_band" # 返回例如: 1:2:3:... 表示锁定的 n1, n2, n3 ...
27. AT+QNWPREFCFG="nsa_nr5g_band"
-
含义: 查看当前 NSA 5G NR 的频段锁定设置。
-
示例:
AT+QNWPREFCFG="nsa_nr5g_band"
28. AT+QNWPREFCFG="nr5g_band",1:2:3:4:5:6
-
含义: 举例:锁定 SA NR 频段 n1, n2, n3, n4, n5, n6。
-
示例:
AT+QNWPREFCFG="nr5g_band",1:2:3:4:5:6
29. AT+QNWPREFCFG="nsa_nr5g_band",1:2:3:4:5:6
-
含义: 举例:锁定 NSA NR 频段 n1, n2, n3, n4, n5, n6。
-
示例:
AT+QNWPREFCFG="nsa_nr5g_band",1:2:3:4:5:6
30. AT+QNWPREFCFG="lte_band"
-
含义: 获取当前 4G LTE 的频段锁定设置。
-
示例:
AT+QNWPREFCFG="lte_band"
31. AT+QNWPREFCFG="lte_band",1:2:3:4:5:6
-
含义: 举例:锁定 LTE 频段 1、2、3、4、5、6。
-
示例:
AT+QNWPREFCFG="lte_band",1:2:3:4:5:6
32. AT+QMAP="WWAN"
-
含义: 查看当前运营商分配的 IPv4/IPv6 地址(WWAN 侧信息)。
-
示例:
AT+QMAP="WWAN" # 显示 WWAN 分配的地址信息
33. AT+QMAP="LANIP"
-
含义: 查看当前 VLAN0 的 DHCP 网关、起止地址信息。
-
示例:
AT+QMAP="LANIP" # 返回例如 "IP_start_range, IP_end_range, Gateway_IP"
34. AT+QMAP="LANIP",IP_start_range,IP_end_range,Gateway_IP
-
含义: 设置 VLAN0 的 DHCP 起止地址和网关 IP。
-
示例:
# 例如将 DHCP 范围设置为 192.168.1.100 ~ 192.168.1.200,网关为 192.168.1.1 AT+QMAP="LANIP","192.168.1.100","192.168.1.200","192.168.1.1"
35. AT+QMAP="DHCPV4DNS","disable"
-
含义: 禁用模组上的内部 DNS 代理,将 DNS 透传给下游设备。
-
示例:
# 当使用 IP Passthrough 时,推荐禁用此项以获取运营商真实 DNS AT+QMAP="DHCPV4DNS","disable"
36. AT+QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF"
-
含义:
将以太网上的 IP Passthrough( IPPT ) 打开,并传递给目标 MAC(此处示例为
FF:FF:FF:FF:FF:FF
通配)。
注意:对于 RM551E-GL 等某些模组,需替换为实际以太网设备的 MAC 地址,而不是
FF:FF:FF:FF:FF:FF
。 -
示例:
# 打开 IPPT,所有流量将直接透传至目标 MAC AT+QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF"
37. AT+QMAP="MPDN_rule",0
-
含义: 关闭 IP Passthrough 或清空相应的 MPDN 配置规则 0。
-
示例:
# 关闭 IPPT 并恢复正常模式 AT+QMAP="MPDN_rule",0 # 关闭后若需以太网自动连接, 请执行 AT+QMAPWAC=1 并重启
Comments 4 条评论
我可以问一下为什么该网站无法再访问吗?
https://docker-mirrors.mjjman.com/Onedrive1/%E7%B3%BB%E7%BB%9F%E9%95%9C%E5%83%8F/OPENWRT/%E5%B0%8F%E7% %B3%20BE%207000 是
&
https://sharelist.mjjman.com/
@zinzin 这两个网站停止维护了呢
网盘换成pan.tcpxy.com了
@monologue 非常感谢
很棒的文章