在Buildroot系统上，手把手教你给RK3566开发板配置移远EC20 4G模块（附完整内核配置与拨号流程）-编程实验室

RK3566开发板Buildroot系统集成移远EC20 4G模块全流程指南

当RK3566开发板遇上移远EC20 4G模块，如何在Buildroot系统中实现稳定可靠的蜂窝网络连接？本文将带你从内核配置到拨号测试，完整走通这个嵌入式开发中的经典场景。

1. 开发环境准备与硬件连接

在开始之前，确保你已准备好以下硬件和软件环境：

硬件清单：
- Rockchip RK3566开发板（至少2GB内存）
- 移远EC20 4G模块（建议使用EC20-EU或对应区域版本）
- 4G天线（主天线和分集天线各一）
- 12V/2A电源适配器
- USB转TTL调试串口板
软件基础：
- 已安装Buildroot的Linux主机（推荐Ubuntu 20.04 LTS）
- RK3566的Buildroot SDK（版本建议2022.02或更新）
- 串口终端工具（如minicom或picocom）

硬件连接时需特别注意：

将EC20模块正确插入开发板的Mini PCIe插槽
确保主天线连接在MAIN端口，分集天线连接DIV端口
使用USB转TTL连接开发板调试串口到主机

验证硬件连接是否正常：

# 在主机上查看串口设备 ls /dev/ttyUSB*

应该能看到至少三个USB转串口设备，分别对应EC20的AT命令端口、调试端口等。

2. 内核驱动配置与编译

Buildroot环境下内核配置有其特殊性，以下是关键步骤：

2.1 进入内核配置界面

cd buildroot/output/build/linux-custom make ARCH=arm64 menuconfig

2.2 必须开启的驱动选项

在菜单中依次配置以下关键选项：

USB支持层：

Device Drivers → USB support → USB Serial Converter support → [*] USB driver for GSM and CDMA modems

网络设备支持：

Device Drivers → Network device support → USB Network Adapters → [*] QMI WWAN driver for Qualcomm MSM based 3G and LTE modems

CDC Ethernet支持：

Device Drivers → Network device support → [*] USB Network Adapters → [*] CDC Ethernet support

提示：使用空格键切换选项状态，*表示编译进内核，M表示编译为模块

2.3 保存并应用配置

配置完成后：

# 保存配置 cp .config arch/arm64/configs/rockchip_linux_defconfig # 返回Buildroot目录重新编译 cd ../../../ make linux-rebuild

编译时间视主机性能而定，通常需要15-30分钟。编译完成后，新的内核镜像会自动集成到系统镜像中。

3. 系统烧写与模块检测

3.1 烧写新系统镜像

使用RKDevTool或upgrade_tool将生成的固件烧写到开发板：

# 示例使用upgrade_tool sudo upgrade_tool ul output/images/sysimage.img

3.2 验证EC20模块识别

系统启动后，通过串口登录开发板，执行以下检测命令：

检查USB设备枚举：

lsusb | grep 2c7c

正常应看到类似输出：

Bus 001 Device 003: ID 2c7c:0125 Quectel Wireless Solutions Co., Ltd. EC20 LTE modem

检查网络接口：

ifconfig -a

应该能看到wwan0或usb0网络接口。

检查内核消息：

dmesg | grep qmi

正常会看到QMI驱动初始化的相关日志。

如果以上检查都通过，说明内核驱动已正确加载。

4. 网络拨号与连接测试

移远模块支持多种拨号方式，这里介绍最常用的QMI模式。

4.1 准备quectel-CM工具

由于Buildroot默认不包含此工具，需要手动交叉编译：

下载源码：

wget https://github.com/Quectel/quectel-CM/archive/refs/tags/V1.6.4.tar.gz tar -zxvf V1.6.4.tar.gz

配置交叉编译环境：

export PATH=$PATH:buildroot/output/host/bin export CROSS_COMPILE=aarch64-linux-

编译：

cd quectel-CM-1.6.4 make

编译成功后会在当前目录生成quectel-CM可执行文件。

4.2 配置APN信息

创建配置文件/etc/quectel.conf：

APN=your.apn.name USERNAME=your_username PASSWORD=your_password

常见运营商APN参考：

运营商	APN名称	用户名	密码
中国移动	cmnet	(空)	(空)
中国联通	3gnet	(空)	(空)
中国电信	ctnet	(空)	(空)

4.3 启动拨号连接

将quectel-CM复制到开发板，并执行：

./quectel-CM -s your.apn.name &

成功连接后，可以通过以下命令验证：

检查网络接口：

ifconfig wwan0

测试网络连通性：

ping -I wwan0 8.8.8.8

配置DNS（如需域名解析）：

echo "nameserver 8.8.8.8" > /etc/resolv.conf

5. 常见问题排查

在实际部署中可能会遇到以下典型问题：

5.1 模块无法识别

现象：lsusb看不到2c7c:0125设备

排查步骤：

检查硬件连接是否牢固
测量模块供电电压（应≥3.7V）
尝试更换USB接口
检查内核是否启用了必要的USB驱动

5.2 拨号失败

现象：quectel-CM报错或无法获取IP

解决方案：

确认APN配置正确
检查SIM卡是否欠费
尝试手动发送AT命令测试：

echo -e "AT+CPIN?\r\n" > /dev/ttyUSB2

5.3 网络不稳定

优化建议：

调整天线位置，确保信号强度：

cat /sys/class/net/wwan0/operstate

修改QMI超时参数：

echo 30 > /sys/module/qmi_wwan/parameters/wwan_tx_timeout

启用链路保持功能：

echo 1 > /proc/sys/net/ipv4/tcp_keepalive_time

6. 进阶配置与优化

对于需要长期稳定运行的产品级部署，还需考虑以下方面：

6.1 自动重连机制

创建systemd服务单元/etc/systemd/system/quectel-cm.service：

[Unit] Description=Quectel CM Connection Manager After=network.target [Service] ExecStart=/usr/bin/quectel-CM -s your.apn.name Restart=always RestartSec=10s [Install] WantedBy=multi-user.target

启用服务：

systemctl enable quectel-cm systemctl start quectel-cm

6.2 信号质量监控

通过AT命令获取信号强度：

echo -e "AT+CSQ\r\n" > /dev/ttyUSB2

典型响应格式：

+CSQ: 24,99

第一个值表示信号强度（0-31，越大越好），第二个表示信道误码率（99表示未知）。

6.3 功耗优化配置

对于电池供电设备，可以启用EC20的节能模式：

echo -e "AT+QSCLK=1\r\n" > /dev/ttyUSB2

同时调整Linux网络参数：

iwconfig wwan0 power on

7. 实际部署建议

在完成实验室验证后，产品化部署还需注意：

天线选择：根据频段需求选择合适的天线，4G全频段天线通常是最佳选择
ESD防护：在模块天线接口处添加TVS二极管
SIM卡座：选用带自弹机制的工业级SIM卡座
固件升级：定期检查移远官网获取EC20模块固件更新
温度监控：在高温环境下需确保模块散热良好

通过串口获取模块温度：

echo -e "AT+QTEMP\r\n" > /dev/ttyUSB2

典型响应：

+QTEMP: "xa0",27,34,36

分别表示：模块温度、PA温度和环境温度（单位：℃）。

在RK3566开发板上成功集成EC20 4G模块后，你可以进一步探索：

多网络链路聚合（4G+以太网）
基于网络质量的自动切换
远程OTA升级方案
数据用量监控与管理

在Buildroot系统上，手把手教你给RK3566开发板配置移远EC20 4G模块（附完整内核配置与拨号流程）