蜂窝网络

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 卡，注意卡槽方向和接触可靠性。

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

快速开始

开机自动注网

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

# 进入板端终端
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 命令验证外网连通性。下图为蜂窝网络连通性验证示例。

拨打电话

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

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

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

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

接听电话

当收到来电后，窗口会显示来电信息，此时输入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 丢包情况。

板端确认命令

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

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 地址；用户只需要按本文命令确认接口、路由和连通性即可。