Jetson Orin Nano - EC20 4G模组驱动移植

目录

一、移植过程

1、修改内核配置

1.1 配置USB转串口驱动

1.2 配置QMI_WWAN驱动

2、修改Kernel源码，支持EC20

2.1 修改USB转串口驱动

1）修改 drivers/usb/serial/option.c，添加VID和PID

2）使用USBNet驱动

3）添加零包机制

4）添加Reset-resume机制（休眠唤醒）

3、添加QMI_WWAN驱动

二、验证EC20驱动移植结果

1、编译kernel

2、命令测试结果

2.1 查看内核打印信息

2.2 查看 /dev/ttyUSB 0 -3 节点生成

2.3 查看 /dev/cdc-wdm0 节点生成

2.4 查看wwan0网卡

3、按照EC20文档测试

3.1 测试AT命令

3.2 测试QMI_WWAN驱动（4G）

3.2.1 验证quectel-CM

1）编译生成测试程序

2）测试成功

CONFIG_USB_SERIAL=y
CONFIG_USB_SERIAL_WWAN=y
CONFIG_USB_SERIAL_OPTION=y

CONFIG_USB_NET_DRIVERS=y
CONFIG_USB_USBNET=y
CONFIG_USB_NET_QMI_WWAN=y
CONFIG_USB_WDM=y

static const struct usb_device_id option_ids[] = { 
#if 1 // 2025-04-24 Added by Quectel
    { USB_DEVICE(0x2C7C, 0x0125) }, 
#endif
    ... ...
}

static int option_probe(struct usb_serial *serial,
            const struct usb_device_id *id)
{
    ... ...

#if 1  // 2025-04-24 Added by Quectel  
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)) { 
        __u16 idProduct = le16_to_cpu(serial->dev->descriptor.idProduct); 
        struct usb_interface_descriptor *intf = &serial->interface->cur_altsetting->desc; 

        if (intf->bInterfaceClass != 0xFF || intf->bInterfaceSubClass == 0x42) { 
                //ECM, RNDIS, NCM, MBIM, ACM, UAC, ADB 
                return -ENODEV; 
        } 

        if ((idProduct&0xF000) == 0x0000) { 
                //MDM interface 4 is QMI 
                if (intf->bInterfaceNumber == 4 && intf->bNumEndpoints == 3 
                        && intf->bInterfaceSubClass == 0xFF && intf->bInterfaceProtocol == 0xFF) 
                        return -ENODEV; 
        } 
} 
#endif 

    /* Store the device flags so we can use them during attach. */
    usb_set_serial_data(serial, (void *)device_flags);

    return 0;
}

static struct urb *usb_wwan_setup_urb(struct usb_serial_port *port,
                      int endpoint,
                      int dir, void *ctx, char *buf, int len,
                      void (*callback) (struct urb *))
{
 ... ...
    usb_fill_bulk_urb(urb, serial->dev,
              usb_sndbulkpipe(serial->dev, endpoint) | dir,
              buf, len, callback, ctx);
     
#if 1   //2025-04-24 Added by Quectel for zero packet 
    if (dir == USB_DIR_OUT) { 
        struct usb_device_descriptor *desc = &serial->dev->descriptor; 
    
        if (desc->idVendor == cpu_to_le16(0x2C7C)) 
        urb->transfer_flags |= URB_ZERO_PACKET; 
    } 
#endif
    return urb;
}

static struct usb_serial_driver option_1port_device = {
    ... ...
#ifdef CONFIG_PM
    .suspend           = usb_wwan_suspend,
    .resume            = usb_wwan_resume,
#if 1  //2025-04-24 Added by Quectel 
    .reset_resume   = usb_wwan_resume, 
#endif
#endif
};

# must insert qmi_wwan_q.o before qmi_wwan.o 
obj-${CONFIG_USB_NET_QMI_WWAN} += qmi_wwan_q.o 
obj-${CONFIG_USB_NET_QMI_WWAN} += qmi_wwan.o 

$ scp ./quectel-CM nvidia@192.168.7.36:/tmp                    #用scp命令将quectel-CM拷贝到板子
$ scp defult.script nvidia@192.168.7.36:/usr/share/udhcpc/     #用scp命令将 defult.script 拷贝到板子 /usr/share/udhcpc/ 目录
$ scp defult.script nvidia@192.168.7.36:/etc/udhcpc/           #用scp命令将 defult.script 拷贝到板子 /etc/udhcpc/ 目录

注意设置 defult.script 的权限，开发板输入命令

$ sudo chmod 755 /usr/share/udhcpc/defult.script
$ sudo chmod 755 /etc/udhcpc/defult.script

断开网线，开发板输入命令：

$ sudo ./quectel-CM &     #要加sudo，否则打开文件失败

• default.script脚本最前面加打印，发现调用udhcpc命令时，default.script脚本没有调用
• 改用 dhclient wwan0 后，ip才设到wwan0，并能ping通 "www.baidu.com"。进一步确认是default.script脚本的问题
• default.script其实就是shell脚本，命令行直接执行 ./default.script，打印"-bash: ./default.script: /bin/sh^M: bad interpreter: No such file or directory"，原因是default.script文件是windos格式，需转为Linux格式

• ubuntu下安装dos2unix：$ sudo apt-get install dos2unix
• $ dos2unix default.script 将default.script转换为 UNIX/Linux格式
• 将 default.script 重新传入开发板测试，设置 default.script 权限为 755

$ sudo chmod 755 /etc/udhcpc/default.script #修改权限
$ sudo chmod 755 /usr/share/udhcpc/default.script #修改权限

$ sudo quectel-CM &
$ ifconfig wwan0
$ ping www.baidu.com

测试过程如图：