RK3568平台下EM05 4G模块Kernel驱动移植与调试实战
1. RK3568平台EM05 4G模块驱动移植概述
在嵌入式设备开发中，4G模块的集成是物联网项目的关键环节。Rockchip RK3568作为一款高性能处理器，搭配移远通信的EM05 4G模块时，需要完成内核驱动的移植工作。这个过程中最核心的就是让Linux内核正确识别USB接口的4G模块，并生成对应的设备节点。
我最近在一个工业网关项目上实际调试过这个组合，发现EM05模块的驱动移植主要涉及三个关键点：设备树GPIO配置、USB VID/PID匹配、以及QMI协议支持。不同于简单的USB网卡，4G模块通常需要多个串口通道（AT命令、PPP拨号、诊断接口等），这对内核驱动的完整性提出了更高要求。
2. 设备树配置与硬件准备
2.1 设备树GPIO配置
在RK3568的DTS文件中，需要为4G模块添加电源管理节点。以下是一个典型的配置示例：
rk_modem: rk-modem { compatible = "4g-modem-platdata"; pinctrl-names = "default"; pinctrl-0 = <<e_power_en <e_reset>; 4G,power-gpio = <&gpio0 RK_PC6 GPIO_ACTIVE_HIGH>; 4G,reset-gpio = <&gpio1 RK_PD4 GPIO_ACTIVE_LOW>; status = "okay"; };这里有几个坑需要特别注意：
- GPIO极性：EM05的复位引脚是低电平有效，而电源使能通常是高电平有效
- 时序要求：上电时需要保证复位信号的持续时间（实测至少需要200ms的低电平）
- 电流供应：建议在电源路径上预留电流检测点，我们遇到过电源不稳导致模块反复重启的情况
2.2 硬件检查要点
在移植初期，建议先用USB转接板单独测试模块：
- 测量VBUS电压是否稳定在5V±5%
- 检查DP/DM线是否接反（这个错误很隐蔽）
- 用示波器确认reset信号波形符合时序要求
- 注意天线阻抗匹配，VSWR最好小于2:1
3. 内核驱动移植实战
3.1 配置内核选项
首先确保内核包含以下关键配置：
CONFIG_USB_SERIAL=y CONFIG_USB_SERIAL_OPTION=y CONFIG_USB_NET_QMI_WWAN=y CONFIG_USB_WDM=y这些配置可以通过make menuconfig在以下路径找到：
- Device Drivers → USB support → USB Serial Converter support
- Device Drivers → Network device support → USB Network Adapters
3.2 添加USB设备ID
EM05的VID(2C7C)和PID(0125)需要添加到drivers/usb/serial/option.c中：
static const struct usb_device_id option_ids[] = { { USB_DEVICE(QUECTEL_VENDOR_ID, QUECTEL_PRODUCT_EM05) }, // ... 其他设备 };如果使用的是较新的内核版本(5.10+)，可能还需要在qmi_wwan.c中添加对应的QMI配置：
static const struct driver_info qmi_wwan_info_quectel = { .flags = FLAG_WWAN | FLAG_SEND_ZLP, .manage_power = qmi_wwan_manage_power, };3.3 QMI协议支持
对于Android系统，需要特别处理QMI协议：
- 在option.c中修改probe函数：
static int option_probe(struct usb_serial *serial, const struct usb_device_id *id) { // 添加Quectel模块特殊处理 if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)) { if (serial->interface->cur_altsetting->desc.bInterfaceClass != 0xFF) { return -ENODEV; } } // ...原有代码 }- 添加reset_resume支持：
static struct usb_serial_driver option_1port_device = { .reset_resume = usb_wwan_resume, };4. 常见问题排查指南
4.1 节点未生成排查
如果/dev/ttyUSB*节点没有生成，按以下步骤检查：
- 执行
lsusb -v确认设备已被识别 - 检查dmesg日志是否有usb枚举错误
- 确认option驱动已正确加载（lsmod | grep option）
- 测试直接操作底层USB设备：
echo 2c7c 0125 > /sys/bus/usb-serial/drivers/option1/new_id4.2 供电异常处理
我们遇到过几种典型供电问题：
- 上电时序问题：在reset释放后延迟500ms再操作模块
- 电流不足：在电源路径上并联1000μF电容
- ESD损坏：添加TVS二极管保护电路
4.3 QMI网络连接失败
当wwan0接口已生成但无法上网时：
- 检查qmi_wwan驱动版本是否支持EM05
- 使用qmicli工具测试基础功能：
qmicli -d /dev/cdc-wdm0 --nas-get-signal-strength- 确认APN配置正确：
echo -e 'AT+CGDCONT=1,"IP","your.apn"\r' > /dev/ttyUSB25. Android系统适配要点
5.1 init进程修改
需要修改system/core/init/devices.cpp以正确创建设备节点：
// 在HandleUevent函数中添加 } else if (uevent.subsystem == "usbmisc" && !uevent.device_name.empty()) { devpath = "/dev/" + uevent.device_name;5.2 SELinux策略
新增以下策略文件：
# device/qcom/sepolicy/common/vendor/radio.te allow radio qmi_device:chr_file rw_file_perms; allow radio modem_proxy:fd use;5.3 RIL层配置
在vendor/rild/目录下添加quectel的ril库，并更新init.rc：
service ril-daemon /vendor/bin/rild -l /vendor/lib/libquectel-ril.so class main user root6. 性能优化建议
经过实测，在RK3568上我们可以通过以下调整提升4G性能：
- USB吞吐优化：
echo 4096 > /sys/class/net/wwan0/tx_queue_len- QMI缓存调整：
// 在qmi_wwan.c中增加rx_urb_size dev->rx_urb_size = 32 * 1024;- 中断亲和性设置：
echo 2 > /proc/irq/$(cat /proc/interrupts | grep dwc3 | awk '{print $1}' | cut -d: -f1)/smp_affinity- TCP参数优化：
echo 10 > /proc/sys/net/ipv4/tcp_fin_timeout echo 1 > /proc/sys/net/ipv4/tcp_tw_reuse在实际项目中，这些调整使得FTP下载速率从45Mbps提升到了58Mbps，效果显著。不过具体参数需要根据实际网络环境微调。
移植完成后，建议进行至少72小时的压力测试，重点关注模块的热稳定性和长时间传输的可靠性。我们曾遇到过连续工作12小时后模块假死的情况，最终通过调整电源管理策略解决了问题。