LFeng/LFLede
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init

Browse Source
This commit is contained in:
zhongluofeng
2026-08-21 18:28:33 +08:00
commit 9e478f1591
76 changed files with 27707 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
RM520N-5G/文档/RM520N-MBIM拨号成功路线.md
+207
View File
@@ -0,0 +1,207 @@
# RM520N-GL 5G 模块在 iStoreOS(虚拟化直通)下 MBIM 拨号成功路线
> 日期：2026-08-19
> 环境：宿主飞牛(Fnos) 将移远 RM520N-GL 5G 模块通过 PCIe(vfio-pci) 直通给 iStoreOS 虚拟机
> 目标：让 iStoreOS 能够拨号上网，5G 模块作为宽带备用(wan2)
> 状态：✅ 5G 拨号成功、稳定上网、已固化开机自启
---
## 一、最终成果一句话
在 iStoreOS 里，用 **移远官方 Quectel-CM V1.6.8（musl 静态编译）** 通过 **MBIM 模式** 拨号，模块成功拿到运营商内网 IP 并上网（`ping 223.5.5.5` 通）。
**关键结论：RM520N-GL 在 PCIe 直通 + pcie_mhi 驱动下，QMI 模式是死路（模块不响应 QMI），必须用 MBIM 模式。**
---
## 二、环境与拓扑
| 项 | 值 |
|---|---|
| 5G 模块 | 移远 RM520N-GL，固件 `RM520NGLAAR03A04M4G`，IMEI 868371050275649 |
| 模块宿主位置 | 飞牛 `06:00.0 17cb:0308` |
| 直通方式 | vfio-pci 直通给 istoreos 虚拟机 |
| 虚拟机内位置 | `00:0a.0 Qualcomm SDX62` |
| iStoreOS IP | 192.168.110.135 |
| iStoreOS 登录 | root / SSH 已开启 |
| 数据通道 | PCIe/RMNET + qmap vlan（MBIM 模式走 `rmnet_mhi0.1`） |
| AT 通道 | `/dev/mhi_DUN` |
### 关键驱动
- **pcie_mhi 驱动** V1.3.8（移远私有 MHI 驱动）
- 加载参数：`mhi_mbim_enabled=1`（**MBIM 模式**）
- MBIM 模式设备节点：`/dev/mhi_MBIM`（QMI 模式是 `/dev/mhi_QMI0`）
---
## 三、为什么是这样（决策记录）
### 走过的弯路
1. **ModemManager 识别不了**：移远 pcie_mhi 驱动把控制通道暴露为私有 `/dev/mhi_QMI0`，不是标准 cdc-wdm，mmcli 扫不到。
2. **luci-app-modem 界面管不到**：修好 `at_port=/dev/mhi_DUN` + `manufacturer=quectel` 后，界面能读到信息但不拨号。
3. **QMI 拨号失败（V1.6.7）**：系统自带 quectel-CM 1.6.7 只支持 ECM 分支，报 `unsupport software_interface 1`。
4. **升级 V1.6.8 仍失败（QMI）**：V1.6.8 支持 QMI 分支，但 **模块对 QMI 请求从不响应**——手动发 QMI SYNC 能写入但读不到任何响应；换 `qmap_mode`、软重启都不行。判定是 **RM520N-GL + pcie_mhi v1.3.8 的 QMI 硬伤**。
5. **✅ 切 MBIM 成功**：驱动 `mhi_mbim_enabled=1` → `/dev/mhi_MBIM` 出现 → quectel-CM 直接拨号成功。完全复现移远官方日志 `pcie_mhi_mbim.txt` 的流程。
### 核心经验
- **RM520N-GL 在 PCIe/MHI 下能用 MBIM，QMI 通道是死的**（至少 pcie_mhi v1.3.8 + 此固件下如此）。
- MBIM 模式**不需要 proxy**，`quectel-CM -s <apn>` 直接拨号即可。
- iStoreOS 是 **musl libc**，必须用 **musl-gcc 静态编译** quectel-CM（glibc 静态编译的 qmi-proxy 在 musl 上闪退/卡死）。
---
## 四、完整复现步骤
### 步骤 1：确认模块拓扑与直通
```bash
# 宿主(飞牛)
lspci | grep 17cb # 找到 06:00.0 17cb:0308
# 直通给 istoreos VM 后，guest 内
lspci | grep -i qualcomm # 00:0a.0 Qualcomm SDX62
ls /sys/bus/mhi_q/devices/ # 应看到 0308_00.00.0a_DIAG/DUN/EFS/QMI0 等
ls /dev/mhi_DUN /dev/mhi_QMI0 # AT 通道在
```
### 步骤 2：切到 MBIM 模式（关键！）
```bash
# 备份当前配置
cp /etc/modules.d/90-pcie_mhi /etc/modules.d/90-pcie_mhi.bak
# 卸载驱动
rmmod pcie_mhi
# 以 MBIM 模式重新加载
insmod /lib/modules/$(uname -r)/pcie_mhi.ko mhi_mbim_enabled=1
# 验证：/dev/mhi_MBIM 出现，/dev/mhi_QMI0 消失
ls /dev/mhi_MBIM
# 固化（重启自动 MBIM）
echo "pcie_mhi mhi_mbim_enabled=1" > /etc/modules.d/90-pcie_mhi
```
### 步骤 3：部署 musl 版 quectel-CM V1.6.8
```bash
# 二进制在 文件/binaries/quectel-CM（musl 静态编译 V1.6.8）
# 备份旧版 V1.6.7
cp /usr/bin/quectel-CM /usr/bin/quectel-CM.bak-20260819-167
# 替换
cp quectel-CM /usr/bin/quectel-CM
chmod 755 /usr/bin/quectel-CM
/usr/bin/quectel-CM 2>&1 | head -1 # 应显示 QConnectManager_Linux_V1.6.8
```
### 步骤 4：MBIM 拨号（核心命令）
```bash
# 直接拨号，不需要 proxy
/usr/bin/quectel-CM -s wonet -f /tmp/quectel_cm.log
# 注意：MBIM 模式不要加 -i rmnet_mhi0（会异常）；APN 用 wonet（联通卡）
```
成功标志：日志出现 `ActivationState Deactivated -> Activated`，`rmnet_mhi0.1` 拿到 `inet` IP，`ping -I rmnet_mhi0.1 223.5.5.5` 通。
### 步骤 5：开机自启
```bash
# 使用 文件/configs/init.d_modem5g
cp 文件/configs/init.d_modem5g /etc/init.d/modem5g
chmod 755 /etc/init.d/modem5g
/etc/init.d/modem5g enable # 建立 S95modem5g
# 手动测试
/etc/init.d/modem5g start
/etc/init.d/modem5g stop
```
### 步骤 6：开机绑定修复（已确认非必需，默认跳过）
```bash
# 说明 (2026-08-20 更新):
# 原生流程即可自启拨号: 90-pcie_mhi(驱动) -> S95modem5g(拨号) -> S96wan5g-route(策略路由)
# rc.local **不需要**手动 bind mhi_q。
# 教训: 手动强绑`echo 0000:00:0a.0 > /sys/bus/pci/drivers/mhi_q/bind`可能抢设备致 SYS_ERR。
# 若模块失联(无/dev/mhi_DUN)，先断电重启飞牛，仍无效才可手动 bind 临时唤醒。
```
---
## 五、已验证的关键事实
### 拨号成功日志（节选，完整见 文件/logs/）
```
[08-19_13:00:xx] Quectel_QConnectManager_Linux_V1.6.8
[08-19_13:00:xx] Modem works in MBIM mode
[08-19_13:00:xx] cdc_wdm_fd = 8 # 成功打开 /dev/mhi_MBIM
[08-19_13:00:xx] mbim_device_caps_query()
[08-19_13:00:xx] DeviceId: 868371050275649
[08-19_13:00:xx] FirmwareInfo: RM520NGLAAR03A04M4G
[08-19_13:00:xx] mbim_subscriber_status_query()
[08-19_13:00:xx] SimIccId: 89860125801671811893
[08-19_13:00:xx] RegisterState Unknown -> Home # 已注册
[08-19_13:00:xx] PacketServiceState Unknown -> Attached
[08-19_13:00:xx] mbim_set_connect(onoff=1, sessionID=0)
[08-19_13:00:xx] ActivationState Deactivated -> Activated # ← 拨号成功!
[08-19_13:00:xx] mbim_ip_config(sessionID=0)
[08-19_13:00:xx] IPv4 = 10.98.xxx.xxx/30 # 拿到内网 IP
```
接口验证：
```
ip addr show rmnet_mhi0.1 # inet 10.98.xxx.xxx/30 ... state UP
ping -c 3 -W 2 -I rmnet_mhi0.1 223.5.5.5 # 2/2 received
```
### 界面管理（MBIM 下 luci 正常）
```
sh /usr/share/modem/modem_info.sh /dev/mhi_DUN quectel quectel 1
# 返回 manufacturer=Quectel, temperature, SIM ready, IMEI/IMSI 正常
```
luci 界面（网络→Modem）可作**状态监控**；但 luci 自动拨号(AT激活)不适用于 PCIe MBIM（数据通道由 quectel-CM 控制）。
---
## 六、目录文件清单
```
RM520N-5G-成功路线/
├── 文档/
│ └── RM520N-MBIM拨号成功路线.md # 本文档
├── 文件/
│ ├── binaries/ # musl 静态编译的 V1.6.8 二进制
│ │ ├── quectel-CM # ★ 拨号主程序（部署到 /usr/bin）
│ │ ├── quectel-qmi-proxy # (备用，QMI 模式才需要)
│ │ ├── quectel-mbim-proxy
│ │ └── quectel-atc-proxy
│ ├── source/ # V1.6.8 完整源码(21 .c + 头文件 + PDF文档)
│ │ └── Quectel_QConnectManager_Linux_User_Guide_V1.0.pdf
│ ├── configs/ # istoreos 配置文件(可直接复用)
│ │ ├── modem_config.txt # /etc/config/modem
│ │ ├── 90-pcie_mhi.txt # /etc/modules.d/90-pcie_mhi (mhi_mbim_enabled=1)
│ │ ├── rc.local # /etc/rc.local (默认无需绑定, 见故障排查文档)
│ │ └── init.d_modem5g # /etc/init.d/modem5g (开机自启拨号)
│ └── logs/
│ ├── quectel_cm_success_log.txt # 本次成功拨号日志(真实)
│ └── 官方参考_pcie_mhi_mbim.txt # 移远官方 MBIM 成功日志(参考)
```
---
## 七、编译说明（如需重编）
iStoreOS 是 musl libc，必须 musl 静态编译：
```bash
# 在 WSL(Ubuntu) 或其他 x86_64 glibc 环境
sudo apt install musl-tools
# musl-gcc 需要 linux 头文件，复制到 musl include
sudo cp -r /usr/include/linux /usr/include/x86_64-linux-musl/
sudo cp -r /usr/include/x86_64-linux-gnu/asm /usr/include/x86_64-linux-musl/
sudo cp -r /usr/include/asm-generic /usr/include/x86_64-linux-musl/
# 编译 quectel-CM（V1.6.8，QMI 分支）
cd 文件/source
musl-gcc -O1 -static -pthread -o quectel-CM \
QmiWwanCM.c GobiNetCM.c main.c QCQMUX.c QMIThread.c util.c \
qmap_bridge_mode.c mbim-cm.c device.c atc.c atchannel.c at_tok.c udhcpc.c
```
---
## 八、遗留 / 建议
1. **wan2 备份（最终目标）**：5G 已能上网，还差把 `rmnet_mhi0.1` 配成 wan2 备份（wan1 宽带优先）。推荐 mwan3 或 OpenWrt 策略路由。
2. **luci 界面**：目前可作状态监控。如需界面控制拨号(启停 modem5g)，可在 luci-app-modem 加轻量入口。
3. **QMI 死路提醒**：不要再尝试 QMI 拨号，此模块此驱动下不通，MBIM 是正解。
4. **APN**：本次用 `wonet`(联通)。换卡需改 `/etc/init.d/modem5g` 里的 `-s` 参数。
RM520N-5G/文档/RM520N-故障排查与自启链路.md
+41
View File
@@ -0,0 +1,41 @@
# RM520N-GL 5G 模块故障排查与自启链路（2026-08-20 更新）
## 开机自启链路（已验证可靠）
```
/etc/modules.d/90-pcie_mhi (pcie_mhi mhi_mbim_enabled=1) 驱动加载
↓
/etc/rc.d/S95modem5g (等待 /dev/mhi_MBIM 后起 quectel-CM -s wonet)
↓
/etc/rc.d/S96wan5g-route (策略路由 from 200.0/24 lookup wan5g + MASQUERADE)
```
- **无需**在 rc.local 里手动 bind mhi_q（那会抢设备导致 SYS_ERR）
- 飞牛断电重启后，原生流程自动恢复拨号（2026-08-20 实测：rmnet_mhi0.1 = 10.x，ping 223.5.5.5 ≈ 8.9ms）
## 故障现象：5G 起不来 / 模块 SYS_ERR
**症状**：无 rmnet_mhi0.1、无 /dev/mhi_DUN|MBIM、只有 /dev/mhi_BHI、无 quectel-CM 进程
**dmesg**：`dev_state:SYS_ERR`、`probe failed error -5/-110`
### 排查顺序（重要教训）
1. **优先断电重启飞牛**（模块真正断电复位；istoreos 内 reboot 不动 PCIe 供电，治不好 SYS_ERR）
2. 若重启无效，**临时手动唤醒**：
```
echo 0000:00:0a.0 > /sys/bus/pci/drivers/mhi_q/bind
```
（mhi_q = pcie_mhi 驱动注册名。bind 后 /dev/mhi_MBIM 出现，rmnet 接口建立）
3. **不要**手动 unbind/rmmod pcie_mhi / rescan 折腾——会把设备弄成"无驱动孤儿"，反而更难恢复
### 已确认的死路（勿重复踩）
- 禁用 modules.d 里的内核 mhi 驱动（mhi_pci_generic 等）**无效**：它们是 PCI autoload（modalias 拉起的），禁 modules.d 拦不住
- 手动 rmmod pcie_mhi + 重 insmod **不唤醒**（refcnt 仍 0）
## 移远 pcie_mhi 驱动机制
- `/lib/modules/6.6.144/pcie_mhi.ko`，alias 为 `MHI_CORE`（非标准 PCI ID 匹配）
- insmod 后 PCI probe 函数注册为驱动名 **mhi_q**（dmesg 里 `mhi_q 0000:00:0a.0` 就是 pcie_mhi 在跑）
- 与内核 `mhi_pci_generic`（识别为 qcom-sdx65m，需装高通固件，实际加载失败）竞争同一设备
- 模块正常时 pcie_mhi 首发 probe 能成功；异常时需要 bind mhi_q 手动唤醒
## 5G 出口行为（2026-08-20 实测）
- IPv4 HTTP/HTTPS 国内站点：正常（baidu 200）
- 国外明文 HTTP（如 neverssl.com）：可能被运营商/防火墙过滤（返回空/卡住）
- 5G 出口 **无 IPv6**（curl -6 返回 000）
- 主路由双 WAN failover 检测可能因此误判：若主路由用国外站点/双栈做健康检查会误报"外网不通"
RM520N-5G/文档/RM520N-硬件结构与网络拓扑.md
+131
View File
@@ -0,0 +1,131 @@
# 硬件结构与网络拓扑（2026-08-19）
> 峰的家用 NAS/软路由硬件拓扑与 RM520N-GL 5G 模块直通结构
> 整理日期：2026-08-19
---
## 一、硬件结构
### 宿主机（飞牛 Fnos）
| 项 | 值 |
|---|---|
| 系统 | 飞牛 fnOS（云主机/软路由宿主） |
| CPU | Intel Core i5-8250U @ 1.60GHz（4核8线程） |
| 内存 | 15 GiB |
| 网卡 | 4 × Intel I226-V（enp1s0 / enp2s0 / enp3s0 / enp4s0） |
| 网卡现状 | enp1s0 = UP，enp4s0 = UP；enp2s0 / enp3s0 = 未接（DOWN） |
| 虚拟化 | KVM/QEMU（libvirt，`pc-i440fx-7.2`），需用 `vfio` 直通 |
### 5G 模块（移远 RM520N-GL）
| 项 | 值 |
|---|---|
| 型号 | Quectel RM520N-GL |
| PCI 位置（宿主） | `06:00.0`，PCI_ID `17cb:0308`（Qualcomm Device 0308） |
| 物理接口 | PCIe / M.2 转接卡（M.2→PCIE ×1） |
| 直通方式 | vfio-pci 直通给 istoreos 虚拟机 |
| 固件 | RM520NGLAAR03A04M4G |
| IMEI | 868371050275649 |
| SIM | 联通（ICCID 89860125801671811893，IMSI 460092810130406） |
### istoreos 虚拟机（5G 路由器）
| 项 | 值 |
|---|---|
| VM 名称 | adwi9jj4（libvirt domain-1） |
| 系统 | iStoreOS（OpenWrt 定制版，musl libc） |
| 登录 IP | 192.168.110.200（root，SSH） |
| 虚拟网卡 | 2 × virtio-net-pci（tap 桥接） |
| 直通 | vfio-pci hostdev `0000:06:00.0` → guest PCI `00:0a.0` |
---
## 二、虚拟网卡映射（宿主 ↔ istoreos）
| 宿主网卡 | istoreos 虚拟网卡 | guest 接口 | MAC | 网段/用途 |
|---|---|---|---|---|
| enp1s0 (UP) | net0 (virtio, tap) | **eth0** | dc:f9:90:7a:e3:d8 | 192.168.110.200 → 走宽带（管理+SSH） |
| enp4s0 (UP) | net1 (virtio, tap) | **eth1** | ec:45:6d:3b:62:ef | 192.168.200.1 → 5G 出口（给主路由 wan2） |
> 注：宿主网卡通过 OVS/veth（`enp1s0-ovs`、`enp4s0-ovs` 等）连接。
---
## 三、网络拓扑（逻辑）
```
┌─────────────────────────────────────────┐
│ 主路由 (OpenWrt) │
│ wan1 = 192.168.1.2 → 光猫宽带 (优先) │
│ wan2 = 192.168.200.2 → istoreos eth1 │
│ lan = 192.168.110.1 │
└──────┬────────────────────┬──────────────┘
│ │
(宽带) │ │ (5G 备份出口)
│ │
┌────────────▼──────┐ ┌─────────▼──────────┐
│ istoreos eth0 │ │ istoreos eth1 │
│ 192.168.110.200 │ │ 192.168.200.1 │
│ (管理/SSH) │ │ (NAT → 5G) │
└────────┬──────────┘ └─────────┬──────────┘
│ │
(直通vfio) │
┌───────────▼──────────┐ │
│ RM520N-GL 5G 模块 │◄────────────┘
│ 06:00.0 → 00:0a.0 │
│ MBIM → rmnet_mhi0.1 │
└──────────────────────┘
```
### 数据流向
| 流量 | 路径 | 出口 |
|---|---|---|
| istoreos 自身管理 | eth0 → 默认路由 110.1 | **宽带**（主路由 wan1） |
| 主路由 wan2 侧 (200.x) | eth1 → 策略路由表 200 → 5G NAT | **5G** |
| 主路由正常上网 | wan1 宽带（192.168.1.2） | **宽带**（优先） |
| 宽带断时 | 主路由自动切 wan2 → istoreos 5G | **5G**（备份） |
---
## 四、关键驱动与配置
### 驱动
- **pcie_mhi** V1.3.8（移远私有 MHI 驱动），参数 `mhi_mbim_enabled=1`（**MBIM 模式**）
- MBIM 设备节点：`/dev/mhi_MBIM`（控制通道）、`/dev/mhi_DUN`（AT 通道）
- 数据接口：`rmnet_mhi0`（主）、`rmnet_mhi0.1`（实际拨号数据面，qmap vlan）
### istoreos 关键接口
| 接口 | IP | 作用 |
|---|---|---|
| eth0 (wan) | 192.168.110.200/24，网关 110.1 | 宽带/管理 |
| eth1 (br-lan) | 192.168.200.1/24 | 主路由 wan2 网关 |
| rmnet_mhi0.1 | 运营商动态 IP (10.x) | 5G 数据面 |
| docker0 / br-lan | — | 系统默认 |
### 开机自启链（重启自动恢复）
1. **/etc/modules.d/90-pcie_mhi**：`pcie_mhi mhi_mbim_enabled=1` 驱动加载
2. **S95modem5g**：等待 `/dev/mhi_MBIM` → `quectel-CM -s wonet` 拨号（MBIM）
3. **S96wan5g-route**：等待 `rmnet_mhi0.1` 有 IP → 加策略路由表 200 + NAT
> 注：rc.local **不需要**手动 bind mhi_q（手动强绑会抢设备致 SYS_ERR）。模块失联时先断电重启飞牛，仍无效再手动 `echo 0000:00:0a.0 > /sys/bus/pci/drivers/mhi_q/bind` 临时唤醒。详见《RM520N-故障排查与自启链路.md》
---
## 五、当前 IP 网段一览
| 网段 | 用途 | 关键设备 |
|---|---|---|
| 192.168.1.0/24 | 光猫宽带 | 主路由 wan1 = 192.168.1.2 |
| 192.168.110.0/24 | 主路由 LAN | 主路由 110.1，istoreos eth0 = 110.200 |
| 192.168.200.0/24 | 主路由 wan2 ↔ istoreos eth1 | 主路由 wan2 = 200.2，istoreos eth1 = 200.1 |
| 10.x.x.x | 5G 运营商内网 | istoreos rmnet_mhi0.1 |
---
## 六、备份与归档
- 完整成功路线归档于本目录上级：`/vol2/1000/OS/RM520N-5G-成功路线/`
- `文件/configs/` 基础拨号配置
- `文件/多WAN配置/` 双出口（eth1→5G / eth0→宽带）
- `文件/binaries/` musl 编译的 Quectel-CM V1.6.8
- `文件/source/` V1.6.8 源码
- 归档压缩包：`/vol2/1000/OS/RM520N-5G-成功路线.tar.gz`