Embedded Linux USB Driver User Guide
Contents
1. USB Driver Structure UC15 Embedded Linux USB Driver User Guide Confidential Released 8 18 UC F UMTS HSPA Module Series NI Wireless Module Expert UC15 Embedded Linux USB Driver User Guide 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 It provides 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 Create 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 Compile the kernel to generate image file and 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 native machine as target machine and the other one as hos2. is shown as below etc ppp peers Module UC15 Usage root gt pppd call Module UC15 Keep pppd attached to the terminal Comment this to get daemon mode pppd nodetach For sanity keep a lock on the serial line lock Serial Device to which the HSPDA phone is connected IdevittyUSB3 Serial port line speed 115200 user lt insert here the correct username for authentication gt password lt insert here the correct password for authentication gt No hardware flow control nocrtscts Ask the peer for up to 2 DNS server addresses usepeerdns The phone is not required to authenticate noauth pppd must not propose any IP address to the peer noipdefault No ppp compression novj novjccomp noccp If you want to use the HSDPA link as your gateway defaultroute ipcp accept local ipcp accept remote The chat script be sure to edit that file too connect chat s v f etc ppp peers Chat Module UC15 connect The close script be sure to edit that file too disconnect chat s v f etc ppp peers Chat Module UC 15 disconnect The content of the file Chat Module UC15 connect is shown as below ABORT NO CARRIER ABORT ERROR UC15 Embedded Linux USB Driver User Guide Confidential Released 16 18 QUECTSE UMTS HSPA Module Series CNET wireless Module Expert UC15 Embedded Linux USB Driver User Guide ABORT NO DIALTONE ABORT BUSY ABORT NO ANSWER AT ATEO Dial the number
3. 3 2 3 Modify Kernel Configuration Select the configuration items of USB to serial driver of the Linux kernel so that the OS can support the module Retrieve the appropriate kernel source code version for your embedded system Unpack it to your host machine and put it in its root directory type make menuconfig Configure the kernel compiling items in the pop up window And browse through the menus Device Driver USB Support USB Serial Converter support and choose USB Generic Serial Driver and USB driver for GSM and CDMA modems as build in the illustration is shown as below UC15 Embedded Linux USB Driver User Guide Confidential Released 10 18 q UtC C SZ UMTS HSPA Module Series Wireless Module Expert UC15 Embedded Linux USB Driver User Guide Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt module capable FIQ Mode Serial Debugger Bus support gt Kernel Features gt Boot options gt CPU Power Management gt T Floating point emulation gt Userspace binary formats gt Power management options gt Networking support gt 1 device Drivers gt File systems gt Kernel hacking gt Security opt
4. Interface Reserved AT Interface For AT commands Modem Interface For PPP connections and AT commands NDIS Interface Network driver interface NOTE The NDIS interface is unavailable temporarily UC15 Embedded Linux USB Driver User Guide Confidential Released 7118 QUEC TE UMTS HSPA Module Series C Wirsless Module Exp ri UC15 Embedded Linux USB Driver User Guide 3 System Setup Linux OS includes a generic USB to serial driver for GSM WCDMA modem You can make the module available in the embedded Linux OS by adding some kernel configuration items and information VID PID in Linux kernel The first part of this chapter describes the structure of Linux USB driver and the rest explains how to build the USB driver for the 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 Applicantions Fa Linux Host T i USB Device Drivers USBD UB 9 amp V 9 Interface USB Core Module Software HCD E M esee Interface USB Host Controller Driver OHCI EHCI UHCI l Module USB Controllers OHCI EHCI UHCI d _ gt Figure 1
5. lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt module capable USB Serial Converter support USB Serial Console device support Functions for loading firmware on EZUSB chips USB Generic Serial Driver lt gt USB AIRcable Bluetooth Dongle Driver lt gt USB ARK Micro 3116 USB Serial Driver lt gt USB Belkin and Peracom Single Port Serial Driver lt gt USB Winchiphead CH341 Single Port Serial Driver lt gt USB ConnectTech WhiteHEAT Serial Driver lt gt USB Digi International AccelePort USB Serial Driver lt gt USB CP210x family of UART Bridge Controllers lt gt USB Cypress M8 USB Serial Driver lt gt USB Empeg empeg car Mark I II Driver lt gt USB FTDI Single Port Serial Driver lt gt USB Fundamental Software Dongle Driver lt gt USB Handspring Visor Palm m50x Sony Clie Driver lt gt USB PocketPC PDA Driver lt gt USB IR Dongle Serial Driver v Exit lt Help gt Figure 6 Select USB Generic Serial Driver UC15 Embedded Linux USB Driver User Guide Confidential Released 12 18 UC F UMTS HSPA Module Series MP Wireless Module Expert UC15 Embedded Linux USB Driver User Guide USB Serial Converter support Arrow keys navigate the menu Enter selects submenus Highlighted letters are hotkeys Pres
6. OK ATD 99 CONNECT The content of the file Chat Module UC15 disconnect is shown as below ABORT OK ABORT BUSY ABORT DELAYED ABORT NO ANSWER ABORT NO CARRIER ABORT NO DIALTONE ABORT VOICE ABORT ERROR ABORT RINGING TIMEOUT 12 UU OW ATH SAY nGoodbay n After creating PPP connection successfully you can browse internet with the default browser of Android OS UC15 Embedded Linux USB Driver User Guide Confidential Released 17 18 UMTS HSPA Module Series UC15 Embedded Linux USB Driver User Guide OQWECCre Wireless Module Expert 5 Appendix A Reference Table 3 Terms and Abbreviations Description Operating System Abbreviation Product ID OS PID VID Vendor ID 18 18 Confidential Released UC15 Embedded Linux USB Driver User Guide
7. ORT euet et testet betae mestre beet nitur ene e nena rd en ete dx he dr edad 11 FIGURE 5 SELECT USB SERIAL CONVERTER SUPPORT din totae nda reed tet ea Era cba er e a rae 12 FIGURE G SELECT USB GENERIC SERIAL DRIVER ibn ht ce tette aed eth baa rete pa h te TT sian 12 FIGURE 7 SELECT USB DRIVERS FOR GSM AND CDMA MODEMS eee 13 UC15 Embedded Linux USB Driver User Guide Confidential Released 5 18 UMTS HSPA Module Series UC15 Embedded Linux USB Driver User Guide OQWECCre Wireless Module Expert 1 Introduction This document mainly introduces how to generate the USB driver for the module in embedded Linux OS and how to use the module after the USB driver has been installed successfully 6 18 Confidential Released UC15 Embedded Linux USB Driver User Guide OQWECCre UMTS HSPA Module Series eem UC15 Embedded Linux USB Driver User Guide Wireless Module Expert 2 Product Overview UC15 has the ability to conduct the wireless communication Therefore applications such as voice call short message and network can be run well in the embedded Linux system In order to use the physical USB interface of the module you must generate the USB driver for the module first This module is a composite USB device and it includes five function interfaces and these five interfaces have different functionalities The details are shown as below Table 1 Interface Description DM Interface Diagnose port Reserved
8. TION 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 Copyright Quectel Wireless Solutions Co Ltd 2013 All rights reserved UC15 Embedded Linux USB Driver User Guide Confidential Released 1 18 QUEC SZ UMTS HSPA Module Series UN wiialess Module Expert UC15 Embedded Linux USB Driver User Guide About the Document History Revision Date Author Description 1 0 2013 12 09 Clare CHEN Initial UC15 Embedded Linux USB Driver User Guide Confidential Released 2118 QUEC SZ UMTS HSPA Module Series Wireless Module Expert UC15 Embedded Linux USB Driver User Guide Contents About the Doc rme nt TT 2 Se T Ta sae TIE ETE A 3 Table Nde ree e E Es ceavac deve seuc EEE e E eE eE e eE a EREE EEEE se 4 Figure Index g E EEE 5 1 IntrOGdU COT eee eee a a e eae aa a aa eee ea a 6 2 J rehe E TTT 7 3 Systemi Set p HH 8 3 1 Linux USB Driver Struehuire 552225 RR RR RO ER Rx EE UE RE Ur ERE RA RRR Nx 8 3 2 CSAS TESTI FINS aceite eee eee eee tr a Mw eee avi ce dee 9 39 2 1 Install Cross GCombpiler tete tret te tcc e Chen Eee teet Rei tette bees 9 3 2 2 Modify the Source Code File of Linux Kernel aa seene 9 3 2 3 Modify Kernel Configur
9. ation a E I A eee AA 10 3 2 4 Compile the Kernel cccccccsccnneeeeeceeceebeceeeseeteceeeeesdageeeececeeeeeseneeeeesenaneeeseceeeeeseeess 13 3 9 Load the Der sss sss sss eee T oa 13 4 Instructions for Use ee A ee of ee RO 15 4 1 Modify the Rights of the Devices Port sees eee 15 4 2 Test AT Commands on the Devices Port 15 4 3 Credite a PPP Wenngction A sse eee ee oes IR see eese 15 5 Appendix Reference s vesse mm eese 18 UC15 Embedded Linux USB Driver User Guide Confidential Released 3 18 QUEC SZ UMTS HSPA Module Series UN wiialess Module Expert UC15 Embedded Linux USB Driver User Guide Table Index TABLE 1 INTERFACE DESCRIPTION 2 2 2 hance matin ine sets eei tec tb vec eroe te wel sepe cvm t rk dz EpL ARE vnd adenine 7 TABLE 2 RELATIONSHIP BETWEEN INTERFACES AND DEVICES eene 14 TABLE 3 TERMS AND ABBREVIATIONS cct steterit tata d a fec e Puede ate id d 18 UC15 Embedded Linux USB Driver User Guide Confidential Released 4118 QUEC SZ UMTS HSPA Module Series UN wiialess Module Expert UC15 Embedded Linux USB Driver User Guide Figure Index FIGURE USB DRIVER STRUCTURE icio io taser niente ied A siete Ua si dae dT e odd 8 FIGURE 2 THE CONTENT OF THE FILE OPTION OS ics tierce tnc ru tt ecran nra tta daai ia cha 10 EIGURE 3 SELECT DEVICE DRIVERS ito rrt reda eter tee a Mnasuat ies cede as laude 11 FIGURE 4 SELECT USB SUPP
10. d in the path kernel_src arch arm boot then you can burn it into the target machine and connect the module to the machine 3 3 Load the Driver When the module is connected with the Linux kernel system mentioned above the system will recognize the module and read its device descriptor then create five interface devices automatically listed as below After that you can use these five interface devices UC15 Embedded Linux USB Driver User Guide Confidential Released 13 18 UC F UMTS HSPA Module Series NI Wireless Module Expert UC15 Embedded Linux USB Driver User Guide dev ttyUSBO dev ttyUSB1 dev ttyUSB2 dev ttyUSB3 dev ttyUSB4 You can check the result in the terminal by the inputting following command ls dev ttyUSB If the five device node files are listed it is certain that the module has been recognized by Linux Android OS And the corresponding relations between the interfaces and the devices are shown as below Table 2 Relationship between Interfaces and Devices Index Interface Name Device Name 0 DM interface dev ttyUSBO 1 Reserved interface dev ttyUSB1 2 AT interface dev ttyUSB2 3 Modem interface dev ttyUSB3 4 NDIS interface devi ttyUSB4 UC15 Embedded Linux USB Driver User Guide Confidential Released 14 18 OQWECCre UMTS HSPA Module Series Wireless Module Expert UC15 Embedded Linux USB Driver User Guide zm Instructions for Use After the USB driver of the module has be
11. en loaded successfully you can use the module It is suggested to dispose the voice call and SMS service on AT interface and dispose the Data service on modem interface 4 1 Modify the Rights of the Devices Port Before using the module make sure that the two ports can be read written and executed For example type the commands below in the terminal to modify the rights chomd 777 dev ttyUSB2 chomd 777 dev ttyUSB3 4 2 Test AT Commands on the Devices Port You can use serial debugging tools to send AT commands to check whether the module can work When you configure the serial debugging tools the serial port must be dev ttyUSB2 or dev ttyUSB3 and the sending data may be as follows Sending data AT r n Received data OK If the received data is OK it indicates that the module is available 4 3 Create a PPP Connection In general you should create a PPP connection before using the data service of the module The command of creating a PPP connection in terminal is shown as below UC15 Embedded Linux USB Driver User Guide Confidential Released 15 18 OWE CF z UMTS HSPA Module Series Wireless Module Expert UC15 Embedded Linux USB Driver User Guide pppd call Module UC15 The parameter Module UC15 is a script file of PPP dial In general the PPP dial script files include three files Module UC 15 Chat Module UC 15 connect and Chat Module UC 15 disconnect The content of the file Module UC 15
12. h NUECES oad a Module Expert UC15 Embedded Linux USB Driver User Guide UMTS HSPA Module Series Rev UC15 Embedded Linux USB Driver User Guide V1 0 Date 2013 12 09 www quectel com QUEC SZ UMTS HSPA Module Series UN wiialess Module Expert UC15 Embedded Linux USB Driver User Guide Our aim is to provide customers with timely and comprehensive service For any assistance please contact our company headquarters 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 COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO LTD TRANSMITTABLE REPRODUCTION DISSEMINA
13. ions gt Cryptographic API gt Library routines gt Load an Alternate Configuration File Save an Alternate Configuration File lt Exit lt Help gt Figure 3 Select Device Drivers Device Drivers Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt module capable lt gt Power supply class support gt lt gt Hardware Monitoring support gt lt gt Generic Thermal sysfs driver gt Watchdog Timer Support gt Sonics Silicon Backplane gt Broadcom specific AMBA gt Multifunction device drivers gt voltage and Current Regulator Support gt lt gt Multimedia support gt Graphics support gt lt gt Sound card support gt HID Devices gt I I USB support gt lt gt MMC SD SDIO card support gt lt gt Sony MemoryStick card support EXPERIMENTAL gt LED Support gt Near Field Communication NFC devices gt lt gt Switch class support gt v lt Exit gt lt Help gt Figure 4 Select USB Support UC15 Embedded Linux USB Driver User Guide Confidential Released 11 18 UC F UMTS HSPA Module Series CN Wire
14. less Module Expert UC15 Embedded Linux USB Driver User Guide uu D A M oJ USB support gt Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt module capable ids The shared table of common or usual storage devices USB Imaging devices lt gt USB Mustek MDC800 Digital Camera support lt gt Microtek X6USB scanner support USB port drivers Se ee E USB Miscellaneous drivers EMI 6 2m USB Audio interface support EMI 216 USB Audio interface support ADU devices from Ontrak Control Systems USB 7 Segment LED Display USB Diamond Rio500 support USB Lego Infrared Tower support USB LCD driver support USB LED driver support Cypress CY7C63xxx USB driver support Cypress USB thermometer driver support Siemens ID USB Mouse Fingerprint sensor support A AA AAA AAA AA e VVVVVVVVVVV lt Exit gt lt Help gt Figure 5 Select USB Serial Converter Support USB Serial Converter support Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes
15. rch Tools Documents Help I J open v swe C Qa en L3 option c X h static const u8 zte k3765 z no sendsetup 9 1 2 static const struct option blacklist info zte k3765 z blacklist infolen ARRAY SIZE zte k3765 z no sendsetup ifaceinfo zte k3765 z no sendsetup reason OPTION BLACKLIST SENOSETUP static COLT USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA LIGHT USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA QUAD USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA QUAD LIGHT USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA NOIS 1 USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA NOIS LIGHT USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA NOIS QUAD USB DEVICE OPTION VENDOR ID OPTION PRODUCT RICOLA NOTS QUAD LIGHT USB DEVICE OPTION VENDOR ID OPTION PRODUCT COBRA USB OEVICE OPTION VENDOR ID OPTION PRODUCT COBRA BUS USB DEVICE OPTION VENDOR ID OPTION PRODUCT VIPER USB DEVICE OPTION VENDOR ID OPTION PRODUCT VIPER BUS USB DEVICE OPTION VENDOR ID OPTION PRODUCT GT MAX READY USB DEVICE OPTION VENDOR ID OPTION PRODUCT FUJI MODEM LIGHT USR DEVICE OPTION VENDOR ID OPTION PRODUCT FUJI MODEM GT USB DEVICE OPTION VENDOR ID OPTION PRODUCT FUJI MODEM EX Cv Tab Width 8 in 501 Col 24 Figure 2 The Content of the File option c
16. sing Y includes N excludes M modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded M module lt gt module capable USB Qualcomm Serial modem lt gt USB SPCP8x5 USB To Serial Driver USB HP4x Calculators support USB Safe Serial Encapsulated Driver USB Secure Encapsulated Driver Padded USB Siemens MPI driver lt gt USB Sierra Wireless Driver lt gt USB Symbol Barcode driver serial mode USB TI 3410 5052 Serial Driver USB REINER SCT cyberJack pinpad e com chipcard reader lt gt USB Xircom Entregra Single Port Serial Driver lt P SB driver for GSM and CDMA modems lt gt USB ZyXEL omni net LCD Plus Driver USB Opticon Barcode driver serial mode lt gt USB ViVOpay serial interface driver lt gt ZIO Motherboard USB serial interface driver lt gt USB Quatech SSU 100 Single Port Serial Driver lt gt USB Debugging Device Exit Help Figure 7 Select USB Drivers for GSM and CDMA Modems Make sure the mandatory items have been selected then save and exit 3 2 4 Compile the Kernel The last step of building the driver is using the cross compiler to compile the kernel Before inputting the command below you should locate the kernel s root directory and type first make After compiling the kernel successfully the zlmage file will be create
17. t machine The reason for adopting cross compilation is that most embedded target system cannot provide enough resources to compile source code files so we have to realize 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 install method about it Here we use the cross compiler arm linux gcc 4 5 1 as an example First install it and add the compiler s path in the system environment variables and re logout the 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 the module so that the OS can recognize it The UC15 s VID and PID are shown as follows e VID 0x05c6 PID 0x9090 UC15 Embedded Linux USB Driver User Guide Confidential Released 9 18 QUEC F UMTS HSPA Module Series Wireless Module Expert UC15 Embedded Linux USB Driver User Guide Open the file option c in the path of drivers usb serial and find the structure array of static structusb device idoption ids Insert USB DEVICE 0x05c6 0x9090 to the array then save and close it The content of the file option c is shown as below LA option c opt FriendlyARM tiny210 android linux 3 0 8 drivers usb serial gedit File Edit View Sea
Download Pdf Manuals
Related Search