查看“1002 RPi0 4G Cat1”的源代码

[[1002 RPi0 4G Cat1 EN|Change the language to English]]

== '''关键词''' ==
树莓派Raspberry Pi Zero、Zero 2W、Cat1 4G LTE、扩展板、Nano SIM、eSIM、RPi-Connect、远程连接、免驱即插即用

== '''一、简介''' ==
树莓派Zero CAT1是一款尺寸只有65*30mm的4G LTE扩展板，基于树莓派Zero系列（包括Zero、Zero W(H)以及Zero 2W）尺寸设计，利用树莓派Zero板子反面引出的USB和电源的镀金测试点，进行外设扩展。扩展板分USB版和顶针版两个版本，其中顶针版是通过顶针将扩展板和Zero的USB口连接起来，此时无法再通过树莓派Zero的microUSB外接键盘鼠标等USB设备，而我们可以通过远程界面来控制本设备。USB版（不焊接顶针）可以用于树莓派3B、4B和5或者其他兼容性板子上，扩展板采用内凹设计，方便安装在树莓派3B/4B/5等板子上方的时候，不影响或尽量少影响40Pin引脚的外接。

4G Cat1是针对10Mbps左右的中速物联网应用的高性价比模组，10Mbps下行5Mbps上行的速率可以满足绝大多数联网和传输需求；4G全网通,支持联通、电信和移动。CAT1扩展板在树莓派官方OS下免驱，即插即用。

== '''二、硬件资源''' ==
1. '''顶针版'''通过4个顶针和树莓派Zero系列通过镀金顶针连接，扩展板位于Zero下方，通过Zero的MicroUSB电源口供电，'''''此时树莓派Zero自身的micro   USB口以及板载USB-C口和1.25mm 4P接口都不能外接任何设备或电源'''''。

2. '''USB版本（不焊接顶针）'''通过USB口和开发板通讯及供电，USB口采用Type-C口和1.25mm 4P接口两种形式引出，二选一使用；

3. 采用Nano SIM卡座，并预留eSIM芯片位置(SIM卡和eSIM芯片二选一)，硬件支持热插拔，需要软件配合。

4. 4G天线采用IPEX一代接口，可接4G FPC天线或棒状天线。

5. 引出调试串口和AT主串口，3.3V电平。

6. 两个LED指示灯，其中STAT灯亮表示CAT1正常运行；NET用于指示网络状态，1.8秒亮0.2秒灭表示注网成功，1.8秒灭0.2秒亮表示未注网，需要检查SIM卡和天线。

7. 反面预留BOOT和复位的按键位置，如有升级固件需要或者按键复位需要可自行焊接。

8. 尺寸：65*30*6.6mm；

9. M2.5mm固定孔和树莓派Zero开发板完全吻合。PCB板通过UL和ROHS认证，防火等级94V-0。 

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_21.jpg

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_22.jpg

== '''三、树莓派OS的操作''' ==

=== 3.1 USB版 ===
USB版若接树莓派Zero系列开发板，一般需要再搭配带USB接口的扩展板使用，所以只要在config.txt里面启用USB Host模式即可；

此处我们是基于我司树莓派Zero双网口扩展板组装好树莓派Zero 2W后，再接CAT1-USB版；

CAT1-USB版占用Zero双网口扩展板（下图）右侧USB-A口，此USB口不能外接任何设备，不然4G将无法使用：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_12.jpg

启动系统后，执行<code>ifconfig -a</code>，可以看到eth2，即为4G CAT1；而eth0和eth1是双网口扩展板上的2个百兆网口：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_14.jpg
=== 3.2 顶针版 ===

==== 3.2.1 准备工作 ====
Zero 2W的自身只有一个USB口，现被4G占用，因此无键盘鼠标可用，后续操作只能通过WiFi或者4G联网进行，所以在烧写时需要对系统进行预设置，配置WiFi并使能SSH才能进一步使用（如果您是用树莓派ZeroW或Zero WH，使用方法一样）。

如果您是使用树莓派Zero，因为没有WiFi功能，那只能先在其它扩展板上调试完成所有业务逻辑并设置成开机自运行，如果你后续无其它USB设备外接需求，4G Cat1仅用于提供网络接入，那可以使用顶针版，否则建议使用USB版本。

硬件：供电请插到Zero 2W标注PWR的USB电源口，如果插到另外一个USB口或者扩展板上的USB口，都会造成4G模块被屏蔽。

接线示意图：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_20.jpg

系统： 镜像为2024-07-04-raspios-bookworm-arm64.img.xz（树莓派OS，Raspberry Pi OS with desktop）。

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

树莓派OS下载地址：

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

==== 3.2.2 烧录系统（需对WiFi连接及SSH服务的设置） ====
打开树莓派镜像烧录器，选择完设备平台、镜像和烧录位置后，点击”NEXT“：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_01.jpg

然后点击”编辑设置“

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_02.jpg

在弹出的窗口中，GENERAL页面中，可以主机名、用户名和密码、默认连接的WiFi、区域：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_03.jpg

在SERVICES页面中，请设置开启SSH服务：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_04.jpg

设置完成后点击”保存“，返回上一层页面，然后点击”是“：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_05.jpg

在警告窗口中点击”是“

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_06.jpg

这样就开始了烧写，烧写完毕后使用该TF卡启动系统，系统使用预设的用户名和密码自动登录，并自动连接至预设的WiFi（需在该WiFi热点覆盖范围内）。

如果系统卡在树莓派logo处无法启动：

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_58.jpg

请仔细观察顶针是否对准了镀金触点，并请在PC端打开TF卡系统分区根目录下的config.txt检查USB的初始化脚本：

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_41.jpg

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

<code># otg_mode=1</code>（建议按此注释掉）

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

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_57.jpg

==== 3.2.3 通过WiFi进行SSH控制 ====
系统启动后，如果WiFi连接成功，会在桌面右上角WiFi图标下面显示内网连接IP：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_07.jpg

也可以通过查看路由器后台来获得系统内网IP：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_19.jpg

此处使用MobaXterm软件进行SSH，MobaXterm软件下载地址：

https://mobaxterm.mobatek.net/download-home-edition.html

打开MobaXterm软件，新建一个连接，选择SSH，Remote Host填入树莓派OS的IP，Specify username填入登录账号，如下图所示：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_08.jpg

点击”OK“，然后登录，登录完成后，我们即可通过MobaXterm对树莓派Zero2W进行命令行操作：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_23.jpg



此时，我们查看4G模块的连接情况：

<code>lsusb</code>

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_24.jpg

可见4G模块已连接。

使用ifconfig -a查看网络，可见4G模块为eth0，已经获得了IP：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_25.jpg

==== 3.2.4 使用AT命令 ====
在SSH终端中执行命令：

<code>ls /dev</code>

此时应该能看到dev设备下有ttyACM0-2三个设备：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_27.jpg

下载安装minicom工具：

<code>sudo apt-get install minicom</code>

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_28.jpg

通过minicom打开AT命令串口：

<code>sudo minicom -D /dev/ttyACM0</code>

注意，使用哪个串口，应以在进入此串口后，可输入运行AT命令，显示不乱码，不乱跳结果为准。

下面以minicom为例，

如果需要查看回显，请键入命令：<code>ate1</code>，然后回车，继续键入其它命令，回车可以看到结果。

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_29.jpg

常用AT命令：

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

<code>at+cpin?</code>

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

2. 检查天线信号质量：

<code>at+csq</code>

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

3. 检查注网情况：

<code>at+cops?</code>

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

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

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

<code>at+cgsn</code>

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

<code>at+reset</code>

6. 关闭射频：

<code>at+cfun=0</code>

开启射频：

<code>at+cfun=1</code>

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

==== 3.2.5 开启SIM卡热插拔功能 ====
本扩展板支持SIM卡热插拔，但是这个功能默认状态下是关闭的，如果要开启，请先拔掉SIM卡，然后打开AT命令串口：

<code>sudo minicom -D /dev/ttyACM0</code>

执行：

<code>at+csdt=1</code>

如果输出OK，说明设置成功。

可以用<code>at+csdt?</code>来检测当前状态，返回1代表已经开启SIM卡热插拔功能。

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_33.jpg

热插拔SIM卡后，分别执行下列命令，都成功（eth0是4G模组），说明支持热插拔：

<code>sudo udhcpc -i eth0</code>

<code>ping www.mcuzone.com -I eth0</code>

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_34.jpg

== '''四、4G的应用（远程控制）''' ==
RPi-Connect提供了从任何地方安全接入到树莓派的服务。基于此服务，搭配Zero_Cat1_4G顶针版即可实现在户外没有无线网络的情况下，依旧可以远程访问树莓派操作。注意：要使用此服务必须运行Bookworm及以上系统。同时，只有树莓派5，4或400可以使用屏幕分享。Zero2W只能使用Remote shell。接下来演示如何配置远程连接服务。

=== 4.1 安装DNS服务（仅限2024.07.04及之后的系统版本） ===
4G CAT1模块是免驱的，在每次开机就可以实现4G自动连接，但是为了不引起DNS服务器冲突，还需要对开机自启动进行如下设置：

安装切换DNS服务器的软件udhcpc：

<code>sudo apt install udhcpc</code>

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_18.jpg

开启rc-local服务：

<code>sudo sudo systemctl enable --now rc-local</code>

通过下面的命令打开rc.local：

<code>sudo nano /etc/rc.local</code>

在exit 0上面添加你要开机执行的命令，然后保存文件（本示例中eth0代表4G模块，名称以实际为准）：

<code>sleep 5 && sudo udhcpc -i eth0 && sleep 5 && sudo udhcpc -i eth0 && sleep 5 && sudo udhcpc -i eth0</code>

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_23.jpg

sleep命令的作用是延迟多少秒执行之后的命令，因为4G模块获取IP地址需要一定的时间，所以为了防止udhcpc执行失败，需要多执行几次，并且在每一次执行命令之间加上一定的延迟。这样执行的结果，是等系统启动后，大约20秒左右可以使用4G网络。

=== 4.2 申请Raspberry Pi ID ===
如果已有Raspberry Pi ID请直接登录，如果没有请按下列步骤申请。

打开在<nowiki/>https://id.raspberrypi.com/<nowiki/>，输入您要使用的邮箱以及密码：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_12.jpg

创建账号完成后需要进入邮箱验证：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_13.jpg

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_14.jpg

验证完成后即可使用该id。

=== 4.3 安装远程服务 ===
打开SSH终端，安装Raspberry Pi Connect软件，如果安装时显示已安装则不需另外安装：

<code>sudo apt install rpi-connect</code>

安装完成后，我们在终端输入<code>loginctl enable-linger</code>确保每次重启后系统自动打开远程服务。

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_32.jpg

重启系统，在图形界面中，依次选择如下图项目后，确保Raspberry Pi Connect已打开：

http://www.mcuzone.com/wiki/0002_MPS2280iPoE/MPS2280iPoE_08.png

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_13.jpg

然后在树莓派终端输入：

<code>rpi-connect signin</code>

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_30.jpg

此时显示一个网址，如上图所示，我们在浏览器（建议使用别的电脑，Zero系列因为硬件资源关系，打开浏览器时非常缓慢）中打开这个网址：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_17.jpg

点击Sign in，按照提示进行绑定即可，首先需要设置设备名称：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_18.jpg

点击Create device and sign in：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_19.jpg

这样就完成了绑定，终端中也会有成功的显示：

http://www.mcuzone.com/wiki/1002_Zero_4G_Cat1/1002_Zero_4G_Cat1_31.jpg

=== 4.4 使用远程控制 ===
在PC上打开：<code><nowiki>https://connect.raspberrypi.com/devices</nowiki></code>：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_21.jpg

刚才添加的Zero 2W设备下面只有”Remote shell“字样，表示此设备只能通过远程命令行界面控制。

点击Connect，弹出远程命令行界面，即可输入命令：

http://www.mcuzone.com/wiki/1003_Zero_4G_Cat1-Hub/1003_Zero_4G_Cat1-Hub_22.jpg

配置完毕后，可以使系统每次启动时都能通过4G上网，并开启Raspberry Pi Connect远程服务，我们就可以在PC上通过远程命令行界面控制设备。

{{联系我们_图标}}