WCDMA&LTE Linux移远USB驱动程序用户指南（WCDMA/LTE Standard/Automotive/LTE-A Module Series）

于 2020-04-09 13:18:38 发布
阅读量3.8k 收藏 15
点赞数 2
分类专栏： 笔记
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_46045444/article/details/105403003
版权
本文档详细介绍了如何在Linux系统中集成和使用Quectel WCDMA/LTE模块的USB驱动程序，包括USB串行、CDC ACM、GobiNet和QMI WWAN驱动的配置、加载以及电源管理。提供了针对不同模块的驱动程序修改、内核配置和测试方法，适用于UC15/UC20/EC20等多个系列的Quectel模块。
摘要由CSDN通过智能技术生成

介绍

本文档介绍如何在Linux操作系统中集成用于Quectel模块的USB驱动程序，以及如何成功加载USB驱动程序后使用模块。
适用产品
本文件适用于以下Quectel模块。
表1：适用产品
在这里插入图片描述
在这里插入图片描述

产品概述

Quectel UMTS/HSPA/LTE模块上的USB包含几个不同的功能接口。下表描述了Linux系统中不同模块的接口信息。
表2：接口信息
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

系统设置

本章主要介绍Linux下USB协议栈的总体结构以及如何使用USB协议栈
串行、CDC ACM、GobiNet和QMI WWAN驱动程序，以及如何编译和加载驱动程序。
Linux USB驱动程序结构
USB是一种层次化的总线结构。USB设备和主机之间的数据传输是由USB控制器实现。下图说明了USB驱动程序的体系结构。
Linux USB主机
驱动程序包括三部分：USB主机控制器驱动程序、USB内核驱动程序和USB设备驱动程序。
在这里插入图片描述
图1:USB驱动程序结构
USB主机控制器驱动程序是层次结构的底层，是一个可以直接和硬件交互的软件模块
USB核是整个USB主机驱动程序的核心，负责USB总线、USB总线的管理
设备和USB总线带宽；它为USB设备驱动程序提供接口，通过该接口
应用程序可以访问USB系统文件。
USB设备驱动程序与应用程序交互，主要提供访问
特定的USB设备。

USB串行驱动程序

如果客户使用的是UC15/UC20/EC20/EC21/EC25/EG91/EG95/BG96/AG35/EG06/EP06/EM06/EG12/EP12/EM12/EG16/EG18需要USB串行驱动程序，请阅读了解详。否则跳过
当模块连接到USB串行驱动程序时，驱动程序将在目录/dev中创建设备文件，命名如下：
ttyUSB0/ttyUSB1/ttyUSB2…
以下部分介绍如何集成USB串行驱动程序。
添加VID和PID
为了识别模块，客户应添加以下模块VID和PID信息：
文件：[KERNEL]/drivers/usb/serial/option.c

static const struct usb_device_id option_ids[] = {
#if 1 //Added by Quectel
{ USB_DEVICE(0x05C6, 0x9090) }, /* Quectel UC15 */
{ USB_DEVICE(0x05C6, 0x9003) }, /* Quectel UC20 */
{ USB_DEVICE(0x2C7C, 0x0125) }, /* Quectel EC25 */
{ USB_DEVICE(0x2C7C, 0x0121) }, /* Quectel EC21 */
 { USB_DEVICE(0x05C6, 0x9215) }, /* Quectel EC20 */
{ USB_DEVICE(0x2C7C, 0x0191) }, /* Quectel EG91 */
{ USB_DEVICE(0x2C7C, 0x0195) }, /* Quectel EG95 */
{ USB_DEVICE(0x2C7C, 0x0306) }, /* Quectel EG06/EP06/EM06 */
{ USB_DEVICE(0x2C7C, 0x0512) }, /* Quectel EG12/EP12/EM12/EG16/EG18 */
{ USB_DEVICE(0x2C7C, 0x0296) }, /* Quectel BG96 */
{ USB_DEVICE(0x2C7C, 0x0435) }, /* Quectel AG35 */
#endif

对于EC20模块，如果内核源文件中存在以下文件和语句，请删除它们，因为它们将与EC20的USB驱动程序冲突。
文件：[KERNEL]/drivers/usb/serial/qcsserial.c

{USB_DEVICE(0x05c6, 0x9215)}, /* Acer Gobi 2000 Modem device (VP413) */

文件：[KERNEL]/drivers/net/usb/qmi_wwan.c

{QMI_GOBI_DEVICE(0x05c6, 0x9215)}, /* Acer Gobi 2000 Modem device (VP413) */

添加零包机制
根据USB协议的要求，用户需要在散装运输过程中添加处理零包的机制
对于高于2.6.34的Linux内核版本：
文件：[KERNEL]/drivers/usb/serial/usb-wwan.c

static struct urb *usb_wwan_setup_urb(struct usb_serial *serial, 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 //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(0x05C6) && desc->idProduct == cpu_to_le16(0x9090))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9003))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9215))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x2C7C))
urb->transfer_flags |= URB_ZERO_PACKET;
}
#endif
return urb;
}

对于低于2.6.35的Linux内核版本：
File:[kernel]/drivers/usb/serial/option.c

/* Helper functions used by option_setup_urbs */
static struct urb *option_setup_urb(struct usb_serial *serial, 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 //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(0x05C6) && desc->idProduct == cpu_to_le16(0x9090))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9003))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9215))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x2C7C))
urb->transfer_flags |= URB_ZERO_PACKET;
#endif
return urb;
}

添加重置恢复
当MCU进入暂停/睡眠状态时，某些USB主机控制器/USB集线器将断电或重置模式，并且在MCU退出挂起/休眠模式后，它们无法恢复USB设备。请添加以下语句启用重置恢复过程。
对于高于3.4的Linux内核版本：
文件：[KERNEL]/drivers/usb/serial/option.c

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

对于低于3.5的Linux内核版本：
文件：[KERNEL]/drivers/usb/serial/usb-erial.c

/* Driver structure we register with the USB core */
static struct usb_driver usb_serial_driver = {
 .name = "usbserial",
 .probe = usb_serial_probe,
 .disconnect = usb_serial_disconnect,
 .suspend = usb_serial_suspend,
 .resume = usb_serial_resume,
#if 1 //Added by Quectel
 .reset_resume = usb_serial_resume,
#endif
 .no_dynamic_id = 1,
 .supports_autosuspend = 1,
};

Enlarge Bulk out URBs
对于低于2.6.29的Linux内核版本，需要bulk out URBs去获得更快的上行速度
File: [KERNEL]/drivers/usb/serial/option.c

#define N_IN_URB 4
#define N_OUT_URB 4 //Quectel 1
#define IN_BUFLEN 4096
#define OUT_BUFLEN 4096 //Quectel 128

使用GobiNet或QMI WWAN
如果客户使用的是C20/EC20/EC21/EC25/EG91/EG95/BG96/AG35/EG06/EP06/EM06/EG12/EP12/EM12/EG16/EG18，需要GobiNet或QMI WWAN，请添加以下语句防止这些模块的接口4用作USB串行设备。
对于高于2.6.30的Linux内核版本：
文件：[KERNEL]/drivers/usb/serial/option.c

static int option_probe(struct usb_serial *serial, const struct usb_device_id *id) {
struct usb_wwan_intf_private *data;
……
#if 1 //Added by Quectel
//Quectel UC20的接口4可以用作USB网络设备
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x05C6) &&serial->dev->descriptor.idProduct == cpu_to_le16(0x9003)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC20的接口4可用作USB网络设备
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x05C6) && 
serial->dev->descriptor.idProduct == cpu_to_le16(0x9215)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC25&EC21&EG91&EG95&EG06&EP06&EM06&BG96/AG35的接口4可用作USB网络设备
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
#endif
/* 存储设备id，以便在连接期间使用 */
usb_set_serial_data(serial, (void *)id);
return 0;
}

对于低于2.6.31的Linux内核版本：
文件：[KERNEL]/drivers/usb/serial/option.c

static int option_startup(struct usb_serial *serial)
{
……
dbg("%s", __func__);
#if 1 //Added by Quectel
//Quectel UC20's interface 4 can be used as USB network device
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x05C6) && 
serial->dev->descriptor.idProduct == cpu_to_le16(0x9003)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC20's interface 4 can be used as USB network device
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x05C6) && 
serial->dev->descriptor.idProduct == cpu_to_le16(0x9215)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC25&EC21&EG91&EG95&EG06&EP06&EM06&BG96/AG35's interface 4 can be used as 
USB network device
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
#endif
……
}

修改内核配置
内核配置中有几个必选项，请按照以下步骤操作
配置内核：
步骤1：更改到内核目录

cd <your kernel directory>

第二步：设置环境变量，导入board的defconfig。以下是Raspeberry Pi board的例子

export ARCH=arm
export CROSS_COMPILE=arm-none-linux-gnueabi
make bcmrpi_defconfig

步骤3：编译内核。

make menuconfig

步骤4：启用配置USB串行选项

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

Linux下PC核心模块驱动程序的构建与加载
请按照以下步骤将驱动程序构建为内核模块，并使用modprobe命令加载在PC机上实现Linux操作系统的模块。
步骤1：切换到内核目录

cd <your kernel directory>

步骤2：构建驱动程序

sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=option.o modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=usb_wwan.o
modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=qcserial.o modules

步骤3：加载驱动程序并重新启动。

sudo cp drivers/usb/serial/option.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo cp drivers/usb/serial/usb_wwan.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo cp drivers/usb/serial/qcserial.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo depmod
sudo reboot

用于UG9的CDC ACM驱动程序
步骤2：生成驱动程序

sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=option.o modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=u
最低0.47元/天 解锁文章
M . H ~
关注
专栏目录
(HAL)stm32f407+freertos通过usb驱动移远4G模块-EC600U
gongrulin的博客
07-09 1415
文章记录了stm32cubemx+stm32f407+freertos+usb host实现移远4G模块EC600U的usb驱动的调试过程，usb host cdc库的使用和遇到的问题及解决办法。
移远4G模块Linux下USB驱动
08-25
22年6月22号版本，支持到v5.18.5版本内核
移远4G模块调试方法记录
Litost_Cheng的博客
01-13 9652
本文以移远的EC25通信模块为例，记录如何借助官方手册，将模块移植到Linux系统，以及如何使用AT指令，对模块的基本功能（短信，打电话、上网等）进行测试
移远Quectel_WCDMA&LTE;_Linux_USB_Driver_User_Guide
09-06
Quectel_WCDMA&LTE;_Linux_USB_Driver_User_Guide_V1.8
Quectel_WCDMA&LTE;_Linux_USB_Driver_User_Guide_V1.7.pdf
02-05
Quectel_WCDMA&LTE;_Linux_USB_Driver_User_Guide_V1.7.pdf
移远全套驱动驱动以及文档，包括GobiNet_Driver_V1.6.2.9，QMI_WWAN_Driver_V1.2.0.14
04-24
在嵌入式Linux平台实测可用
移远4G/5G模块基于windows USB NDIS拨号驱动
04-07
QUECTEL模块基于windows USB NDIS驱动,可实现基于windows系统NDIS自动拨号
移远5G模组驱动 Quectel_LTE&5G_Linux_USB_Driver_V1.0.zip
11-16
移远5G模组驱动
显示/光电技术中的安华高推出ACPL-312T车用级2.5A门极驱动光电耦合器
11-22
设计上符合汽车电子协会(AEC, Automotive Electronics Council)严格的AEC-Q100车用规范标准，Avago的ACPL-312T提供有2.5A最大尖锋电流输出来推动高功率IGBT/MOSFET，并且可以在高达125℃的高温下运作。另外，仅0.5μ...
移远5G模块_windows驱动(Quectel_LTE&5G_Windows_USB_Driver_V2.1)
12-10
移远5G模块_windows驱动(Quectel_LTE&5G_Windows_USB_Driver_V2.1)
移远LET EC2.0 R20 WIN10 驱动程序
04-25
移远LET EC2.0 R20 WIN10 驱动程序，LTE Module Series Rev. LTE_Windows_USB_Driver_Installation_Guide_V1.0 Date: 2017-11-14 Status: Released www
移远4g模块驱动手册
07-20
移远4g模块驱动手册
Quectel_WCDMA&LTE_Linux_USB_Driver_User_Guide_V1.8.pdf
02-16
移远EC20 4G模块linux内核驱动
Quectel-LTE&5G-Linux-USB-Driver-User-Guide-V2.0.rar
09-09
移远EC20 4G模组、RM500Q 5G模组， 在嵌入式linxu下驱动开发文档，包含GobiNet驱动移植，QMI_WWAN 驱动移植等内容。
Automotive-SPICE-PAM-30-翻译版_spice_pam_spice_汽车A-SPICE_Automotive
10-01
"Automotive-SPICE-PAM-30-翻译版_spice_pam_spice_汽车A-SPICE_Automotive" 这个标题涵盖了几个关键术语，包括"Automotive-SPICE"（汽车软件过程改进与能力评估模型）、"PAM"（过程评估模型）、"30"可能指的是版本...
使用框图详解Automotive-SPICE汽车开发流程SWE.1软件需求分析+SWE.2软件架构设计
最新发布
09-07
Automotive-SPICE，全称为Automotive Software Process Improvement and Capability Determination，是汽车行业的一个标准，旨在提高软件开发过程的质量和成熟度。SWE.1和SWE.2是该框架中关于软件开发流程的两个关键...
MPCController.rar_automotive MPC_carsim_无人驾驶/模型预测控制/轨迹跟踪_模型预测ca
07-14
通过carsim与matlab联合仿真，基于模型预测控制算法的无人车辆轨迹跟踪（内含五个matlab编程代码）
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值