# 蜂窝网络

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**Quectel Pi** 开发板支持蜂窝网络（Cellular Network）功能，可通过 USIM 卡接入运营商 LTE 网络，实现移动数据通信。本文说明 USIM 卡和蜂窝天线连接方式、开机自动注网逻辑，以及板端网络状态验证和常见问题排查方法。

系统启动后会自动完成 modem 初始化、SIM 识别、运营商注网和数据拨号；正常情况下无需用户手动执行拨号命令。

> 💡 开机自动注网说明：插入有效 USIM 卡并连接蜂窝天线后，开发板上电进入系统会自动尝试注册运营商网络并建立数据连接。注网成功后，系统会生成 `rmnet_data0` 等蜂窝数据接口并获取 IP 地址；如果未获取到 IP，请优先检查 SIM 卡状态、天线连接、信号覆盖和运营商套餐。

# 硬件连接

- **SIM 卡卡槽：** Nano SIM 拔插式卡座。上电前插入可用 USIM 卡，注意卡槽方向和接触可靠性。

```{image} images/image_LVwjbmHmLo4fFExGXw4cCdD8nzh.webp
:width: 1021px
:height: 653px
:align: center
```

- **蜂窝天线接口：** IPEX-4TH 天线座。测试前请连接 LTE 主天线，并尽量在信号良好、无遮挡的位置验证网络。

```{image} images/image_H1Bub8ec6ogqHZx17K5cMn6rnqs.webp
:width: 1280px
:height: 834px
:align: center
```

# 快速开始

## 开机自动注网

插入 USIM 卡、连接蜂窝天线并上电启动后，系统会自动进行蜂窝网络注网和数据拨号。进入系统界面后，可以打开本机终端，也可以通过 ADB 连接板端执行以下命令确认网络状态。

```bash
# 进入板端终端
adb shell

# 查看蜂窝数据接口是否生成并获取 IP
ifconfig rmnet_data0
# 或
ip addr show rmnet_data0

# 查看默认路由
ip route

# 验证外网连通性
ping -c 4 8.8.8.8
ping -c 4 www.baidu.com
```

如果 `rmnet_data0` 处于 `UP` 状态并显示有效 `inet addr` / `inet` 地址，说明蜂窝数据拨号成功；此时可以执行 `ping` 命令验证外网连通性。下图为蜂窝网络连通性验证示例。

```{image} images/image_WmdsbOnjdoG4f8xE9jJcBW43nOe.webp
:width: 756px
:height: 261px
:align: center
```

## 拨打电话

命令行输入qlril-api-test命令进行拨打电话

```{image} images/image_OAfTbnmdXorzy9xdKSHc2K8LnPc.webp
:width: 591px
:height: 418px
:align: center
```

输入4可以查询当前默认使用卡1还是卡2 ，输入5可以进行默认卡切换

```{image} images/image_GSJvb4eqNoKnGjxF5a4c4M3Snxb.webp
:width: 515px
:height: 251px
:align: center
```

下面是跟通话相关的常见指令

```{image} images/image_D1nLbOr3roKaR8xMoq7c3BmPnMc.webp
:width: 453px
:height: 340px
:align: center
```

输入43，然后按照提示输入目标手机号码可以进行拨打电话

```{image} images/image_QE6hbBRQso43VQx5coCcu8synQc.webp
:width: 998px
:height: 158px
:align: center
```

## 接听电话

当收到来电后，窗口会显示来电信息，此时输入44可接听电话，45进行拒接，47挂断

# 常见问题排查

| **现象** | **可能原因** | **建议排查** |
| --- | --- | --- |
| `rmnet_data0` 不存在 | modem 未初始化、RIL/数据服务异常，或蜂窝数据链路未拉起。 | 执行 `ifconfig -a`、`ip link` 查看接口；如系统集成 ModemManager，可执行 `mmcli -L` 确认 modem 是否识别。 |
| `rmnet_data0` 存在但无 IP | SIM 卡未正常识别、未完成注网、信号弱、套餐未开通数据业务或 APN 配置异常。 | 确认 USIM 卡可用且方向正确，检查天线连接和信号环境；必要时换卡、换位置或查看 modem/SIM 状态。 |
| 有 IP 但无法访问外网 | 默认路由、DNS、运营商网络或目标地址连通性异常。 | 先执行 `ip route` 查看默认路由，再分别测试 `ping -c 4 8.8.8.8` 和 `ping -c 4 www.baidu.com`，区分路由问题和 DNS 问题。 |
| 网络不稳定或时通时断 | 天线接触不良、信号覆盖弱，或测试环境存在遮挡/干扰。 | 重新插拔并固定天线，将开发板移到信号较好的位置，观察 `rmnet_data0` 收发包和 ping 丢包情况。 |

# 板端确认命令

维护或定位问题时，可先收集以下信息，确认接口、路由和网络连通性：

```bash
adb shell
ifconfig -a
ip addr show rmnet_data0
ip route
ping -c 4 8.8.8.8
ping -c 4 www.baidu.com

# 如系统已集成 ModemManager，可进一步查看 modem/SIM 状态
mmcli -L
mmcli -m 0
```

# 结论

蜂窝网络在开机后会自动注网和建立数据连接。正常情况下，插入有效 USIM 卡并连接蜂窝天线后，进入系统即可看到 `rmnet_data0` 获取 IP 地址；用户只需要按本文命令确认接口、路由和连通性即可。