RM500U 标签下常年飘着一类帖子：“模组没反应”、“驻网了但 ping 不通”、“只有 4G 没有 5G”。这些问题九成不是硬件坏了，而是调试方法不对——拿到板子先 ATI 刷屏，看没输出就拔插重来，一天就过去了。
这篇整理一套调试流程：三层定位法——先确认模组活着，再确认驻上网了，最后确认数据链路通了。每层只用一两条命令，逐层收敛，不跳步。文末附官方资料入口。
说明：命令整理自官方《RGx00U & RM500U Series AT Commands Manual》（v1.0）与移远技术支持团队在社区的公开回复；不同固件版本支持的命令集有差异，拿不准的命令一律先发
AT+XXX=?（Test）看固件认不认，以你手上固件的手册为准。
调试前的三个准备
- 认清 USB 口角色。RM500U 枚举出多个口：AT 命令口、DIAG 抓 log 口、（可选）网口。发 AT 别找错口，DIAG 口是给 QXDM/QPST 抓 log 用的，发 AT 不会有正常回显。
- 串口参数 115200 8N1。这是移远 AT 口默认值。“指令无响应”的第一嫌疑不是模组坏了，是波特率。
- 供电要留余量。5G 模组发射峰值电流比 Cat.1 大一个量级，供电不足的典型症状不是“开不了机”，而是莫名重启、反复掉电——这类问题查软件查半天，最后一根电源线解决。按官方硬件设计手册配电源。
第一层：模组活着吗
AT → OK 串口链路通不通，一条就知道
ATI → Quectel + 型号 + revision
AT+CGMI → Quectel 厂商
AT+CGMM → RM500U-CN 型号
AT+CGMR → 固件版本号 查任何“文档说支持但不生效”的问题，先看这个
AT+CGSN → IMEI
AT+CPIN? → +CPIN: READY SIM 卡状态
AT+CFUN? → 功能级别 1=完整功能；0=最低功能（很多配置要先降到 0）
AT+CSQ → +CSQ: 24,99 第一个值 0~31 对应 -113~-51 dBm（每格 2 dBm），99=未知
这一层不过，后面全是白费。特别提醒：AT+CGMR 抄下来，后面查“手册里有这条命令但固件不认”全靠它。
第二层：驻上网了吗
AT+COPS? → 当前注册的运营商（=? 是扫描可用运营商，慢，耐心等）
AT+CEREG? / AT+C5GREG? → EPS / 5GS 注册状态（1=已注册本地网，5=漫游）
AT+QNWINFO → 当前接入制式，比如 NR5G-SA / LTE ★官方推荐第一步
AT+QENG="servingcell" → 服务小区全参数（RSRP/RSRQ/SINR/频段/PCI）★官方排查第一命令
AT+QENG="neighbourcell" → 邻区，信号差时对比着看
“只有 4G 没有 5G”是最高频的问题，排查顺序就三步：
AT+QNWINFO看当前制式到底是什么——NR5G-SA、NR5G-NSA 还是 LTE；- 把 SIM 插进一台确认支持 5G 的手机，排除卡的问题（官方支持团队的原话：先确认卡开没开 5G）；
- 确认是 SA/NSA 的问题还是频段的问题，再考虑锁频段
AT+QCFG="band"（参数格式以手册为准，锁错了反而把自己锁失网）。
RSRP 不是看 AT+CSQ。AT+CSQ 的 0~31 是 GSM 时代的粗粒度信号格，5G 的精准场强看 AT+QENG="servingcell" 里的 RSRP/RSRQ/SINR。-110 dBm 是可用底线，-120 以下基本就是“有信号没体验”。
第三层：数据链路通了吗
驻上网 ≠ 有网。第三层看 IP 和网卡：
AT+CGATT? → PDP 附着状态，1=已附着
AT+CGACT=1,1 → 激活 PDP（有些场景要先 AT+CGACT=0,1 再激活）
AT+CGPADDR=1 → 拿到的 IP 地址，空的就是没通
AT+QNETDEVCTL=1,1,1 → 激活数据网络设备 ★“能驻网但电脑没网卡/没网”的经典修复
AT+QCFG="usbnet",1 → USB 网络模式配置（ECM/RNDIS 取向）
AT+QETH=1,1 → 启用以太网口（用网口的场景）
社区里一个经典案例：模组注册上网全正常，但系统里就是没有网卡、ping 不通，一条 AT+QNETDEVCTL=1,1,1 解决——网络设备没被激活，前面所有命令都是“裸奔”。
顺手记两个进阶玩法：
- 想通过网口直接发 AT：
AT+QCFG="nat"配路由/网桥模式 +AT+QCFG="eth_at",1使能网口 AT 功能，重启生效后，在上位机侧用网络调试助手就能收发 AT，不用串口线（官方支持团队给的方法）。 - 抓 URC 上报：
AT+QURCCFG="urcport","smd"把 URC 导到指定端口（需要固件支持，先用 AT+CGMR 确认版本）。
六个高频坑
| # | 现象 | 根因 | 处理 |
|---|---|---|---|
| 1 | 指令完全无响应 | 波特率错 / 找错 USB 口 | 115200 8N1；认准 AT 口，DIAG 口是抓 log 的 |
| 2 | 莫名重启、反复掉电 | 5G 峰值电流大，供电不足 | 按硬件设计手册配电源，别用开发板 USB 直供硬撑 |
| 3 | 只有 4G | SIM 不支持 5G / NSA-SA 差异 / 频段 | 先 AT+QNWINFO 看制式 → 换手机验卡 → 再谈锁频段 |
| 4 | 驻网了 ping 不通 | PDP 未激活 / 网络设备未激活 | AT+CGACT + AT+CGPADDR + AT+QNETDEVCTL=1,1,1 |
| 5 | 拔插 SIM 不识别 | 热插拔检测默认关 | AT+QSIMDET=1,1 使能；检测电平按硬件设计配（高/低电平在位两种插座接法，官方硬件手册 4.1.2 有图），且要在无卡或 AT+CFUN=0 状态下配置，重启生效 |
| 6 | 手册有命令、固件不认 | 手册按系列发布，命令随固件增减 | 一切以 AT+CGMR 的固件版本对应手册为准；不确定就发 Test 命令 |
关于抓 log
上面全是“状态查询”，真正难的问题（驻网反复、协议栈异常）要抓 log：DIAG 口 + 官方 QXDM/QPST，抓下来再分析，比在 AT 口瞎试高效十倍。log 不会解，把关键片段连同 AT+CGMR 版本号一并发到社区，官方技术支持能更快定位。
资料入口
官方下载区（文档/驱动/工具，按型号筛选）：下载专区 | 移远通信-全球物联网整体解决方案供应商
AT 命令手册名：《RGx00U & RM500U Series AT Commands Manual》（v1.0）。固件不走公开下载，按社区“获取资料专区”的模板发帖留邮箱和购买渠道，版主会发。
调试 5G 模组和 Cat.1 最大的区别：多了一层 NR/NSA/SA 的制式维度。把“制式—场强—数据链路”三层分开看，大部分玄学问题都会落回某一层的某一个命令上。
