1006 RPi0 4G MiniPCIe（MiniPCIe扩展4G模组）：修订间差异

2025年3月17日 (一) 13:38的最新版本

关键词

树莓派、 Raspberry Pi Zero、Zero W、Zero WH、Zero2 W、MiniPCIe 4G LTE CAT4、USB2.0-A、以太网、扩展板、SSH

一、简介

此扩展板基于树莓派Zero系列扩展的MiniPCIe 4G，利用树莓派Zero反面的USB和电源的镀金测试点，进行外设扩展。本扩展板实际就是一个USB HUB集线器，利用顶针将扩展板和Zero的USB口连接起来，免去外接USB线缆，节约空间且美观；通过USB扩展四路USB口，其中一路USB转百兆有线以太网，一路USB连接MiniPCIe 4G Cat4模组以及两路USB2.0-A主机接口。

扩展板支持树莓派Zero全系列所有开发板，包括Zero、Zero W、Zero WH和Zero 2W，也支持香橙派Zero 2W。

4G LTE CAT4模组是针对高速物联网应用的高性价比模组，可以满足绝大多数联网和传输需求；我们配套的多款4G LTE模组均为4G全网通，在树莓派官方OS、Ubuntu系统以及OpenWrt系统都是免驱，自动识别，无需额外安装驱动。4G LTE模组在香橙派官方Ubuntu系统下也是免驱，自动识别，即插即用。

二、硬件资源

1. 两组镀金顶针分别用于扩展板的供电和USB通讯；

2. 一路USB-C供电接口（此时树莓派Zero自身的MicroUSB无需再供电）；也可以用Zero上的MicroUSB口供电；二选一使用；

3. 一路USB2.0 MiniPCIe接口，用于连接4G LTE模组；

4. 一路Nano SIM卡座；

5. 一路百兆以太网；

6. 两路USB2.0-A口，每路可确保2A电流输出；

7. 三个LED指示灯：PWR/MODE/ACT LED；

8. 一个4G复位按键；

9. 尺寸：85*70mm；

10. PCB板沉金工艺，无铅生产，板材通过UL和ROHS认证，防火等级94V-0；

11. 可选配铝合金外壳。

注意1：连接了此扩展板后，Zero上的MicroUSB将不可接任何USB设备，且无法再使用OTG功能。

注意2：有些系统需要禁用OTG功能并将USB模式设置为Host模式。

三、树莓派OS的操作

硬件平台：树莓派Zero 2W+扩展板；

软件平台：树莓派OS版本为2024-07-04-raspios-bookworm-arm64.img.xz，树莓派OS下载地址：

https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit

（若使用树莓派Zero一代系列的板子，只支持32位系统，请注意下载版本。)

3.1 查看硬件设备

3.1.1 查看USB设备

扩展板上的2个USB口分别接一个U盘和无线键鼠，miniPCIe接高通4G模组，打开树莓派OS的终端，输入命令lsusb，如下图所示：

Device 002：USB Hub；

Device 003：百兆以太网；

Device 004：USB2.0-A接口，接无线键鼠；

Device 005：高通 4G模组；

Device 006：USB2.0-A接口，接U盘；

若USB口未接任何设备，则执行lsusb后，不会出现Device 006和004。

3.1.2 查看4G和以太网

打开树莓派OS的终端，输入命令ifconfig -a，（我们内网ip是192.168.8.x，用来判断下面对应扩展板百兆网卡设备），如下图所示：

CAT4 4G：

高通4G：

ZTE CAT4：

EC20：

3.2 测试4G和以太网

本节使用高通4G模块作为测试模块。

3.2.1 ping包测试

测试的时候有优先级，如有内外网特殊优先级需要请调整各网络的metric值以及DNS服务器设置。

有关网卡优先级的相关设置，请参阅以下链接：

1. 网卡优先级的设置

2. 利用udhcpc指定DNS服务器

3. udhcpc应用场景举例

现在系统已连接有线百兆网卡和4G，可以用-I参数指定从哪个网卡开始ping包，如下所示：（不同的4G型号，对应的设备名称不一样，请以用户自己的ifconfig-a的结果为准）

ping www.mcuzone.com -I eth0

ping www.mcuzone.com -I usb0

优先级可以通过可以执行route命令来查看，哪个网卡的metric值小就从优先从哪个网卡通讯。

我们也可以通过关闭某个网卡，达到强制指定通过另一个网络进行通讯，如需关闭usb0，可执行下面的命令：

sudo ifconfig usb0 down

以及通过执行下面的命令来开启usb0：

sudo ifconfig usb0 up

3.2.2 iperf3测速

Windows版iperf3下载：

http://www.mcuzone.com/down/Software.asp?ID=10000634

Linux下iperf3安装：

sudo apt-get install iperf3

百兆以太网测速结果：

client模式92.3Mbps左右：

server模式94.8Mbps左右：

注意：USB转百兆有线受Zero 2W性能和USB Hub以及4G Cat4模组带宽占用影响并不能跑满，请知悉。

3.2.3 4G网速测试

因为Zero 2W性能限制，在其上运行Chromium等浏览器进行网页测速时，系统运行会非常慢，因此我们使用轻量浏览器surf进行测速。

安装轻量浏览器surf：

sudo apt install surf

然后关闭WiFi，拔掉网线，只剩下4G网络连接，进入https://test.ustc.edu.cn/进行测速。在树莓派终端中运行：

surf https://test.ustc.edu.cn

结果如下：

注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。

3.3 4G的AT命令使用

3.3.1 打开AT命令串口方法

（这里使用高通4G演示）在树莓派系统下对4G进行AT命令操作，需要打开AT命令串口，打开方法如下：

首先打开ttyUSB串口：

输入命令lsusb，如下图所示：

记下4G模块的ID值：05c6 90b6

使用下列命令打开ttyUSB串口，其中echo后面的值就是上面记录的ID值：

sudo modprobe option

sudo sh -c 'echo 05c6 90b6 > /sys/bus/usb-serial/drivers/option1/new_id'

执行以上两条命令后系统应该会多出ttyUSB0-2三个设备，输入ls /dev可以查看：

然后用串口工具打开特定串口：

安装minicom工具：

sudo apt-get install minicom

通过minicom打开AT命令串口：

sudo minicom -D /dev/ttyUSB0

然后直接键入AT命令，回车可以看到结果，如果需要查看回显，请键入命令：ate1：

注意：操作流程都一样，只是不同的4G型号，相应的USB ID会不一样，所以以lsusb查看实际的USB ID为准。

3.3.2 常用AT命令

常用AT命令：

1. 检查SIM卡是否识别到：

at+cpin?

返回ready表示卡已识别，返回error要检查硬件

2. 检查天线信号质量：

at+csq

返回值在26-31表示信号OK，信号满格31；返回值在20-25表示信号勉勉强强；返回值在20以下表示信号比较糟糕或者天线没接

3. 检查注网情况：

at+cops?

正常应该返回运营商代码和7，7代表4G。

注意，以上命令只有at+csq不要加问号，另外两条命令需要加问号。

4. 查看4G模块的IMEI码：

at+cgsn

5. 重启4G模块（有时候如果重插SIM卡，热插拔不一定管用，可以用这个reset命令来复位模块）：

at+reset

6. 关闭射频：

at+cfun=0

开启射频：

at+cfun=1

上述两条命令成对使用，可以在不重启4G模组的情况下让模组重新注网。

7. APN设置

普通手机SIM卡，不需要任何设置，直接使用；有些物联网卡需要设置APN才能使用，以下是用户使用提供的参考，具体的APN代码需要SIM卡运营商提供。

移动卡：

AT+CPNETAPN=0,"cmnet","",""

电信卡：

AT+CPNETAPN=0,"ctnet","",""

3.4 修改4G模组的IP地址

如果4G的IP地址和你的内网地址冲突，可以修改4G的IP地址。

1) 高通4G、ZTE CAT4：

将4G模块的IP改为直接获取公网IP即可，请执行AT命令：

设置IP为公网：AT+GTIPPASS=1

设置IP为内网：AT+GTIPPASS=0

查询当前IP为公网还是内网：AT+GTIPPASS?

2) CAT4 4G：

执行AT命令：

AT+ROUTEIP=<newip>

注意，只支持192.168.x.1这样格式的地址，如果设置了AT+ROUTEIP=192.168.3.1，最终获得的IP为192.168.3.100，修改完后需断电重启系统。

查询当前IP：AT+ROUTEIP?，返回两个值，前一个为旧IP，后一个为新IP。

测试命令：AT+ROUTEIP=?

3）EC20的IP地址不清楚如何修改，如有需要，需要用户自行研究。

3.5 GPS的测试

3.5.1 高通4G-GPS

若您是高通4G-GPS模块，如需使用GPS功能，请先接GPS无源天线，且将天线甩到窗户外面；GPS的使用是通过AT命令操作的，操作步骤请看第3.3章节，运行minicom，打开ttyUSB0串口：

sudo minicom -D /dev/ttyUSB0

并运行：

at+gtgpsepo=1 //开启AGPS

at+gtgpspower=1 //打开GPS

稍等片刻待定位成功，运行：

at+gtgps? //查看NMEA信息

就可以看到GPS信息输出：

3.5.2 EC20-GPS

若您是EC20-GPS模块，要使用GPS功能，请先接GPS有源天线，且将天线甩到窗户外面，GPS使用AT命令操作，操作步骤一样，输入命令lsusb，如下图所示：

记下4G模块的ID值：2c7c 0125

使用下列命令打开ttyUSB串口，其中echo后面的值就是上面记录的ID值：

sudo modprobe option

sudo sh -c 'echo 2c7c 0125 > /sys/bus/usb-serial/drivers/option1/new_id'

执行以上两条命令后系统应该会多出ttyUSB0-3三个设备，输入ls /dev/ttyUSB*可以查看：

运行minicom，打开ttyUSB3串口：

sudo minicom -D /dev/ttyUSB3

并运行：

AT+QGPS=1 //打开GPS

运行成功后打开ttyUSB1：

sudo minicom -D /dev/ttyUSB1

就可以看到该串口有GPS信息输出，稍等片刻即可定位：

3.6 EC20的打电话和发短信操作

3.6.1 打电话操作

3.6.2 收发短信操作

这里我们演示的收发短信操作，仅限英文字符。

四、FAQ

4.1 系统启动一半卡住了，怎么办？

问1：如果系统卡在树莓派logo处无法启动（如图）：

答1: 请在PC端打开TF卡系统分区根目录下的config.txt检查USB的初始化脚本：

需要确认下图中的三处红框的位置是否都配置成完全，如果没有，请手动添加完整并保存文件：

# otg_mode=1（建议按此注释掉）

dtoverlay=dwc2,dr_mode=host（两处必须确保加上）

4.2 鼠标键盘无法使用，怎么办？

问2: 启动后键盘鼠标及4G模组都无法使用，怎么办？

答2：硬件上，1）请仔细观察顶针是否对准了镀金触点，螺钉是否拧紧；2）请查看树莓派zero开发板自身的micro口有没有外接其他设备，连USB线也不能接；

如果硬件上没有问题，那要从软件上解决，请参考答1的操作步骤。

4.3 接了扩展板后，USB gadget还能用么？

问3: 我之前用树莓派zero的micro USB作为 USB gadget；现在接了扩展板后，能用扩展板上的USB口实现USB gadget功能么？

答3: 不能。原本树莓派zero的micro USB作为USB gadget，是将树莓派zero的micro USB的OTG作为device功能使用；但是我们的扩展板是将树莓派zero的micro USB OTG作为HOST使用，OTG是2个功能接口二选一使用；故，若您想用USB gadget，那只能放弃我们的扩展板，直接用树莓派zero即可。