1. 项目概述与硬件选型最近在做一个工业边缘数据采集的项目需要设备在户外或工厂车间等复杂环境下稳定联网回传数据。Wi-Fi覆盖不稳定拉网线又不现实所以4G联网成了刚需。手头正好有万象奥科的HD-RK3568-IOT评估套件核心板是他们的HD-RK3568-CORE处理器是瑞芯微的RK3568。这块板子接口丰富双网口、双CAN、多串口一看就是为工业场景设计的。为了测试其4G联网能力我搭配了移远的EC20 4G模块。整个过程从硬件插卡、驱动识别到PPP拨号、路由配置再到最终的网络测试踩了一些坑也总结了不少经验。如果你也在RK3568平台上折腾4G模块特别是移远EC20系列这篇从实战中来的记录或许能帮你省下不少时间。RK3568这颗芯片确实是个多面手四核A55主频拉到2.0GHz干点复杂的边缘计算绰绰有余。自带的1TOPS NPU对于我们要做的简单图像识别或异常检测预处理也很有帮助。最关键的是它的扩展性和稳定性官方支持Linux主线内核驱动生态比较完善这对于后期开发和维护至关重要。选择万象奥科的核心板一方面是看中其工业级设计和丰富的接口直接引出9路串口和3路CAN太适合工控了另一方面是他们提供的底板把大部分接口都做成了标准连接器调试起来非常方便。4G模块选型上移远EC20是经过大量项目验证的经典款全网通支持国内三大运营商的4G网络AT命令集成熟资料也多。更重要的是它在Linux下的驱动支持很好通常会被识别为多个ttyUSB设备分别用于AT命令、PPP拨号和GPS如果模块支持。这种架构清晰出了问题也好排查。2. 硬件连接与驱动识别万事开头难硬件连接是第一步也是最容易出错的一步。我的配置是万象奥科HD-RK3568-IOT底板上面已经预留了Mini PCIe接口用来接4G模块。EC20模块是Mini PCIe封装的直接插到底板的插槽里就行。注意一定要对准金手指和卡槽的缺口轻轻推入听到“咔哒”一声表示锁扣扣紧这才算安装到位。千万不要带电操作务必在设备完全断电的情况下进行插拔否则瞬间的电流冲击很可能损坏模块或核心板的PCIe控制器。接下来是SIM卡。我用的是一张普通的中国联通4G物联网卡。卡槽一般在模块的侧面或顶部用指甲轻轻抠开卡托将SIM卡按照卡托上指示的方向放入通常是芯片面朝下然后推回卡槽。这里也有个细节有些卡托设计比较紧推回去的时候要用点力确保完全闭合否则会导致接触不良后面拨号会一直失败。硬件连接好后就可以上电启动了。系统我刷的是万象奥科提供的基于Buildroot构建的Linux系统内核版本是5.10的对RK3568和EC20的支持都比较完善。开机进入系统后第一件事就是检查驱动是否正常加载。打开终端输入命令ls /dev/ttyUSB*。如果一切正常你应该能看到类似下面的输出/dev/ttyUSB0 /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3对于移远EC20模块系统通常会为其创建4个ttyUSB设备节点。这几个节点分工明确ttyUSB0 通常用于PPP拨号。这是建立网络连接的关键通道。ttyUSB1 用于发送AT命令查询模块状态、信号强度、网络注册情况等。ttyUSB2 另一个AT命令端口有时也用于传输调试信息。ttyUSB3 如果模块支持GPS功能这个端口会用于NMEA数据的输出。如果你只看到一两个或者一个都没看到那就要排查了。首先用lsusb命令查看USB设备列表找找有没有“Quectel”字样的设备。如果没有可能是模块没插好、供电不足特别是如果用了USB转接板或者内核驱动没编译进去。RK3568的官方内核默认应该包含了qmi_wwan、option等驱动用于支持这类USB接口的4G模块。如果lsusb能看到设备但ttyUSB没出来可以尝试手动加载驱动sudo modprobe usbserial vendor0x2c7c product0x01250x2c7c是移远的VID0x0125是EC20的PID具体值请以lsusb输出为准。注意不同版本的EC20模块比如EC20-CE、EC20-E的USB PID可能不同lsusb看到的才是准确的。驱动加载后再用dmesg | tail查看内核日志能看到系统识别并创建ttyUSB节点的过程这是最直接的诊断方法。3. 网络拨号脚本配置与解析驱动识别成功相当于给4G模块接上了“神经”。接下来就是要让它“说话”联网。万象奥科提供的系统里在/home/4g目录下已经准备好了一套拨号脚本和配置文件这省去了我们从零开始写脚本的麻烦。这个目录里通常会有ppp、chat脚本以及运营商配置文件。核心的拨号动作是通过pppdPoint-to-Point Protocol daemon这个程序来完成的它利用chat脚本与模块进行AT命令交互最终在ttyUSB0上建立一个PPP网络接口通常是ppp0。拨号前最关键的一步是配置APNAccess Point Name接入点名称。APN相当于4G网络接入互联网的“门户”不同运营商、甚至不同物联网卡套餐的APN都可能不同。配置文件一般是/home/4g/peers/目录下的某个文件或者像原文提到的cmnet_chat脚本。我们需要修改这个文件中的APN设置。以我的中国联通物联网卡为例我需要修改/home/4g/peers/4g-ppp文件具体文件名可能因系统镜像而异。找到类似下面这行connect /usr/sbin/chat -s -v -f /home/4g/chat/connect.chat然后去查看/home/4g/chat/connect.chat文件。在这个chat脚本里会有发送AT命令设置APN的语句。找到下面这行OK ATCGDCONT1,IP,3gnet这里的3gnet就是默认的APN。我需要把它改成我的联通卡对应的APN。经过查询和测试这张卡的APN是unim2m.njm2mapn。所以修改为OK ATCGDCONT1,IP,unim2m.njm2mapn实操心得APN不对是拨号失败最常见的原因之一。移动的卡常用“cmnet”电信是“ctnet”联通传统是“3gnet”但物联网卡五花八门一定要向你的SIM卡供应商确认准确的APN。还有一个方法可以把SIM卡插到手机上在手机的网络设置里查看当前使用的APN。除了APNchat脚本里还可能包含其他AT命令比如关闭回显ATE0、查询信号ATCSQ、设置全功能模式ATCFUN1等。一般不建议新手随意改动其他命令除非你非常清楚每条命令的作用。配置好APN后就可以尝试拨号了。通常有一个封装好的shell脚本比如/home/4g/4g.sh。它的内容本质上是调用pppd命令#!/bin/bash pppd call 4g-ppp 4g-ppp就是刚才我们修改的peer配置文件。执行这个脚本sudo /home/4g/4g.sh或者直接运行sudo pppd call 4g-ppp执行后如果没有报错并很快返回命令行通常意味着拨号进程已经在后台启动了。这时候不要急着测网络先等几秒钟。4. 网络接口与路由配置实战拨号脚本执行后我们如何确认网络是否真的通了呢首先使用ifconfig命令查看网络接口。如果拨号成功你会看到除了eth0有线网卡、lo回环之外多了一个ppp0接口。$ ifconfig ppp0 ppp0: flags4305UP,POINTOPOINT,RUNNING,NOARP,MULTICAST mtu 1500 inet 10.90.159.227 netmask 255.255.255.255 destination 10.64.64.64 ppp txqueuelen 3 (Point-to-Point Protocol) RX packets 12 bytes 1243 (1.2 KiB) TX packets 13 bytes 961 (961.0 B)这里可以看到ppp0接口成功获取到了运营商分配的IP地址10.90.159.227。这是一个典型的运营商内网地址。destination 10.64.64.64是对端运营商网关的地址。MTU是1500这是标准以太网帧大小。但是有IP地址并不代表流量就会走这个接口。Linux系统里数据包根据路由表来决定从哪个网卡出去。查看路由表使用ip route或route -n命令。$ route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 192.168.1.1 0.0.0.0 UG 0 0 0 eth0 10.64.64.64 0.0.0.0 255.255.255.255 UH 0 0 0 ppp0 192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0在这个例子中系统存在多个网络接口eth0和ppp0。路由表的第一条是默认路由Destination为0.0.0.0它将所有不知道往哪发的数据包都导向192.168.1.1这个网关并通过eth0网卡发出。这意味着即使ppp0拨号成功了你的网络流量默认还是会走有线网络。为了让系统优先使用4G网络我们需要将ppp0接口的路由设置为默认路由并且其优先级要高于eth0的路由。在Linux中路由的优先级由Metric值决定值越小优先级越高。我们需要做两件事删除旧的默认路由sudo route del default gw 192.168.1.1添加通过ppp0的新默认路由sudo route add default dev ppp0执行后再查看路由表$ route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 0.0.0.0 0.0.0.0 U 0 0 0 ppp0 10.64.64.64 0.0.0.0 255.255.255.255 UH 0 0 0 ppp0 192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0现在默认路由的Iface变成了ppp0并且Gateway是0.0.0.0因为是点对点协议对端地址已知。这样所有的外部网络请求比如访问百度就会通过4G网络发出了。重要注意事项这种手动修改路由的方式在本次拨号期间有效。如果ppp0连接断开重连或者系统重启路由又会恢复原样。因此在生产环境中我们需要将路由配置脚本化并集成到拨号流程中。一个常见的做法是在/etc/ppp/ip-up.d/目录下创建一个脚本pppd在成功建立连接后会自动执行该目录下的所有脚本我们可以在这里面添加设置默认路由的命令。反之在/etc/ppp/ip-down.d/目录下的脚本会在连接断开时执行用于恢复路由。5. 网络连通性测试与问题深究路由配置好后就到了最激动人心的测试环节。最直接的测试就是ping一个公网域名。$ ping -c 4 baidu.com PING baidu.com (39.156.66.10) 56(84) bytes of data. 64 bytes from 39.156.66.10: icmp_seq1 ttl50 time65.4 ms 64 bytes from 39.156.66.10: icmp_seq2 ttl50 time63.8 ms 64 bytes from 39.156.66.10: icmp_seq3 ttl50 time62.9 ms 64 bytes from 39.156.66.10: icmp_seq4 ttl50 time64.1 ms --- baidu.com ping statistics --- 4 packets transmitted, 4 received, 0% packet loss, time 3005ms rtt min/avg/max/mdev 62.925/64.050/65.449/0.957 ms能ping通且延迟稳定在60-70ms说明4G网络连接完全正常数据包已经可以通过ppp0接口到达互联网并返回。我们还可以测试一下带宽和稳定性。用curl下载一个小文件看看速度$ curl -o /dev/null http://speedtest-sgp1.digitalocean.com/100mb.test % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 100M 100 100M 0 0 2.34M 0 0:00:42 0:00:42 --:--:-- 2.37M平均下载速度约2.34MB/s约18.7Mbps这符合4G网络在一般信号强度下的表现。当然你也可以用iperf3进行更专业的上下行带宽测试。测试过程中难免会遇到问题。下面是我总结的一些常见故障和排查思路做成了一个速查表问题现象可能原因排查步骤ls /dev/ttyUSB*无设备1. 模块未正确安装或供电不足2. 内核驱动缺失3. 模块硬件故障1. 断电重新插拔模块检查底板供电跳线。2. 执行lsusb查看是否有Quectel设备。执行dmesg | grep usb或dmesg | tail查看内核识别日志。3. 尝试更换模块或插槽。有ttyUSB设备但拨号失败无ppp01. APN配置错误2. SIM卡未激活、欠费或锁卡3. 信号强度太弱4.chat脚本语法错误或超时1.反复确认APN可尝试手机插卡查看。2. 将SIM卡插入手机看能否正常上网。3. 通过echo -e ATCSQ\r\n /dev/ttyUSB1查询信号强度CSQ: 31,99第一个值0-31越大越好99表示未知。4. 手动执行pppd命令并加debug参数sudo pppd call 4g-ppp debug观察交互日志看AT命令在哪一步卡住。有ppp0接口但ping不通外网1. 默认路由未指向ppp02. 运营商网络问题如未开通数据业务3. 防火墙iptables规则阻拦1. 执行route -n确认默认路由0.0.0.0的Iface是ppp0。2.ping一下对端网关地址如10.64.64.64如果能通说明PPP链路正常问题在运营商侧。3. 临时关闭防火墙测试sudo iptables -F生产环境慎用。连接间歇性断开1. 信号不稳定2. 模块发热或供电波动3.pppd配置的LCP链路控制协议回声请求超时1. 改善天线放置位置使用外置天线。2. 检查底板电源设计确保供电电流充足4G模块发射时峰值电流可能超过2A。3. 在ppp配置文件中添加lcp-echo-interval 30和lcp-echo-failure 4参数让pppd主动保活。独家避坑技巧日志是你的最好朋友出问题时第一时间看dmesg内核日志和pppd的debug日志sudo pppd call 4g-ppp debug。日志里会清晰记录AT命令交互过程、运营商返回的错误码如CME ERROR: 3代表SIM卡失败。手动AT命令调试在拨号前可以用minicom或picocom工具连接到/dev/ttyUSB1手动发送AT命令测试模块基本功能如AT返回OK、ATCPIN?查询SIM卡状态、ATCSQ查询信号、ATCOPS?查询注册网络。这能帮你快速定位是模块问题、SIM卡问题还是网络问题。供电是稳定性的基石工业现场环境复杂RK3568核心板加上4G模块全速运行时功耗不低。务必确保你的电源适配器能提供稳定、足额的电流建议12V/2A以上。电压跌落可能导致核心板或4G模块重启。在底板上靠近4G模块的电源引脚处并联几个大容量的钽电容和陶瓷电容可以有效平滑电流波动。6. 集成到系统服务与开机自启手动测试成功只是第一步我们的目标是让设备上电后就能自动连接4G网络。这就需要将拨号过程配置成一个系统服务。在基于Systemd的系统如Debian、Ubuntu或高版本Buildroot中我们可以创建一个service文件。假设我们的拨号脚本路径是/usr/local/bin/4g-connect.sh其内容应该是健壮的包含错误处理和路由配置#!/bin/bash # /usr/local/bin/4g-connect.sh # 等待USB设备稳定 sleep 5 # 检查ttyUSB设备是否存在 if [ ! -c /dev/ttyUSB0 ]; then echo 4G module ttyUSB0 not found! exit 1 fi # 杀死可能存在的旧pppd进程 killall pppd 2/dev/null sleep 2 # 启动pppd拨号 pppd call 4g-ppp persist # 等待ppp0接口出现 COUNT0 while [ $COUNT -lt 30 ]; do if ifconfig ppp0 /dev/null 21; then echo ppp0 interface is up. # 删除原有默认路由谨慎操作确保只有这一个默认路由来源 ip route del default 2/dev/null # 添加通过ppp0的默认路由 ip route add default dev ppp0 echo Default route set to ppp0. exit 0 fi sleep 1 COUNT$((COUNT1)) done echo Failed to bring up ppp0 interface. exit 1然后创建Systemd服务单元文件/etc/systemd/system/4g-connect.service[Unit] Description4G Network Connection Service Afternetwork.target syslog.target Wantsnetwork.target [Service] Typeforking ExecStart/usr/local/bin/4g-connect.sh Restarton-failure RestartSec10 StandardOutputjournal [Install] WantedBymulti-user.target保存后执行以下命令启用并启动服务sudo chmod x /usr/local/bin/4g-connect.sh sudo systemctl daemon-reload sudo systemctl enable 4g-connect.service sudo systemctl start 4g-connect.service sudo systemctl status 4g-connect.service # 查看状态这样设备每次启动都会自动尝试连接4G网络。Restarton-failure确保了在连接意外断开时服务会自动重启拨号脚本。注意在设置开机自动删除旧默认路由并添加新路由时需要非常小心。如果你的设备同时需要通过有线网络eth0访问局域网内的其他设备如本地服务器盲目删除所有默认路由可能会中断这条路径。更复杂的场景可能需要使用策略路由ip rule根据目的IP地址或端口来决定走eth0还是ppp0。7. 性能调优与稳定性保障基础功能跑通后就要考虑如何在真实工业环境中长期稳定运行了。4G网络本身具有波动性PPP连接也比有线网络更“脆弱”一些。1. PPP链路保活在/etc/ppp/peers/4g-ppp配置文件中可以添加以下参数来增强链路的稳定性persist maxfail 0 holdoff 10 lcp-echo-interval 30 lcp-echo-failure 4 noauthpersist: 连接断开后自动重拨。maxfail 0: 无限次尝试重拨。holdoff 10: 重拨前等待10秒。lcp-echo-interval 30和lcp-echo-failure 4: 每30秒发送一个LCP回声请求如果连续4次即120秒没有收到回应则认为链路失效触发重连。这是防止“死连接”的关键。2. 网络监控与自动恢复即使有PPP保活有时也可能遇到模块假死、网络无响应但PPP链路还显示up的情况。我们可以写一个简单的监控脚本定时检测外网连通性如果失败则重启4G服务。#!/bin/bash # /usr/local/bin/4g-monitor.sh PING_HOST8.8.8.8 LOG_FILE/var/log/4g-monitor.log if ! ping -c 2 -W 5 $PING_HOST /dev/null 21; then echo $(date): Network is DOWN. Restarting 4g service... $LOG_FILE systemctl restart 4g-connect.service else echo $(date): Network is OK. $LOG_FILE fi然后用crontab设置每5分钟运行一次*/5 * * * * /usr/local/bin/4g-monitor.sh3. 信号强度与天线优化4G模块的性能极度依赖信号。EC20模块通常有主集和分集两个天线接口。务必接上两根合格的天线。天线应尽量放置在金属外壳外部远离其他高频电路和金属物体。通过AT命令ATCSQ定期记录信号强度RSSI值在10-31之间较好低于10则可能经常断线。对于固定安装的设备可以考虑使用外置的棒状天线或吸盘天线并通过馈线引到信号更好的位置。4. 功耗与散热考量RK3568和4G模块在全速运行时都会发热。在密闭的工业机箱内散热不良会导致芯片降频甚至重启。确保设备有良好的通风或者为RK3568核心板和4G模块加上散热片。如果设备是电池供电则需要通过软件策略优化功耗例如在不传输数据时通过AT命令ATQCFGusbnet或ATQCFGnwscanseq等让模块进入低功耗模式。通过以上这一套组合拳——从硬件连接、驱动确认、脚本配置、路由设置到系统服务集成和最终的稳定性调优——我们就在RK3568平台上构建了一个可靠、可商用的4G联网解决方案。这套流程不仅适用于移远EC20其思路和方法也基本适用于其他通过USB接口连接的4G/5G模组如移远EC200T、广和通L610等只是在具体的VID/PID、AT命令和驱动名称上略有差异。