移远5G模块常用AT命令

Monologue 发布于 2025-01-05 1,477 次阅读


AI 摘要

在快速发展的5G技术时代,掌握Quectel 5G模块的AT命令成为开发者的一项关键技能。本文将详细介绍RM520N系列及其它型号的常用AT指令,从PCIe RC以太网模式的配置到基本操作的实现,结合实用示例,让你在调试过程中游刃有余。无论是初学者还是经验丰富的工程师,这份指南都将帮助你高效管理模组,为你的项目增添无限可能。快来探索这些强大的指令吧!

以下内容汇总了常用的 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

功能说明:

  1. AT+QETH="eth_driver","r8125",1:选择 2.5G 以太网驱动 r8125 并启用。
  2. +QCFG="pcie/mode",1:启用 PCIe RC 模式。
  3. +QCFG="usbnet",1:将 USB 网络接口配置为 ECM 模式,并设置为 AP 模式的网络连接行为。
  4. +QMAP="MPDN_rule",0,1,0,1,1,"FF:FF:FF:FF:FF:FF":开启 IP Passthrough(IPPT),将网络透传给以太网侧。
  5. +QMAP="DHCPV4DNS","disable":禁用板载的 DNS 代理(DNS IPPT),使客户端自行获取真实 DNS。
  6. +QCFG="usbcfg",0x2C7C,0x0801,1,1,1,1,1,2,0:强制开启 ADB 接口(并绕过 ADB 验证)。
  7. +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) 的命令步骤:

  1. 先执行:

    AT+QCFG="pcie/mode",1;+QCFG="usbnet",1
    • 开启 PCIe RC 模式,并将 USB 接口切换至 ECM + AP 模式。
  2. 解锁 ADB:

    1. 发送:

      AT+QADBKEY?
      • 返回形如 +QADBKEY: 29229988(此为示例值)。
    2. 打开在线生成器

      https://blog.mjjman.com/quectel-unlock.php

      ,将上一步返回的数字如:

      29229988

      粘贴到 STDIN 区域并运行,得到形如:

      AT+QADBKEY="mrX4zOPwdSIEjfM"
      • 将上述命令 AT+QADBKEY="mrX4zOPwdSIEjfM" 发送给模组即可完成 ADB 解锁。
  3. 启用 ADB 接口:

    1. 查询当前

      usbcfg

      AT+QCFG="usbcfg"
      • 示例返回:
      +QCFG: "usbcfg",0x2C7C,0x0122,1,1,1,1,1,0,0
    2. 发送如下命令以开启 ADB:

      AT+QCFG="usbcfg",0x2C7C,0x0122,1,1,1,1,1,1,0
  4. 重启生效:

    AT+CFUN=1,1

示例用法:

  • 如果运行的是最新正式版固件,需先执行 AT+QCFG="pcie/mode",1;+QCFG="usbnet",1,然后根据获取到的 ADB code 进行解锁,再通过 usbcfg 命令启用 ADB,最后重启生效。

主要效果:

  1. 启用 PCIe RC 模式(x70 系列固件会自动选择驱动)。
  2. USB 侧使用 ECM 并可开启 ADB 接口。
  3. 重启后生效,若自动选择到错误的 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 并重启

此作者没有提供个人介绍。
最后更新于 2025-02-23