Home

WWAN Toolkit User`s Guide

Contents

1. The SimPin sample This example demonstrates how to send SMS Short Message Service messages and display received messages At startup the application powers on the radio checks the status of the SIM card and then tries to populate the message inbox with the received messages currently stored on the SIM card Under the SMS Inbox tab the user can select a message from a list and read its contents It is also possible to erase a selected message If the user switches to the Send SMS tab an SMS message can be created and sent In this case the C implementation represents the biggest deviation To create tab pages in C it is recommended to subclass the CTabCtrl once for each respective tab Each tab class then takes care of its own events i e TabInbox takes care of inbox events and TabSendSms takes care of incoming SMS The other languages handle all application events in the main class When AWT Abstract Window Toolkit is used in Java development tab pages are not supported This is solved by using one panel for the inbox and another for sending SMSs The panels are either hidden or displayed based on which button is pressed at the bottom of the screen Filename Language Description Sms java Java Main class where all relevant application Es CE events take place FrmSms vb VB NET SmsDlg cpp C Startup and initialization class Listens to all toolkit events and delegates them to one of the tab classes
2. 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 VoiceDialer WWAN Toolkit User s Guide 555666777888 Message This is my message SMS Centre 46555111222333 SMS Inbox Send SMS Chapter 5 Samples E ok me mmetme A 46555123456 05 09 20 00 19 46555123456 46555123456 46555123456 46555123456 This is my message Count 11 SMS Inbox Send sms The SMS sample Send window and SMS inbox This example demonstrates how to create a voice dialling application When the application is started that is when the radio is powered on and the status of the SIM card is checked the user can make and receive phone calls DTMF Dual Tones Multi Frequncy tones will be sent during ongoing calls if a number star or hash button is pressed Main class where all relevant application Filename Language Description VoiceDialler java Java Frm VoiceDialler cs C events take place Frm VoiceDialler vb VB NET VoiceDialler cpp C BBE m y a amp U The Voicedialer sample 47 Chapter 5 Samples Connectivity API Sample 48 The following sample can be found for each language in the Connectivity folder Sample Description Connectivity Automatic and manual switching application Requires a profile
3. is called The call will fail if there is no current connection available Unlocking a Connection 20 After calling the Lock null method you must call the Unlock method to release the lock If you do not the switcher will stay connected to the same connection until it loses the signal When the signal is lost the switcher will not try to connect to a new connection until the old one has been unlocked WWAN Toolkit User s Guide Chapter 3 Using the Connectivity API Manually Selecting a Connection The Lock method can not only be used to lock the currently used connection it can also be used to force the switcher to try to connect to a specific connection Locking to a specific connection is done by entering the name of the connection Lock L MyPSD Connection The selected connection is released by calling Unlock Powering on Radios Without Connecting When creating a profile using the Profile Manager tool you have the ability to select the option Disable automatic switching and the power management option set to Always On In this state when SetProfile L MyProfile is invoked the switcher will power on radios used by the connections included in the profile but it will not connect to any connections when they become available This is useful when you want to keep switching manual with the Lock Unlock methods and want to minimize the time required to establish a connection Remember
4. 10 Embedded Visual C 4 0 oj sid A ea A063 10 Visual Studio NET 2003 sis eu aa ra en 10 Java Environments SHDD eee nents 10 Guidelines for Using the Core ADD 43s AS tA ite Ba 11 Initiating the Toolkit and Radios ans se en an ie Bos po BE 11 Shutting Down the Toolkit and the Radio 12 About Data WWAN Connections rs san era 12 Creating a WWAN Connection Entry cc eae 13 Removing a WWAN connection cee eens 14 Establishing the WWAN connection spodek a ds 14 3 Using the Connectivity API 17 Introduction to the Connectivity API 2 2 a 18 Use Case Scenarios 1226016 6g big gy payee ted ad ayes ae ped OA ee det l gi 4 19 WWAN Toolkit User s Guide v Contents A A O ade eee 19 Guidelines for Using the Connectivity API 35 0 08 bos da 240546981 A 20 sE k Che AD PORT Eta E a en 0 aa 20 Automatically switching between connections 20 Locking 4 connection eeg reur aep En re ie dee ees 20 Unlocking a connection u Bn adh BMG Be ew Been ents 20 Manually selecting a connection 2324 Sr ar 21 Powering on radios without connecting 21 Using SMS and voice functionality cn Aare ea ner 21 SIM PIN security 4 0 2220 rl a es 21 Powering off all radios as A A Br 22 Battery E OE ss la 600 sa S04 ARO 22 External Vs Battery Power Management sts Via 2 Damian
5. Remember that roaming can be costly Description Use a specific PDP address AT command to execute before connection is attempted Some networks require you to disable CHAP when connecting with PAP authentication Some networks requires you to disable PAP when connecting with CHAP authentication WWAN Toolkit User s Guide Circuit Switched Settings Basic Parameter Phone Number User Name Password Use Connection Manager Allow Roaming Typical Value 46811112222 XXXX YYYY Unchecked FALSE Checked TRUE Circuit Switched Settings Advanced Parameter Command String Wireless LAN Settings Parameter Use Intermec Settings Profile SSID Network Type Channel WWAN Toolkit User s Guide Typical Value CBST 71 0 1 Typical Value Unchecked FALSE Profile 1 Profile 4 myWLAN Infrastructure 1 11 Chapter B Connection Types Description Phone number supplied by your network operator to connect to their network User name obtained from network operator Password obtained from network operator This checkbox lets your connection be registered with MS Connection Manager MS Connection manager allows applications such as Pocket Internet Explorer to use your connection The drawback is that it also prompts notification dialog boxes about the current connection manager status and permits the user to terminate a connection manually If this checkbox is checked the connection wil
6. 22 D initializing the AP st A ads a ohe ds dua ab 22 4 TOO Sii An 23 Device DW ais es ars Asari nome ues eae E A a 24 Connectivity Profile Manager sn een cv Aaa 25 SHE the Tools way a ae nah wr O Kanai ay 23 Cre ting a new profiles ui NEN 25 Creating a new connection 6 eee cece eee 26 Ping es E bs 30 Adding a connection to a profile 2 2 00 ame mund 31 Deleting a connection from a prohl dnou basa en 32 Deleting editing a connection a ser o hee woes Shaw eh bee wee 32 Loadine Modifying a profile rn es so t Hirn 32 Ordering Connections within the Profile 33 Copying Profiles from a device use ea an 33 WWAN Wizard Visual Studio 2003 Plugin for C NET 34 Using the Wizard under nenat a ee ne 34 Common Components 4444444444444 400 37 Power Manager WWANPowerManager cs 37 PIN Query FrmRequestPin cs 37 Start Form POMAR RAR ato ar 37 Selectable Components ut ein 37 Voice Dialler FrmVoiceDialer cs 000 aa ac 38 Phone Book FrmPhoneBookes an a 38 SIM PIN Handler TASA AA Ad dy 38 SMS Inbox Erms MS Ibor 2 ea 38 SMS Sender FrmSMSSender cs empire 38 Data Com RAS Conn Mgr DialupData cs 38 Putting together a working application Example 39 5 A kk eines ie ese Sy ee be A 41 XXDDIIE the Sample 328140010006 era ae 42 C
7. SMS messages SIM PIN Handler Manage SIM PIN security Data Com RAS Data communication using RAS Data Com Conn Mgr Data communication using MS Connection Manager 4 If you have selected any of the DataCom components in the previous step you will be asked to enter additional information Most of this is network specific and therefore has to be obtained via your network operator WWAN Toolkit User s Guide 35 Chapter 4 Tools 36 RAS Parameters Connection type Packet Switched GPRS 1xRTT O Circuit Switched GSM CDMA Access Point Name APN User name Password L Domain 4 DHCP TCP IP Settings IP Address AA DNS Alternative DNS WINS Alternative WINS Behaviour I Reconnect Timeout Cancel Next gt de The Behaviour parameter tells the application whether or not to reconnect when a connection has been dropped The Timeout parameter specifies the duration in minutes of the reconnection attempt Click Next when all data has been entered The source code is being added to your project Note that the References folder contains a reference to the WWAN Toolkit NET wrapper WWAN Toolkit User s Guide Chapter 4 Tools Solution Explorer myWWANProject alala a Solution myWW ANProject 1 project Ei GH myWWANProject E y References 9 Intermec Communications WWAN 2 Microsoft WindowsCE Forms z MSCorLib 21 System System Data LJ S
8. The Intermec WWAN Toolkit is a powerful Software Development Kit with which it is easy to build mobile applications that facilitate communication across cellular networks It gives the developer the freedom to focus on the core design task at hand without having to consider 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 It works on all Intermec Mobile Computers equipped with a WWAN radio It also incorporates LAN and WLAN functionality helping developers to make their mobile applications even more versatile TheWWAN Toolkit consists of two Application Programming Interfaces APIs The WWAN Toolkit Core API is targeted for applications that require only WWAN communication The WWAN Toolkit Connectivity API on the other hand has a smaller subset of WWAN methods but adds the capability to automatically or manually switch between WWAN WLAN and LAN communication The two APIs cannot be used in parallel so the choice of which API to use must be made early in the development process As a general rule you should utilize the Core API when you need a fully featured WWAN API and choose the Connectivity API when you need network switching capabilities Note Even though the WWAN Toolkit may in some cases operate together wit
9. Toolkit User s Guide WWAN Toolkit User s Guide Document Change Record This page records changes to this document The document was originally released as version 001 Version Number Date Description of Change 003 10 2006 Revised to support software release 5 2 Added references to the CN3 mobile computer iii WWAN Toolkit User s Guide Contents Contents Before You Beein ar na N EN We ER RR viii Global Services and Support io heras nr nnd viii Wartanty Information siea eke Da lebe viii Web Suppott were NADIA viii Telephone Support sta shunt Saree ea eis viii Who Should Read This Manual un es a ees en ix Related Docnments ann ee SW et Au och ix 1 Introduction 14222006291 o ed N 1 O AA al 2 WWAN Toolkit Gore AP ata idad een 2 WWAN Toolkit Connectivity API ac a a deda SN 5 3 2 Getting Started una ee euere 5 Installing the WWAN Toolkit ona PC use aa ei aan 6 Installing the WWAN Toolkit on your Mobile Computer 6 Developing Applications in Different Environments 7 Carp Development c 6S A lr de o 7 Additional Installation Information ar date a v 7 NET Development CF and VB NET ae a aan 8 Additional Installation Information cupido 8 Jaya Development daa ica du a he pupa Rep vi Ba pay 9 Additional Installation Information 9 Running the Toolkit Core in your Development Environment Emulator
10. Type Infrastructure Device Type Unknown 5 Transfer complete Refresh Close O ro O O O O 9 O O O COCOS o wEIECS 24 WWAN Toolkit User s Guide Chapter 4 Tools Connectivity Profile Manager The Connectivity API is configured through XML files These files are created with a tool called the Connectivity Profile Manager A profile determines the overall behavior of the API and contains one or more connections A connection contains data about a specific network PSD CSD WLAN LAN such as APN SSID etc Profiles are loaded using the SetProfile string name method and once a profile has been loaded the API determines what connections are available and automatically selects the cheapest media To start the tool e Select Start Menu gt Programs gt WWAN Toolkit gt Tools gt Profile Manager The tool can also be started from the Tools menu in Visual Studio Creating a New Profile The first thing you will see when you start the application is the Profile view To create a new profile 1 Select File gt New D Connectivity Profile Manager o x File Help Profile Name Connections Truck Driver Power Management Always On v O Disable automatic switching O Suppress SMS L Suppress Incoming Voice Calls KEN CEI 2 Enter a name for your profile This would typically be a name that describes when and where the profile should be used for e
11. WWANToolkit5_2 ARM CAB Cab Files Signed WWANToolkit5_2 ARM CAB Connectivity API Connectivity API C include StructUtil cpp StructUtil h ConnectivityErrorCodes h ConnectivityObjects h Connectivity Toolkit h Connectivity API C lib ConnectivityApi dll ConnectivityApi lib Connectivity API DotNet doc Files used during installation Connectivity API DotNet lib ConnectivityApi dll Connectivity API Java lib ConnectivityApi dll ConnectivityJNI dll connectivity jar Documentation Intermec Communications WWAN ConnectivityApi dll Modem definitions for 760 GSM Toolkit cab file to be installed on device Toolkit cab file to be installed on a secure CN3 Utility class to be used when extracting information e g GetConnection Header for the above cpp Error code definitions Events structs and other generic definitions Main header method definitions Connectivity Binary Library file Connectivity binary NET wrapper binary Connectivity binary JNI wrapper binary Library file All documentation can be accessed through Start Menu gt WWAN Toolkit gt Documentation Plugins Plugins DotNet C Plugin Wizard installed in Visual Studio see Tools section of the User Guide for more information Samples Sample source code assembled according to API Please refer to the samples section of the User Guide for more information Tools Tools Devicelnfo Device information tool Ple
12. and connections to be created with the Connectivity Profile Manager tool before execution Please refer to the Tools section of this manual for further information Also shows all events received from the Connectivity API in a listbox This example shows how to take advantage of the Connectivity API Before the application can be used you need to create XML files containing your profiles and connection settings This is done in the desktop application Connectivity Profile Manager see the Tools section for more information During start up the GUI is displayed and the profiles and connections available in the XML files located in the Windows directory on the handheld device are read and populate the drop down boxes The application consists of three forms the Connectivity Ping and Eventlog forms In the Connectivity form the user can choose to set a profile or lock manually connect on to a specific connection When a profile is selected and the Set button pressed the switching functionality of the Connectivity API is used to see which of the connections for the specified profile are available and which one is ranked the highest Since LAN is normally cheaper and faster than WWAN it should be given higher priority The switcher will use the selected connection as long as it exists and no higher ranked alternative becomes available With the Lock button you can force the Connectivity To
13. between different networks Typically you will need to retrieve the APN and your user name and password from the network operator If your network does not utilize DHCP press the TCP IP button and fill out the form according to the network preferences The Connectivity API can either use RAS or MS Connection Manager to connect to the Internet By checking the Use connection manager checkbox your connection will be registered with MS Connection Manager MS Connection manager allows applications such as Pocket Internet Explorer to use your connection The drawback is that it also prompts notification dialog boxes about the current connection manager status and permits the user to terminate a connection manually By checking the Allow Roaming checkbox your connection will be able to connect even if the WWAN radio is currently roaming through a different network than your home network Remember that roaming can be costly Pressing the Advanced button reveals some additional parameters A complete list of parameters for the packet switched connection mode is provided in Appendix B WWAN Toolkit User s Guide 27 Chapter 4 Tools 28 Circuit Switched GSM CDMA Connection Settings Connection settings Name Media Vodafone CSD Circuit Switched Data Circuit Switched Data CSD Phone Number User Name Password 7 Use connection manager Allow roaming TCPAP Ping test Ad
14. close down all internal variables and also make a clean exit from the network Power off the radio Use the WWANRadioPowerOff to power of the radio After this method has been called no other Toolkit method should be called except for WWANRadioPowerOn About Data WWAN Connections 12 There are two types of data connections and two different methods to establish them Types e Packet Switched Data This is done through the GPRS and 1xRTT 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 e 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 WWAN Toolkit User s Guide Chapter 2 Getting Started Methods e RAS This method is the core communication module for Windows This will establish a TCP IP stack that is capable of communicating with the network or the Internet After a connection has been established applications can in their turn open sockets to servers that are available on the network The RAS API will not display any pop up windows about the current state of the connection process e Connection Manager This exists on top of the RAS API Applications that are Connection Manager aware can use the s
15. describes how to implement some typical features ofa WWAN application using the Connectivity API It is assumed that you are already familiar with the Profile Manager Tool and know how to deploy profiles to your mobile device If this is not the case refer to the Tools chapter in which the functionality of Profile Manager is thoroughly described Before anything else can be done you need to initialize the API This is done by calling the Initialize method Automatically Switching Between Connections Automatic switching is performed by simply calling the SetProfile L MyProfile method where MyProfile represents the name of the connection you want to use After making the SetProfile call you need to monitor the events from the switcher a CONNECTIVITY_EVENT_ SWITCHER SUCCESS event indicates that the switcher has found an available connection and connected through it The CONNECTIVITY_EVENT_CONNECTION_CONNECTED event that precedes the switcher success event will tell you the index of the connection being used This index can be used with the GetConnection method to obtain the name of the connection Locking a Connection When you want to force the switcher to stay connected to a particular connection e g when transferring data you should call the Lock NULL method By supplying a null value as the parameter you tell the API that you want to use whatever connection is used at the moment until Unlock
16. dll must be registered on device Library file 67 Appendix A Toolkit Files 68 WWAN Toolkit User s Guide WWAN Toolkit User s Guide B Connection Types This appendix provides detailed descriptions of each connection type that can be used when you are working with WWAN Toolkit Connectivity development 69 Chapter B Connection Types Packet Switched Settings Basic Parameter APN Access Point Name User Name Password Use Connection Manager Allow Roaming Typical Value Internet vodafone net XXXX YYYY Unchecked FALSE Checked TRUE Packet Switched Settings Advanced Parameter PDP Address Command String Disable CHAP Disable PAP 70 Typical Value 192 199 199 2 SGAUTH 2 FALSE FALSE Description GPRS networks only APN is obtained from your network operator Some networks do not require an APN User name obtained from network operator Password obtained from network operator This checkbox lets your connection be registered with MS Connection Manager MS Connection manager allows applications such as Pocket Internet Explorer to use your connection The drawback is that it also prompts notification dialog boxes about the current connection manager status and permits the user to terminate a connection manually If this checkbox is checked the connection will be able to connect even if the WWAN radio is currently roaming through a different network than your home network
17. 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 that there is a connection but the microphone and speaker on the device seem dead WWAN Toolkit User s Guide Chapter 6 Frequently Asked Questions A If you have upgraded your OS firmware the speaker and microphone volume levels are sometimes set to zero by default Use SetSpeakerVol and SetMicVol to change the levels as preferred 3 O How do I retrieve the phone number of the device A Use the GetPhoneNumber method 5 LAN 1 Q The Connectivity API cannot detect LAN Whats wrong A Make sure there is no serial and or USB cable connected to the dock Ethernet is automatically disabled whenever the device is connected via USB Make sure you have a LAN connection defined and that it is added to your profile If there is no LAN connection defined the switcher will discard the availability of Ethernet WWAN Toolkit User s Guide 53 Chapter 6 Frequently Asked Questions B Development Issues 1 1 2 54 Common Q A Can I run an application which utilizes COM port 4 or COM port 5 at the same time as the WWAN Toolkit No The WWAN toolkit requires access and control of both COM4 and COMS at all times on the Intermec 760 If you choose to do so this might cause unpredictable results On Phone Edition units however COM5 1s not used by th
18. more than three times will lock the device In this event a PUK code is required to unlock it WWAN Toolkit User s Guide 11 Chapter 2 Getting Started Select network operator GSM only Use the Automat icNetworkRegister 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 be required to select the operator If this is the case see the Network Selection Functionality section in the WWAN Toolkit C API Programmers Reference Manual Setup event reporting All applications that require events from the toolkit must register their interest through SetModemEvent Reporting This method will make sure that the application can receive events concerning the network the connection process and incoming voice calls and SMSs Error handling Errors reported by methods in the Toolkit can be retrieved through two methods The Get Last WWANErrorCode will return the last known error code and Get Last WWANErrorString will return a string representation of the last error code Using these methods will help applications handle the problems and notify the user Shutting Down the Toolkit and the Radio Before powering off the radio the toolkit must be cleanly exited The following describes the advised steps to do this Shut down the Toolkit To shut down the toolkit call the Shut DownTool Kit method This will
19. source pointing to the com intermec wwantoolkit package Note Users who have developed applications with older WWAN Toolkit versions can still use the com intermec c700 wwantoolkit jni package since this is still supported However the wwantoolkit package adds object oriented Java classes and is easier to use The com intermec c700 jni package is not documented in this release Connectivity API Development 1 Copy ConnectivityJNI dll to the Windows folder of your device the dll is located in INSTALLDIR ConnectivityAPI Java lib 2 Add a reference to the connectivity jar file located in INSTALLDIR ConnectivityAPI Java lib Add an import statement to your source pointing to the com intermec wwantoolkit connectivity package Remember to add the jar file to your class path as well as copying it to the device Chapter 2 Getting Started Running the Toolkit Core in your Development Environment Emulator The WWAN Toolkit adds the feature to test your applications in your development environment as if they ran on a mobile computer all methods return TRUE without performing any actual radio interaction The emulator dlls are located in INSTALLDIR W WAN ToolkitCore Emulator Embedded Visual C 4 0 1 Add the headers found under INSTALLDIR WWAN ToolkitCore C Include and lib INSTALLDIR WWAN ToolkitCore Emulator to your project 2 Start the Windows CE Remote File Viewer cefilevw exe is normally located i
20. sure that there is a cellular network available before attempting to connect Use SignalStrength to determine if the signal is strong enough to successfully establish a connection A signal strength of 0 means that there is no network available and all connection attempts will fail Checking for PSD network This is only needed if the connection is a Packet Switched data connection The Get GPRSAttach method will confirm the availability of a GPRS or 1xRTT network In GSM networks the radio must attach to the GPRS network before it can be used SetGPRSAttach will attach it to the GPRS network In CDMA networks the radio is automatically attached when started so there is no need to call Set GPRSAttach After attaching to the PSD network check the attach status through Get GPRSAttach If there is no PSD network available all PSD connection attempts will fail WWAN Toolkit User s Guide WWAN Toolkit User s Guide Chapter 2 Getting Started Setting up GPRS APN GSM ONLY This is only needed if the connection is a PSD connection used in a GPRS network The APN is set up through the GPRSSetupContext method The APN can be set up using that method or adding it as a extra dial command in a RAS entry Make the WWAN Connection Establishing connections can take a long time and therefore all of the methods included in this process are asynchronous which means that they will start the connection process but the connect
21. the form to be activated to receive incoming SMSs This is however depending on implementation and design choices made by the user It is also wise to delete the message instantly upon arrival and store it in a database or file to make sure that the SIM card is not swamped with messages Data Com RAS Conn Mgr DialupData cs Holds the parameters for the connection this is typically where you would change your parameters if they where incorrect or if the operator had changed the network requirements The class is instantiated by WWANConnector cs If you want to change a RAS connection to MS Connection Manager or vice versa you can easily change the parameter according to your likings B public bool UseConnectionManager FALSE WWAN Toolkit User s Guide Chapter 4 Tools Data Com RAS Conn Mgr WWANConnector cs The WWANConnector class handles the logic behind the connection process It is responsible for setting up connecting and disconnecting the connections Data Com RAS Conn Mgr FrmConnector cs The simple FrmConnector form utilizes the WWANConnector class to connect and disconnect with RAS or MS Connection Manager depending on the settings Putting Together a Working Application Example Here is how you can create a simple working voice dialler 1 After you have selected your components you need to create an instance of the forms in your start form FrmMain Add a button to FrmMain
22. versions of the WWAN Toolkit requires a previously installed version of the software e The toolkit only supports the Windows XP and Windows 2000 platforms Installing the WWAN Toolkit on Your Mobile Computer Please note that the WWAN Toolkit currently supports the following platforms e 760 GSM CDMA running Pocket PC 2003 or Windows Mobile 2003 e 761A GSM CDMA running Pocket PC 2003 or Windows Mobile 2003 e 761A GSM CDMA running Windows Mobile 2003 Phone Edition e 761B GSM CDMA running Windows Mobile 2003 Phone Edition e CN3 GSM CDMA running Windows Mobile 5 0 Phone Edition To install the WWAN Toolkit on your mobile computer 1 Copy the WWANToolkit5_2 ARM cab file located in INSTALLDIR Cab Files to your mobile computer If you are planning to develop applications for data communications on the 760 GSM unit or if you wish to use the WWAN Toolkit Connectivity API copy Modems_MC45_All cab as well Refer to Appendix A for a complete list and descriptions of all the files installed 2 Execute the file s on your mobile computer 3 Please observe additional installation steps required for the different development environments in the sections ahead 4 Warm boot the device WWAN Toolkit User s Guide Chapter 2 Getting Started Developing Applications in Different Environments C Development WWAN Toolkit User s Guide This section gives a brief description of how to get started developing WWAN applications
23. your networks Despite its relative simplicity it still supports the following functionality e Automatic or Manual Switching between WWAN WLAN LAN Profile and Connection Information e Device Information Event Handling e Telephony e Messaging SMS API documentation is distributed as separate manuals for each programming language Chapter 1 Introduction 4 WWAN Toolkit User s Guide WWAN Toolkit User s Guide 2 Getting Started This chapter covers the following topics Installing the WWAN Toolkit on a PC Installing the WWAN Toolkit on your Mobile Computer Developing Applications in Different Environments Running the Toolkit in your Development Environment Emulator Guidelines for Using the Core API Chapter 2 Getting Started Installing the WWAN Toolkit on a PC To install che WWAN Toolkit on your development PC simply insert the product CD in the CD drive and follow the on screen instructions If the installation does not start automatically open your browser and execute the Setup exe file located on the disk The installation reguires 30 MB of free disk space on your Windows drive Typically program files will be located in C Program Files Intermec WWAN Toolkit V5 2 Note Throughout this document this folder will be referred to as INSTALLDIR For a complete list and descriptions of all the files installed refer to Appendix A Also note the following e Upgrading from older
24. 2 Select the connections you want to add to the profile by clicking in the listbox WWAN Toolkit User s Guide 31 Chapter 4 Tools 32 3 The connection has now been added to your profile Repeat the process if you wish to add more connections to the profile When you are done select File gt Save The procedure described above can also be done by clicking the right mouse button in the list box on the profile screen and selecting New And Add The connection screen will appear and when you press Save the connection will be automatically added to your active profile You can automatically deploy to the device by selecting Save And Deploy from the menu The device must be connected to your PC via ActiveSync see indicator at the bottom left corner of Profile Manager You have now completed the process of creating a profile and can proceed to implement the necessary API calls in your project Do not forget that the complete documentation for the Connectivity API can be conveniently accessed via Start Menu gt WWAN Toolkit gt Documentation Deleting a connection from a profile Select the item to be deleted single click the left mouse button Right click on the list box and select Delete Deleting editing a connection Note You cannot delete a connection that is used in a profile If you want to delete the connection completely you have to remove the connection from all profiles first To delete or edit
25. Add your controls to show your WWAN forms here 2 In the click event handler add the following code sample shows the voice dialler private void buttonl_Click object sender System EventArgs e FrmVoiceDialer dialer newFrmVoiceDialer dialer ShowDialog WWAN Toolkit User s Guide 39 Chapter 4 Tools 40 WWAN Toolkit User s Guide WWAN Toolkit User s Guide 5 Samples This chapter contains descriptions of the sample code 41 Chapter 5 Samples About the Samples The sample source code is located in the INSTALLDIR Samples folder Each API has its dedicated subfolder Core and Connectivity located in the samples folder Each language in turn has their dedicated subfolder C Java C and VB located under each API folder To test the applications make sure you follow the installations and preparation steps described in previous chapters Core API Samples DataCom 42 The following samples can be found for each language in the WWAN Toolkit Core folder 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 netwo
26. Intermec l Va User s Guide h 0m WWAN Toolkit Intermec l Va User s Guide Te WWAN Toolkit Intermec Technologies Corporation Worldwide Headquarters 6001 36th Ave W Everett WA 98203 U 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 noticed and do not represent a commitment on the part of Intermec Technologies Corporation 2005 2006 by Intermec Technologies Corporation All rights reserved The word Intermec the Intermec logo Norand Arci Tech 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 Microsoft Windows and the Windows logo are registered trademarks of Microsoft Corporation in the United States and or other countries ii WWAN
27. a reference to the wrapper dll The reference is added by opening up the references dialog box and selecting Intermec WWAN Toolkit from the drop down list Note C developers can also use the Visual Studio 2003 plugin as Z described in Chapter 4 Tools Connectivity API Development 1 Include the NET wrapper dll in your application directory on the device The Connectivity API dll is called Intermec Communications ConnectivityDotNetAPI dll and can be found in INSTALLDIR Connectivity DotNet lib 2 To develop a NET application using the Connectivity API you need to add a reference to the wrapper dll The reference is added by opening up the references dialog box and selecting Intermec Communications ConnectivityDotNetAPI from the drop down list 8 WWAN Toolkit User s Guide Java Development Chapter 2 Getting Started Java development for Windows Mobile does not require a specific development environment which is why the setup procedure is not described in detail here Core API Development l4 WWAN Toolkit User s Guide 1 Copy WWANjni dll to the Windows folder of your device the dll is located in INSTALLDIR WWAN ToolkitCore 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 Add a reference to the wwantk jar file located in INSTALLDIR WWAN ToolkitCore Java lib Add an import statement to your
28. a connection 1 Select File gt Edit Connection 2 Select the connection that you want to delete edit 3 Press the Delete button located at the left to delete or edit the connection Then press Save Loading Modifying a profile 1 Select File gt Load 2 Select the profile from the list and make your changes as needed 3 Select Save And Deploy from the menu when you are done WWAN Toolkit User s Guide Chapter 4 Tools Ordering Connections Within the Profile Connections are automatically ordered within the profile based on their relative cost For example a LAN connection will receive a higher rank than a WLAN connection and a PSD connection will be placed above a CSD ditto This hierarchy can be disabled by manually re ordering the connections Any connection can be selected and then moved up or down in the list with the Up and Down buttons The Connectivity API will always try to use the connection on top of the list first provided this is available Connections My Local Network Milkyway manuall Telia PSD Copying Profiles From a Device You can copy all profiles and connections directly from a device To copy all profiles from a device 1 First make sure the device is properly docked see indicator in the cradle 2 Select File gt Copy From Device Your current Profiles are being saved as a backup you cannot merge your current profiles with the ones copied from the device importing select Restore fro
29. ame connection instead of establishing an entirely new one One example of such applications is the Pocket Internet Explorer Using Connection Manager will also display a bubble on top of all applications showing the connection process note that this bubble can be misused by certain users to enter faulty settings and disrupt the application Creating a WWAN Connection Entry The toolkit can create connection entries but it can also use settings configured by the user The steps below show how to create a PSD connection entry Create a dialling location Use CreateDiallingLocation to create the location that you are dialling from This is commonly a g g g entry within the PocketPC dialling location pages Create a RAS entry Use CreateRasEntry to create the RAS entry This requires all the parameters for the PSD network If you are unsure of those parameters please contact your network representative In most cases it is not necessary to set up all parameters and most of them can be left blank An application should only have to set up the connection parameters once during its lifetime but it is also possible to create them before and removing them afterwards There is one major difference between connecting to a PSD network in GSM and CDMA e When using GPRS the phone number should be 99 1 or 99 The GPRS APN can be set up using the extra dial commands Please refer to the complete method description in the API man
30. ase refer to the tools section of the User Guide for more information Tools Profile Manager Connectivity Profile manager tool please refer to the tools section of the User s Guide for more information WWAN Toolkit Core API WWAN Toolkit Core API C include WWANErrorCodes h WWANToolkit h WWAN Toolkit Core API C lib WWAN Toolkit dll wwantoolkit_mapirule dll WWANToolkit lib Error code definitions Main header file Main Core binary MAPI rule used by Phone Edition to direct SMS messages COM dll must be registered on device Library file WWAN Toolkit Core API Dotnet doc userguide Files used during installation produces help integrated into Visual Studio WWAN Toolkit Core API Dotnet lib Intermec Communications WWAN dll Core NET wrapper 66 WWAN Toolkit User s Guide WWANToolkit dll wwantoolkit_mapirule dll WWAN Toolkit Core API Emulator wwantoolkit dll wwantoolkit lib WWAN Toolkit Core API Java lib WWANjni dll WWANToolkit dll wwantoolkit_mapirule dll wwantk jar WWAN Toolkit User s Guide Chapter A Toolkit Files Main Core binary MATT rule used by Phone Edition to direct SMS messages COM dll must be registered on device Emulator dll compiled for x86 processors read more in the emulator section of the User Guide Library file JNI wrapper for WWAN Toolkit Core API WWAN Toolkit core binary MAPI rule used by Phone Edition to direct SMS messages COM
31. at handles both incoming and outgoing voice calls DTMF tones are also supported In a complete solution it is wise to move the event handling to the main form since keeping it in the voice dialler form requires that the form is activated in order to receive incoming voice calls This is however depending on implementation and design choices made by the user Phone Book FrmPhoneBook cs FrmPhoneBook contains a form that allows you to read write delete entries from the toolkit s built in phone book On the 76x and CN3 GSM devices this is synonymous to the SIM phone book The SIM phone book is very limited and we strongly recommend you to create your own phone book using a file or database SIM PIN Handler FrmSim cs FrmSim lets you lock and unlock your SIM card change the PIN code and unlock it using PIN amp PUK codes SMS Inbox FrmSMSInbox cs FrmSMSInbox has a simple GUI that allows you to read and delete SMS messages stored on the SIM card Rather than using this built in function which uses the SIM card for storage we recommend you to implement your own storage solution This is to prevent the SIM card memory from being overloaded SMS Sender FrmSMSSender cs FrmSMSSender allows you to send SMS messages It also notifies the user whenever a new SMS is received In a complete real life solution it would be wise to move the event handling incoming SMS to the main form since keeping it in the SMS inbox form requires
32. ction DHCP is set as default If your network does not use DHCP press the TCP IP button and fill out the form according to the networks preferences Ping Test Clicking the Ping Test button opens up a dialog box WWAN Toolkit User s Guide Chapter 4 Tools Ping addresses 4 Ping IP addresses V Ping verify connection IP address Add _ Delete selected Cancel Ping Testing against IP addresses is a way for the Connectivity API to verify that a connection is maintained The Connectivity API will not issue the connected event if not all addresses are reachable Check the box in the upper left corner enter an IP address and press the Add button Press Ok when you are done and remember to save your connection Delete an IP address by selecting it from the list and press Delete Selected Ping can also be achieved manually by issuing the command Ping in your code Remember that ping testing can be costly when connected through GPRS 1xRTT Packet Switched connections depending on the terms stated in the contract with your network provider Adding a Connection to a Profile When you have closed the connection screen and saved the connection you can add the connection to your profile To add a connection to a profile 1 If your profile is still active right click the Connections listbox on the right side of the screen and select Add Select a connection t milkyway 80211 Corporate LAN
33. d open up the project in the development environment before proceeding 1 In Visual Studio the plugin is started under Tools gt Intermec WWAN Toolkit gt Intermec WWAN Wizard Window Help Intermec WWANToolkit 5S Intermec WWAN Wizard ES Debug Pracesses Ctri lt P e Intermec Connectivity Profile Manager B Connect to Device Intermec Device Info 2 If you are creating a new project give it a name and tell the wizard where the project should be saved Click Next WWAN Toolkit User s Guide Chapter 4 Tools Add a new WWAN Toolkit Project A Project Name my WAN Project Storage location c sourcecode 5 _ Next gt Intermec E expect MORE 3 In the new dialog box select what type of components forms you wish to include in your project descriptions can be found in the table below thorough descriptions follow in the next section When you are finished click Next Intermec WWAN Wizard Please select required components M Voice Dialer O Phone Book O SMS Sender O SMS Reader O SIM PIN Handler O Data Com RAS O Data Com Conn Mar Intermec expectMORE Cancel Next gt Component Description Voice Dialer Simple voice dialer that can dial voice calls handle incoming calls and send DTMF tones Phone Book Read write and delete items from the built in phone book SMS Sender Send SMS messages receive SMS messages SMS Reader Read and delete stored
34. e Multi Frequency is the signal to the phone company that you generate when you press the touch keys of an ordinary telephone With DTMF each key you press on your phone generates two tones of specific frequencies ESN Electronic Serial Number Used on CDMA networks to identify the unit GGSN Short for Gateway GPRS Support Node The 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 GPRS Short for General Packet Radio Service a standard for wireless communications which run at speeds up to 115 kbps compared with the 9 6 kbps of current GSM systems GPRS which supports a wide range of bandwidths is an efficient use of limited bandwidth and is particularly suited for sending and receiving small bursts of data such as e mail and Web browsing as well as large volumes of data GSM Short for Global System for Mobile Communications one of the leading digital cellular systems GSM uses narrowband TDMA which allows eight simultaneous calls on the same radio frequency WWAN Toolkit User s Guide 61 Chapter 7 WWAN Glossary 62 IMEI International Mobile Equipment Identity A unique number given to every single mobile phone The number consists of four groups that looks like this nnnnnn nn nnnnnn n The first set of numbers is the type approval code TAC The first two digits represent the country code The rest make up the
35. e WWAN Toolkit Can I combine Cellcore TAPI ExTapi with the WWAN Toolkit On Phone Edition units you could possibly use a small subset of the APIs but you cannot use SMS or Voice functionality from Cellcore while running the toolkit The 760 does not support Cellcore APIs have previously written an application in Embedded Visual Basic Now that the the WWAN Toolkit no longer supports the COM wrapper what do 1 do Migrate your application to Java C VB Net or C Compact Framework The following Microsoft web page may be helpful http msdn microsoft com library default asp url library en us dnppcgen html fromemb asp NET 1 Q What does MissingMethodException NET mean A This means that the NET wrapper cannot find the native method or dll Make sure wwantoolkit dll is located in the windows directory of your device Make sure the wrapper is matching the dll you are using WWAN Toolkit User s Guide Chapter 6 Frequently Asked Questions C Connection Problems 1 Common 2 RAS 1 Q A b gt gt 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 w
36. ected The Datacom sample Description Main class where GUI and application is initialized Description Class that holds connection logic and reports events back to the GUI All connection parameters are stored in this class This example shows how to start up the toolkit and retrieve information from it 43 Chapter 5 Samples Phone Book 44 When the application is started it tries to power on the radio and then moves on to checking the status of the SIM card and retrieves information from the toolkit Filename Language Description Info java Java Main class where all relevant application FREE CH events take place FrmInfo vb VB NET InfoDlg cpp C Y 42502 Information retrieved with WWANToolkit Toolkit version 4 5 2 902 Radio firmware REVISION 03 06 Radio id 350450410043502 Radio model SIEMENS MC45 Operator name vodafone SE Operator id 24008 Subscriber id 240084600234108 Signal strength 4 The Info sample This example demonstrates how to use the phone book At startup the application powers on the radio checks the status of the SIM card and populates the phone book list The phone book entries are read either from the SIM card GSM devices or from file CDMA devices Since AWT Abstract Window Toolkit is used in Java it is not possible to add hidden data to a list item here Hence the index of the phone book entry is added to each list it
37. ection 1 Select File gt New Connection A new screen appears Connection settings Name Media Packet Switched Data Packet Switched Data Access Point Name APN User Name Password 7 Use connection manager V Allow roaming f TCPAP Ping test Advaned Delete Cancel Save 2 Enter a unique name for your connection that describes the connection type and the carrier WWAN Toolkit User s Guide Chapter 4 Tools 3 Select the media you want to use An overview of the different media types is provided in the table below Media Description Packet Switched PSD GPRS or 1xRTT dialup connection Circuit Switched CSD GSM or CDMA dialup connection expensive paid per minute as opposed to per packet Wireless LAN Using the built in WLAN card 802 11 LAN Ethernet via dock To be able to use Ethernet you have to add a LAN connection to your profile otherwise the switcher will disregard any available LAN connection USB cable cannot be inserted in the dock when using LAN Packet Switched GPRS 1xRTT Connection Settings Connection settings Name Media Packet Switched Data x Packet Switched Data Access Point Name APN User Name Password 7 Use connection manager M Allow roaming TCPAP Ping test Advaned Delete Cancel Save Mandatory parameters for a packet switched connection vary
38. ed as profiles in the API Each profile can contain a number of connections a connection in its turn can be made through a LAN WLAN or WWAN The API will read two XML files containing this information and use it to switch between the different networks The API will take care of all internal checking such as checking the availability of a network and relies on parameters to know when to switch to a different network All the application has to do besides initializing the API is to control when a different profile should be used WWAN Toolkit User s Guide Chapter 3 Using the Connectivity API Use Case Scenarios In order to accurately map out the different profiles an application will be using the user is recommended to construct case scenarios for it That way it is easier to see when a specific network is needed and when it is not Example Scenario Let us imagine the daily routines of an employee at a package delivery company Start of the day The messenger comes into the office and picks up the mobile computer from the docking station The unit is fully charged and has been updated with the latest delivery information and software during the night In the depot The messenger scans each package The package ID is sent to the database through WLAN On the road Inhis truck the messenger keeps in touch with his employer via voice calls and SMSs At the customer s site The custo
39. egistry HKEY_LOCAL_MACHINE SOFTWARE Intermec WWANToolkit SMSPassthrough Value and type is of no importance 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 on a 700 CXL 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 W WANToolkit SmsFileName The toolbar in Phone Edition signals No service when running a WWAN Toolkit application What is wrong As the toolkit takes control of all functionality that was previously handled by the operating system you can no longer rely on any tools included in the OS The WWAN Toolkit will still be able to query network status and perform its tasks as usual Our application previously used Siemens MC45 on COM4 CHAP Siemens MC45 on COM 4 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 You use it the same way you always have 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 COMA PAP CHAP Ican no longer start the phone application Pho
40. eless settings allows you to specify all your WLAN parameters through the Connectivity Profile Manager Enter your SSID and network type Ad Hoc also requires you to specify the channel used Connection settings E Name Media Mesa U Wireless LAN F Use Intermec wireless settings V Broadcast SSID rywLAN Network Type Infrastructure You can also set up your security by pressing the Security button These settings are not described in depth in this guide please refer to the documentation of your mobile device WWAN Toolkit User s Guide 29 30 Chapter 4 Tools WLAN Security Settings N E 8021x Security Association Encryption Noe S A jue E WEP Keys Keyl Key2 Kay3 Keyd Data TX Key ka H Note The Connectivity API currently only supports WEP WPA LEAP and PEAP TLS TTLS is not supported through the Profile Manager You can however still utilize TLS TTLS by applying Intermec wireless settings Microsoft Zero Config is not supported LAN Connection Settings Connection settings Name Media fa BH _TCPAP_ Ping test Delete Cancel LAN only has settings for TCP IP If you do not create a LAN connection the switcher will assume that you do not wish to utilize a LAN even if it becomes available Typically the only thing you need to do is to create a connection name it select LAN as media type and save the conne
41. em in the rightmost position of a pipe separated string Filename Language Description PhoneBook java Java Main class where all relevant application FrmPhoneBook cs C events take place FrmPhoneBook vb VB NET PhoneBookDlg cpp C WWAN Toolkit User s Guide Chapter 5 Samples Phonebook Y 42 5 15 ok John Smith 555123456 Jenna Scott Name Jenna Scott Number 555666777 The Phonebook sample SimPin This example demonstrates how to use the SIM Subscriber Identity Module security functionality During application startup the radio is powered on and the status of the SIM card is read Based on the current status buttons for each available option are enabled Example If the SIM card is locked and requires the PUK Personal Unblocking Key code to be unlocked only the button entitled Enter PUK will be enabled The available functions are entering the PIN Personal Identification Number and PUK number if the card is locked changing the PIN number and enable disable the PIN lock on the SIM card Filename Language Description SimPin java Java Main class where all relevant application ES CH events take place FrmSimPin vb VB NET SimPinDlg cpp C WWAN Toolkit User s Guide 45 Chapter 5 Samples SMS 46 M 4 5 26 Current Status PinReady PIN Code New PIM Code PUK Code Enter PI PIN Change PIN Enter PUK
42. er s session information when the subscriber has a session active When a mobile device wants to use GPRS it must first 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 e The subscribers IP address e The subscribers IMSI e The subscriber s WWAN Toolkit User s Guide Chapter 7 WWAN Glossary 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 Switching Packet switching is a method of switching data in a network where individual packets of a set size and format are accepted by the network and delivered to their destinations The sequence of the packets is maintained and the destination established by the exchange of control information also contained in the packets between the sending terminal and the network before the transmission starts The network is open to all users all the time with packets from the various nodes being interleaved throughout the network The packets can be sent in any order as the control information sent at the beginning of the transmission ensures they are interpreted in the correct order at the receiving end Because each packet carries its own control instructions it can use any route
43. ers are added for each event The Connectivity Toolkit is referenced using the with events attribute All window events sent from the toolkit are acknowledged and redirected to the appropriate handler method For simplicity the application is developed with CTabCtrl in C instead of using separate forms Filename ConnectivityFrame java ConnectivityForm cs ConnectivityForm vb ConnectivityDlg cpp Language Description Java Main class where all relevant application CE events take place VB NET C WWAN Toolkit User s Guide WWAN Toolkit User s Guide 6 Frequently Asked Questions This chapter addresses some of the issues that may come up when the WWAN Toolkit is used to develop software applications 51 Chapter 6 Frequently Asked Questions A Network Issues 52 Common Q A My application fails to enable modem event reporting Why is this Typical sequence PowerOn Setup EnableModemEventReporting Make sure you have a SIM card On the 760 the toolkit will not report an error unless event reporting has been enabled What characters are supported when sending receiving SMSs On the 760 the PDU 7 bit alphabet is used Refer to http www dreamfabric com sms default_alphabet html CDMA Q A m gt A Why does SetGPRSAttach always return FALSE on CDMA You can only perform GetGPRSAttach on CDMA This verifies that the 1xRTT network is available there is no need to attach
44. ess technology 59 Chapter 7 WWAN Glossary 60 1xRTT Short for single carrier 1x Radio Transmission Technology a 3G wireless technology based on the CDMA platform 1xRTT has the capability of providing speeds of up to 144 kbps 1xRTT is also referred to as CDMA2000 700C Models supported The following 700 models are supported by the toolkit e 700C a k a 760 e 700CXL a k a 761 700C comes with two different radio options e Siemens MC45 GSM e Sierra Wireless SB555 CDMA 700CXL comes with two different radio options e Siemens MC45 GSM Sierra Wireless EM3420 CDMA APN Short for Access Point Name An access point is An IP network to which a mobile can be connected e A set of settings which are used for that connection e 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 then used in a DNS query to a private DNS network This process called APN resolution finally gives the IP address of the GGSN which should serve the access point At this point a PDP context can be activated Circuit Switching A circuit switched network is a type of network in which a physical path is obtained for and dedicated to a single connection between two end points in the network for the duration of the connection Ordinary voice phone service is circuit switched The telephone company reser
45. final assembly code The second group of numbers identifies the manufacturer 01 and 02 AEG 07 and 40 Motorola 10 and 20 Nokia 4land 44 Siemens 51 Sony Siemens Ericsson The third set is the serial number and the last single digit is an additional number usually 0 IMSI International Mobile Subscriber Identity Identifier used by GSM networks to identify different cellular devices MMS Short for Multimedia Messaging Service With an MMS compatible handset you can send and receive a combination of text images sound and video Multiplexing Multiplexing means the sending of multiple signals or streams of information on a carrier at the same time in the form of a single complex signal and then recovering the separate signals at the receiving end Throughout the WWAN Toolkit manual we are referring to the toolkit s ability to create and handle several virtual COM ports to support modem interaction when connected via RAS or via the Connection Manager Network Operator See Service Provider PAP PAP or Password Authentication Protocol is the most basic form of authentication in which 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 PDP The PDP context is a data structure present on both the SGSN and the GGSN which contains the subscrib
46. h other applications or SDKs that interact with the WWAN radio Intermec does not recommend this as it might cause unpredictable results WWAN Toolkit Core API The WWAN Toolkit Core API offers a rich API for WWAN interaction At the same time it simplifies the development procedure by being less complex than the majority of low level APIs currently available on the market The user does not need to understand complex AT protocols and the toolkit works across various operating system platforms The various functions of the API relate to the following main categories Power Management e RAS and Connection Manager Data connectivity e SMS Voice Calls e SIM Card Management Phone Book e Network Information WWAN Toolkit User s Guide ES Chapter 1 Introduction e Radio Information Note The Core API does not contain any functionality for WLAN interaction but this can be achieved by utilizing other Intermec APIs such as 8021 lapi dll and 80211pm dll in conjunction with the Core API The WLAN APIs are described in the 700 series manual and the IDL documentation For more information visit www intermec com idl WWAN Toolkit Connectivity API WWAN Toolkit User s Guide The Connectivity API is a library built upon the WWAN Toolkit Core and various other Intermec libraries The API which has been cut down to a small number of methods does not replace the WWAN Toolkit but is merely an alternative way of getting access to
47. he method CreateRAS Connection con found in the WWAN Communicator source code included in the WWAN Toolkit C samples WWAN Toolkit User s Guide Chapter 6 Frequently Asked Questions D Operating System 1 Windows Mobile 2003 1 Q A My modem WWAN Application has stopped responding after I reflashed my 761 to WM2003 Premium What could be the reason for this If you have a 761 that was previously running Phone Edition and you reflash it to run Premium Edition instead you will need to reset the user defined profile stored in the MC45 to factory defaults This is because Phone Edition changes the result code format ATVx in the user defined profile to be numeric whereas most modem software written for Premium Edition expect text results such as OK and ERROR To reset the user defined profile in the MC45 to factory defaults you need to send two AT commands AT amp F will set all current parameters to manufacturer defaults AT amp W will then save those parameters to the user defined profile in non volatile memory 2 Windows Mobile 2003 Phone Edition 1 Q Iam using the WWAN Toolkit on a 700 CXL device and I want my SMSs to end up in my inbox without being grabbed by the toolkit How do I accomplish this Why does SetGPRSAttach always return FALSE on CDMA The SMS is handled by the Toolkit 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 r
48. hen I create a RAS Connection 115200 bps This parameter has no significance on 7x1 or CN3 devices running Phone Edition on 7x0 machines and machines running Premium 115200 is the maximum speed I get RAS Error 619 The Port Is Disconnected What does this mean Something is wrong with your network settings Make sure you have the correct APN username and password and any other parameters required by your operator Most common source of error incorrect APN 3 Connection Manager 1 Q A Why do I receive a No path to destination message when I am trying to establish a ConnectionManager 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 it 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 4 GPRS 1 Q Why does the toolkit not let me know when I have lost my packet switched connection A The PSD networks usually take somewhere between 20 minutes 2 hours to ve
49. in different programming environments If you are planning on building a data communications application you will need to start by obtaining certain network information e Contact your GSM CDMA network operator and request the data you need to be able to connect to the WWAN network On GSM this is typically an Access Point Name APN For instance CDMA often requires a user name and a password e Ifyou are planning to use the Connectivity API and WLAN contact your IT department to obtain SSID and security preferences for your local WLAN Since each API and programming language has its own reference manual this guide does not contain any API listings Please refer to the main page of the documentation which can be located via the Start Menu on your PC for more information Source code samples can be found in INSTALLDIR Samples API Language and are described in the Samples section of this guide The WWAN Toolkit supports development in Embedded Visual C 4 and Visual Studio 2005 CN3 devices only Core API Development 1 Add a link reference to the WWAN Toolkit lib file located in INSTALLDIR WWAN ToolkitCore C lib To add the reference select Project gt Settings in the menu bar Click the Link tab and in the Category drop down menu select Input 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
50. in the Connectivity APL To obtain information about your device 1 Start the tool via the Start Menu gt WWAN Toolkit gt Tools gt Device Information 2 Put the device in the cradle and make sure it is connected via Active Sync the icon located in the bottom left corner of the application should read Connected 3 Press the Refresh button The process takes 60 seconds to execute do not remove the device from the cradle during this time 4 When the process is complete you can expand the tree view to see detailed information of your system Note The configuration information is also stored as a file on your PC Z Devicelnfo txt located in the Tools folder Include this file in support errands as it will allow Intermec support staff to resolve issues more efficiently WWAN Toolkit Device Information Windows CE Version 4 20 0 Intermec OS Build Version 4 51 PSM Version 3 77 Device Configuration CN 761481G2E 7005803 Serial Number SN B9600401040640E 9D Device Model 740 Phone Edition Yes WWAN Module Yes WLAN Module Yes BlueTooth Module Yes E Ri WWAN Information Device Name SIEMENS MC45 Serial Number 35045041 3342653 Subscriber ID 240010900380362 Firmware REVISION 04 03 Network Operator TELIA 5 Network Operator ID 24001 Device Type GSM r WLAN Information SSID INTERMEC BSSID Access Point 00 00 00 00 00 00 MAC Address 00 02 78 ef 92 21 Network
51. ion is not yet 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 Those methods will start the connection process and will only return FALSE if there is a major problem with the connection parameters The Toolkit will send events until the connection has either been established or dropped and applications must await the appropriate connection event before they can start communicating with servers To ensure that the connection has been fully established it is considered best practice to 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 it is best to make sure that it is still functioning as it should 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 Dropping the WWAN connection To terminate a Connection Manager connection use DoDialUpHangup To terminate a RAS connection use DoRASHangup 15 Chapter 2 Getting Started 16 WWAN Toolkit User s Guide WWAN Toolkit User s Guide 3 Using the Connectivity API This chapter contains the following topics e Introducti
52. l be able to connect even if the WWAN radio is currently roaming through a different network than your home network Remember that roaming can be costly Description AT command to execute before connection is attempted Description If unchecked all parameters are configured through the Profile Manager Tool If checked parameters on the device will be used according to the selected wireless profile Only when Use Intermec Settings is checked The SSID of your wireless network Infrastructure switcher based network Ad Hoc Device to device network Only when Ad Hoc has been selected 71 Chapter B Connection Types 72 WWAN Toolkit User s Guide Intermec Worldwide Headquarters 6001 36th Avenue West Everett Washington 98203 U S A tel 425 348 2600 fax 425 355 9551 www intermec com WWAN Toolkit User s Guide P N 1 960641 03
53. les This second choice works well in combination with Intermec Smart Systems as you can let the Smart Systems console be responsible for setting up the parameters If your network does not utilize DHCP press the TCP IP button and fill out the form according to the networks preferences The Broadcast checkbox indicates that the SSID is broadcasted This tells the Connectivity API that it should only try to connect to a network if it finds an SSID that matches the same SSID that you have specified WWAN Toolkit User s Guide Chapter 4 Tools If the checkbox is unchecked SSID will not be broadcasted and the Connectivity API will only attempt to connect when it finds an unnamed SSID with sufficient signal strength Having SSIDs that are not broadcasted consumes more power and is a lot slower than having broadcasted ones We strongly recommend that you use only broadcasted SSIDs SSIDs that are not broadcasted offer a low level of security since they can easily be sniffed Selecting the Use Intermec wireless settings checkbox tells the Connectivity API to utilize a pre configured wireless profile found on the device note that this is not a connectivity profile but a wireless settings profile found on the device Connection settings E Name Media Wireless LAN zi Wireless LAN Use Intermec wireless settings IV Broadcast Profile Profie_1 y _ TCPAP Ping test Delete Save Deselecting Use Intermec wir
54. m Backup The profiles copied from the Z Note In case you wish to restore the profiles you had on your PC before device will now be replaced by the backed up profiles WWAN Toolkit User s Guide 33 Chapter 4 Tools WWAN Wizard Visual Studio 2003 Plugin for C NET Using the Wizard 34 ES The WWAN Toolkit comes with a plugin that integrates with Visual Studio 2003 and greatly simplifies the development process of WWAN applications It currently supports automatic code generation C for the WWAN Toolkit Core API You can either add WWAN enabled forms to your existing solution or create a new solution with WWAN enabled forms with a few simple clicks If you choose to install the plugin see WWAN Toolkit installation instructions you should restart your development PC to load the plug in alternatively issue the devenv setup command The plug in can easily add WWAN enabled source code into your existing projects or create a brand new smart device solution containing WWAN enabled source code You can open up any of the source code files forms and modify them as you wish Take the opportunity to add your own look and feel to the forms and make them appear less generic Some of the forms might require additional code to work in a real life situation but as the wizard cannot dictate how you design your projects the choice is up to you Note If you wish to add source code to an existing project you shoul
55. mer signs off each package electronically The mobile application updates the status of each delivered package on the server through WWAN The application downloads new delivery and pickup information Back at the office depot The messenger heads out for another round of deliveries and pickups or docks the mobile computer and goes home for the day Based on this scenario it seems appropriate to set up the following profiles for the application Depot WLAN LAN On the road WWAN and Customer site WLAN WWAN Note that WWAN has been excluded from the Depot profile this is to avoid unnecessary costs Once the application has confirmed that all packages have been scanned the messenger is ready to move out and the application tells the API to switch to the On the road profile This profile allows only for WWAN connections and will not try to connect to any WLAN that will coincidentally come into range When the messenger has arrived at the customer site the application loads the appropriate profile and the messenger can once again send and receive data from the HQ server via WLAN if this is available WWAN Toolkit User s Guide 19 Chapter 3 Using the Connectivity API For more information on setting up profiles refer to the section describing the Connectivity Profile Manager in the Tools chapter Guidelines for Using the Connectivity API Initializing the API This section
56. n the folder C Program Files Windows CE Tools Common Platman bin Connect to Pocket PC 2003 Emulator 3 Open up the Windows folder 4 Select File gt Export File browse to the emulator dll and select it 5 Start your project with the emulator running in the background Visual Studio NET 2003 1 Add a reference to the WWAN Toolkit NET wrapper 2 Click the right mouse button in the Solution explorer of your project and select Add gt Add Existing Item 3 Browse to the emulator dll select the dll 4 Make sure that the build action is set to Content for the dll in the properties window 5 Start Run your project and select Pocket PC 2003 Emulator as your target when deploying Java Environments WSDD 1 Add a reference to WWANToolkit jar 2 Add a system property called emulate that is set to ON With emulate the JNI DLL is never accessed and the JNI access methods return canned responses Demulate off will turn emulation off Or just remove Demulate from the JVM startup To set a system property in command prompt add Demulate 0N to the argument list 10 WWAN Toolkit User s Guide Chapter 2 Getting Started Guidelines for Using the Core API When the WWAN Toolkit is used to interact with the modem use the following as a guide to correctly set up the modem and the Toolkit Core Initiating the Toolkit and Radio Power on the radio The radio must be powered on before it can be
57. ne Edition once I have started my WWAN Toolkit application What is wrong WWAN Toolkit User s Guide 57 Chapter 6 Frequently Asked Questions 58 EZR A gt If you warm booted the device or your application crashed just 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 Can I use the Phone Edition applications Phone Application Inbox etc at the same time as I am using the WWAN Toolkit No you cannot The toolkit needs to be in full control Why can I not uninstall the WWAN Toolkit on the device Phone Edition Warm boot the device to release the OS handle to the dlls Uninstall the toolkit On my Phone Edition unit I want to be able to control voice calls using the built in dialer How do I do this By adding the registry key SOFTWARE Intermec WWANToolkit PhoneApplication Note that events will still be sent to the toolkit while all incoming calls are handled by the OS phone application Can I enable the signal strength event on Premium OS A Yes by adding a DWORD registry key under SOFTWARE Intermec W WAN Toolkit EnableSignalStrength where the value indicates poll time in seconds WWAN Toolkit User s Guide WWAN Toolkit User s Guide 7 WWAN Glossary This chapter provides a list with explanations of important terms and concepts related to wirel
58. ntability and fitness for a particular purpose Web Support Visit the Intermec web site at www intermec com to download our current manuals in PDF format 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 Telephone Support These services are available from Intermec Technologies Corporation In the USA and Canada call 1 800 755 5505 and Services Description choose this option Factory Repair and On Request a return authorization 1 site Repair number for authorized service center repair or request an on site repair technician Technical Support Get technical support on your 2 Intermec product Service Contract Status Inquire about an existing 3 contract renew a contract or ask invoicing questions Schedule Site Surveys or Schedule a site survey or request 4 Installations a product or system installation Ordering Products Talk to sales administration 5 place an order or check the status of your order ix Before You Begin Outside the U S A and Canada contact your local Intermec representative To search for your local representative from the Intermec web site click Contact Who Should Read This Manual Related Documents This Users Guide is for the person who i
59. olkit into using a specified connection and thereby prevent switching At the top left corner of the screen the statuses of the different connection types LAN WLAN and WWAN are displayed The possible options are not powered crossed over powered but unavailable dim grey and available coloured 1 Please note that due to 80211 architecture an available state does not necessarily mean that the particular network you want to use is available it merely indicates that the device has detected one or more 80211 networks with sufficient network signal strength WWAN Toolkit User s Guide WWAN Toolkit User s Guide Chapter 5 Samples The other two icons displayed at the top indicate battery status and connection status The connection status indicator is grey when the switcher is idle yellow when it is working blue when a connection is established and red if the switcher is unable to establish a connection When a connection is established the type and name of the connection is displayed in the Active Connection field Y lt 9 07 wie Active Connection Connection Profile AllNoAutomatic C NET Connectivity Sample Establishing a connection Tra Lif ConnectivityForm v Press the Ping Test button to verify the connection This launches another page where an IP address can be entered When the Ping button is pressed an attempt is made to ping the given IP addre
60. on to the Connectivity API e Use Case Scenarios e Guidelines for Using the Connectivity API 17 Chapter 3 Using the Connectivity API Introduction to the Connectivity API 18 The Connectivity API provides the user with a simple way of automatically or manually switching between PSD CSD WLAN LAN networks IP addresses are not persistent so whenever the carrier is switched the user receives a notification via the event handler This works quite well with a lot of queuing systems as they use what is available at the moment The API is intelligent enough to always select the cheapest media available for automatic switching LAN will always be preferred to WLAN and WLAN over WWAN To keep the API easy to use the number of methods has been kept at a minimum Connectivity parameters are defined in XML documents known as Profiles and Connections and can be reconfigured without recompiling the source code The Connectivity API is built upon existing Intermec components such as the WWAN Toolkit Core the 80211 APIs and NetTools Application Connectivity Toolkit API WWAN Toolkit Core API ITC API Operating System APIs Drivers Hardware The Connectivity Toolkit API and Adjacent Layers The Connectivity API has been designed to correspond to the different scenarios that an application can go through during a workday or work session These different scenarios are describ
61. ote APL Samples nens sd sonic hod 42 vi WWAN Toolkit User s Guide Contents DataC IM SA 80861005108 1856 404 4 42 Lo mm Sate Clea ous lac tain O a c c 43 PHONE Book ca anne kn am rs aka Lane een 44 Simbin then duis saad aaa H nh dua ae ge pot r Be 44 SMS er cs 99 6100 ter uber er A ea a 45 Voice Dialer R PR sn ae ee ee 46 Connectivity APL Sampler sun sans sehe 48 6 Frequently Asked Questions aaaeeeaa 51 7 WWAN Glossary rrearen 59 A TOOIKIE Files 2a a ao sa slds 65 B Connection TYDES lt 3 cts Il is deo zda dy ea c 69 WWAN Toolkit User s Guide vii Contents viii WWAN Toolkit User s Guide Before You Begin Before You Begin This section provides you with technical support information and sources for additional product information Global Services and Support WWAN Toolkit User s Guide Warranty Information To understand the warranty for your Intermec product visit the Intermec web site at www intermec com and click Service amp Support The Intermec Global Sales amp Service page appears From the Service amp Support menu move your pointer over Support and then click Warranty Disclaimer of warranties The sample code included in this document is presented for reference only The code does not necessarily represent complete tested programs The code is provided as is with all faults All warranties are expressly disclaimed including the implied warranties of mercha
62. rify that there is no connection available so even if you do not have sufficient signal strength you will not receive an event telling you the connection is missing Ping using the Active WWAN Available method to make sure your server is available WWAN Toolkit User s Guide 55 Chapter 6 Frequently Asked Questions 2 O I need to use a very long string in the extra commands string from the GPRS connection 56 ASGAUTH 1 CGDCONT 1 IP mylongapn inter net This string is longer than 39 characters thereby exceeding the character limit of this command How can I introduce this string Use SetGPRSContext This command does not have the same limitations that the extra dial command has In code C SetGprsContextFlags f SetGprsContextFlags SetApniSetGprsContextFlags SetDataCompression SetGprsCont extFlags SetHeaderCompression myToolkitRef Connections SetGprsContext flags 1 mylongapn inter net false false Then use phone number 99 1 when setting up the RAS connection The CAB file can be found in the toolkit installation folder on your PC Remember to warm boot the device after installing the mc45 CAB file otherwise the device will not find the wana modem type You need to have the MODEMS MC45 All cab file installed when you use SetGPRSContext You should also use modem name WANA on COM4 No modem reset when setting up the RAS connection For more information on this issue please refer to t
63. rk status radio information This example demonstrates how to create a dial up connection with RAS Remote Access Server or the MS Connection manager When the application is started that is when the radio has been powered on and the status of the SIM card has been checked the user can click the connect button Based on the settings an attempt is made to create a dialup connection If a connection is established another click on the button will make the application disconnect The application contains reconnection logic This is applied when the connection has been broken unintentionally for example due to weak signal strength WWAN Toolkit User s Guide Info WWAN Toolkit User s Guide Chapter 5 Samples The main difference between the 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 and in C and VB Net events are raised to notify the GUI In C the events from the WWAN Toolkit are first handled in the GUI and then passed on to the connector class while in the other languages the connector itself listens to the toolkit events Filename Language DataCom java Java FrmDataCom cs CH FrmDataCom vb VB NET DataComDlg cpp C Filename Language WWANConnector java Java WWANConnector cs CH WWANConnector vb VB NET WWANConnector cpp C E 46752 Setting up connection Disconm
64. s a full set of interaction with the connected radio network SIM Short for Subscriber Identity Module A SIM card is a smart card containing information that is inserted into the 700C with a built in 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 SMS Short Message Service is the transmission of short text messages to and from a mobile phone fax machine and or IP address Messages must not be longer than 160 alpha numeric characters and contain no images or graphics TDMA Short for Time Division Multiple Access a technology for delivering digital wireless services using time division multiplexing TDMA works by dividing a radio frequency into time slots and then allocating slots to multiple calls In this way a single frequency can support multiple data channels simultaneously UMTS Short for Universal Mobile Telecommunications System a 3G mobile technology that is capable of delivering information at speeds up to 2Mbps WWAN Short for Wide Wireless Area Network A common term to describe cellular networks like GPRS CDMA etc WWAN Toolkit User s Guide A Toolkit Files This chapter lists all the files that are installed with the toolkit along with brief descriptions of each file WWAN Toolkit User s Guide 65 Appendix A Toolkit Files WWAN Toolkit Files installed Cab Files Modems_MC45_All cab
65. s responsible for installing configuring and using the Intermec WWAN Toolkit This Users Guide provides you with information about the features of the WWAN Toolkit and how to install configure operate maintain and troubleshoot it Before you work with the WWAN Toolkit you should be familiar with your network and general networking terms such as IP address This table contains a list of related Intermec documents Document Title Part Number WWAN Toolkit C API Programmer s Reference Manual 1 960651 XX 700 Color with Windows Mobile 2003 Quick Start Guide 962 054 XXX 700 Color CDMA Radio Setup Quick Start Guide 962 054 XXX 700 Series Mobile Computer User s Manual Windows Mobile 961 054 XXX 2003 CN3 Mobile Computer User s Manual 935 003 XXX The Intermec web site at www intermec com contains our documents as PDF files that you can download for free To download documents 1 Visit the Intermec web site at www intermec com 2 Click Service amp Support gt Manuals 3 In the Select a Product field choose the product whose documentation you want to download To order printed versions of the Intermec manuals contact your local Intermec representative or distributor WWAN Toolkit User s Guide 7 Introduction This chapter contains the following e Product Overview The WWAN Toolkit Core API e The WWAN Toolkit Connectivity API WWAN Toolkit User s Guide Chapter 1 Introduction Product Overview Z
66. ss with the current connection The result of the ping operation is displayed as a status LED at the centre of the screen Red indicates that the target could not be reached while blue indicates success Ping IP address 66 249 93 99 O C NET Connectivity Sample Verifying a connection 49 Chapter 5 Samples 50 Plenty of messages are sent from the Connectivity Toolkit to the application and not all of them are suitable to display graphically Pressing the Eventlog button launches a page where the user can view all log messages 9 EventlogForm HW WLAN Power True HW LAN Available False HW LAN Power True Loading profile AllNoAutomatic HW WLAN Power False HW WLAN Available False HW WWAN Power False ConEv NotAvailable Telia HW WWAN Available False HW LAN Power False HW LAN Available False Loading profile None HW WLAN Available False HW WLAN Available False HW WLAN Available False Yx d 9 09 EY C NET Connectivity Sample Displaying the eventlog The visual presentation layer is more elaborate for the NET languages C and VB than for Java and C They all share similar functionality but the latter two use no graphic components Other than that the event handling feature constitues the greatest difference between the languages Language Java C VB NET C Event handling procedure A listener adapter is extended or a listener is implemented Listen
67. tab and select Preprocessor from the Category drop down menu Point out the header files by adding the API directory to the Additional Include Directories field Chapter 2 Getting Started Connectivity API Development 1 Add a link reference to the ConnectivityApi lib file located in the INSTALLDIR Connectivity API C lib directory To add the reference select Project gt Settings in the menu bar Click the Link tab and in the Category drop down menu select Input 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 and select Preprocessor from the Category drop down menu Point out the header files by adding the API directory to the Additional Include Directories field 3 Add the header files to your project The header files are also located in the APIAnclude directory The following header files should be included ConnectivityAPI h Methods ConnectivityErrorCodes h Error code definitions ConnectivityObjects h Objects and general definitions NET Development C and VB NET The WWAN Toolkit supports development with Compact Framework V1 0 and V1 1 Core API Development 1 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 2 To develop a NET application using the Core API you need to add
68. that this will of course increase power consumption Using SMS and Voice Functionality SIM PIN Security WWAN Toolkit User s Guide SMS and voice functionality can only be used when the WWAN radio is powered on The WWAN radio is powered on whenever you load a profile that contains a WWAN connection and the profile hasnt got the Suppress SMS Suppress Voice flags set You can also load a connection Lock that utilizes the WWAN radio to turn on the radio By monitoring the CONNECTIVITY_EVENT HARDWARE PHONE AVAILABILITY event you will be notified when the phone is ready to be used The Connectivity API can only unlock a SIM card it cannot change the PIN code or disable the PIN Whenever the Connectivity API sends the event CONNECTIVITY EVENT HARDWARE WWAN PIN REGUEST you have to call the Authenticate method or the powering on of the WWAN radio will be halted until a valid PIN PUK code has been entered 21 Chapter 3 Using the Connectivity API Powering Off All Radios Battery Levels By calling SetProfile NULL you tell the API to shut down all active radios This is particularly useful when entering a hospital airplane or any other vehicle or building that requires broadcasting electronics to be turned off Under normal circumstances you should switch to a profile that only uses radios that are allowed in the particular environment that you are working in Radios are switched on again when SetProfile L M
69. 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 On the 761 and CN3 running Phone Edition OS you can On 760 running Premium you cannot Why do I not get a roaming event on CDMA devices There is a possibility that 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 Q A Where can I learn more about GSM GPRS technology Cisco has released a design guide on the subject This is available at http w ww cisco com en US netsol ns34 1 ns396 ns 177 ns278 networking solutions design guide chapter09186a00801219ac html Bio Enable s web page is not as comprehensive but covers most topics http www bioenabletech com technical introduction to gsm modem technology htm WWAN Q A Q Why is there no ring signal when I get a voice call The incoming call event is received but no sound is played 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
70. to reach its destination As used in GPRS and 1xRTT networks PIN Personal Identification Number A code used for all GSM based phones to establish authorization for access to certain functions or information The PIN code is delivered together with your network subscription PSD Short for Packet Switched Data See also Packet Switching PUK Personal Unblocking Code You will need to get this from your service provider if you enter the wrong PIN code 3 times in a row RAS Short for 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 then functions on the server s LAN as if the remote computer was connected to the LAN directly Roaming Roaming 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 Provider The 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 WWAN Toolkit User s Guide 63 Chapter 7 WWAN Glossary 64 SGSN Short for Serving GPRS Support Node The SGSN is the node which in a sense carries out the same function as the Local Agent in Mobile IP However an SGSN is considerably more complex since it also perform
71. ual for more information e When using 1xRTT the phone number should be 777 Acknowledge this when creating a Circuit Switched connection e When using GSM or CDMA the phone number should be the number of the dialup server WWAN Toolkit User s Guide 13 Chapter 2 Getting Started Link the new RAS entry to Connection Manager This is only required if the connection will be using Connection Manager instead of RAS as explained at the start of this section Use AddEntryToConnMgr to link the RAS entry so it can be used by the Connection Manager Linking it will also display it under Connections in the Settings menu Removing a WWAN connection The toolkit will not clean up the Windows registry when it is shut down so connections that have been created will remain when the toolkit is set up later on Remove the RAS entry link from Connection Manager This is only required if the AddEntryToConnMgr method has been used Use RemoveEnt ryFromConnMgr to remove the link This will also remove the entry under Connections in the Settings menu Deleting the RAS entry To delete the RAS entry use DeleteRasEnt ry Deleting the dialling location Use DeleteDiallingLocation to delete it from the dialling location list Establishing the WWAN connection 14 Once the connection parameters have been set up the connection process can be started Checking for signal strength Always make
72. used which is done by calling the WWANRadioPowerOn method This method will take approximately 20 seconds to execute and when it returns the radio is powered and ready Set up the toolkit To set up the internal states and variables the WWAN Toolkit must be set up To use the cross platform feature of the toolkit it should be set up with SetupWWANToolKit This method will automatically detect the carrier and radio type and set it up so it can be used This will also set up multiplexing on some radios providing the application with the means to communicate with the modem during a WWAN connection Ensure that the modem is responding Use the IsModemReady function Check if the PIN code is required GSM only SIM cards that are used in GSM network can be locked and can only be used once they have been unlocked To check if the SIM card is ready to be used call the CheckSimPin method This method can return PIN READY the SIM card is unlocked and ready to be used e 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 only be unlocked by calling EnterPukNumber Follow up with CheckSimPin to ensure that the PIN or PUK entry was successful If not use the entry functions above For more information about PIN codes please see the Glossary chapter or the mentioned API methods Z Note Entering the incorrect PIN code
73. vaned Delete Cancel Save The only reguired parameter for a circuit switched connection is a valid phone number to connect through If your network does not utilize DHCP press the TCP IP button and fill out the form according to the networks preferences The Connectivity API can either use RAS or MS Connection Manager to connect to the Internet By checking the Use connection manager checkbox your connection will be registered with MS Connection Manager MS Connection manager allows applications such as Pocket Internet Explorer to use your connection The drawback is that it also prompts notification dialog boxes about the current connection manager status and permits the user to terminate a connection manually By checking the Allow Roaming checkbox your connection will be able to connect if the WWAN radio is currently roaming through a different network than your home network Remember that roaming can be costly Pressing the Advanced button reveals some additional parameters A complete list of parameters for the circuit switched connection mode is provided in Appendix B Wireless LAN 80211 Connection Settings There are two ways to configure an 802 11 WLAN connection You can either specify all parameters in the Connectivity Profile Manager which gives you full control of the parameters for all your media with a single tool or you can use the settings already set up on the device under Wireless Settings profi
74. ves 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 Used in GSM and CDMA networks CDMA Short for Code Division Multiple Access a digital cellular technology that uses spread spectrum techniques Unlike competing systems such as GSM that use TDMA CDMA does not assign a specific frequency to every user Instead every channel uses the full available spectrum WWAN Toolkit User s Guide Chapter 7 WWAN Glossary CHAP CHAP Challenge Handshake Authentication Protocol is a more secure procedure for connecting to a system than the Password Authentication Procedure PAP CHAP works like this Once the link has been set up the server sends a challenge message to the connection requestor The requestor responds with a value obtained by using a one way hash function The server checks the response by comparing it its own calculation of the expected hash value and if the values match the authentication is acknowledged If this is not the case 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 CSD Short for Circuit Switched Data See also Circuit Switching DTMF Dual Ton
75. xample Depot Profile WWAN Toolkit User s Guide 25 Chapter 4 Tools 26 3 Select Power Management Power Mgmt Modes Always On Rough Switching Smooth Switching Description Keeps all radios on at all times This provides the fastest switching but consumes the most battery power Turns on the radios after a connection has been lost This saves power compared to the Always On mode as all radios are not switched when there is an active connection but it also gives the longest delay when trying to connect to a different media after the current connection has been lost This power mode turns on the radios when the signal of the currently loaded connection is getting weak This demands more power than rough switching but decreases the delay times 4 If you do not want a ring signal or event whenever an incoming voice call is received check the Suppress Incoming Voice Call button If you do not want to receive an SMS event whenever an incoming SMS is received check the Suppress SMS button 5 Leave Disable Automatic Switching unchecked for now This feature is further described in the Connectivity usage guidelines section 6 Select File gt Save to save your profile To create a new connection The next step is to create connections that can be used in the profile Creating a New Connection Connections consist of data that describe what media should be used and the settings required to establish a conn
76. yProfile or Lock L MyConnection is called By monitoring the battery status events your application can keep track of the main battery status It is recommended that you switch off all radios whenever you receive a LOW level indication from the API and charge the batteries as soon as possible External Vs Battery Power Management The Connectivity API will signal whenever it switches from battery to external power However this is not used to detect Ethernet availability since the Connectivity API does not know whether the power comes from a docking station or from an external power cord Deinitializing the API 22 Before you close down your application it is important that you call the Deinitialize method NET users should avoid putting this call in the Dispose method as this might prevent it from being called when required WWAN Toolkit User s Guide WWAN Toolkit User s Guide 4 Tools The WWAN Toolkit comes with a number of useful development tools that are described in this chapter e Device Info e Connectivity Profile Manager e WWAN Wizard Visual Studio 2003 Plugin for C NET 23 Chapter 4 Tools Device Info This tool is used to interrogate the device about its current configuration The tool can be used in situations where the user or Intermec support requires additional information about a device s configuration It obtains this information by using the GetXXXInfo methods
77. ystem Drawing 2 System Windows Forms z 1 System XML DialupData cs FrmConnector cs FrmMain cs ES FrmPhoneBook cs FrmRequestPIN cs FrmSIM cs FrmSMSInbox cs FrmSMSSender cs FrmYoiceDialer cs E WWWANConnector cs 7 WW ANPowerManager cs Common Components The following components are always added to your project Power Manager WWANPowerManager cs WWANPowerManager contains methods to control the power of the radio and to start and shut down the toolkit This class is instantiated and controlled from the FrmMain cs form PIN Query FrmRequestPin cs FrmRequestPin is instantiated and visualized by the power manager whenever a PIN code is required by the SIM card Start Form FrmMain cs Simple start form that powers the radio through WWAN PowerManager Typically you should move any event handlers that are application global to this class incoming voice call incoming SMS and handle them accordingly The form also retrieves some parameters from the toolkit to notify you about the current status of the radio Typically you should add buttons source to instantiate the other forms You could remove this form completely and replace it with your own start form Selectable Components WWAN Toolkit User s Guide The following classes and forms are selected by the user and added to the project 37 Chapter 4 Tools 38 Voice Dialler FrmVoiceDialer cs This is a rudimentary voice dialler th

Download Pdf Manuals

Related Search

Related Contents

TRIBOS SVP-4    SMC ECS4310-18T network switch  Required documents  ESP-TM Manual  LabMax-Pro SSIM User Manual  MC65 Guide de L`utilisateur [French] (P/N 72E  Guía de audio USB perfecto bit a bit Guía de audio USB Audio USB  

Copyright © All rights reserved. Failed to retrieve file