Quectel Android Linux CMUX Driver User Guide V1.0

User Manual: Pdf

Open the PDF directly: View PDF PDF.
Page Count: 8

Android & Linux
CMUX Driver User Guide
Rev. Android&Linux_CMUX_Driver_User_Guide_V1.0
Date: 2014-05-21
www.quectel.com
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 1 / 7
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Office 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 IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
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.
Copyright © Quectel Wireless Solutions Co., Ltd. 2014. All rights reserved.
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 2 / 7
About the Document
History
Revision
Date
Author
Description
1.0
2014-05-21
Joe WANG
Initial
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 3 / 7
Contents
About the Document ................................................................................................................................... 2
Contents ....................................................................................................................................................... 3
1 Introduction .......................................................................................................................................... 4
2 System Integration ............................................................................................................................... 5
2.1. The Structure of CMUX ............................................................................................................. 5
2.2. Driver Integration ....................................................................................................................... 5
2.2.1. Get CMUX Driver Source Code ....................................................................................... 5
2.2.2. Compile Driver ................................................................................................................. 5
2.2.3. Parameters Instruction ..................................................................................................... 6
3 Appendix A Reference ......................................................................................................................... 7
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 4 / 7
1 Introduction
This document mainly introduces how to integrate the CMUX driver into Android or Linux OS for Quectel
wireless module.
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 5 / 7
2 System Integration
This chapter describes the structure of Android and Linux CMUX driver and explains how to integrate the
CMUX driver into Android or Linux OS for Quectel wireless module.
2.1. The Structure of CMUX
The multiplexer provides several virtual connections between TE and MS. TE and MS communicate with
each other through the virtual channel. And each channel between TE and MS is called Data Link
Connection (DLC) and established separately and sequentially. Each DLC may have individual flow
control procedures for buffer management and the aggregate link also has overall flow control
mechanisms.
TE MS
TE Process
Convergence
Layer
Multiplexer
Layer
Physical Layer
Serial link
MS Process
Convergence
Layer
Multiplexer
Layer
Physical Layer
Serial link
Figure 1: CMUX Structure
2.2. Driver Integration
2.2.1. Get CMUX Driver Source Code
Quectel provides the CMUX source code, please contact Quectel technical support to get it.
2.2.2. Compile Driver
CMUX driver only has one file named “gsm0710muxd_bp.c”, you can use the following command to
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 6 / 7
compile CMUX driver:
"gcc -o gsm0710muxd_bp gsm0710muxd_bp.c -lpthread"
For embedded system, you should use cross compiler to compile.
2.2.3. Parameters Instruction
1. Here are all parameters for CMUX driver:
- -d: Fork, get a daemon [yes]
- -v: Set verbose logging level. 0 (Silent) - 7 (Debug) [6]
- -s: <serial port name>: Serial port device to connect to [/dev/ttyS0]
- -c: <hardware flow control>: Hardware flow control [disabled]
- -t: <timeout>: Reset modem after this number of seconds of silence [0]
- -P: <pin-code>: PIN code to unlock SIM [-1]
- -p: <number>: Use ping and reset modem after this number of unanswered pings [0]
- -b: <baudrate>: Mode baudrate [115200]
- -m: <modem>: Mode (basic, advanced) [basic]
- -f: <framsize>: Frame size [130]
- -n: <number of ports>: Number of virtual ports to create, must be in the range of 1-31 [3]
- -o: <output log to file>: Output log to /tmp/gsm0710muxd.log [no]
- -h: Show this help message and show current settings.
Parameters in “[]” are the default values.
2. Here are several parameters which are used frequently:
- -s: <serial port name>: Serial port device to connect [/dev/ttyS0]
- -n: <number of ports>: Number of virtual ports to create, must be in the range of 1-31 [3]
- -b: <baudrate>: Mode baudrate [115200]
3. Example of how to run CMUX driver:
gsm0710muxd_bp -s /dev/ttyS0 -b 115200 -n 3
When CMUX driver is working, it will create several pts files in /dev/pts, and also create several links in
/dev/chn. It is better to use links than pts files, because links are always named from 1 to N (N is the
parameter you set), while pts files maybe not.
4. Debug
-v: Set verbose logging level. 0 (Silent) - 7 (Debug) [6]
If debug is needed, set parameter “-v” value to 7 to print all debug message.
Quectel
Confidential
Android & Linux CMUX Driver User Guide
Android & Linux_CMUX_Driver_User_Guide Confidential / Released 7 / 7
3 Appendix A Reference
Table 1: Terms and Abbreviations
Description
Data Link Connection
Operating System
Terminal Equipment
Mobile Station
Quectel
Confidential

Navigation menu