RK3568上EM05 4G模块驱动调试全记录（附避坑指南）

RK3568平台4G模块驱动深度调试：从内核到应用的完整实战指南

在嵌入式物联网项目中，为设备添加蜂窝网络连接能力已经成为许多场景的标配需求。最近我在一个基于Rockchip RK3568平台的项目中，需要集成移远通信的EM05 4G模块。这个模块支持LTE Cat4，理论下行速率可达150Mbps，对于需要远程数据传输的工业设备、智能网关等应用来说是个不错的选择。

但实际集成过程并不像数据手册描述的那么简单。从内核驱动配置到上层应用适配，每一步都可能遇到意想不到的坑。我花了将近两周时间才让整个系统稳定运行，期间经历了供电异常、节点不生成、网络连接不稳定等一系列问题。这篇文章就是这次调试经历的完整记录，希望能为正在或即将进行类似工作的开发者提供一些实用的参考。

1. 硬件准备与基础环境搭建

1.1 硬件连接与电源管理

EM05模块采用Mini PCIe接口，但实际通信接口是USB 2.0。在RK3568开发板上，我们需要通过USB HOST接口连接模块。硬件连接看似简单，但有几个关键点需要特别注意：

电源设计要点：

EM05模块的峰值电流可能达到2A，特别是启动瞬间和网络搜索时。如果供电不足，模块可能无法正常启动，或者运行不稳定。我在项目中使用的电源配置如下：

注意：很多开发板自带的3.3V电源轨电流能力有限，如果直接使用可能导致电压跌落。建议使用独立的DC-DC转换器为4G模块供电。

关键控制信号：

除了电源，EM05还有几个重要的控制引脚：

• PWRKEY：模块开关机控制，低电平有效，需要保持至少1.5秒
• RESET：硬件复位引脚，低电平有效
• WAKEUP_IN：唤醒主机信号
• STATUS：模块状态指示

在设备树中，这些引脚的配置需要特别注意电平有效性和上下拉设置。错误的配置可能导致模块无法启动或异常复位。

1.2 开发环境准备

我使用的开发环境基于Android 11 SDK，但大部分内容同样适用于Linux系统。以下是环境配置的关键步骤：

# 1. 获取RK3568 SDK
repo init -u https://github.com/rockchip-linux/manifests -b master
repo sync -j8

# 2. 配置编译环境
source build/envsetup.sh
lunch rk3568-userdebug

# 3. 检查内核配置
cd kernel/
make ARCH=arm64 rockchip_defconfig

必要的工具链配置：

# 在SDK的device/rockchip/rk3568/BoardConfig.mk中确认
TARGET_KERNEL_CONFIG := rockchip_defconfig
TARGET_KERNEL_ARCH := arm64
TARGET_KERNEL_CROSS_COMPILE_PREFIX := aarch64-linux-gnu-

USB调试工具准备：

在调试过程中，以下工具非常有用：

# 安装必要的USB调试工具
sudo apt-get install usbutils libusb-1.0-0-dev

# 常用调试命令
lsusb -v  # 查看USB设备详细信息
dmesg | grep usb  # 查看USB相关内核日志
cat /proc/tty/driver/usbserial  # 查看USB串口设备状态

2. 内核驱动配置与修改

2.1 设备树配置详解

设备树配置是驱动调试的第一步，也是最容易出错的地方。对于EM05模块，我们需要在设备树中正确配置电源管理和USB接口。

基础设备树节点配置：

&usb_host0_ehci {
    status = "okay";
};

&usb_host0_ohci {
    status = "okay";
};

&usbhost_dwc3 {
    dr_mode = "host";
    status = "okay";
    
    /* 4G模块设备节点 */
    quectel_em05: quectel-em05 {
        compatible = "quectel,em05";
        status = "okay";
        
        /* 电源使能引脚 */
        pwr-en-gpio = <&gpio0 RK_PC6 GPIO_ACTIVE_HIGH>;
        
        /* 复位引脚配置 */
        reset-gpio = <&gpio1 RK_PD4 GPIO_ACTIVE_LOW>;
        
        /* 状态指示引脚 */
        status-gpio = <&gpio2 RK_PA3 GPIO_ACTIVE_HIGH>;
        
        /* 唤醒引脚配置 */
        wakeup-gpio = <&gpio2 RK_PA4 GPIO_ACTIVE_HIGH>;
        
        /* 电源稳定延时（毫秒） */
        power-on-delay-ms = <100>;
        reset-duration-ms = <10>;
        
        /* USB端口配置 */
        usb-port = <0>;
    };
};

电源时序控制：

正确的电源上电时序对模块稳定工作至关重要。我在驱动中添加了专门的电源管理函数：

static int em05_power_on(struct quectel_em05 *em05)
{
    int ret;
    
    /* 1. 使能电源 */
    gpiod_set_value(em05->pwr_en_gpio, 1);
    msleep(50);  // 等待电源稳定
    
    /* 2. 释放复位（如果之前处于复位状态） */