企业官网建设流程全解析

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 vendor=0x2c7c product=0x0125（0x2c7c是移远的VID，0x0125是EC20的PID，具体值请以lsusb输出为准）。

注意：不同版本的EC20模块（比如EC20-CE、EC20-E）的USB PID可能不同，lsusb看到的才是准确的。驱动加载后，再用dmesg | tail查看内核日志，能看到系统识别并创建ttyUSB节点的过程，这是最直接的诊断方法。

3. 网络拨号脚本配置与解析

驱动识别成功，相当于给4G模块接上了“神经”。接下来就是要让它“说话”联网。万象奥科提供的系统里，在/home/4g目录下已经准备好了一套拨号脚本和配置文件，这省去了我们从零开始写脚本的麻烦。这个目录里通常会有ppp、chat脚本以及运营商配置文件。

核心的拨号动作是通过pppd（Point-to-Point Protocol daemon）这个程序来完成的，它利用chat脚本与模块进行AT命令交互，最终在ttyUSB0上建立一个PPP网络接口（通常是ppp0）。

拨号前，最关键的一步是配置APN（Access 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 AT+CGDCONT=1,"IP","3gnet"

这里的"3gnet"就是默认的APN。我需要把它改成我的联通卡对应的APN。经过查询和测试，这张卡的APN是"unim2m.njm2mapn"。所以修改为：

OK AT+CGDCONT=1,"IP","unim2m.njm2mapn"

实操心得：APN不对是拨号失败最常见的原因之一。移动的卡常用“cmnet”，电信是“ctnet”，联通传统是“3gnet”，但物联网卡五花八门，一定要向你的SIM卡供应商确认准确的APN。还有一个方法，可以把SIM卡插到手机上，在手机的网络设置里查看当前使用的APN。

除了APN，chat脚本里还可能包含其他AT命令，比如关闭回显（ATE0）、查询信号（AT+CSQ）、设置全功能模式（AT+CFUN=1）等。一般不建议新手随意改动其他命令，除非你非常清楚每条命令的作用。

配置好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: flags=4305<UP,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值决定，值越小优先级越高。

我们需要做两件事：

1. 删除旧的默认路由：sudo route del default gw 192.168.1.1
2. 添加通过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_seq=1 ttl=50 time=65.4 ms 64 bytes from 39.156.66.10: icmp_seq=2 ttl=50 time=63.8 ms 64 bytes from 39.156.66.10: icmp_seq=3 ttl=50 time=62.9 ms 64 bytes from 39.156.66.10: icmp_seq=4 ttl=50 time=64.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进行更专业的上下行带宽测试。

测试过程中，难免会遇到问题。下面是我总结的一些常见故障和排查思路，做成了一个速查表：

独家避坑技巧：

• 日志是你的最好朋友：出问题时，第一时间看dmesg内核日志和pppd的debug日志（sudo pppd call 4g-ppp debug）。日志里会清晰记录AT命令交互过程、运营商返回的错误码（如+CME ERROR: 3代表SIM卡失败）。
• 手动AT命令调试：在拨号前，可以用minicom或picocom工具连接到/dev/ttyUSB1，手动发送AT命令测试模块基本功能，如AT（返回OK）、AT+CPIN?（查询SIM卡状态）、AT+CSQ（查询信号）、AT+COPS?（查询注册网络）。这能帮你快速定位是模块问题、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接口出现 COUNT=0 while [ $COUNT -lt 30 ]; do if ifconfig ppp0 >/dev/null 2>&1; 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=$((COUNT+1)) done echo "Failed to bring up ppp0 interface." exit 1

然后创建Systemd服务单元文件/etc/systemd/system/4g-connect.service：

[Unit] Description=4G Network Connection Service After=network.target syslog.target Wants=network.target [Service] Type=forking ExecStart=/usr/local/bin/4g-connect.sh Restart=on-failure RestartSec=10 StandardOutput=journal [Install] WantedBy=multi-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网络。Restart=on-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 noauth

• persist: 连接断开后自动重拨。
• 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_HOST="8.8.8.8" LOG_FILE="/var/log/4g-monitor.log" if ! ping -c 2 -W 5 $PING_HOST > /dev/null 2>&1; 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.sh

3. 信号强度与天线优化：4G模块的性能极度依赖信号。EC20模块通常有主集和分集两个天线接口。务必接上两根合格的天线。天线应尽量放置在金属外壳外部，远离其他高频电路和金属物体。通过AT命令AT+CSQ定期记录信号强度（RSSI），值在10-31之间较好，低于10则可能经常断线。对于固定安装的设备，可以考虑使用外置的棒状天线或吸盘天线，并通过馈线引到信号更好的位置。

4. 功耗与散热考量：RK3568和4G模块在全速运行时都会发热。在密闭的工业机箱内，散热不良会导致芯片降频甚至重启。确保设备有良好的通风，或者为RK3568核心板和4G模块加上散热片。如果设备是电池供电，则需要通过软件策略优化功耗，例如在不传输数据时，通过AT命令AT+QCFG="usbnet"或AT+QCFG="nwscanseq"等让模块进入低功耗模式。

通过以上这一套组合拳——从硬件连接、驱动确认、脚本配置、路由设置，到系统服务集成和最终的稳定性调优——我们就在RK3568平台上构建了一个可靠、可商用的4G联网解决方案。这套流程不仅适用于移远EC20，其思路和方法也基本适用于其他通过USB接口连接的4G/5G模组（如移远EC200T、广和通L610等），只是在具体的VID/PID、AT命令和驱动名称上略有差异。