18
UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12 www.quectel.com

WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

Embed Size (px)

Citation preview

Page 1: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UC20 WinCE RIL Driver

User Guide

UMTS/HSPA Module Series

Rev. UC20_RIL_USB_Driver_User_Guide_V1.0

Date: 2013-08-12

www.quectel.com

Page 2: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 1 / 17

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: [email protected]

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, 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. 2013. All rights reserved.

Quectel

Confidential

Page 3: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 2 / 17

About the document

History

Revision Date Author Description

1.0 2013-08-12 Wythe WANG Initial

Quectel

Confidential

Page 4: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 3 / 17

Contents

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

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

Figure Index ................................................................................................................................................. 4

1 Introduction .......................................................................................................................................... 5

2 System Integrating ............................................................................................................................... 6

2.1. Introduction to Driver Package ................................................................................................ 6

2.2. Integrate RIL Driver Files......................................................................................................... 6

2.2.1. Check System Component .............................................................................................. 6

2.2.2. Copy Files ........................................................................................................................ 7

2.2.3. Modify the Platform.reg .................................................................................................... 7

2.2.4. Modify the Platform.bib .................................................................................................... 7

2.2.5. Rebuild and Create System Image .................................................................................. 8

2.2.6. Load Testing ..................................................................................................................... 8

3 Create PPP Connection ....................................................................................................................... 9

4 Appendix A Reference ....................................................................................................................... 17

Quectel

Confidential

Page 5: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 4 / 17

Figure Index

FIGURE 1: RIL DRIVER PACKAGE STRUCTURE ............................................................................................ 6

FIGURE 2: RIL DRIVER PACKAGE STRUCTURE ............................................................................................ 7

FIGURE 3: OPEN CONTROL PANEL ................................................................................................................. 9

FIGURE 4: CLICK NETWORK AND DIAL-UP CONNECTIONS ....................................................................... 10

FIGURE 5: CLICK MAKE NEW CONNECTION ............................................................................................... 10

FIGURE 6: MAKE NEW CONNECTION INTERFACE ....................................................................................... 11

FIGURE 7: MODEM SELECTION INTERFACE ................................................................................................ 11

FIGURE 8: SELECT “QUECTEL UC20 HSUSB MODEM” ............................................................................... 12

FIGURE 9: CONNECTION PROPERTIES ........................................................................................................ 12

FIGURE 10: SET APN ....................................................................................................................................... 13

FIGURE 11: SET PHONE NUMBER ................................................................................................................. 13

FIGURE 12: ADD NEW CONNECTION OK ...................................................................................................... 14

FIGURE 13: DIAL-UP CONNECTION INTERFACE ......................................................................................... 14

FIGURE 14: ADD USER NAME AND PASSWORD .......................................................................................... 15

FIGURE 15: BEGIN TO SET-UP PPP CONNECTION ..................................................................................... 15

FIGURE 16: PPP CONNECTED ....................................................................................................................... 16

FIGURE 17: SURF INTERNET ......................................................................................................................... 16

Quectel

Confidential

Page 6: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 5 / 17

1 Introduction

This document mainly introduces how to integrate the RIL driver for UC20 module in WinCE 6.0 OS, and

how to use PPP dial function without RIL.

Quectel

Confidential

Page 7: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 6 / 17

2 System Integrating

UC20 provides USB driver and RIL driver for WinCE6.0. Before you integrate RIL driver, please make

sure that UC20 USB driver for WinCE6.0 has been installed successfully (please refer to

UC20_WinCE_USB_Driver_User_Guide).

2.1. Introduction to Driver Package

RIL driver package includes BINARY and REG folder. qlril.dll is stored in BINARY folder. qlril.reg,

matching with qlril.dl, is stored in REG folder. Please refer to the structure of driver package as below:

Figure 1: RIL Driver Package Structure

2.2. Integrate RIL Driver Files

To integrate WinCE RIL driver, please add the driver BINARY and REG files in your system. When you

start the integration, you should follow the steps as below:

2.2.1. Check System Component

RIL driver transforms the RIL request from application layer into AT commands, and then send them to

UC20 module. You need to enable some system components under the options of kernel, before using

RIL driver in your system board. For WinCE6.0, VS2005 is the main development tool,which ensures you

to choose the necessary option in “Catalog Items View”, shown as below:

Quectel

Confidential

Page 8: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 7 / 17

Figure 2: RIL Driver Package Structure

2.2.2. Copy Files

Please copy the qlril.dll and qlril.reg in the driver package to your BSP project folder, i.e.

C:\WINCE600\PLATFORM\<TARGETBSP>\FILES.

Please do remember to change <TARGETBSP> as your own BSP directory name.

2.2.3. Modify the Platform.reg

Add the below line at the end of platform.reg.

#include “$(_PLATFORMROOT)\<TARGETBSP>\FILES\qlril.reg”

2.2.4. Modify the Platform.bib

Add the following comment in Module section of platform.bib.

NOTE

Quectel

Confidential

Page 9: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 8 / 17

MODULES

..

..

qlril.dll $(_PLATFORMROOT)\(TARGETBSP)\FILES\qlril.dll NK SHK

..

..

2.2.5. Rebuild and Create System Image

After you have done the four steps above, you need to execute “clean sysgen” command to rebuild your

project and create the new system image.

2.2.6. Load Testing

Install the new image to your target board and reboot it. The new system will load the RIL driver

automatically. You can make phone-call or send short message via RIL API to test whether RIL is loaded

successfully.

Quectel

Confidential

Page 10: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 9 / 17

3 Create PPP Connection

For RIL users, you should use the USB AT Port as the AT channel for RIL to do the VOICE CALL and SMS

service, and use USB Modem port for PPP connection on “Network and Dial-up Connections” system

options. It is simple to set up PPP dial-up over UC20 module with the new PPP connection. When PPP

dial-up is established, you can enjoy surfing the Internet. The method of creating PPP connection is given

as below:

1. Open and Enter “Control Panel”.

Figure 3: Open Control Panel

2. Double Click “Network and Dial-up Connections”

Quectel

Confidential

Page 11: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 10 / 17

Figure 4: Click Network and Dial-up Connections

3. Enter Window Interface below:

Figure 5: Click Make New Connection

4. Double click the “Make New Connection” and the pop-up box below is displayed:

Quectel

Confidential

Page 12: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 11 / 17

Figure 6: Make New Connection Interface

5. Click the “Next” button:

Figure 7: Modem Selection Interface

6. Select the “Quectel UC20 HSUSB Modem” on the pull-down menu:

Quectel

Confidential

Page 13: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 12 / 17

Figure 8: Select “Quectel UC20 HSUSB Modem”

7. Click the “Configure” button:

Figure 9: Connection Properties

8. Select “Call Options” and configure the APN in the “Extra Settings” text-box. For example, if you use

SIM Card of CHINA-UNICOM, and you need to set “3gnet” for CHINA-UNICOM to your APN:

Quectel

Confidential

Page 14: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 13 / 17

Figure 10: Set APN

9. Click “OK” and click “Next” button, it goes to the interface of phone number configure. Then, fill “*99#”

in the Phone number text-box:

Figure 11: Set Phone number

10. Click “Finish” button and a new icon named “My Connection” will appear in this window:

Quectel

Confidential

Page 15: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 14 / 17

Figure 12: Add new connection OK

11. Double click “My Connection” icon:

Figure 13: Dial-up Connection Interface

12. Fill in user name and password of PPP dial-up in the text-box. It uses „“wap” both as User Name and

Password here:

Quectel

Confidential

Page 16: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 15 / 17

Figure 14: Add User Name and Password

13. Click “Connect” button to set up the PPP connection:

Figure 15: Begin to set-up PPP connection

14. Usually, the PPP dial-up will be connected in several seconds:

Quectel

Confidential

Page 17: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 16 / 17

Figure 16: PPP Connected

15. Finally, you can surf the Internet on your WinCE board:

Figure 17: Surf Internet

Quectel

Confidential

Page 18: WinCE RIL Driver User Guide - quectel.com · UC20 WinCE RIL Driver User Guide UMTS/HSPA Module Series Rev. UC20_RIL_USB_Driver_User_Guide_V1.0 Date: 2013-08-12

UMTS/HSPA Module UC20 WinCE RIL Driver User Guide

UC20_WinCE_RIL_Driver_User_Guide Confidential / Released 17 / 17

4 Appendix A Reference

Table 1: Terms and Abbreviations

Abbreviation Description

OS Operating System

RIL Radio Interface Layer

BSP Board Support Package

Quectel

Confidential