QC Linux Driver User Guide
Contents
1. 7 x S az hazes ie gt ra Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 18 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Error Management Routine else ttyUSBx Device Opened 3 1 3 2 read The read function reads nbyte bytes from the file associated with the open file descriptor fildes and copies them in the buffer that is pointed to by buf Header file unistd h Prototype ssize_t read int fildes void buf size_t nbyte Parameters fildes file descriptor buf destination buffer pointer nbyte number of bytes that read attempts to read Returns The number of bytes actually read if the operation is completed successfully otherwise it is 1 Example Read sizeof read buff bytes from the file associated with fd and stores them into read buff char read_buff BUFF_LEN if read fd read buff sizeof read_buff lt 0 Error Management Routine else Value Read 3 1 3 3 write The write function writes nbyte bytes from the buffer that are pointed by buf to the file associated with the open file descriptor fildes Header file unistd h il fi SLs d s w i z i i z gt RS rs ETA a aa 7s Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 19 of 23 Tel2. A amp Telit QC Linux USB Driver Software User Guide if close fd lt 0 Error Management Routine else File Closed 3 1 3 5 Test Program 1vv0300804 r7 04 11 2014 The following simple C program is useful to test the modem issuing an AT command The program opens the dev ttyUSBx device and calls the write and the read function to send an AT command and receive the subsequent output include lt stdio h gt Standard input output definitions include lt string h gt String function definitions include lt unistd h gt UNIX standard function definitions include lt fcntl h gt File control definitions include lt errno h gt Error number definitions include lt termios h gt POSIX terminal control definitions define USB dev ttyUSBx define BUFSIZE 1000 define BAUDRATE B115200 int open_port char port struct termios options int fd fd open port O_RDWR O_NOCTTY O_NDELAY if fd 1 printf open_port Unable to open the port else printf Port s with file descriptor 1 port fd fentl fd F_LSETFL FNDELA Y tcgetattr fd amp options cfsetispeed amp options BAUDRATE cfsetospeed amp options BAUDRATE options c_cflag I CLOCAL CREAD i 7 P 7 sS m tafi i oe X 4 a gt 4 f r Hiv i rH K j g A a Ek Reproduct
3. Reo forbidden without Telit Communications S p A written authorization Al Rights iu page 16 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Example of pppd_script Debug info from pppd debug kdebug 4 Most phones don t reply to LCP echos Icp echo failure 3 Icp echo interval 3 Keep pppd attached to the terminal Comment this to get daemon mode pppd nodetach The chat ane e sure to edit that file SE Serial Device to which the phone is connected dev ttyUSBx Serial port line speed 115200 dump The phone is not required to authenticate noauth user lt insert here the correct username for authentication gt name lt insert here the name of the connection gt password lt insert here the correct password for authentication gt If you want to use the HSDPA link as your gateway defaultroute pppd must not propose any IP address to the peer noipdeftault locp accept local locp accept remote Keep modem up even if connection fails persist Hardware flow control crtscts Ask the peer for up to 2 DNS server addresses usepeerdns No ppp compression nov nobsdcomp noviccomp nopcomp noaccomp For sanity keep a lock on the serial line lock Show password in debug messages show password thorization All Rights Reserved page 17 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 This scrip
4. wireless solutions Teli QC Linux USB Driver User Guide 1vv0300804 r7 04 11 2014 A Lr i jm ts 4 Ja a k A i Wi Wy wis A hk f e ree e eee 4 mM i i Making machines talk Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Disclaimer SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE Notice While reasonable efforts have been made to assure the accuracy of this document Telit assumes no liability resulting from any inaccuracies or omissions in this document or from use of the information obtained herein The information in this document has been carefully checked and is believed to be entirely reliable However no responsibility is assumed for inaccuracies or omissions Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes Telit does not assume any liability arising out of the application or use of any product software or circuit described herein neither does it convey license under its patent rights or the rights of others It is possible that this publication may contain references to or information about Telit products machines and programs programming or services that are not announced in your country Such references or information must not be construed to mean tha
5. KEE Fr a i x 3 Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 5 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 1 Introduction 1 1 Scope This user guide serves the following purpose Provides details about Telit QC based modems Explains how to compile and install the Linux USB option and qmi_wwan drivers Describes how software developers can use the functions of Linux device drivers to configure manage and use Telit modems 1 2 Audience This User Guide is intended for software developers who develop applications using Telit QC based modems and Linux 1 3 Contact Information Support Our aim is to make this guide as helpful as possible Keep us informed of your comments and suggestions for improvements For general contact technical support report documentation errors and to order manuals contact Telit s Technical Support Center at TS EMEA telit com TS NORTHAMERICA telit com TS LATINAMERICA telit com TS APAC telit com Alternatively use http www telit com en products technical support center contact php Telit appreciates feedback from the users of our information i 7 La amp m cd g j gt p 4 Le gt A i F i 4 A 5 4 sa T B y 8 2 3 a vg dotted or a IEN d e az Peace ps Reproduction forbidden without Telit Communication
6. DE910 Support New document organization ISSUE 3 2012 06 12 Added CE910 Support 4 Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 7 of 23 ISSUE 4 ISSUE 5 ISSUE 6 ISSUE 7 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 2013 02 20 Added LE920 and HE920 Support 2013 11 19 Added HE910 V2 and UE910 V2 Modified LE920 pid and interfaces 2014 10 27 Added LE910 and modified LE920 interfaces 2014 11 04 Added qmicli instructions for starting data connection with qmi F s 4 4 FI Af 4 P lt a i ry _ 3 is Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 8 of 23 Telit QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 2 System Setup In the first part of this chapter the general organization of the USB stack in Linux is described In the second part it is explained how to setup the system for using the module Please note that all the instructions provided in this guide are generic for further information refer to the documentation of your Linux distribution 2 1 Linux USB Drivers Structure USB drivers lie between the different kernel subsystems block net char etc and the USB hardware controllers The Linux USB core provides an interface for USB drivers to use and control the hardware without having to worry
7. PRODUCT CC864 DUAL CC864 SINGLE USB DEVICE TELIT VENDOR ID TELIT PRODUCT CC864 SINGLE CC864 KPS DE910 DUAL USB DEVICE TELIT VENDOR ID TELIT PRODUCT DE910 DUAL HE920 HE910 V2 CE910 DUAL USB DEVICE TELIT VENDOR ID TELIT PRODUCT CE910 DUAL UE910 V2 USB DEVICE TELIT VENDOR ID TELIT PRODUCT UE910 V2 Save the changes and close the file 2 3 1 1 Additional customization for LE910 and LE920 The LE910 and LE920 have the same USB interfaces configuration They require specific customization for not letting the driver option claim other USB interfaces needed by different drivers The driver option should not be bound to the interfaces 1 and 2 According to the kernel version different changes should be done in the option source code As an example we can consider the source code of the 3 7 kernel version First add the following struct static const struct option_blacklist_info telit_le920 blacklist reserved BIT 1 BIT 2 Then the following line should be added to the usb device id option ids structure USB_DEVICE TELIT VENDOR ID TELIT PRODUCT LE920 driver info kernel_ulong_t amp telit_le920 blacklist 2 3 2 Customizing the driver qmi_wwan When using LE910 or LE920 if the network interface is not recognized by the system it is possible that the driver should be customized Retrieve the appropriate kernel source code version for your system preferably with the distribution p
8. about the different types of controllers that are present on the system User VFS Block Net Char TTY layer layer layer layer layer Linux Kernel Upper APIs Lower APIs Hardware page 9 of 23 Telit QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 The USB Core subsystem provides specific APIs to support USB devices and host controllers Its purpose is to abstract all hardware or device dependent parts by defining a set of data structures macros and functions These functions can be grouped into an upper and a lower API layer the upper layer APIs are used by device drivers while the lower APIs are used by the host controllers When a device driver or a host controller is loaded in Linux using the modprobe command the USB core is also automatically loaded 2 2 Loading the drivers 2 2 1 Loading the driver option Linux OS includes a generic USB driver for GSM CDMA modems in the form of a kernel module called option according to the considered kernel version it is possible that the driver should be customized for working well with Telit modules Refer to chapter 2 3 1 for detailed instructions Most recent Linux distributions do not require any user action in order to load this driver it is enough to simply plug the USB cable If the modem is recognized by the operating system some devices named dev ttyUSBx will be created The number of devices varies according to the used module For example the UC
9. it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Prototype ssize_t write int fildes const void buf size_t nbyte Parameters fildes file descriptor buf destination buffer pointer nbyte number of bytes that write attempts to write Returns The number of bytes actually written if operation is completed successfully this number shall never be greater than nbyte otherwise it is 1 Example Write strlen value to be written bytes from the buffer pointed by value to be written to the file associated with the open file descriptor fd char value to be written dummy write if write fd value to be written strlen value_to_be_written lt 0 Error Management Routine else I Value Written 3 1 3 4 close The close function shall deallocate the file descriptor indicated by fildes To deallocate means to make the file descriptor available for return by subsequent calls to open or other functions that allocate file descriptors Header file unistd h Prototype int close int fildes Parameters fildes file descriptor Returns 0 if successfull 1 otherwise Example Close the ttyUSBx file k s i C gt f P Te E y 4 Af 4 FAG a A 4 Te ey gt gi Tal Sem Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 20 of 23
10. should be customized for working correctly with Telit modules Retrieve the appropriate kernel source code version for your system preferably with the distribution package system if any and unpack install it From the unpacking root directory open the file drivers usb serial option c Check for the existence of the proper define statement related to your module according to the following table UC864 E UC864 define TELIT PRODUCT UC864E 0x1003 E AUTO UC864 K UC864 WD UC864 WDU UC864 G define TELIT PRODUCT UC864G 0x1004 CC864 DUAL define TELIT PRODUCT CC864_ DUAL 0x1005 CC864 SINGLE define TELIT PRODUCT CC864 SINGLE 0x1006 CC864 KPS CC864 K SS DE910 DUAL define TELIT PRODUCT DE910 DUAL 0x1010 HE920 HE910 V2 CE910 DUAL define TELIT PRODUCT CE910 DUAL 0x1011 LE910 LE920 define TELIT PRODUCT LE920 0x1201 UE910 V2 define TELIT PRODUCT UE910 V2 0x1012 If not present add the statement y BA Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 12 of 23 lel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Then add the proper line in the usb device id option ids structure according to the following table UC864 E UC864 USB DEVICE TELIT VENDOR ID TELIT PRODUCT UC864E E AUTO UC864 K UC864 WD UC864 WDU USB DEVICE TELIT VENDOR ID TELIT PRODUCT UC864G USB DEVICE TELIT VENDOR ID TELIT
11. 864 G presents the following devices dev ttyUSBO dev ttyUSB1 dev ttyUSB2 dev ttyUSB3 Please note that AT commands are allowed on Modem and Auxiliary ports Refer to the following table for port setup details UC864 E UC864 E AUTO UC864 K UC864 WD UC864 WDU CC864 SINGLE CC864 KPS UC864 G CC864 DUAL DE910 DUAL HE920 HE910 V2 ttyUSBO Modem port ttyUSB1 Diagnostic port ttyUSB2 Auxiliary port ttyUSBO Modem port ttyUSB1 Diagnostic port ttyUSB2 NMEA port ttyUSB3 Auxiliary port ttyUSBO Diagnostic port ttyUSB1 NMEA port ttyUSB2 Auxiliary port ttyUSB3 Modem port 4 J p Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 10 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 ttyUSB1 Modem port LE910 LE920 ttyUSBO Diagnostic port ttyUSB1 NMEA port ttyUSB2 Modem port 1 ttyUSB3 Modem port 2 ttyUSB4 SAP port UE910 V2 ttyUSBO Diagnostic port ttyUSB1 Auxiliary port ttyUSB2 Modem port If no devices are created in your system check for the existence of the kernel module Ismod grep option If no entries are found load the kernel module with root privileges modprobe option If an error response is returned such as FATAL Module option not found the meaning is that the kernel module is not present in your
12. V2 7 TEN tion All Rights Reserved page 4 of 23 i Ll Soa H 7 E 5 amp n fi 3 v 4 a 7 y f 44 A s o i ed i m nm REE P p m maa i i aa Reproduction forbidden without Telit Communications S p A written authoriza Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Contents T PIVOT OCU UO SORESESEREBE SER E BES EOR ES SE RENSES N E O DEER BE SEE BESES BSA DES RSS IR ENEDES 6 MD SCOPO sesaria AEE E E AEE EEEE E 6 PP E i 8 AA AA E E NE EN A E N NAA A E E RE SE RE REDE 6 1 3 Contact Information SUP POV ssosdssveiscdvavessctsencanesteveacesssweicndvavessodecnsavcsvewvasesesweieesvaswasocenssanesvaveavesceusesess 6 L OIC OVE VIEW sass sca es ccna sc aetene de saves ce veusarsiveuessuuedvesedeveusessevcesacsuieusscuesveieduvevessseseceacsutnuesceeeaverss 7 1 5 Document OFC ISIN sosssccesiessscsssveceisecctsscvecessscustnssicsssvasciseuscesseotessscssensssaseiverdcevestnessoeenssdeseessscsetverdss 7 MG TEC OMA MING oa aoe sce stones esc N es cs ce es esse gs ates esa cua sess esa TE E T 7 L R ALE DO CUNMOIIGS esasccrsececneceesstarscscecescaecevesusecactondscatesceesacnsetucetesseececnocseseiensaseadususesstucctececneessoetessnecaseess 7 LS Document History cisscescehesccseccsesedcsvevesccstonssicoteccuscacsesadcevetnescotvessicetecauneacsessi cx sssaesietnecseconecesteeseessicasevaes es 7 D ASV SLCTIE CID BESES E A E E A 8 2 1 Linux USB Driyers Structure cas cesnscassadeccas
13. ackage system if any and unpack install it From the unpacking root directory open the file se a Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 13 of 23 lel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 drivers net usb qmi_wwan c LE920 VID PID and interface info should be added to the driver source code According to the kernel version different changes should be done in the source code As an example we can consider the source code of the 3 7 kernel version The following line should be added to the usb device id products structure QMI FIXED INTF 0x1bc7 0x1201 2 Telit LE920 2 3 3 Compiling the drivers From the unpacking root directory of your kernel run the kernel configuration system e g menuconfig Configure the kernel according to the considered system configuration then browse through the menus Device Drivers USB Support USB Serial Converter support and choose to build USB driver for GSM and CDMA modems as a module U5 Navman GPS device MEW USB Prolific 2303 Single Port Serial Driver NEW USB Ours Technology Inc OTi 6859 USB To RS232 Bridge Controller EXPERIMENTAL NEW USB HP4 Calculators support MEI USB Safe Serial Encapsulated Driver EXPERIMENTAL NEW USE Sierra Wireless Driver NEW TI 3410 5052 Serial Driver MEL USE REINER SCT cyberJack pinpad e co
14. cotessascsssneedsadsssssestencsscotanssaveesessdcassesescetousddcotossescsesesedcossssestes 9 22 Ladino he CIV CES SEE E 10 2 2 1 Loading the driver OPUOM isos rer nea enn SEENTE EE En ENE EAEE EEEE RA 10 2 2 2 Loading the driver qmi _WWan is s 00sdsacessdanssnoniaenserasivnseonsdossenssanneesasisasevasaensoossdensanddtsascesssouduedsaeesesnsdenstadsteees 11 EN TITER CNG CV OLS TE E E A E T A TN T E A 12 PAR te i Gai IS To La DA TET SR hediyen 000 sasear Te E PANA ee en 12 2 3 1 1 Additional customization for LE910 and LE920 0 0 eeccccccccccsssseeeececeeeaeeeseecceeeeeaaeeeeeeeeeeeaaenes 13 2 3 2 Customizing the driver qmi WWan ccccssscccccecssessscceeccceeeeessseeeecceeeeessseeeeceeeeeessaeeeeeceeeeeesaeeeeeceeeeessaeeeeees 13 2 9 3 Compline the EY CLS rense En ae reed pe ke ED ken arrede 14 i RE USUI TV ENEA AA E A A A 16 3 1 Usine the driver 1 27 178 sssasesscsiesssssasancssennasenssnvaddsdenbawssiansaadsdausibesssavasdadesduscssasseadsdessstesasesacesdssawessiusoness 16 SE Ee OMNI 9 E EEA AE S ONA E E A E E E E O E E OEE 16 Jee Create PPP 10 141 12120 6 ea EEE EEEE AEEA 16 SEERE REE E eara E EE EEE AAEE ENEA EE EEEE ATA E 18 3 1 3 1 EO ES EE N TEE TE EA ETE E E E E T 18 PES A e E AE E E E E A A E ERE ere 19 WO e EEA E E A E E A E 19 3 1 3 4 EA A E PE AE EEEE SE SEES ES SETE E A TIA IEA A EAEE A TEES EE 20 LERE O e E N N 21 3 2 Usine the driver qmi WA arsen deesses saoer reri a EE EPEE EEE a E EEEE 22 SER
15. em protocol helper library It can be used for starting the data connection on the network interface of the modem with the following steps 2 b i a i eX gt i i wd E y ag i oo A SK P ie SF ee Rg y ar d 2 ai ve _ 2S bas fa a 45 i i a fig f g 7 1 A Ca y Se A T a r n x 5 re Ba Sa TENEN kaan 4 Y FE ER sr Far Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 22 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Through dev ttyUSBx send the following AT command AT CGDCONT 1 IPV4V6 lt apn name gt From a root shell type ifconfig wwan0 up qmicli d dev cdc wdm0 wds start network client no release cid dhclient wwan0O Check if the network interface has a valid ip address ifconfig wwan0 qmicli is a command line tool available in the libqmi package Please note that this is only an example of usage The suggested commands can be different depending on the libqmi version and the system used For detailed instructions and further documentation please refer to the project website pri f 7 H _ Ss tafi r Bi gt KT S J PN a 4 a z Ud 4 72 VA a di G i ij 4 P i i LTR 7 F ta z z r 4 ev a a j 3 ae E 2 a eo 3 i Reproduction forbidden without Telit Communications S p A wr
16. entation may be reproduced transmitted transcribed stored in a retrieval system or translated into any language or computer language in any form or by any means without prior written permission of Telit High Risk Materials Components units or third party products used in the product described herein are NOT fault tolerant and are NOT designed manufactured or intended for use as on line control equipment in the following hazardous environments requiring fail safe controls the operation of Nuclear Facilities Aircraft Navigation or Aircraft Communication Systems Air Traffic Control Life Support or Weapons Systems High Risk Activities Telit and its supplier s specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities Trademarks TELIT and the Stylized T Logo are registered in Trademark Office All other product or service names are the property of their respective owners Copyright Telit Communications S p A 2014 Ae rodiiction forbidden without Telit Communications S p A written authorization Al Rights Reserved page 3 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 Applicable Products Product Supported Ni UC864 E UC864 G UC864 WDU UC864 WD UC864 E AUTO UC864 K CC864 DUAL CC864 SINGLE CC864 KPS DE910 DUAL CE910 DUAL LE920 LE910 HE920 UE910 V2 HE910
17. ighted computer programs including the exclusive right to copy or reproduce in any form the copyrighted computer program Accordingly any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit products described in this instruction manual may not be copied reverse engineered or reproduced in any manner without the express written permission of Telit or the 3rd Party SW supplier Furthermore the purchase r TE CA i Se i p big Aa L 2 i j y orm T A m a n TTEN Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 2 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 of Telit products shall not be deemed to grant either directly or by implication estoppel or otherwise any license under the copyrights patents or patent applications of Telit or other 3rd Party supplied SW except for the normal non exclusive royalty free license to use that arises by operation of law in the sale of a product Usage and Disclosure Restrictions License Agreements The software described in this document is the property of Telit and its licensors It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement Copyrighted Materials Software and documentation are copyrighted materials Making unauthorized copies is prohibited by law No part of the software or docum
18. ion forbidden without Telit Communications S p A written authorization ae ol All Rights Reserved page 21 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 options c cflag amp CSIZE PARENB CSTOPB CSIZE options c_cflag l CS8 options c_cflag amp CRTSCTS options c_Iflag amp ICANON ECHO ECHOE ISIG options c_iflag amp IXON IXOFF IXANY ICRNL INLCR IGNCR options c_oflag amp OPOST if tcsetattr fd TCSANOW amp options 1 printf Error with tcsetattr s n strerror errno else printf s n succeed return fd int main int serialFD open_port USB char buf BUFSIZE memset buf 0 BUFSIZE write serialFD AT r strlenC AT r sleep 1 read serialFD buf BUFSIZE printf The string is s n buf close serialFD return 0 The sleep instruction is necessary because the response of the modem after issuing the command AT is not immediate so you need to wait a bit before reading Obviously there are more efficient ways to do this that is for example put the read call in a while loop and exit when the read buffer contains a certain string 3 2 Using the driver qmi_wwan To use the network interface exported by LE910 and LE920 a modem manager with support for QMI is recommended The libqmi project cgit freedesktop org libqmi is an open source QMI mod
19. itten authorization All Rights Reserved page 23 of 23
20. m chipcard reader EXPERIMENTAL NEU USE Mircom 7 Entreara Single Port Serial Driver MEW PP A RR A GR LER anal ec ie ie ae Ed USB ZyXEL omni net LCD Plus Driver EXPERIMENTAL CNEL USI Debugging Device ME lt Exit gt lt Help gt ee ny When using the LE920 browse through the menus Device Drivers Network Device Support USB Network Adapters and choose to build QMI WWAN driver for Qualcomm MSM based 3G and LTE modems as a module Once configured start the build The kernel module option ko can be found in the directory drivers usb serial while the module qmi_wwan ko can be found in the directory drivers net usb If the kernel has been previously already built the module can be compiled simply typing make M drivers usb serial y BA Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 14 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 for option or make M drivers net usb for qmi_wwan The modules can then be loaded using modprobe or insmod In order to avoid runtime loading the drivers should not be built as a modules but as parts of the kernel This is the suggested configuration for Android devices 4 J a Ud gt 7 a F ni 1 4 m 4 A p Tira i i p 4 i A 4 E ie STS Wa K 2 y e a 2 TEN Rep
21. roduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 15 of 23 Tel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 3 Using the module 3 1 Using the driver option 3 1 1 Shell commands For testing the serial ports created by the driver type in a shell replace the name of the device with the proper one cat dev ttyUSBx amp it echo en ATEO r gt dev ttyUSBx echo en AT r gt dev ttyUSBx in order to print on standard output the answer of the modem to the command ATEO r and AT r Please note that sending the command ATEO is mandatory otherwise there could be issues in the terminal output 3 1 2 Create a PPP connection Most recent Linux distributions have GUI tools for creating PPP connections the following instructions are for creating a PPP connection through command line interface PPP support needs to be compiled into the kernel pppd and chat programs are also needed pppd needs two scripts the first script performs the environment setting and calls the second script used by the chat program For creating a PPP connection type pppd file etc pppd_script amp 1 The use of ATEO echo disabled before any other AT command is necessary because it prevents the sending receiving of spurious characters to from the modem when used in interaction with the Linux commands echo and cat Na
22. s S p A written authorization All Rights Reserved page 6 of 23 lel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 1 4 Product Overview For modem features please refer to the chosen modem user guide 1 5 Document Organization This manual contains the following chapters e Chapter 1 Introduction provides a scope for this manual target audience technical contact information and text conventions e Chapter 2 System Setup describes how to setup the system before using the USB driver e Chapter 3 Using the module details USB device driver use and shows how software developers can use it to interact with the modem through shell commands and C programming How to Use If you are new to the chosen product it is recommended to start by reading the related Hardware User Guide and Product Description in their entirety to better understand how the modem driver works 1 6 Text Conventions This section lists the paragraph and font styles used for the various types of information presented in this user guide Format Content Arial Linux shell commands filesystem paths and example C source code 1 7 Related Documents All documentation can be downloaded from Telit official web site www telit com if not otherwise indicated 1 8 Document History Revision Date Changes ISSUE 0 2009 01 30 First Release ISSUE 1 2010 01 13 Added CC864 Support Applied new layout ISSUE 2 2012 02 13 Added
23. system and it should be built Refer to the next chapter for generic instructions 2 2 2 Loading the driver qmi_wwan The LE910 and LE920 export also a network interface that can be used when the driver qmi_wwan is available since the 3 4 version of the vanilla kernel According to the considered kernel version it is possible that the driver should be customized for working well with Telit modules Refer to chapter 2 3 2 for detailed instructions If the driver is correctly loaded by the operating system a network interface named wwanx e g wwanQ will be created For checking the network interface presence the ifconfig command can be used ifconfig a If no network interface is created in your system check for the existence of the kernel module Ismod grep qmi_wwan If no entry is found load the kernel module with root privileges ra Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 11 of 23 lel it QC Linux USB Driver Software User Guide 1vv0300804 r7 04 11 2014 modprobe qmi_wwan If an error response is returned such as FATAL Module gmi_wwan not found the meaning is that the kernel module is not present in your system and it should be built Refer to the next chapter for generic instructions 2 3 Building the drivers 2 3 1 Customizing the driver option If the modem is not recognized by the system it is possible that the driver
24. t Telit intends to announce such Telit products programming or services in your country Copyrights This instruction manual and the Telit products described in this instruction manual may be include or describe copyrighted Telit material such as computer programs stored in semiconductor memories or other media Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive rights for copyrighted material including the exclusive right to copy reproduce in any form distribute and make derivative works of the copyrighted material Accordingly any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied reproduced distributed merged or modified in any manner without the express written permission of Telit Furthermore the purchase of Telit products shall not be deemed to grant either directly or by implication estoppel or otherwise any license under the copyrights patents or patent applications of Telit as arises by operation of law in the sale of a product Computer Software Copyrights The Telit and 3rd Party supplied Software SW products described in this instruction manual may include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor memories or other media Laws in the Italy and other countries preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyr
25. t calls the option connect using the script hsdpa_connect following there is an example of this script bin sh Connection to the network AT CGDCONT 1 IP lt insert here the correct APN provided by your network operator gt Dial the number OK ATD 99 1 The modem is waiting for the following answer CONNECT After launching a PPP connection is possible to use ftp protocol or other utilities that allow the access to the Internet 3 1 3 C programming The following paragraphs show all the functions that can be used from C source code to perform read write operations on the serial devices 3 1 3 1 open The open function shall establish the connection between a file and a file descriptor The file descriptor is used by other I O functions to refer to that file Header file fcntl h Prototype int open const char pathname int flags Parameters pathname file name with its own path flags is an int specifying file opening mode is one of O RDONLY O_WRONLY or O_RDWR which request opening the file read only write only or read write respectively Returns The new file descriptor fildes if successfull 1 otherwise Example Open the dev ttyUSBx int fd file descriptor for the dev ttyUSBx entry if fd open dev ttyUSBx O_RDONLY lt 0 Sa as 223 f gt gt s i s v La 4 f We t 185 4 i f a L Pa A i s mm 4 G s p A al m f i TEN
Download Pdf Manuals
Related Search