这篇写给第一次碰蜂窝模组、手里有一块 RM500U-CN 5G HAT（或裸 M.2 模组）的同学。所有 AT 命令、VID/PID、拨号参数都来自微雪 wiki 与移远官方手册，命令可直接复制。
一、先看它是什么：一块像网卡一样用的 5G 模组
RM500U-CN 是移远的 5G Sub-6 模组：展锐（UNISOC）方案、3GPP R15、5G NR SA/NSA 双模，频段 n1/3/5/8/28/41/77/78/79，SA 峰值下行 2.1 Gbps / 上行 900 Mbps。封装是 M.2 B Key，30.0 × 52.0 × 2.3 mm——它不是路由器，是一枚被电脑枚举的猫。
微雪的 HAT 转接板把它变成「能插树莓派/电脑」的板卡，六个关键部位先认一遍：M.2 插槽、USB 3.1、Type-C 外部供电口、电源切换开关（USB / EXT PWR）、拨码开关（A/B/C 三组）、双 SIM 卡槽 + RST 键 + NET 灯。
先建立三个认知，每个都影响后面的操作：
- 5G 模组是被枚举的设备：插上电脑它会变成 1 个网卡 + 4~5 个串口。它不主动干活，一切听 AT 指令。
- RM500U 峰值电流超过 USB 口承载：规格书典型 3.7V 供电，峰值 >2A。HAT 上必须外接 Type-C 5V/3A，只靠 USB 会「能识别、起不来、上网就掉」。
- 一切控制都走 AT：开关机、查状态、切卡、选频段、拨号模式，全部是串口上的一行行文本——串口通了，整个世界就通了。
还有一句买前就该知道的：RM500U 适配中国运营商频段，不支持 GNSS 和语音；要全球频段 + 定位看 RM520N-GL（高通方案）。
二、上电：80% 的第一次失败都出在这一步
顺序不能乱，六步走完再谈软件：
① 拨码开关 C 组全拨 ON。 HAT 上 A/B/C 三组丝印开关对应不同模组家族：A 给 SIM7600X 系列 4G、B 给 SIM8202X 系列 5G、C 给 RM50X / RM520N / EM06X 系列。RM500U 属于 C。没拨 C 的现象非常迷惑——USB 插上什么都不出来，像没插，你会先怀疑线、再怀疑板子，最后才想到拨码。
② 模组插进 M.2 插槽，金手指对齐推到底，拧固定螺丝。 歪插会识别成未知设备或直接没反应。
③ 插 SIM 卡到槽 1，缺角朝外压到底。 天线四根全接上（5G 需要多天线分集）。没卡的话后面 AT+CPIN? 会报 SIM not inserted。
④ 供电切到 EXT PWR，Type-C 接 5V/3A。 这一步是 RM500U 和 4G 模组最大的差别——它的功耗档位（USB2 空闲 57mA，但发射峰值远超 2A）不是笔记本一个 USB 口养得起的。
⑤ USB 3.1 双头线接电脑。 注意是数据线，很多「完全没反应」最后查出来是充电线。
⑥ 上电开机。 HAT 上电自动开机（也可以把 PWR 引脚拉低控制），看 NET 灯：快闪 = 正在搜网，慢闪 = 已注网。
开机成功的四个判据，缺任何一个回去查上一步：设备管理器出现 4~5 个新串口 → NET 灯闪烁 → AT 口回 OK → AT+CPIN? 返回 READY。
三、装驱动，认识那些口
Windows：第一次插上会有一串带叹号的未知设备。到微雪 wiki 资料区下载 Quectel Windows USB 驱动（注意展锐款 RM500U 用专门的 RM500U-Driver 包，高通款是另一个），解压跑 setup.exe，装完设备管理器会多出：
| 设备 | 干什么 | 你需要动它吗 |
|---|---|---|
| Quectel DM/DIAG Port | 抓底层日志（QLog） | 平时不动 |
| Quectel NMEA Port | GNSS 输出（RM500U 无 GNSS，闲置） | 不动 |
| Quectel USB AT Port | AT 指令收发，主战场 | 天天用 |
| Quectel Modem Port | 老式 PPP 拨号 | 不动 |
| MBIM / RNDIS 网络适配器 | 上网本体 | 拨号后出现 |
Linux（树莓派/Ubuntu）：串口走内核自带的 option 驱动，但 RM500U 的 VID:PID = 2c7c:0900 部分系统没收录，要手动注册一次：
sudo su
sudo modprobe option
sudo sh -c 'echo "2c7c 0900" > /sys/bus/usb-serial/drivers/option1/new_id'
之后 ls /dev/ttyUSB* 会出现 ttyUSB0~3。哪个是 AT 口？对每个口发 AT，回 OK 的就是（一般是 ttyUSB2，固件版本不同序号会漂）。串口参数固定 115200 8N1。
一句话记住：AT 口是「遥控器」，网卡设备是「轮子」——遥控器能发指令，轮子能跑流量，两者都在才算活。
四、第一次 AT 对话：五组命令管住一块模组
Windows 用 SSCOM/QCOM，Linux 用 minicom -D /dev/ttyUSB2。发 AT 回 OK，说明链路通了。日常必用的 20 条按功能分五组：
① 身份——它是谁
AT+CGMI → Quectel（厂商）
AT+CGMM → RM500U-CN（型号）
AT+CGSN → IMEI
AT+CSUB / AT+QGMR → 模块版本+芯片 / 固件版本
② SIM——卡认到了吗
AT+CPIN? → +CPIN: READY 才算认到
AT+QUIMSLOT? → 当前用卡槽 1 还是 2
③ 网络——注上网了吗
AT+CEREG? → LTE 注册状态，,1 = 已注册本网
AT+C5GREG? → 5G 注册状态（SA/NSA 看这里）
AT+COPS? → 当前运营商名
AT+QENG="servingcell" → 信号全家桶：频段/RSRP/SINR/小区号
④ 策略——怎么选网（第五节细说）
⑤ 控制——开关与复位
ATE0 / ATE1 → 关/开回显（写脚本建议 ATE0）
AT+CFUN=1,1 → 软复位模组
AT+CFUN=0 → 飞行模式
上手路径：先跑①②确认「硬件活着、卡认到了」，再跑③确认「注上网了」，最后才碰拨号和复位——顺序反了全是玄学。
五、双卡与网络策略：两张卡、一个 APN
双卡单待是 RM500U 的特色能力（HAT 板载两个卡槽）：
AT+QUIMSLOT? → 查当前卡槽
AT+QUIMSLOT=2 → 切到卡 2
AT+QUIMSLOT=1 → 切回卡 1
AT+CPIN? → 切完确认新卡认到
注意两点：切换即重启射频，切完要等几秒再查；AT+CPIN? 查的是当前激活槽，不是两个都查。
APN 是「注上网了但没流量」的高发原因，三家运营商对照（IPV4V6 双栈最稳）：
中国移动：AT+CGDCONT=1,"IPV4V6","CMNET"
中国联通：AT+CGDCONT=1,"IPV4V6","3GNET"
中国电信：AT+CGDCONT=1,"IPV4V6","CTNET"
网络模式与频段：
AT+QNWPREFCFG="mode_pref",AUTO → 自动（默认）
AT+QNWPREFCFG="mode_pref",NR5G → 只挂 5G
AT+QNWPREFCFG="mode_pref",LTE → 只挂 4G（信号差时兜底）
AT+QNWPREFCFG="nr5g_band",78 → 锁 n78（室内穿透较好的主流频段）
调试时建议 AUTO；做固定场景（如工业网关）再锁频段，避免漂到弱小区。
六、拨号上网：三种模式，改的都是同一条 QCFG
RM500U 支持 MBIM / RNDIS / ECM 三种网卡形态，区别只在「电脑看到它是什么设备」，核心命令就一行 AT+QCFG="usbnet",N。
6.1 RNDIS（usbnet=3）——Windows 最省事的万能模式
AT+QCFG="ethernet",0
AT+QCFG="nat",1
AT+QCFG="usbnet",3
AT+QNETDEVCTL=2,3,1
AT+CFUN=1,1 ← 必须重启，配置才生效
重启后电脑会多出一块 RNDIS 网卡。Windows 7/部分 Win10 会给这块网卡挂叹号——手动装驱动：右键 RNDIS → 更新驱动 → 浏览我的计算机 → 从列表选 → 网络适配器 → Microsoft → Remote NDIS Compatible Device。装完 ipconfig 能看到网卡拿到 192.168.x.x 私网地址（因为 nat=1，模组在做 NAT）。
6.2 MBIM（usbnet=2）——Windows 10/11 原生协议
AT+QCFG="usbnet",2
AT+QNETDEVCTL=1,3,1
AT+CFUN=1,1
Win10+ 直接出「蜂窝数据」网卡，系统原生驱动免安装，任务栏会出现移动网络图标。要 Linux 用则需 mbimcli 工具链，不如 ECM 省事。
6.3 ECM（usbnet=1）——Linux/树莓派首选
AT+QCFG="ethernet",0
AT+QCFG="usbnet",1
AT+QNETDEVCTL=1,3,1
AT+QNETDEVCTL=1,1,1
AT+QCFG="nat",0
AT+CFUN=1,1
重启后树莓派上多出一块标准 USB 网卡（名字形如 enx…/usb0），向它要 IP 并测试：
sudo apt-get install udhcpc
sudo udhcpc -i enxe2f1fbfdd5e7 # 或 sudo dhclient -v 网口名
sudo route add -net 0.0.0.0 网口名
ifconfig # 看到 inet 即拿到 IP
ping -I 网口名 www.baidu.com
6.4 所有模式共用的四步节奏
改 QCFG → 发 QNETDEVCTL 拨号 → AT+CFUN=1,1 重启让配置生效 → 电脑侧看新网卡有没有拿到 IP。
改完不重启 = 配置没生效，这是「发了命令没反应」的第一大原因。另外 RNDIS 的 nat=1（模组做 NAT，电脑拿私网 IP）和 ECM 的 nat=0（桥接，电脑直接向运营商侧要地址）不要混着设，否则「有网卡没流量」。
七、测速与「为什么跑不到 2Gbps」
规格书写 SA 下行 2.1 Gbps，实测往往只有几十到几百 Mbps，这不是模组的问题，是五个因素叠加：
| 因素 | 影响 |
|---|---|
| 基站距离 | 离 5G 基站越近信号越好速度越快 |
| 基站负荷 | 上下班高峰期明显变慢 |
| 基站数量 | 等量 4G 覆盖需要双倍 5G 基站，覆盖仍有空洞 |
| 运营商限速 | 部分套餐达量限速，可要求运营商重置 |
| 室内衰减 | 建筑穿透损耗大，室内比室外差一档 |
测速用 speedtest.cn 客户端即可。做产品别拿峰值做预算，拿实测中位数 × 0.7 做设计值才靠谱。
八、六个必踩的坑
| # | 现象 | 判据 | 修法 |
|---|---|---|---|
| 1 | 插上电脑没反应 | 设备管理器全空、NET 灯不亮 | 拨码 C 全 ON；EXT PWR 上 5V/3A；换数据线 |
| 2 | 识别到但起不来 | 设备出来又消失 | 峰值 >2A，USB 供电不够 → 必须 EXT PWR 外供 |
| 3 | AT 口不回 OK | 串口能开、发 AT 无返回 | 对每个 ttyUSB 轮流试；115200 8N1；发 ATE1 试回显 |
| 4 | SIM 认不到 | CPIN? 无 READY |
卡插反/没到底；AT+QUIMSLOT? 对槽；卡锁 PIN |
| 5 | 注网失败/无 5G | C5GREG? 一直 ,2 |
换到窗边；确认卡开了 5G；QNWPREFCFG=AUTO 别锁死频段 |
| 6 | 网卡有但没流量 | 网卡在、无 IP 或无网关 | QNETDEVCTL 拨号 + CFUN=1,1 重启；RNDIS 叹号手装驱动；APN 配对运营商 |
排查顺序：① 灯（NET 闪不闪）→ ② 口（有没有枚举出串口和网卡）→ ③ 卡（CPIN READY?）→ ④ 网（CEREG/C5GREG ,1?）→ ⑤ 拨（QNETDEVCTL 发了没、重启没）→ ⑥ 电脑侧（网卡拿 IP 没）。别跳步，每步都有判据。
最隐蔽的一个：换过 QCFG 后忘了 AT+CFUN=1,1——模组活着、命令都回 OK，但一切新配置其实没生效。
九、资料清单（都在微雪 wiki 的资料区）
| 文件 | 用途 |
|---|---|
| RM500U-CN 5G 模块产品规格书 | 频段/功耗/尺寸，选型对比 |
| RG500U-CN AT 命令手册 | 本篇所有命令的官方原文（RM500U 与 RG500U 命令集同源） |
| RM50XQ 系列硬件设计手册 | 供电/引脚设计参考（做底板时用） |
| RM500U-CN 网卡拨号应用指导 | MBIM/RNDIS/ECM/PPP 四种拨号的官方流程 |
| Quectel Windows USB 驱动（RM500U 专用包） | 展锐款专用，别装成高通款的 |
工具：Windows 端 SSCOM / QCOM 发 AT；Linux 端 minicom；抓底层日志用 QLog 走 DIAG 口。
最后：三句话
- 先电后软：拨码、外供、天线、SIM——硬件四件事没落实，软件怎么调都是「没反应」。上电六步 + 四个判据走完，再打开串口。
- 改完配置必重启：
AT+CFUN=1,1是 RM500U 的「保存并应用」。忘了它，你已经改好的一切其实都没生效。 - 六步倒退排查：电脑侧没 IP 查拨号，拨号没效查重启，注网没成查卡和信号，串口没有查驱动和 VID/PID——每一步都有判据，别用感觉调试。
卡住的地方把 AT 口日志贴到评论区——有 READY、CEREG、usbnet、QNETDEVCTL 这几个关键字，我大概能判断卡在哪一层。