查看“4009 M6 4G”的源代码

== '''关键词''' ==
友善 NanoPi M6、RK3588S、USB3.0、USB2.0、M.2 NVME、4G LTE、HDMI、Debian、Ubuntu

== '''一、简介''' ==
M6-4G是一款专门为友善NanoPi M6开发板设计的，基于其M.2 M接口扩展出来的4G LTE模块，友善官方Ubuntu OS和Debian OS实现免驱，自动识别4G。4G是采用中兴方案组，板载Nano SIM卡座，预留eSIM芯片位置，4G天线采用1代ipex接口，双天线配置。

NanoPi M6（简称”M6”）是友善电子团队设计出品的一款开源高性能一体化边缘计算平台。它采用瑞芯微RK3588S作为主控处理器，配备 64-bits LPDDR5内存，以及可选的eMMC闪存模块，支持运行FriendlyWrt、Android、Debian和Ubuntu等多种系统，并支持GPU和VPU加速。

M6接口丰富，布局紧凑，主板尺寸只有 90x62 mm，它带有30Pin GPIO，其中包含普通I/O口、I2C、I2S、PWM和SPI等接口，还带有1个HDMI输出接口，可解码播放最高8K@60fps H.265/VP9，以及8K@30fps H264等格式视频。

M6还带有1个M.2 NVME固态硬盘接口，以及和1个USB3.0和2个USB2.0接口，并支持当前流行的PD快充电源供电(USB C接口)，外接移动硬盘时无需担心供电不足, 另外可选配安装一体化CNC氧化铝外壳。

M6非常适合企业客户定制开发自己专属的系统，并适合嵌入式爱好者发掘、探索打造自己独具一格的玩法。

== '''二、硬件资源''' ==

== '''三、友善Ubuntu系统''' ==
本文档的演示用从TF卡启动系统，测试的友善官方Ubuntu系统（图形化桌面版本）烧写包版本：rk3588-sd-ubuntu-noble-desktop-6.1-arm64-20250122.img.gz

将网口与上级路由器相连，上电启动系统。在终端中执行<code>lsusb</code>，结果如下：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_01.jpg" width=700></html>

红框处即为4G模组。

执行<code>ifconfig -a</code>，查看网络参数如下：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_02.jpg

执行<code>route</code>，查看路由表，eth0排在第一位，因此是有线网络优先上网：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_03.jpg

其中10.11.162.121为4G模组的默认网关，请以实际为准。

如果要让4G网络优先上网的话，可以运行命令：

<code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 10.11.162.121</code>

这两条命令（以“&&”分隔）的解释：

<code>sudo ip route del default</code>：删除路由表中的默认路由；

<code>sudo route add -net default netmask 0.0.0.0 gw 10.11.162.121</code>：添加4G网络的网关为新的默认路由。

执行完毕后，再执行<code>route</code>，查看路由表，看到eth1排第一位，就是4G优先上网：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_04.jpg

如果需要改回优先走有线网络，操作方法同上。

'''''注意，重启后路由表还是会恢复原状，所以如果重启后要网络继续默认走有线网络，需要再执行一次<code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 10.11.162.121</code>。'''''

此时我们ping IP和域名，均成功，说明4G模块工作正常：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_05.jpg

打开<nowiki/>https://www.speedtest.cn/<nowiki/>进行网速测试，结果如下：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_06.jpg

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

== '''四、Debian系统的测试''' ==
将Debian系统（图形化桌面版本）烧写进TF卡。

我们测试的友善官方烧写包版本：rk3588-sd-debian-bullseye-desktop-6.1-arm64-20250123.img.gz

将4G模组插入M.2接口（以ZTE CAT4 4G为例），插入SIM卡和烧好系统的TF卡，将网口与上级路由器相连，上电启动系统，系统会自动登录并进入桌面。

在终端中执行<code>lsusb</code>，结果如下：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_07.jpg" width=700></html>

红框处即为4G模组。

执行<code>ip addr</code>，查看网络参数如下：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_08.jpg" width=700></html>

eth0是M6的网口，连接上级路由器，获得了上级路由器的IP地址；

eth1是4G模组，已经正确获得了IP地址。

执行<code>ip route</code>，查看路由表，eth0排在第一位，因此此时是通过有线网络连接上级路由器上网：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_09.jpg" width=700></html>

在上图中，4G模组的网关地址为10.129.122.170。

如果要优先通过4G网络上网的话，可以运行命令：

<code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 10.129.122.170</code>

执行完毕后，再执行<code>ip route</code>，查看路由表，目前的默认路由为4G网络的网关（eth1排第一位）：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_10.jpg" width=700></html>

这样网络就默认走4G网络了。其余操作与在Ubuntu系统下类似，请参阅上一章相关章节。

此时我们ping IP和域名，均成功，说明4G模块工作正常：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_11.jpg" width=700></html>

打开<nowiki/>https://www.speedtest.cn/<nowiki/>进行网速测试，结果如下：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_12.jpg" width=700></html>

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

== '''五、4G的操作''' ==

=== 5.1 使用AT命令 ===
Ubuntu系统和Debian系统下，AT命令使用方法是一样的，这里以ZTE CAT4 4G模组在Ubuntu系统下的操作为例。

使用AT命令前，我们需要先打开串口，在树莓派终端中执行命令<code>lsusb</code>，如下图所示：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_01.jpg" width=700></html>

本模块的id为2cb7 0001，记录下这个值。

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

<code>sudo modprobe option</code>

<code>sudo sh -c 'echo 2cb7 0001 > /sys/bus/usb-serial/drivers/option1/new_id'</code>

执行上述两条命令之后执行：

<code>ls /dev/ttyUSB*</code>

此时应该能看到dev设备下有ttyUSB0-4五个设备：

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_13.jpg

安装串口软件minicom：

<code>sudo apt install minicom</code>

通过minicom打开AT命令串口：

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

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

第一次输入AT命令可能没有回显，此时如果输入命令<code>at</code>后回车，有返回OK，就说明工作正常。如果需要查看回显，请键入命令：<code>ate1</code>，然后回车，继续键入其它命令，回车可以看到结果。

用<code>AT+CPIN?</code>来检查SIM是否正常插入并识别；

用<code>AT+CSQ</code>来检查信号强度，第一个值是0-31，需要25以上才算信号质量良好；

用<code>AT+COPS?</code>来检查注网情况，双引号内是运营商代码，最后一个数字是网络模式，7代表4G。

http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_14.jpg

=== 5.2 常用的AT命令 ===
{{ATCOMM}}

=== 5.3 修改IP地址 ===
如果4G的IP地址和你的内网地址冲突，可以修改4G的IP地址（以ZTE CAT4 4G为例）。

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

设置IP为公网：<code>AT+GTIPPASS=1</code>

设置IP为内网：<code>AT+GTIPPASS=0</code>

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

修改IP完毕后需要断电重启才能生效。

=== 5.4 FAQ ===

==== 5.4.1 无法ping域名怎么办？ ====
问：执行ifconfig -a后，可以看到已经获得了IP地址，但是无法ping域名，怎么才能解决这个问题？

答：若ping IP地址成功，说明4G模组可以正常上网，ping域名失败（如下图），则是DNS服务器解析有问题。

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_15.jpg" width=700></html>

需要安装udhcpc；请将M6的网口接上级路由器（以Ubuntu系统和ZTE CAT4 4G为例）：

<code>sudo apt install udhcpc</code>

安装成功后请执行（<code>-i</code>后面的网络标识请执行<code>ifconfig -a</code>，然后查看相应的4G模组信息）：

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

后再ping：

<html><img src="http://www.mcuzone.com/wiki/4009_M6_4G/4009_M6_4G_16.jpg" width=700></html>

==== 5.4.2 每次启动系统都要运行一次udcpc怎么办？ ====
问：对于4G模块要通过修改DNS服务器联网的，安装并运行udcpc后可正常联网，但是每次系统重启都需要运行一次udcpc。如果想开机即可自动通过4G网络上网，怎么办？

答：需要在rc.local文件添加开机命令，可以参考如下步骤（以ZTE CAT4 4G为例，eth1是4G模组的网络标识，通过执行<code>ifconfig -a</code>可以看到，请以实际为准）：

开启rc-local服务：

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

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

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

在exit 0上面添加你要开机执行的命令，即：

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

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

然后保存文件，这样就可以开机即可实现自动通过4G模组上网。

== '''六、总结''' ==
此处仅介绍4G模块基于NanoPi M6的操作，不涉及到NanoPi M6开发板自身的操作及软件系统，关于NanoPi M6开发板资料，请前往友善官网查阅：

https://wiki.friendlyelec.com/wiki/index.php/NanoPi_M6/zh

{{联系我们_图标}}