Quectel UC20 Manuale utente

UC20

Embedded Linux USB Driver

User Guide

UMTS/HSPA Module Series

Rev. UC20_Embedded_Linux_USB_Driver_User_Guide_V1.0

Date: 2013-06-04

www.quectel.com

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 1 / 18

Our aim is to provide customers with timely and comprehensive service. For any

assistance, please contact our company headquarter:

Quectel Wireless Solutions Co., Ltd.

Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233

Tel: +86 21 5108 6236

Mail: info@quectel.com

Or our local office, for more information, please visit:

http://www.quectel.com/support/salesupport.aspx

For technical support, to report documentation errors, please visit:

http://www.quectel.com/support/techsupport.aspx

GENERAL NOTES

QUECTEL OFFERS THIS 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 ARE SUBJECT TO

CHANGE WITHOUT PRIOR NOTICE.

THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF

QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS

DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS 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.

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 2 / 18

About the document

History

Revision

Date

Author

Description

1.0

2012-05-31

Clare CHEN

Initial

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 3 / 18

Contents

About the document ................................................................................................................................... 2

Contents....................................................................................................................................................... 3

Table Index................................................................................................................................................... 4

Figure Index ................................................................................................................................................. 5

1Introduction .......................................................................................................................................... 6

2Product Overview ................................................................................................................................ 7

3System Setup ....................................................................................................................................... 8

3.1. Linux USB Drivers Structure...................................................................................................... 8

3.2. Building the driver...................................................................................................................... 9

3.2.1. Install cross compiler........................................................................................................ 9

3.2.2. Modify the source code file of Linux kernel...................................................................... 9

3.2.3. Modify kernel configuration ............................................................................................ 10

3.2.4. Compiling the kernel ...................................................................................................... 13

3.3. Loading the driver.................................................................................................................... 13

4Application of reference.................................................................................................................... 15

4.1. Modifying the rights of the devices port................................................................................... 15

4.2. Testing AT commands on the devices port.............................................................................. 15

4.3. Create a PPP connection ........................................................................................................ 15

5Appendix A Reference....................................................................................................................... 18

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 4 / 18

Table Index

TABLE 1: INTERFACE DESCRIPTION............................................................................................................... 7

TABLE 2: RELATIONSHIP BETWEEN INTERFACES AND DEVICES ............................................................ 14

TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 18

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 5 / 18

Figure Index

FIGURE 1:USB DRIVER STRUCTURE.............................................................................................................. 8

FIGURE 2: ADD UC20 SUPPORT .................................................................................................................... 10

FIGURE 3:KERNEL CONFIGURATION –SELECT DEVICE DRIVERS ...........................................................11

FIGURE 4:KERNEL CONFIGURATION –SELECT USB SUPPORT................................................................11

FIGURE 5:KERNEL CONFIGURATION –SELECT USB SERIAL CONVERTER SUPPORT ......................... 12

FIGURE 6:KERNEL CONFIGURATION –SELECT USB GENERIC SERIAL DRIVER ................................... 12

FIGURE 7:KERNEL CONFIGURATION –SELECT USB DRIVER FOR GSM AND CDMA MODEMS ........... 13

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 6 / 18

1Introduction

This document introduces how to generate the USB driver for UC20 module in Embedded Linux OS, and

how to use the module after the USB driver being loaded successfully.

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 7 / 18

2Product Overview

Quectel UC20 is a wireless WCDMA modem. You can use it to implement some functions such as VOICE

CALL and browsing internet and so on.

In general, the UC20 module will create five interfaces when you connect it with embedded equipments.

These five interfaces have different functionalities. The details are shown as below:

Table 1: Interface Description

DM interface

Diagnose port

NMEA interface

For GPS NMEA sentence output

AT interface

For AT commands

Modem interface

For PPP connections and AT commands

NDIS interface

Network driver interface

The NDIS interface is temporarily unavailable.

NOTES

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 8 / 18

3System Setup

Linux OS includes a generic USB to serial driver for modem. You can make the UC20 module available in

the Embedded Linux OS by adding some kernel configuration items and adding the information (VID/PID)

in Linux kernel.

The first part of this chapter is to describe the structure of Linux USB Driver and the rest is to explain how

to build the USB driver for UC20 module.

3.1. Linux USB Driver Structure

USB is a kind of hierarchical bus structure. The data transmission between USB devices and Host is

achieved by USB Controller. The following picture illustrates the architecture of USB Driver. Linux USB

Host driver includes three parts: USB Host Controller driver, USB core and USB device drivers.

USB Device Drivers

USB Host Controller Driver

( OHCI/EHCI/UHCI )

USB Controllers ( OHCI/EHCI/UHCI )

USB Core

Applicantions

URB

USBD

Interface

HCD

Interface

UC20 Module

Software

UC20 Module

Linux Host

Figure 1: USB Driver Structure

Quectel

Confidential

UMTS/HSPA Module

UC20 Embedded Linux USB Driver User Guide

UC20_Embedded_Linux_USB_Driver_User_Guide Confidential / Released 9 / 18

The USB Host Controller driver, the bottom of the hierarchical structure, is a software module which

interacts directly with hardware.

USB core, the core of the whole USB host driver, is responsible for the management of USB bus, USB

bus devices, and USB bus bandwidth, providing the interfaces for USB device driver, through which the

applications can access the USB system files.

USB device drivers interact with the applications, and mainly provide the interfaces for accessing the

specific USB devices.

3.2. Building the Driver

During the development based on embedded Linux OS, you must retrieve the Linux kernel source code

files and install an appropriate cross compiler first, then modify the kernel configuration and

corresponding source code files, and compile the kernel to generate image file, then burn the file into the

target machine (The OS of the target machine is Android 4.0.3, and the corresponding Linux kernel

version is 3.0.8).The detailed steps are shown as below:

3.2.1. Install Cross Compiler

Cross-compilation is an important technology for embedded development. Its feature is that the source

code files are not compiled in native machine but the other one. In general we call the former target

machine and the latter host machine.

The reason of adopting cross-compilation is that most embedded target system cannot provide enough

resources for compiling source code files, so we have to do that in a high-performance host machine in

which we will create an environment of cross-compilation for the target machine.

In general, the vendor of the embedded machine would provide the cross compiler and the installment

method about it. Here, we use the cross compiler "arm-linux-gcc-4.5.1", install it and add the compiler’s

path in the system environment variables, then re-logout system, then you can use the cross compiler to

compile the source code files.

3.2.2. Modify the Source Code File of Linux Kernel

Modify the source code file "option.c" in Linux kernel by adding VID and PID of UC20, so that the OS can

recognize it.

Quectel

Confidential

Altri manuali per UC20

Indice

Altri manuali Quectel Unità di controllo

Quectel

Quectel WCDMA Istruzioni per l'installazione e il funzionamento

Quectel

Quectel EP06 Manuale utente

Quectel

Quectel SC600Y-EM Series Supplemento

Quectel

Quectel SG560D Series Supplemento

Quectel

Quectel EC2 Series Istruzioni per l'installazione

Quectel

Quectel AG35 SMTP Manuale di installazione

Quectel

Quectel UG89 Supplemento

Quectel

Quectel SG368Z Series Supplemento

Quectel

Quectel UG95 Supplemento

Quectel

Quectel BG96 Manuale di installazione

Quectel

Quectel EG95-E Manuale utente

Quectel

Quectel EG91 Series Supplemento

Quectel

Quectel SC20-AD Manuale utente

Quectel

Quectel BG96 Manuale utente

Quectel

Quectel LC76F Manuale utente

Quectel

Quectel M35 Manuale utente

Quectel

Quectel RG500L EVB Manuale utente

Quectel

Quectel BC660K-GL Manuale utente

Quectel

Quectel BG77 Supplemento

Quectel

Quectel BG96 Manuale di istruzioni

Quectel

Quectel EC200U Series Supplemento

Quectel

Quectel LTE-A Series Supplemento

Quectel

Quectel FC64E Supplemento

Quectel

Quectel BC95-GR-TE-B Manuale utente

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente