LTE/5G Module Series
LTE&5G Linux USB Driver User Guide
LTE&5G_Linux_USB_Driver_User_Guide 1 / 38
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District,
Shanghai, China 200233
Tel: +86 21 5108 6236
Email: info@quectel.com
Or our local office. For more information, please visit:
http://www.quectel.com/support/sales.htm
For technical support, or to report documentation errors, please visit:
http://www.quectel.com/support/technical.htm
Or email to: support@quectel.com
GENERAL NOTES
QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION
AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE
FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF
DAMAGES. ALL RIGHTS ARE RESERVED IN THE EVENT OF A PATENT GRANT OR
REGISTRATION OF A UTILITY MODEL OR DESIGN.
Copyright © Quectel Wireless Solutions Co., Ltd. 2019. All rights reserved.
LTE/5G Module Series
LTE&5G Linux USB Driver User Guide
LTE&5G_Linux_USB_Driver_User_Guide 2 / 38
About the Document
History
Revision
Date
Author
Description
1.0
2015-02-27
Joe WANG
Initial
1.1
2015-3-25
Carl YIN
Updated supported products
1.2
2015-3-30
Kent XU
Added Zero Packet feature in Section 3.2.2 and 3.3.2
1.3
2015-06-24
Carl YIN
1. Added GobiNet and QMI WWAN description in
Section 3.4 and 3.5
2. Added building drivers as a kernel module in Section
3.2.4/3.3.4/3.4.3/3.5.4
3. Added power management in Chapter 4
4. Added FAQ and kernel log in Chapter 6
1.4
2015-12-16
1. Deleted Auto-Connect of GobiNet and QMI WWAN
2. Updated the usage of quectel-CM
1.5
2016-05-13
Carl YIN/
Neo HOU
Updated supported modules
1.6
2016-08-23
Kent XU
Added EC20 R2.0 in supported modules
1.7
2017-05-24
Kent XU
Added EG91/EG95/EG06/EP06/EM06/BG96 in supported
modules
1.8
2017-09-01
Kent XU
Updated description of supported modules and added
AG35 in supported modules.
2.0
2019-12-11
Carl YIN
1. Added applicable modules, which can be referred in
Table 1.
2. Updated USB driver interface description in Table 2.
3. Updated description of USB serial option, GobiNet
and QMI_WWAN drivers in Chapter 3.2, 3.3 and 3.4.
4. Added related content of testing command
“AT$QCRMCALL” and protocol QMAP on GobiNet or
QMI_WWAN driver in Chapter 5.4 and 5.6 as well as
LTE/5G Module Series
LTE&5G Linux USB Driver User Guide
LTE&5G_Linux_USB_Driver_User_Guide 3 / 38
testing MBIM driver in Chapter 5.5.
5. Added FAQs in Chapter 6.
LTE/5G Module Series
LTE&5G Linux USB Driver User Guide
LTE&5G_Linux_USB_Driver_User_Guide 4 / 38
Contents
About the Document ................................................................................................................................... 2
Contents ....................................................................................................................................................... 4
Table Index ................................................................................................................................................... 6
Figure Index ................................................................................................................................................. 7
1 Introduction .......................................................................................................................................... 8
1.1. Applicable Modules ................................................................................................................... 8
2 Overview of Linux USB Driver ............................................................................................................ 9
3 System Setup ..................................................................................................................................... 11
3.1. Linux USB Driver Structure ..................................................................................................... 11
3.2. USB Serial Option Driver ......................................................................................................... 12
3.2.1. Add VID and PID ............................................................................................................ 12
3.2.2. Add the Zero Packet Mechanism ................................................................................... 13
3.2.3. Add Reset-resume Mechanism ...................................................................................... 14
3.2.4. Increase the Quantity and Capacity of the Bulk Out URBs ........................................... 15
3.2.5. Use MBIM, GobiNet or QMI_WWAN Driver .................................................................. 15
3.2.6. Modify Kernel Configuration ........................................................................................... 16
3.3. GobiNet Driver ......................................................................................................................... 17
3.3.1. Modify Source Codes of the Driver ................................................................................ 17
3.3.2. Modify Kernel Configuration ........................................................................................... 17
3.4. QMI_WWAN Driver .................................................................................................................. 18
3.4.1. Modify Source Codes of the Driver ................................................................................ 18
3.4.2. Modify Kernel Configuration ........................................................................................... 19
3.5. Configure Kernel to Support PPP ............................................................................................ 20
3.6. Install and Load Driver as a Kernel Module for PC in Linux ................................................... 21
4 Test the Module .................................................................................................................................. 23
4.1. Test AT Function ...................................................................................................................... 23
4.2. Test PPP Function ................................................................................................................... 23
4.3. Test GobiNet/QMI_WWAN Driver ............................................................................................ 26
4.4. Test "AT$QCRMCALL" on GobiNet/QMI_WWAN Driver ........................................................ 29
4.5. Test MBIM Driver ..................................................................................................................... 30
4.6. Test QMAP on GobiNet/QMI_WWAN Driver ........................................................................... 32
5 Power Management ........................................................................................................................... 33
5.1. Enable USB Auto Suspend...................................................................................................... 33
5.2. Enable USB Remote Wakeup ................................................................................................. 34
6 FAQs and Kernel Log ........................................................................................................................ 35
6.1. How to Check Whether USB Driver Exists in the Module ....................................................... 35
6.2. How to Check Whether the Module Works Well with the Corresponding USB Driver............ 35
6.3. How to Check Which USB Driver Has Been Installed ............................................................ 36