41
WWAN Toolkit User’s Guide

WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Embed Size (px)

Citation preview

Page 1: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

WWAN Toolkit

User’s Guide

Page 2: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

ii WWAN Toolkit User’s Guide

Intermec Technologies Corporation

Worldwide Headquarters6001 36th Ave.W.Everett, WA 98203U.S.A.

www.intermec.com

The information contained herein is provided solely for the purpose of allowing customers to operate and service Intermec-manufactured equipment and is not to be released, reproduced, or used for any other purpose without written permission of Intermec Technologies Corporation.

Information and specifications contained in this document are subject to change without prior notice and do not represent a commitment on the part of Intermec Technologies Corporation.

© 2006-2011 by Intermec Technologies Corporation. All rights reserved.

The word Intermec, the Intermec logo, Norand, ArciTech, Beverage Routebook, CrossBar, dcBrowser, Duratherm, EasyADC, EasyCoder, EasySet, Fingerprint, INCA (under license), i-gistics, Intellitag, Intellitag Gen2, JANUS, LabelShop, MobileLAN, Picolink, Ready-to-Work, RoutePower, Sabre, ScanPlus, ShopScan, Smart Mobile Computing, SmartSystems, TE 2000, Trakker Antares, and Vista Powered are either trademarks or registered trademarks of Intermec Technologies Corporation.

There are U.S. and foreign patents as well as U.S. and foreign patents pending.

Page 3: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Document Change Record This page records changes to this document. The document was originally released as P/N 1-960641-01.

Version Number Date Description of Change

002 12/2011 This document was revised to:• Remove information for the Connectivity API, which is no

longer supported.• Remove information for the 700 Series Mobile Computers.• Include information for the 70 Series Mobile Computers.

001 09/2009 This document was revised to:• Support software release 5.4. • Include information on the CN4 and CN50 mobile computers. • Change the part number from 1-960641-04 to 934-053-001.

04 03/2007 This document was revised to support software release 5.3.

03 10/2006 This document was revised to support software release 5.2. Added references to the CN3 mobile computer.

WWAN Toolkit User’s Guide iii

Page 4: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

iv WWAN Toolkit User’s Guide

Page 5: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Contents

ContentsBefore You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Safety Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiSafety Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiGlobal Services and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Warranty Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiWeb Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiSend Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiTelephone Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Who Should Read This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiRelated Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

1 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

About the WWAN Toolkit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Downloading and Installing the WWAN Toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Developing Applications in Different Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3C++ Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.NET Development (C# and VB.NET) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Java Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Core API Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Using the WWAN Toolkit API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Initiating the Toolkit and Radio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Powering On the Radio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Setting Up the Toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Ensuring the Modem is Responding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Checking if a PIN Code is Required (GSM/UMTS) . . . . . . . . . . . . . . . . . . . . . . . . . . .5Selecting Network Operator (GSM Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Setting Up Event Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Shutting Down the Toolkit and the Radio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Shutting Down the Toolkit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Powering Off the Radio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

About Data WWAN Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Types of Data Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Methods to Call Data Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

Creating a WWAN Connection Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Creating Dialing Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Creating a RAS Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Linking the New RAS Entry to Connection Manager. . . . . . . . . . . . . . . . . . . . . . . . . .7

Removing a WWAN Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Removing the RAS Entry Link From Connection Manager . . . . . . . . . . . . . . . . . . . .7Deleting the RAS Entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Deleting the Dialing Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Establishing the WWAN Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Checking for Signal Strength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8Checking for PSD Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8Setting Up GPRS APN (GSM ONLY) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

WWAN Toolkit User’s Guide v

Page 6: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Contents

Establishing the WWAN Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8Dropping the WWAN Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

2 Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

About the Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12DataCom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Phone Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15SimPin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16SMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17VoiceDialer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

3 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

Network Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Development Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Connection Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Operating System Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

4 WWAN Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

vi WWAN Toolkit User’s Guide

Page 7: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Before You Begin

Before You BeginThis section provides you with safety information, technical support information, and sources for additional product information.

Safety Summary Your safety is extremely important. Read and follow all warnings and cautions in this document before handling and operating Intermec equipment. You can be seriously injured, and equipment and data can be damaged if you do not follow the safety warnings and cautions.

Do Not Repair or Adjust AloneDo not repair or adjust energized equipment alone under any circumstances. Someone capable of providing first aid must always be present for your safety.

First AidAlways obtain first aid or medical attention immediately after an injury. Never neglect an injury, no matter how slight it seems.

ResuscitationBegin resuscitation immediately if someone is injured and stops breathing. Any delay could result in death. To work on or near high voltage, you should be familiar with approved industrial first aid methods.

Energized EquipmentNever work on energized equipment unless authorized by a responsible authority. Energized electrical equipment is dangerous. Electrical shock from energized equipment can cause death. If you must perform authorized emergency work on energized equipment, be sure that you comply strictly with approved safety regulations.

Safety InformationYour safety is extremely important. This section explains how to identify notes that are in this document.

Global Services and SupportWarranty InformationTo understand the warranty for your Intermec product, visit the Intermec website at www.intermec.com and click Support > Returns and Repairs > Warranty.

Note: Notes either provide extra information about a topic or contain special instructions for handling a particular condition or set of circumstances.

WWAN Toolkit User’s Guide vii

Page 8: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Before You Begin

Web SupportVisit the Intermec website at www.intermec.com to download our current manuals (in PDF). To order printed versions of the Intermec manuals, contact your local Intermec representative or distributor.

Visit the Intermec technical knowledge base (Knowledge Central) at intermec.custhelp.com to review technical information or to request technical support for your Intermec product.

Send FeedbackYour feedback is crucial to the continual improvement of our documentation. To provide feedback about this manual, please contact the Intermec Technical Communications department directly at [email protected].

Telephone SupportIn the U.S.A. and Canada, call 1-800-755-5505.

Outside the U.S.A. and Canada, contact your local Intermec representative. To search for your local representative, from the Intermec website, click About Us > Contact Us.

Service Location SupportFor the most current listing of service locations, go to www.intermec.com and click Support > Returns and Repairs > Repair Locations.

For technical support in South Korea, use the after service locations listed below:

AWOO Systems102-1304 SK Ventium522 Dangjung-dongGunpo-si, Gyeonggi-do Korea, South 435-776Contact: Mr. Sinbum KangTelephone: +82-31-436-1191Email: [email protected]

IN Information System PTD LTD6th FloorDaegu Venture Center Bldg 95Shinchun 3 DongDonggu, Daegu City, KoreaEmail: [email protected] or [email protected]

Who Should Read This ManualThis document is written for the person who is responsible for installing, configuring, and maintaining your Intermec device.

This document provides you with information about the features of the WWAN Toolkit.

Before you work with the WWAN Toolkit, you should be familiar with your network and general networking terms, such as IP address.

viii WWAN Toolkit User’s Guide

Page 9: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Before You Begin

Related DocumentsThis is a list of related Intermec documents.

• WWAN Toolkit Programmer’s Reference Manual

• CN3 Mobile Computer User’s Manual for Windows Mobile 5.0

• CN3 Mobile Computer User’s Manual for Windows Mobile 6.1

• CN4 Mobile Computer User’s Manual

• CN50 Mobile Computer for Windows Mobile 6.1 User’s Manual

• CN50 Mobile Computer for Windows Embedded Handheld Mobile 6.5 User’s Manual

• CS40 Mobile Computer User’s Manual

• 70 Series Mobile Computer User’s Manual

The Intermec website at www.intermec.com contains our documents (as PDF files) that you can download for free.

To download documents1 Visit the Intermec website at www.intermec.com.

2 Click the Products tab.

3 Using the Products menu, navigate to your product page. For example, to find the CN4 computer product page, click Computers > Handheld Computers > CN4.

4 Click the Manuals tab.

If your product does not have its own product page, click Support > Manuals. Use the Product Category, the Product Family, and Product to help find your documentation.

WWAN Toolkit User’s Guide ix

Page 10: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Before You Begin

x WWAN Toolkit User’s Guide

Page 11: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

1

Getting Started

This chapter covers the following topics:

• About the WWAN Toolkit

• Downloading and Installing the WWAN Toolkit

• Developing Applications in Different Environments

• Using the WWAN Toolkit API

1

Page 12: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

About the WWAN ToolkitThe Intermec WWAN Toolkit is a powerful Software Development Kit used to easily build mobile applications that facilitate communication across cellular networks. The Toolkit gives developers the freedom to focus on a core design task without considering issues in the periphery, such as choosing the correct communication standard or keeping the application up-to-date with recent OS upgrades.

The WWAN Toolkit supports both the GSM and CDMA standards, and thereby allows for the development of applications in a global context. The Toolkit works on all Intermec Mobile Computers equipped with a WWAN radio.

The WWAN Toolkit provides interfaces for the following functional areas:

• Power Management

• RAS and Connection Manager Data Connectivity

• SMS

• Voice Calls

• SIM Card Management

• Phone Book

• Network Information

• Radio Information

• Carrier Selection

Downloading and Installing the WWAN ToolkitIntermec recommends using Windows XP (with Service Pack 3) or 32-bit Windows 7 when developing applications using the WWAN Toolkit.

The installation requires 18 MB of free disk space on your PC.

To download and install the WWAN Toolkit1 Visit the Intermec website at www.interme.com and select Products >

Computers > Handheld Computers > your computer > Downloads tab. The Downloads page for the computer appears.

2 In the Developer Tool list, click WWAN Toolkit ver. x.xx.xx.xxxx.

3 Download the file to your desktop PC. Typically, program files are located in \Program Files\Intermec\WWAN Toolkit. In this manual, this folder is referred to as INSTALLDIR.

Note: The WWAN Toolkit API does not contain any functionality for WLAN interaction. However, it is compatible with the WLAN APIs provided by the IDL Communications Resource Kit. For more information, visit www.intermec.com/idl.

Note: The WWAN Toolkit may operate together with other applications or SDKs that interact with the WWAN radio, but Intermec does not recommend this because it might cause unpredictable results.

2 WWAN Toolkit User’s Guide

Page 13: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

4 In the INSTALLDIR\Cab Files directory, copy WWANToolkit.ARM.cab to your mobile computer.

5 Execute the file(s) on your mobile computer.

6 There may be additional installation steps required for the different development environments in the sections ahead.

7 Warm boot your mobile computer. For more information, see your mobile computer user’s manual.

Developing Applications in Different EnvironmentsThis section explains how to get started developing WWAN applications in different programming environments. For more information, use the Start Menu shortcuts to refer to the language specific documentation and example applications.

C++ DevelopmentThe WWAN Toolkit supports development in Visual Studio 2005 and Visual Studio 2008.

To use the Toolkit functionality in your Windows Mobile C++ application1 Add a link reference to the WWANToolkit.lib file located in

INSTALLDIR\WWAN Toolkit Core API\C++\lib.

To add the reference:

a In the menu bar, select Project > Settings.

b Click the Link tab.

c From the Category drop-down menu, select Input.

d Add the name of the .lib file to the Object/Library Modules field and point out the path to the .lib file in the Additional Library Path field.

2 Click the C++ tab.

3 From the Category drop-down menu, select Preprocessor.

4 To point out the header files, add the API directory to the Additional Include Directories field.

.NET Development (C# and VB.NET)The WWAN Toolkit supports development with Compact Framework V1.0 and V2.0.

To use the Toolkit functionality in your Windows Mobile .NET application1 Include the .NET wrapper dll in your application directory on the device. This is

called Intermec.Communications.WWAN.dll and is located in INSTALLDIR\Core\DotNet\lib.

Note: Before you begin work on a data communication application, contact your network operator and request information to connect to the data network. For example, most GSM providers require a specific Access Point Name (APN) to connect. Some operators also require a username and password.

WWAN Toolkit User’s Guide 3

Page 14: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

2 To develop a .NET application using the Core API you need to add a reference to the wrapper dll.

To add the reference:

a Open the references dialog box.

b From the drop-down list, select Intermec WWAN Toolkit.

Java DevelopmentThis section does not include a detailed setup procedure because Java development for Windows Mobile does not require a specific development environment.

Core API Development1 Copy WWANjni.dll to the Windows folder of your device. The dll is located in

INSTALLDIR\WWANToolkitCore\Java\lib.

Remember to include the wwantk.jar file in your application folder on the device, and to add the file to the class path when using the Core API.

2 Add a reference to the wwantk.jar file located in INSTALLDIR\WWANToolkitCore\Java\lib.

3 Add an import statement to your source pointing to the com.intermec.wwanToolkit package.

Using the WWAN Toolkit APIIf you are using the WWAN Toolkit to interact with the radio, follow the recommendations in this section.

Initiating the Toolkit and RadioThis section explains how to initiate the Toolkit and radio.

Powering On the RadioYou must power on the radio before you can use it. Call the WWANRadioPowerOn() method to power on the radio. This takes approximately 20 seconds to execute. When it returns, the radio is powered and ready.

Setting Up the Toolkit You must set up the WWAN Toolkit before you can set up the internal states and variables. To use the cross-platform feature of the Toolkit, call the SetupWWANToolKit() method. This method automatically detects the carrier and radio type, and initializes the Toolkit.

Ensuring the Modem is RespondingUse the IsModemReady() function.

4 WWAN Toolkit User’s Guide

Page 15: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

Checking if a PIN Code is Required (GSM/UMTS)If you are using a SIM card in a GSM network, it can be locked and you cannot use it until it is unlocked. To check if the SIM card is ready to use, call the CheckSimPin() method. This method returns:

• PIN_READY, the SIM card is unlocked and ready to use

• PIN_SIM_PIN, the SIM card is locked, and can be unlocked by calling EnterSimPin()

• PIN_SIM_PUK, the SIM card is locked, and can be unlocked by calling EnterPukNumber()

Next, call CheckSimPin() to ensure that the PIN or PUK entry was successful. If not, use the entry functions above. For more information about PIN codes, see the “WWAN Glossary” on page 25 or the mentioned API methods.

Selecting Network Operator (GSM Only)Use the AutomaticNetworkRegister() method to let the radio select which network to use. The choice is based on information in the SIM card provided by your network operator. It may also require selecting the operator. If this is the case, see the Network Selection Functionality section in the WWAN Toolkit Programmer’s Reference Manual.

Setting Up Event ReportingAll applications that require events from the Toolkit must register their interest through the SetModemEventReporting()method. This method ensures that the application can receive events concerning the network, the connection process, and incoming voice calls and SMSs.

Error HandlingYou can retrieved errors reported by methods in the Toolkit using two methods:

• The GetLastWWANErrorCode() returns the last known error code.

• The GetLastWWANErrorString() returns a string representation of the last error code.

These methods help applications handle the problems and notify the user.

Shutting Down the Toolkit and the RadioBefore powering off the radio, you must cleanly exit the Toolkit. Use the following sections to correctly shut down the Toolkit and power off the radio.

Shutting Down the ToolkitTo shut down the Toolkit, call the ShutDownToolKit() method. This closes all internal variables and cleanly exits from the network.

Note: If you enter an incorrect PIN code more than three times, the device locks. If the device locks, you need a PUK code to unlock the device.

WWAN Toolkit User’s Guide 5

Page 16: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

Powering Off the RadioTo power off the radio, call the WWANRadioPowerOff() method. After you call this method, the only Toolkit method you should call is WWANRadioPowerOn().

About Data WWAN ConnectionsThere are two types of data connections and two different methods to establish a data connection. You can create both types of data connections using either connection method.

Types of Data Connections• Packet Switched Data: This is done through the GPRS, 1xRTT, UMTS networks

that exist within the framework of most GSM and CDMA networks. This is most often billed based on the amount of data transmitted and not the length of the transmission.

• Circuit Switched Data: This is done through a normal dial-up connection using the GSM and CDMA networks. This is most often billed based on the duration of the transmission (call) and not the amount of data transmitted.

Methods to Call Data Connections• RAS: This method is the core communication module for Windows. This

establishes a TCP/IP stack that is capable of communicating with the network or the Internet. After a connection is established, applications can, in turn, open sockets to servers that are available on the network. The RAS API does not display any pop-up windows about the current state of the connection process.

• Connection Manager: This exists on top of the RAS API. Applications that are Connection Manager aware can use the same connection instead of establishing an entirely new one. An example is the Pocket Internet Explorer application. Using Connection Manager also displays a bubble on top of all applications showing the connection process. This bubble can be misused by certain users to enter faulty settings and disrupt the application.

Creating a WWAN Connection EntryThe Toolkit can create connection entries and use settings configured by the user. The sections below show how to create a PSD connection entry.

Creating Dialing LocationUse CreateDiallingLocation() to create the location you are dialling from.

This is commonly a “g,g,g” entry within the PocketPC dialing location pages.

Creating a RAS EntryUse CreateRasEntry() to create the RAS entry.

6 WWAN Toolkit User’s Guide

Page 17: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

This method allows you to specify the information required by your network carrier to make a data connection. If you need the values used by your carrier, please contact your network representative. An application should only need to set up connection parameters once during its lifetime, but it is possible to create them before and removing them afterwards. The main difference between connecting to a PSD network in GSM and CDMA is:

• When using GPRS, the phone number should be *99***1# or *99#. The GPRS APN can be set up using the extra dial commands. For more information, see the complete method description in the API manual.

• When using 1xRTT, the phone number should be #777.

• When you create a Circuit Switched connection using GSM or CDMA, the phone number should be the dialup server number.

Linking the New RAS Entry to Connection Manager

Use AddEntryToConnMgr() to link the RAS entry so it can be used by the Connection Manager.

Linking the RAS entry means the RAS entry also displays in the Settings menu under “Connections”.

Removing a WWAN ConnectionWhen you shut down the Toolkit, the Windows registry is not cleaned up. When you set up the Toolkit again, the connections you created still exist.

Removing the RAS Entry Link From Connection ManagerYou only need to remove the RAS Entry link from Connection Manager if you have used the AddEntryToConnMgr() method. To remove the link, use RemoveEntryFromConnMgr(). This also removes the entry in the Settings menu under “Connections”.

Deleting the RAS EntryTo delete the RAS entry, use DeleteRasEntry().

Deleting the Dialing LocationTo delete the RAS entry from the dialing location list, use DeleteDiallingLocation().

Establishing the WWAN ConnectionAfter the connection parameters are set up, you can start the connection process.

Note: This is only required if the connection is using Connection Manager instead of RAS. For more information, see “Methods to Call Data Connections” on page 6.

WWAN Toolkit User’s Guide 7

Page 18: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

Checking for Signal StrengthMake sure there is an available cellular network before you attempt to establish a connection. Use SignalStrength() to determine if the signal is strong enough to successfully establish a connection. A signal strength of 0 means there is no network available, and all connection attempts will fail.

Checking for PSD NetworkYou only need to check for the PSD network if the connection is a Packet Switched data connection. For more information on a Packet Switched data connection, see “About Data WWAN Connections” on page 6.

The GetGPRSAttach() method confirms the availability of a GPRS or 1xRTT network.

In GSM networks, the radio must attach to the GPRS network before it can be used. The SetGPRSAttach() method attaches the radio to the GPRS network.

In CDMA networks, the radio automatically attaches when it is started. After attaching to the PSD network, check the attach status using the GetGPRSAttach() method. If there is no PSD network available, all PSD connection attempts will fail.

Setting Up GPRS APN (GSM ONLY)You only need to set up the GPRS APN if the connection is a PSD connection used in a GPRS network. You can set up the GPRS APN through the GPRSSetupContext() method or by adding it as an extra dial command in a RAS entry.

Establishing the WWAN ConnectionThe time to establish a connection varies between carriers. Therefore, all of the methods in this process start the connection process, but the connection is not active when the method returns. It is important to remember that the connection attempt can fail even if the initial method call is successful.

To establish a Connection Manager connection, use the DoDialUpConnect() method. To establish a RAS connection, use DoRASConnect() method. These methods start the connection process, and only return FALSE if there is a major problem with the connection parameters. The Toolkit sends events until the connection is either established or dropped, and applications must wait for the appropriate connection event before they can start communicating with servers. To ensure that the connection is fully established, check the Toolkit event call-backs for the RAS event RASCS_Connected and/or the Connection Manager event CONNMGR_STATUS_CONNECTED.

If the connection has been up for a while, make sure that it is still functioning correctly. The Toolkit has a method to send an ICMP ping to any server to make sure that the connection is up. Use ActiveWwanAvailable() to determine the WWAN connection status.

8 WWAN Toolkit User’s Guide

Page 19: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

Dropping the WWAN ConnectionTo terminate a Connection Manager connection, use DoDialUpHangup(). To terminate a RAS connection use DoRASHangup().

WWAN Toolkit User’s Guide 9

Page 20: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 1 — Getting Started

10 WWAN Toolkit User’s Guide

Page 21: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

2

Examples

11

Page 22: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

About the ExamplesThe sample source code is located in the INSTALLDIR\Examples folder. Each language has a dedicated subfolder (C++, Java, C# and VB) that contains several applications.

To test the applications, make sure you follow the installations and preparation steps described in previous chapters.

The following samples can be found, for each language, in the WWAN Toolkit Core folder:

DataComThis example shows how to create a dial-up connection with RAS (Remote Access Server) or the MS Connection manager.

When the application starts, it performs the following tasks:

• Powers on the radio.

• Checks the SIM card status.

Click the connect button. Based on the settings, a dialup connection is attempted. If a connection is established, click the connect button again to disconnect the application.

The application contains “reconnection logic”. Reconnection logic is applied when the connection is broken unintentionally. For example, the connection could be broken unintentionally because of weak signal strength.

The main difference between the command languages is the event models.

• In Java, observable interfaces are used to notify the GUI about events.

• In C++, a reference to the GUI class is passed on to the WWANConnector. Events from the WWAN Toolkit are first handled in the GUI, and then passed to the connector class.

• In C# and VB.Net, events are raised to notify the GUI.

• In the other languages, the connector itself listens to the Toolkit events.

Core API Samples

Sample Description

DataCom RAS and Connection Manager sample that supports packet switched connections on both CDMA and GSM devices.

VoiceDialer Simple voice dialler for incoming and outgoing calls. Also supports audio level adjustment.

SIMPin Manage the security settings of the SIM card (GSM only).

PhoneBookManager Manage the phone book.

SMS Send and manage SMSs.

Info Generic information application (network status, radio information)

12 WWAN Toolkit User’s Guide

Page 23: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

The following table shows the main class where GUI and application initializes for each language.

The following table shows the class that holds connection logic and reports events back to the GUI for each language. All connection parameters are stored in this class for each language.

The Datacom Sample

Filename Language

DataCom.java Java

Form1.csForm1.Designer.cs

C#

Form1.vbForm1.Designer.vb

VB .NET

DataComDlg.cpp C++

Filename Language

WWANConnector.java Java

WWANConnector.cs C#

WWANConnector.vb VB .NET

WWANConnector.cpp C++

WWAN Toolkit User’s Guide 13

Page 24: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

InfoThis example shows how to start up and retrieve information from the Toolkit.

When the application starts, it performs the following tasks:

• Powers on the radio.

• Checks the SIM card status.

• Retrieves information from the Toolkit.

The following table shows the main class where all relevant application events take place for each language.

The Info Sample

Filename Language Descriptions

Filename Language

Info.java Java

Form1.csForm1.Designer.cs

C#

Form1.vbForm1.Designer.vb

VB .NET

InfoDlg.cpp C++

14 WWAN Toolkit User’s Guide

Page 25: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

Phone BookThis example shows how to use the phone book.

When the application starts, it performs the following tasks:

• Powers on the radio.

• Checks the SIM card status.

• Populates the phone book list. The phone book entries are read either from the SIM card (GSM devices) or from file (CDMA devices).

Since the AWT (Abstract Window Toolkit) is used in Java, you cannot add hidden data to a list item here. The index of the phone book entry is added to each list item in the rightmost position of a pipe (‘|’) separated string.

The following table shows the main class where all relevant application events take place for each language

The Phonebook Sample

Filename Language Descriptions

Filename Language

PhoneBook.java Java

Form1.csForm1.Designer.cs

C#

Form1.vbForm1.Designer.vb

VB .NET

PhoneBookDlg.cpp C++

WWAN Toolkit User’s Guide 15

Page 26: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

SimPinThis example shows how to use the SIM (Subscriber Identity Module) security functionality.

When the application starts, it performs the following tasks:

• Powers on the radio.

• Checks the SIM card status.

• Based on the status, buttons for each available option are enabled.

For example, if the SIM card is locked and requires the PUK (Personal Unblocking Key) code to be unlocked, only the Enter PUK button is enabled.

The available functions are:

• If the SIM card is locked, enter the PIN (Personal Identification Number) and PUK number.

• If the SIM card is unlocked, change the PIN number and enable/disable the PIN lock on the SIM card.

The following table shows the main class where all relevant application events take place for each language.

The SimPin Sample

Filename Language Descriptions

Filename Language

SimPin.java Java

Form1.csForm1.Designer.cs

C#

Form1.vbForm1.Designer.vb

VB .NET

SimPinDlg.cpp C++

16 WWAN Toolkit User’s Guide

Page 27: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

SMSThis example shows how to send SMS (Short Message Service) messages and display received messages.

When the application starts, it performs the following tasks:

• Powers on the radio.

• Checks the SIM card status.

• Attempts to populate the message inbox with the messages that were received and stored on the SIM card.

From the SMS Inbox tab, you can select and read a message from a list or erase a selected message. From the Send SMS tab, you can create and send an SMS message.

The main difference in this example is in C++. To create tab pages in C++, you need to “subclass” the CTabCtrl once for each respective tab. Each tab class then handles its respective events. For example, TabInbox handles inbox events and TabSendSms handles incoming SMS. All other languages handle all application events in the main class.

When you use AWT (Abstract Window Toolkit) in Java development, tab pages are not supported. To address this, one panel is for the inbox and another is for sending SMSs. Use the buttons on the bottom of the screen to hide or display the panels.

Filename Language Descriptions

Filename Language Description

Sms.java Java Main class where all relevant application events take place.

Form1.csForm1.Designer.cs

C# Main class where all relevant application events take place.

Form1.vbForm1.Designer.vb

VB .NET Main class where all relevant application events take place.

SmsDlg.cpp C++ Startup and initialization class. Listens to all Toolkit events and delegates them to one of the tab classes.

TabSendSms.cpp C++ Subclass of CTabCtrl that handles SMS sending.

TabInbox.cpp C++ Subclass of CTabCtrl that handles the SMS inbox.

WWAN Toolkit User’s Guide 17

Page 28: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 2 — Examples

The SMS Sample: ‘Send’ window and SMS inbox.

VoiceDialerThis example shows how to create a voice dialing application.

When the application starts, the radio powers on and the application checks the SIM card status. After start up, you can make and receive phone calls. If you press the star or hash buttons during a phone call, DTMF (Dual Tones Multi Frequency) tones are sent.

The following table shows the main class where all relevant application events take place for each language.

The VoiceDialer Sample

Filename Language Descriptions

Filename Language

VoiceDialler.java Java

Form1.csForm1.Designer.cs

C#

Form1.vbForm1.Designer.vb

VB .NET

VoiceDialler.cpp C++

18 WWAN Toolkit User’s Guide

Page 29: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

3

Troubleshooting

This chapter addresses issues that may come up when using the WWAN Toolkit to develop software applications.

19

Page 30: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 3 — Troubleshooting

Network IssuesUse this section to help you troubleshoot common network issues.

Common Network Issues

Question Answer

Why does my application fail to enable modem event reporting?

The typical sequence is PowerOn, Setup, EnableModemEventReporting. Make sure you have a SIM card. The Toolkit does not report errors unless event reporting is enabled.

What characters are supported when sending and receiving SMSs?

The PDU 7-bit alphabet is used when sending and receiving SMSs. Refer tohttp://www.dreamfabric.com/sms/default_alphabet.html.

CDMA Issues

Question Answer

Why does SetGPRSAttach always return FALSE on CDMA?

You can only perform GetGPRSAttach on CDMA. This verifies that the 1xRTT network is available, so there is no need to attach to it as on GPRS devices. Distinguish between GPRS and CDMA devices via an “If” statement.

Can I send SMS messages on a CDMA device?

Yes.

Why do I not get a roaming event on CDMA devices?

It is possible you will receive signal strength from another network when you have lost the connection to your home network. Your connection will be terminated and you must cater for these events yourself. The Toolkit does not support roaming events on CDMA radios. GetGPRSAttach should tell you if 1xRTT is available for any connections to be made.

GSM Issues

Question Answer

Where can I learn more about GSM/GPRS technology?

Cisco released a “design guide” that is available at http://www.cisco.com.Bio Enable’s website is not as comprehensive, but covers most topics. You can view the design guide athttp://www.bioenabletech.com/technical_introduction_to_gsm_modem_technology.htm.

WWAN Issues

Question Answer

Why is there no ring signal when I get a voice call?

The “incoming call” event is received but no sound plays. Make sure the ring signal sound file is properly installed in the windows folder. The WAV file is automatically installed with the WWAN Toolkit cab file. You can also rename any WAV file to WWANTKRing.wav and copy it to the windows folder on your device.

Why is there no sound when I pick up an incoming voice call? When I receive an incoming voice call (or dial a number) and pick up the phone (answer), I can hear a connection, but the microphone and speaker on the device seem “dead.”

If you have upgraded your OS/firmware, the speaker and microphone volume levels may reset to zero by default. Use SetSpeakerVol and SetMicVol to set the levels.

20 WWAN Toolkit User’s Guide

Page 31: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 3 — Troubleshooting

Development IssuesUse this section to help you troubleshoot development issues.

How do I determine the device phone number?

Use the GetPhoneNumber () method.

WWAN Issues (continued)

Question Answer

Common Development Issues

Question Answer

Can I combine Cellcore (TAPI, ExTapi, etc.) with the WWAN Toolkit?

On Phone Edition units, you can use a small subset of the APIs, but you cannot use SMS or Voice functionality from Cellcore while running the Toolkit.

I have previously written an application in Embedded Visual Basic. Now that the WWAN Toolkit no longer supports the COM wrapper, what do I do?

Migrate your application to Java, C++, VB.Net or C# (Compact Framework). For help, visit the Microsoft website athttp://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnppcgen/html/fromemb.asp.

.NET Issues

Question Answer

What does “MissingMethodException” (.NET) mean?

The .NET wrapper cannot find the native method or dll. Make sure wwanToolkit.dll is in the windows directory of your device and the wrapper matches the dll you are using.

WWAN Toolkit User’s Guide 21

Page 32: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 3 — Troubleshooting

Connection IssuesUse this section to help you troubleshoot connection issues.

RAS Issues

Question Answer

What does RAS Error 119 (“The port is disconnected”) mean?

This error typically occurs when you have an APN name that does not match your network operator’s APN (GSM only). Make sure you enter the correct APN for the SIM you are currently using.

Where can I find information about the RAS error codes?

http://support.microsoft.com/kb/q163111

What baud rate should I use when I create a RAS Connection?

115200 bps. This parameter has no significance on devices running Phone Edition on older machines, or on machines running Premium. 115200 is the maximum speed.

What does RAS Error 619 (“The Port Is Disconnected”) mean?

• Your network settings are incorrect. Make sure you have the correct APN, username and password (and any other parameters required by your operator).

• Your APN is incorrect.

Connection Manager Issues

Question Answer

Why do I receive a “No path to destination” message when I am trying to establish a Connection Manager connection?

Verify that your connection details are correct. Also make sure that the ConnectionName in the DoDialUpConnect() method call uses “Internet Settings” when running in Pocket PC 2002 and “My ISP” when it is running in PPC 2003 and later versions.

Can I use the Microsoft Connection Manager API/GUI to create my connections while using the Toolkit for powering on the radio?

We do not recommend doing this, even though it may work on some devices. The WWAN Toolkit supplies a sufficient set of commands to control the Connection Manager API through the Toolkit. Alternatively, you can use RAS to remove the notification bubbles and gain even more control.

GPRS Issues

Question Answer

Why does the Toolkit not notify me when I have lost my (packet switched) connection?

The PSD networks usually takes between 20 minutes and 2 hours to verify there is no connection available. So even if you have sufficient signal strength, you will not receive an event telling you the connection is missing. Ping using the ActiveWWANAvailable method to make sure your server is available.

I need to use a very long string in the “extra commands string” from the GPRS connection: ^SGAUTH=1+CGDCONT=1,"IP”,"mylongapn.inter.net". How can I introduce this string because it is longer than 39 characters, and exceeds the character limit of this command?

Use the SetGPRSContext command. This command does not have the same limitations as the extra dial command. In code (C#):

SetGprsContextFlags f = SetGprsContextFlags.SetApn|SetGprsContextFlags.SetDataCompression|SetGprsContextFlags.SetHeaderCompression; myToolkitRef.Connections.SetGprsContext(flags,1," mylongapn.inter.net","",false,false);

For more information, see the CreateRAS(Connection con) method in the WWAN Communicator source code (included in the WWAN Toolkit C# examples).

22 WWAN Toolkit User’s Guide

Page 33: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 3 — Troubleshooting

Operating System IssuesUse this section to help you troubleshoot operating system issues.

Windows Mobile 2003, Windows Mobile 5, and Windows Mobile 6.1 Phone Edition Issues

Question Answer

I am using the WWAN Toolkit, how do I make my SMSs end up in my inbox without being “grabbed” by the Toolkit?

The Toolkit handles the SMS by default. If you want to turn this feature off and let your inbox handle all SMSs (not recommended) you can add a key to the registry:• HKEY_LOCAL_MACHINE\SOFTWARE\Intermec\WWANToolkit\SMSPass

through• Value and type is not import, the key should just be there for the Toolkit to

pass on the SMSs to the inbox.

How do I make SMSs cold boot resilient? By default, all SMSs are stored in the file WINDOWS\sms_storage.dat If you want to change this location (for cold boot resilience etc.), modify the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Intermec\WWANToolkit\SmsFileName.

Why does the toolbar in Phone Edition signals “No service” when running a WWAN Toolkit application?

The Toolkit takes control of the functionality that was previously handled by the operating system. You can not rely on any tools included in the OS. The WWAN Toolkit can still query network status and perform its tasks as usual.

Our application previously used “Siemens MC45 on COM4: (CHAP)” / “Siemens MC45 on COM4: (PAP)” when creating a RAS entry. Now that modems_mc45_all.cab is no longer supported on the 761, how do I do I use CHAP or PAP?

How you use the application does not change. Since the Toolkit can distinguish between the different modem types, you can also use it in the “extra dial string” (SGAUTH), as in previous versions of the Toolkit.The appropriate modem names for PAP/CHAP are:• “Siemens MC45 on COM4: (PAP)”• “Siemens MC45 on COM4: (CHAP)”• “Siemens MC45 on COM4: (PAP/CHAP)”

Why can I can no longer start the phone application (Phone Edition) once I have started my WWAN Toolkit application?

If you warm booted the device, or your application crashed before you tried to use the phone application, you need to restart the WWAN application and make sure it performs a power on/setup/shutdown/power off of the Toolkit to restore the phone application.

Why am I unable to uninstall the WWAN Toolkit on the device (Phone Edition)?

Warm boot the device to release the OS handle to the dlls. and uninstall the Toolkit.

On my Phone Edition unit, how do I control voice calls using the built-in dialer?

Add the registry key SOFTWARE\Intermec\WWANToolkit\PhoneApplication. Events will still be sent to the Toolkit, while all incoming calls are handled by the OS phone application.

WWAN Toolkit User’s Guide 23

Page 34: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 3 — Troubleshooting

24 WWAN Toolkit User’s Guide

Page 35: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

4

WWAN Glossary

This chapter provides explanations of important terms and concepts related to wireless technology.

25

Page 36: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 4 — WWAN Glossary

1xRTTSingle carrier (1x) Radio Transmission Technology (1xRTT) is a 3G wireless technology based on the CDMA platform. 1xRTT can provide speeds of up to 144 kbps. 1xRTT is also referred to as CDMA2000.

APNAccess Point Name (APN) is:

• An IP network to which a mobile can be connected.

• A set of settings which are used for that connection.

• A particular option in a set of settings in a mobile phone.

When a GPRS mobile phone sets up a context, the access point is selected by identifying the APN. This access point is used in a DNS query to a private DNS network. This process (called APN resolution) finally gives the GGSN IP address which should serve the access point. Now you can activate a PDP context.

Circuit-SwitchingCircuit-switched is a type of network in which a physical path is dedicated to a single connection between two end-points. The connection is maintained in the network for the entire phone call.

Ordinary voice phone service is circuit-switched. The telephone company reserves a specific physical path to the number you are calling for the duration of your call. During that time, no one else can use the physical lines involved. This type of network is used for GSM and CDMA.

CDMACode-Division Multiple Access (CDMA) is a digital cellular technology that uses spread-spectrum techniques. Unlike competing systems, such as GSM, which uses TDMA, CDMA does not assign a specific frequency to every user. Instead, every channel uses the full available spectrum.

CHAPChallenge-Handshake Authentication Protocol (CHAP) is a more secure procedure for connecting to a system than the Password Authentication Procedure (PAP). This is how CHAP functions:

• The link is set up.

• The server sends a challenge message to the connection requestor.

• The requestor responds with a value obtained using a one-way hash function.

• The server checks the response by comparing it to its own calculation of the expected hash value.

If the values match, the authentication is acknowledged.

If the values do not match, the connection is usually terminated.

At any time, the server can request the connected party to send a new challenge message. Since CHAP identifiers are changed frequently and authentication can be requested by the server at any time, CHAP provides more security than PAP. RFC1334 defines both CHAP and PAP.

26 WWAN Toolkit User’s Guide

Page 37: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 4 — WWAN Glossary

CSDCSD stands for Circuit Switched Data. For more information, see “Circuit-Switching” on page 26.

DTMFDual Tone Multi Frequency (DTMF) is the signal to the phone company that you generate when you press the touch keys on ordinary telephone. With DTMF, each key you press generates two tones of specific frequencies.

ESNElectronic Serial Number (ESN) is used on CDMA networks to identify the unit.

GGSNThe Gateway GPRS Support Node (GGSN) in GPRS is equivalent to the Home Agent in Mobile IP. It is a router which detunnels user data from GTP, and transmits normal user data IP packets.

GPRSGeneral Packet Radio Service (GPRS) is a standard for wireless communications which run at speeds up to 115 kbps, compared with the 9.6 kbps of current GSM systems.

GPRS supports a wide range of bandwidths and is an efficient use of limited bandwidth. It is particularly suited for sending and receiving small bursts of data, such as email and Web browsing, as well as large volumes of data.

GSMGlobal System for Mobile Communications (GSM) is one of the leading digital cellular systems. GSM uses narrowband TDMA, which allows eight simultaneous calls on the same radio frequency.

IMEIThe International Mobile Equipment Identity (IMEI) is a unique number given to every mobile phone. The number consists of four groups, nnnnnn-nn-nnnnnn-n.

IMSIThe International Mobile Subscriber Identity (IMSI) is an identifier GSM networks use to identify different cellular devices.

MMSWith a Multimedia Messaging Service (MMS) compatible handset, you can send and receive a combination of text, images, sound and video.

MultiplexingMultiplexing means sending multiple signals or streams of information on a carrier simultaneously in the form of a single, complex signal, and then recovering the separate signals at the receiving end.

Throughout this manual, there are references to the Toolkit’s ability to create and handle several virtual COM ports to support modem interaction when connected via RAS or the Connection Manager.

WWAN Toolkit User’s Guide 27

Page 38: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 4 — WWAN Glossary

Network OperatorFor information, see “Service Provider” on page 29.

PAPPassword Authentication Protocol (PAP) is the most basic form of authentication. A user's name and password are transmitted over a network and compared to a table of name-password pairs. Typically, the passwords stored in the table are encrypted. The Basic Authentication feature built into the HTTP protocol uses PAP.

PDPThe PDP context is a data structure on both the SGSN and the GGSN. When the subscriber has an active session, the PDP contains the subscriber’s session information. When a mobile device wants to use GPRS, it must attach and then activate a PDP context. This allocates a PDP context data structure in the SGSN that the subscriber is currently visiting and the GGSN serving the subscriber’s access point.

The recorded data includes:

• The subscriber’s IP address• The subscriber’s IMSI• The subscriber’s

• Tunnel ID (TEID) at the GGSN• Tunnel ID (TEID) at the SGSN

The tunnel ID (TEID) is a number allocated by the GSN which identifies the tunnelled data related to a particular PDP context.

Packet SwitchingPacket switching is a method of switching data in a network. Individual packets, with a set size and format, are accepted by the network and delivered to their destinations.

Before the transmission begins, the sending terminal and the network exchange control information to establish and maintain the sequence of the packets and their destination. Control information is also stored in the packets.

You can send the packets in any order, because the control information sent at the beginning of the transmission ensures the packets are interpreted in the correct order. Because each packet carries its own control instructions, it can use any route to reach its destination, as used in GPRS and 1xRTT networks.

The network is open to all users, at all times, with packets from the various nodes being interleaved throughout the network.

PINThe Personal Identification Number (PIN) is a code used for all GSM based phones to establish authorization for access to certain functions or information. The PIN code is delivered with your network subscription.

PSDStands for Packet Switched Data. For more information, see Packet Switching.

28 WWAN Toolkit User’s Guide

Page 39: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Chapter 4 — WWAN Glossary

PUKYou need to obtain the Personal Unblocking Code (PUK) from your service provider to unlock your device if you enter the wrong PIN code three times in a row.

RASThe Remote Access Service (RAS) makes it possible to connect a remote client computer to a network server over a WAN link or a VPN. The remote computer functions on the server's LAN as if it is connected to the LAN directly.

RoamingRoaming within your home network means that your mobile phone automatically sets up communication procedures with different radio base stations as you are moving. International roaming means that you can use networks other than your own when travelling abroad.

Service ProviderThe service provider is the company that owns your mobile phone’s signature on a contract and bills you for your calls. Also known as Network Operator.

SGSNThe Serving GPRS Support Node (SGSN) is the node that carries out the same function as the Local Agent in Mobile IP. However, an SGSN is considerably more complex because it also performs a full set of interaction with the connected radio network.

SIMA Subscriber Identity Module (SIM) card is a smart card containing information that is inserted into the device that has a GSM module, to facilitate connection to a network operator. The card can also store miscellaneous data used by the cell phone, such as address books, SMSs etc.

SMSShort Message Service is the transmission of short text messages to and from a mobile phone, fax machine and/or IP address. Messages can be up to 160 alpha-numeric characters and cannot contain images or graphics.

TDMATime Division Multiple Access (TDMA) is a technology that delivers digital wireless services using time-division multiplexing. TDMA divides a radio frequency into time slots and allocates slots to multiple calls. In this way, a single frequency can simultaneously support multiple data channels.

UMTSUniversal Mobile Telecommunications System (UMTS) is a 3G mobile technology that delivers information at speeds up to 2 Mbps.

WWANWireless Wide Area Network (WWAN) is a common term to describe cellular networks like GPRS, CDMA, etc.

WWAN Toolkit User’s Guide 29

Page 40: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s
Page 41: WWAN Toolkit User's Guide - Honeywell Productivity and ...epsfiles.intermec.com/eps_files/eps_man/934-053.pdfThis is a list of related Intermec documents. • WWAN Toolkit Programmer’s

Worldwide Headquarters6001 36th Avenue WestEverett, Washington 98203U.S.A.tel 425.348.2600fax 425.355.9551www.intermec.com

© 2011 Intermec Technologies Corporation. All rights reserved.

WWAN Toolkit User’s Guide

*934-053-002*P/N 934-053-002