Jetson Orin Nano上EC20 4G模组驱动移植实战指南

在嵌入式物联网项目中，4G通信模组的稳定接入往往是实现设备远程管理的关键环节。Jetson Orin Nano作为NVIDIA面向边缘计算推出的高性能开发平台，与移远EC20 4G模组的组合，能够为智能摄像头、移动机器人等场景提供可靠的无线连接方案。本文将完整呈现从内核配置到网络调试的全流程实战经验，特别针对Orin Nano的ARM64架构和Linux 5.15内核特性进行适配优化。

1. 开发环境准备与内核配置

1.1 硬件连接与基础检查

在开始驱动移植前，需要确认硬件连接状态：

• 使用USB转接板连接EC20模组与Orin Nano的USB3.0接口
• 通过lsusb命令验证设备识别：

  bash复制$ lsusb | grep 2C7C
  Bus 001 Device 003: ID 2c7c:0125 Quectel Wireless Solutions Co., Ltd. EC20 LTE modem
  

• 检查内核日志确认USB枚举情况：

  bash复制$ dmesg | grep usb
  [  125.671234] usb 1-2: new high-speed USB device number 3 using xhci_hcd
  

1.2 内核配置调整

Orin Nano的默认内核配置需要针对EC20进行以下修改：

关键配置项：

makefile复制# USB串口支持
CONFIG_USB_SERIAL=y
CONFIG_USB_SERIAL_WWAN=y
CONFIG_USB_SERIAL_OPTION=y

# USB网络驱动
CONFIG_USB_NET_DRIVERS=y
CONFIG_USB_USBNET=y
CONFIG_USB_NET_QMI_WWAN=y
CONFIG_USB_WDM=y

配置方法：

1. 进入内核源码目录：

   bash复制cd /usr/src/linux-headers-$(uname -r)
   

2. 使用menuconfig界面调整：

   bash复制make menuconfig
   

   依次进入：
   • Device Drivers → USB support → USB Serial Converter support
   • Device Drivers → Network device support → USB Network Adapters

提示：Orin Nano的默认配置文件位于arch/arm64/configs/defconfig，直接修改该文件可永久保存配置

2. 内核驱动源码级适配

2.1 USB转串口驱动修改

EC20模组通过USB接口暴露多个串口设备，需要修改drivers/usb/serial/option.c文件：

1. 添加设备标识符：

   c复制static const struct usb_device_id option_ids[] = {
       { USB_DEVICE(0x2C7C, 0x0125) },  // EC20标准模式
       { USB_DEVICE(0x2C7C, 0x0126) },  // EC20调试模式
       { } /* Terminating entry */
   };
   

2. 实现零包机制：
   在drivers/usb/serial/usb_wwan.c中添加特殊处理：

   c复制#ifdef CONFIG_QUECTEL_EC20
   if (dir == USB_DIR_OUT && 
       le16_to_cpu(serial->dev->descriptor.idVendor) == 0x2C7C) {
       urb->transfer_flags |= URB_ZERO_PACKET;
   }
   #endif
   

3. 休眠唤醒支持：
   更新option_1port_device结构体：

   c复制static struct usb_serial_driver option_1port_device = {
       .reset_resume = usb_wwan_resume,
   };
   

2.2 QMI_WWAN驱动集成

移远提供的定制版QMI驱动需要以下集成步骤：

1. 将qmi_wwan_q.c复制到drivers/net/usb/目录
2. 修改Makefile编译规则：

   makefile复制obj-$(CONFIG_USB_NET_QMI_WWAN) += qmi_wwan_q.o
   obj-$(CONFIG_USB_NET_QMI_WWAN) += qmi_wwan.o
   

3. 解决依赖冲突：
   • 注释掉CONFIG_QCA_NSS_DRV相关配置
   • 移除CONFIG_PINCTRL_IPQ8074选项

3. 编译与部署流程

3.1 内核编译步骤

1. 准备编译环境：

   bash复制sudo apt install build-essential libncurses-dev bison flex libssl-dev
   

2. 编译内核镜像：

   bash复制make -j$(nproc) Image modules dtbs
   

3. 安装新内核：

   bash复制sudo make modules_install
   sudo cp arch/arm64/boot/Image /boot/
   

3.2 驱动验证方法

完成刷机后，依次检查以下关键节点：

1. 串口设备生成：

   bash复制ls /dev/ttyUSB*
   /dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3
   

2. QMI控制接口：

   bash复制ls /dev/cdc-wdm0
   

3. 网络接口状态：

   bash复制sudo ifconfig wwan0 up
   ifconfig wwan0
   

4. 网络连接实战调试

4.1 AT指令测试

使用minicom进行基础通信测试：

bash复制sudo minicom -D /dev/ttyUSB2 -b 115200

发送测试指令：

code复制AT
AT+CSQ
AT+COPS?

4.2 4G网络拨号配置

1. 编译移远拨号工具：

   bash复制git clone https://github.com/quectel/quectel-CM
   cd quectel-CM && make
   

2. 解决常见问题：

   • 脚本格式问题：

     bash复制sudo apt install dos2unix
     dos2unix default.script
     

   • 权限设置：

     bash复制chmod 755 /usr/share/udhcpc/default.script
     

3. 启动网络连接：

   bash复制sudo ./quectel-CM &
   ping www.baidu.com
   

4.3 网络性能优化

通过调整TCP参数提升4G网络性能：

bash复制sudo sysctl -w net.ipv4.tcp_window_scaling=1
sudo sysctl -w net.core.rmem_max=4194304
sudo sysctl -w net.core.wmem_max=4194304

针对移动网络特点，建议配置心跳保持：

bash复制sudo echo "30" > /proc/sys/net/ipv4/tcp_keepalive_time
sudo echo "5" > /proc/sys/net/ipv4/tcp_keepalive_probes

在完成全部调试后，EC20模组应该能够稳定保持4G连接，实测在信号良好的环境下，下载速率可达50Mbps以上，上传速率约20Mbps，完全满足大多数物联网应用的数据传输需求。实际项目中建议添加自动重连机制，以应对移动网络环境的不稳定性。