Intermec Technologies 700C-SMC45 Pen-notepad computer with Radio Interfaces User Manual back let85x11

Intermec Technologies Corporation Pen-notepad computer with Radio Interfaces back let85x11

user manual pt 2

75700 Series Color Mobile Computer User’s ManualInstalling Applications3There are multiple ways to get an application to your 700 Series ColorMobile Computer; just as there are multiple ways to package the applica-tion for delivery.
Installing ApplicationsChapter —376 700 Series Color Mobile Computer User’s ManualPackaging an ApplicationUse any of the following methods to package an application for installa-tion:SFor very simple applications, the application itself might be the only filethat needs to be delivered.SIt could be a directory structure that contains the application, support-ing files like ActiveX controls, DLLs, images, sound files, and data files.SVia a CAB file.Consider either of the following when choosing a location into which tostore your application:SIn the basic 700 Series Computer, there are no built-in storage optionsother than the Object Store. The Object Store is RAM that looks like adisk. Anything copied here will be deleted when a cold-boot is per-formed on the 700 Series Computer.SIf the optional SecureDigital or CompactFlash storage card is in the sys-tem, then consider this card the primary location for placing an applica-tions install files. The following folders represent either card:SThe SecureDigital storage card creates the “\SDMMC Disk” folder.SThe CompactFlash storage card creates the “\Storage Card” folder.SFiles copied to either of these locations will be safe when a cold-boot isperformed on a 700 Series Computer - providing the AutoRun system isinstalled onto the storage card. You can find this system on the RecoveryCD. Copying a CAB file to the “\CABFILES” folder on one of thesecards will automatically extract that CAB file on every cold boot to en-sure that your system is properly set up. See page 82 for more details onhow this works.Installing ApplicationsConsider any of the following options to get the package to the preferredlocation on your 700 Series Computer.SMicrosoft ActiveSyncSFTP Server (page 78)SApplication Manager in Unit Manager (page 78)SSecureDigital or CompactFlash storage card (page 78)
Installing Applications—Chapter 377700 Series Color Mobile Computer User’s ManualUsing Microsoft ActiveSyncNote: These instructions assume that the 700 Color Management Toolsportion of the 700 Series Color Software Tools CD was installed onto yourdesktop.The Microsoft ActiveSync tool is located on the 700C Companion CD,which contains Microsoft products, such as Outlook and ActiveSync. SeeChapter 2, “Pocket PC 2002,” for information about this tool as providedby Microsoft Corporation.This can be a serial, USB, Ethernet, InfraRed, or 802.11b ActiveSync con-nection. Files can then be copied using File Explorer on a PC or a laptopcomputer. This option is usually only good when updating a few 700 Se-ries Computers.These instructions assume that Microsoft ActiveSync had been installedonto your desktop computer and is up and running. If not, go to Chapter2, “Pocket PC 2002,” for an URL from which you can download the latestapplication.1Connect your 700 Series Computer to your desktop computer via anActiveSync cable or IrDA.2Wait for a “Connected” message to appear in the Microsoft ActiveSyncapplication to signal a connection to the 700 Series Computer. If neces-sary, select File →Get Connected to initiate a connection.3Click Explore to access the Mobile Device directory on your 700 SeriesComputer.
Installing ApplicationsChapter —378 700 Series Color Mobile Computer User’s Manual4From your desktop, select Start →Windows Explorer, then browse theapplicable path for any of the system files needed for your 700 SeriesComputer (listed with their paths). Select to highlight the appropriatefile, right-click the file for a pop-up menu, then select Copy.SBase operating system files:“C:\Intermec\Intermec 700 Color Mgmt Tools\Drive Images”SCAB files:“C:\Intermec\Intermec 700 Color Mgmt Tools\Cab Files”5Within the Mobile Device directory, go to the directory where you wantthe files located on the 700 Series Computer, do a right-click for a pop-up menu, then select Paste.6When all of the files are pasted, perform a warm-boot on the 700 SeriesComputer. When the computer reboots, wait for the LED on the topleft of your keypad to stop blinking. Tap Start →Programs →File Ex-plorer to locate the newly copied executable files, then tap these files toactivate their utilities.Using the FTP ServerThe 700 Series Computer has a built-in FTP Server that connects to a net-work via Ethernet or 802.11b. This “ftp”s to the IP address of the 700 Se-ries Computer and places files. The benefit of using FTP is that a scriptcan be created that will automate the process of copying files to the 700Series Computer. This option is good for when a large number of 700 Se-ries Computers need to be updated. See Chapter 7, “Programming,” formore information.Using the Application Manager in Unit ManagerThis requires the 700 Series Computer to connect to the network viaEthernet or 802.11b. The process is still manual so it would take longerthan the FTP method but it would still be a better option than ActiveSyncwhere many 700 Series Computers need to be updated. The Unit Managerapplications are available on the 700 Series Color Unit Manager CD-ROM.For more information, consult your Intermec sales representative.Using a Storage CardThe following steps pertain to installing an application using a storagecard.Copying to a CompactFlash CardFollow the steps below to install your application on the device using aCompactFlash storage card:1Suspend the 700 Series Color Mobile Computer and remove its Com-pactFlash drive, which holds a SanDisk CompactFlash storage card.2Using a CompactFlash Adapter card, place the CompactFlash Drive inyour desktop PC card drive.
Installing Applications—Chapter 379700 Series Color Mobile Computer User’s Manual3Create a subdirectory on the PCMCIA CompactFlash drive in which tostore your application.4Add the autorun system to the storage card using the CEImagerapplication. See the Software Tools User’ s Manual for information aboutCEImager.5Copy your application, data files, and all required DLLs and drivers tothe subdirectory created on the CompactFlash drive.6Add your application to the AUTOUSER.DAT file on the“\Storage Card\2577” directory that contains the following statement,where your directory is the directory on the CompactFlash storage cardwhere the application was installed, and yourapp.exe is the name of yourapplication. Finish the “RUN=” statement with a carriage return line-feed combination. There may be multiple run statements in the file.RUN=\<your directory>\<yourapp.exe>7Remove the CompactFlash drive from your desktop computer and rein-stall it into the 700 Series Computer.8Warm-boot the 700 Series Computer to add these files to the Compact-Flash storage card.If the AUTOUSER.DAT file is found and the “RUN=” statement is cor-rect, then the task manager will launch and execute your program on start-up.Copying to a SecureDigital Storage CardDo the same steps as for the CompactFlash storage Card, except replacethe “\Storage Card\2577” directory with the “\SDMMC Disk\2577” direc-tory.Updating the System SoftwareYou can use the Recovery CD to reinstall or update the operating systemsoftware on the 700 Series Color Computer. For more information, con-tact your Intermec sales representative.
Installing ApplicationsChapter —380 700 Series Color Mobile Computer User’s ManualApplication MigrationNote: These instructions assume that the 700 Color Management Toolsportion of the 700C Software Tools CD was installed onto your desktopand that a storage card has been added to the base configuration of the 700Color Computer.The following steps are required to ensure that the following will happenon a cold-boot:SCAB files can be restored,Sapplications will automatically start,Sand the registry will be restored.Do the following for the cold-boot procedure:1From your desktop, double-click the Intermec CE Imager desktop iconto access the Intermec CEImager application. If this icon is not on yourdesktop, then double-click the CEIMAGER.EXE executable from the“C:\Intermec\Intermec 700 Color Mgmt Tools\Tools\CEImager” folder.2Click Default under Components List to activate the components.3Click (+) to expand the AutoRun System component, click (+) to ex-pand the Destination Media option, then select either the Compact-Flash Card option or the SecureDigital Card option. Do not select bothstorage cards, as the AutoRun files copied will work for one storage card, butnot work on the other storage card.
Installing Applications—Chapter 381700 Series Color Mobile Computer User’s Manual4Click Install to install the AUTORUN files onto the storage card.5Create a “\Cabfiles” folder on the storage card. Copy any CAB files thatare to be extracted on every startup into this folder.6In the “\2577” directory, add your custom AUTOUSER.DAT file. Seethe Recovery Help for more information on how to set up anAUTOUSER.DAT file.7If you are using the RegFlushKey() API, the application must use a spe-cial API to make sure the registry is written to the appropriate card; oryou can use the Utilities control panel applet, as follows:aFrom the 700 Series Computer, tap Start →Settings →the Systemtab →the Utilities icon →the Registry Save tab.bTap Enable Registry Storage, then tap either of the following:SSDTo write the registry to the SecureDigital storage card.SCFTo write the registry to the CompactFlash storage card.cTap ok to save your entry and exit the Utilities control panel applet.Note: If you are using a SecureDigital storage card, you must change anydisk access from “Storage Card” to “SDMMC Disk.”8Remove the storage card from the desktop PC and install the card intothe 700 Series Color Computer.9Perform a cold-boot on the 700 Series Color Computer. Files willautomatically install from the storage card upon reboot. Any calls to theRegFlushKey() API will automatically write the registry to theappropriate location.
Installing ApplicationsChapter —382 700 Series Color Mobile Computer User’s ManualWhen converting a 700 Series Monochrome Computer application to runon the 700 Series Color Computer, most APIs should work without chan-ges. Below are a few exceptions:SThe 700 Series Monochrome Computer used the “\Storage Card” folderfor nonvolatile storage. You may need to change the application to storedata in a volatile location or onto the “SDMMC Disk” if a SecureDigi-tal storage card is present in the system.SIf the application uses the RegFlushKey() API, it must first verify thatthe proper media is available in the system and call the special API men-tioned in Step 7 on the previous page.SIf the application will be using the 700 Color switchable dock, use theAPI to set the proper port on the dock before communications.SSome WAN radio options have changed. Review the WAN radio sectionto determine if any changes will be required in your application.SThe arrow and tab keys are swapped from the way they were on the 700Series Monochrome Computers. Keyboard remapping is available onthe 700 Series Color Computer if these keys need to be changed. Seepage 79 for more details.SNo special SDK is needed to compile applications for the Xscale proces-sor. Targeting the SA1110 processor will create applications that run onthe 700 Series Color Computer.Cabinet File InstallationCAB files (short for cabinet files) are like .ZIP files, plus they register DLLs,create shortcuts, modify registry entries, and run custom set up programs.Tap a CAB file to extract that file or place the CAB file on one of the ap-proved storage devices in the “\Cab Files” folder, then perform a warm-boot on the 700 Series Computer. There are two methods available to ex-tract a CAB file:STap a CAB file to extract it. When using this method, the CAB file isautomatically deleted when the extraction process is successful, unlessthe CAB file is set with the read-only attribute.SUse the AUTOCAB method where all files are extracted when a cold-boot is performed on the 700 Series Computer. This AutoCab applica-tion is on the Recovery CD, see its “Recovery Help” for more informa-tion.
83700 Series Color Mobile Computer User’s ManualNetwork Support4The 700 Series Color Mobile Computer can integrate up to three radios ina single unit, and will automatically install the appropriate software for ra-dio use when the unit is powered on. The Intermec CORE applicationdefaults to the most recently used module. If a module has not yet beenused or set, CORE will default to the first module as listed alphabetically.The following communication options on the 700 Series Computer pro-vide wired and wireless connectivity:SOnboard wired Ethernet (standard)SWireless Local Area Network (LAN)This 802.11b radio option provides up to 11 Mb/sec throughput.SWireless Wide Area Network (WAN)Includes support for GSM/GPRS and CDMA/1xRTT radios.SWireless PrintingThis allows for cable-free communications with peripheral devices, suchas printers, over a ten-meter range. This compatibility is provided via aBluetooth qualified module by Socket Communications.
Network SupportChapter —484 700 Series Color Mobile Computer User’s ManualCOREThe Intermec Common Object Resource Environment (CORE) applica-tion provides a framework for various modules that let you configure andmanage your Intermec products. These modules are software plug-ins thatcan be configuration tools, such as the 802.11b radio configuration mod-ule, or they can provide information on your environment, such as a bat-tery life module.CORE is built into the operating system of every 700 Series Computer.On the 700 Series Computer, tap Start →Programs →the IntermecCORE icon to access this application.CORE modules are collections of specific information. This information isusually related to a particular radio technology, but not always. Eachmodule can display general and detailed information. Tap the General andDetails tabs near the bottom to switch between general and detailedinformation. Note that not all modules will have detailed information.To learn more about this application, see its online help. Tap Start →Help from the menu to see the CORE online help.Note: Once CORE is running, you can return to it by tapping its iconfrom the System Tray via the Today screen. Tap Start →Today →theIntermec CORE three-ring icon (circled in the following illustration).
Network Support—Chapter 485700 Series Color Mobile Computer User’s ManualNetwork AdaptersYour 700 Series Computer can have up to three radios installed. The de-fault network adapter or radio is dependent on what card is inserted inyour 700 Computer. Below are the the network adapters that exist as ofthis publication. See the Developer’ s Support web site for the latest infor-mation on network adapters for your unit.SEthernet Communications (LAN9000) - page 86.S802.11b Radios (802.11b Wireless LAN driver) - page 87.SWWAN (Wireless WAN) - page 110.SWireless Printing (PAN) - page 120.Note that the tip of the antenna attached to your 700 Series Computer iscolor-coded to identify its radio type. Refer to the following to determineyour radio type:SGreen802.11b diversitySRedCDMA/GPRS US/CanadaSBlueGPRS International
Network SupportChapter —486 700 Series Color Mobile Computer User’s ManualEthernet CommunicationsFollow the steps below to start Ethernet communications on the 700 SeriesComputer. If your system does not contain an 802.11b radio, thenEthernet networking using DHCP will be selected as the default.When “Built-in Ethernet” is selected from the NDISTRY pop-up menu,then the antenna shown to the left will appear in the System Tray. When“No networking” is selected, then this icon will appear with a red “X”above it.From the 700 Series Computer, tap Start →Settings →the Connectionstab →Network Adapters to access the network connections for this unit.Make the changes necessary for your network, then tap ok when finished.Note: “LAN9000” is for Ethernet and ”802.11b Wireless LAN” is for802.11b radios.
Network Support—Chapter 487700 Series Color Mobile Computer User’s Manual802.11b CommunicationsThe 700 Series Computer can integrate the 802.11b radio module alongwith either the GSM/GPRS or the CDMA/1xRTT radio and the WirelessPrinting option. The 802.11b radio module accommodates any WirelessLAN (WLAN) requirements, such as using WLAN access points for cross-docking or load-planning applications.When “Wireless 802.11” is selected via the NDISTRY pop-up menu, thenthe antenna shown to the left will appear in the System Tray.To start 802.11b communications on the 700 Series Computer, tap Start→Settings →the System tab →the Wireless Network icon to access theProfile Wizard for the 802.11b radio module. The Profile Wizard defaultsto the Profiles page.ProfilesUse the Profiles page to add, edit, or delete multiple networking environ-ments for this 802.11b radio. To add a profile from this screen, enter up to32 alphanumeric characters in the Profile field, then tap Add.See“Basic”on page 89 and “Security” on page 90 for more information.Leave Use Profile Name for SSID checked for the SSID (or NetworkName) to use this profile name. If this is cleared (check mark removed),the SSID will default to using the factory-assigned “INTERMEC” net-work name.
Network SupportChapter —488 700 Series Color Mobile Computer User’s ManualSTo add a profile:Tap Add, enter up to 32 alphanumeric characters to name this profile ifyou have not already entered a description in the Profiles page, configu-re the basic and security information for this profile, then click Done toconfigure its basic and security information.SLeave Use Profile Name for SSID checked for the SSID to use this as-signed profile name. If this is cleared (check mark removed), the SSIDwill default to using the factory-assigned “INTERMEC” network name.Go to the next page to continue.STo edit a profile:Select an existing profile from the Profile drop-down list, tap Edit,make the changes needed for this profile (starting in the next para-graph), then tap OK to return to the Profiles page.STo delete a profile:Select a profile from the Profile drop-down list, tap Delete,thentapYesto remove the selected profile.
Network Support—Chapter 489700 Series Color Mobile Computer User’s ManualBasicUse the Basic page to set the network type and radio channel for this pro-file. Click OK to return to the Profiles page.SNetwork type:Tap the drop-down list to select either Infrastructure or Ad-hoc.SSSID (Network Name):This assumes the profile name when Use Profile Name for SSID ischecked on the previous screen, unless another name is entered in thisfield. If you want to connect to the next available network or are notfamiliar with the network name, enter “ANY” in this field. Consult yourLAN administrator for network names.SChannel:If “Ad-hoc” were selected as the network type, then this is enabled. Tapthe drop-down list to select a channel, from 1-15, through which tohandle connections (default is 3).SEnable Power Management:Check this box to conserve battery power (default), or clear this box todisable this feature.
Network SupportChapter —490 700 Series Color Mobile Computer User’s ManualSecurityUse the Security page to set this profile as read-only or to enable WEP(Wired Equivalent Privacy) encryption. Click OK to return to the Profilespage. The following securities are available from the Security Methoddrop-down list. Note that the last three methods are available if you have pur-chased the security package. Contact your Intermec Representative for more in-formation.S802.11 WEP Encryption (next page)S802.1x TLS (page 92)S802.1x TTLS (page 93)SLEAP (page 93)
Network Support—Chapter 491700 Series Color Mobile Computer User’s Manual802.11 WEP Encryption:WEP keys are only needed if they are expected by your clients. There aretwo types available: 64-bit (5-character strings, 12345) (default) and128-bit (13-character strings, 1234567890123). These can be entered aseither ASCII (12345) or Hex (0x3132333435).To enter WEP keys, select “802.11 WEP Encryption” from the SecurityMethod drop-down list. Select a data transmission key from the Data TXKey drop-down list near the bottom of this screen, then enter the encryp-tion key for that data transmission in the appropriate Key # field.
Network SupportChapter —492 700 Series Color Mobile Computer User’s Manual802.1x TLS (Transport Layer Security):TLS is a protocol that ensures privacy between communicating applica-tions and their users on the Internet. To use this protocol, select “802.1xTLS” from the Security Method drop-down list, then enter the following:SClient Key File:Enter the file location where the certificate for your identity is stored.SPassword:Enter the password for the certificate in this field.SSupplicant ID:Enter the user ID associated with this certificate.SServer Cert CN (Certificate Common Name):Enter the common name of your authentication server.SCA List (Certificate Authority):Enter the file location, or path, of the server certificates.
Network Support—Chapter 493700 Series Color Mobile Computer User’s Manual802.1x TTLS (EAP-Tunneled TLS):To use this protocol, select “802.1x TTLS” from the Security Methoddrop-down list, then enter the following:SUsername:Enter your user name for this security protocol.SPassword:Enter your password for this security protocol.SSupplicant ID:Enter “anonymous” unless your administrator indicates otherwise.SServer Cert CN (Certificate Common Name):Enter the common name of your authentication server.SCA List:Enter the file location, or path, of the server certificates.LEAP (Cisco Wireless EAP (Extensible Authentication Protocol)):Enter your unique user name and password to use this protocol.
Network SupportChapter —494 700 Series Color Mobile Computer User’s ManualAdvancedUse this page to secure the configuration for this profile or to make allfields read-only.SMake Profile Read-Only:Check this box, then enter and reenter a password to “lock” or render“read-only” all configurations for this profile. To reverse this step, clearthe check box, then enter the password assigned with the “read-only”status.SCertificates:If “802.1x TLS,” “802.1x TTLS,” or “LEAP” were enabled via the Se-curity tab, then this button will appear. Tap this button to configure theavailable certificates. See “Certificates” on the next page for more infor-mation.
Network Support—Chapter 495700 Series Color Mobile Computer User’s ManualCertificatesUse this page to view, modify, or remove certificates assigned to yourparticular security method. Note that you can also access this page by tappingStart →certificates from the Today screen.SCA Name/IP:Enter a valid CA name or IP address assigned to the certificate in ques-tion. This allows you to enroll the certificate or to browse for its latestinformation.SEnroll File Name:Enter the file name of the certificate to be enrolled.SStore Location:Enter the path where the certificate is to be stored within your 700 Se-ries Computer.SEnroll:Tap this to assign the file entered in Enroll File Name to the locationspecified in Store Location.SCA Vert:Tap this to view the contents of the certificate via the Internet Explorer.SView:Tap this to view information about the certificate, such as to whom thiscertificate was issued, who issued the certificate, and the span of timethe certificate is valid.SRemove:Select a file from the list, then tap this button to delete that file.
Network SupportChapter —496 700 Series Color Mobile Computer User’s ManualImport/ExportUse this page to send a profile or to retrieve a profile to or from anotherlocation within your 700 Series Computer.STo export a profile:Select to highlight a profile, then tap Export. Select from the drop-downlists, the folder, type of files, and location within the folder where theprofile is to go, tap OK to export the profile, tap ok to close the con-firmation screen, then tap OK again to exit the Profile Wizard.
Network Support—Chapter 497700 Series Color Mobile Computer User’s ManualSTo import a profile:Tap Import to access the Open screen, from the drop-down lists, select afolder and file type, then tap a profile from the list provided. Tap ok toclose the confirmation screen, then tap OK again to exit the ProfileWizard.Scan ListUse this Scan List page to monitor network connections, and if lost, to at-tempt to reestablish connections with these networks.Selected ProfileSelect this option to use the profile defined in the Profiles page, then tapOK to exit the Profile Wizard. When connections are lost, attempts will bemade to connect to the specified profile.
Network SupportChapter —498 700 Series Color Mobile Computer User’s ManualScan ListUse this option to select a number of profiles with which to establish con-nections. When connections are lost, attempts will be made to contact eachof the profiles listed, in the order they appear in the list.1Tap this option, then tap Edit Scan List.2Select profiles from the Available Profiles drop-down list, then tap Addto include each selection in the Scan List.3To arrange the hierarchy of profiles, tap to select a profile, then tap ei-ther Move Up or Move Down to move each profile. To remove a pro-file from the list, tap to select that profile, then tap Delete.4Click either ok or Close to return to the Scan List page, then click OKto exit the Profile Wizard.Network Selection APIsThe Network Selection APIs allow the user to change network adapterconfiguration programmatically. Both drivers support the same IOCTLfunction numbers for loading and unloading the drivers.Loading and unloading of the 802.11b driver is performed by the FWV1:device in the system by performing DeviceIOControl() calls to the driver.Loading and unloading of the driver for the built-in Ethernet adapter isperformed by the SYI1: device in the system by performing DeviceIO-Control() calls to the driver.SFor loading an NDIS driver associated with an adapter, the IOCTL isIOCTL_LOAD_NDIS_MINIPORT.SFor unloading NDIS drivers associated with an adapter the IOCTL isIOCTL_UNLOAD_NDIS_MINIPORT.
Network Support—Chapter 499700 Series Color Mobile Computer User’s Manual#include <winioctl.h>#include “sysio.h”void DoLoad(int nDevice) {LPTSTR devs[] = { _T(“SYI1:”), _T(“FWV1:”) };HANDLE hLoaderDev;DWORD bytesReturned;hLoaderDev = CreateFile(devs[nDevice], GENERIC_READ|GENERIC_WRITE, 0,NULL, OPEN_EXISTING, 0, NULL);if (hLoaderDev != INVALID_HANDLE_VALUE) {if (!DeviceIoControl( hLoaderDev, IOCTL_LOAD_NDIS_MINIPORT, NULL, -1, NULL, 0,&bytesReturned, NULL)){MessageBox(NULL, TEXT(“SYSIO IoControl Failed”), TEXT(“Networkloader”),MB_ICONHAND);if (hLoaderDev!=INVALID_HANDLE_VALUE) CloseHandle(hLoaderDev);hLoaderDev = INVALID_HANDLE_VALUE; // bad handle}else {CloseHandle(hLoaderDev);}}}void DoUnload(int nDevice) {LPTSTR devs[] = { _T(“SYI1:”), _T(“FWV1:”) };HANDLE hLoaderDev;DWORD bytesReturned;hLoaderDev = CreateFile(devs[nDevice], GENERIC_READ|GENERIC_WRITE, 0,NULL, OPEN_EXISTING, 0, NULL);if (hLoaderDev != INVALID_HANDLE_VALUE) {if (!DeviceIoControl( hLoaderDev, IOCTL_UNLOAD_NDIS_MINIPORT, NULL, -1, NULL, 0,&bytesReturned, NULL)){MessageBox(NULL, TEXT(“SYSIO IoControl Failed”),TEXT(“Networkloader”),MB_ICONHAND);if (hLoaderDev!=INVALID_HANDLE_VALUE) CloseHandle(hLoaderDev);hLoaderDev = INVALID_HANDLE_VALUE; // bad handle}else {CloseHandle(hLoaderDev);}}}
Network SupportChapter —4100 700 Series Color Mobile Computer User’s ManualThe API provided by Intermec Technologies exposes a limited set of rou-tines that allows a programmer to access and affect the 802.11b networkinterface card from within their application. The routines provided willalso read/write values to the CE registry that pertain to the 802.11b radiodriver. By using the provided functions, a programmer can alter the802.11b parameters of Network Name (SSID), WEP Keys, InfrastructureModes, Radio Channel, and Power Management Modes. A programmercan also retrieve network connect status and signal strength indicationfrom the RF network card.The API is contained within the 80211API.DLL file that should be pres-ent in any load that has the 802.11b networking installed.SNETWLAN.DLLThis file is the 802.11b driver. It will be present in all 700 CE loads thatuse the 802.11b network interface card.S80211API.DLLThis file is an Intermec authored file that provides the programmer witha set of API calls to configure or monitor status of the 802.11b network.SMOD80211.DLLThe CORE module for the 802.11b NIC. It provides the 802.11b sta-tus information displayed when the CORE application is running.S80211CONF.EXEThis is the “Control Panel” for configuring the 802.11b network para-meters. Note that it is an EXE file and is actually called byCPL802.CPL (see below). It is also called by the CORE applicationwhen the “Configuration” button is pressed.SCPL802.CPLA control panel application that does nothing but call80211CONF.EXE.S80211SCAN.EXEInternally manages the Scan List activity.The 80211API.DLL supports an unlimited number of radio configurationprofiles. These profiles are the same as those set by the Wireless Networkcontrol panel applet that runs on the Windows CE unit. You can configuredifferent 802.11b profiles and switch between them using the 802.11 API.See the ConfigureProfile() function on page 106 for more information.
Network Support—Chapter 4101700 Series Color Mobile Computer User’s ManualFunction SummaryBelow are functions available for the 700 Series Color Computer whenenabled with the 802.11b radio module.RadioConnect()Connects to the available radio. Use this function if you plan on using alot of API calls that talk directly to the radio.Syntax: UINT RadioConnect( );Parameters: None.Returns: ERROR_SUCCESS when successful, otherwiseERR_CONNECT_FAILED.RadioDisconnect()Cleans up the connection from the RadioConnect() function after an ap-plication closes.Syntax: UINT RadioDisconnect( );Parameters: None.Returns: ERROR_SUCCESS when successful, otherwiseERR_CONNECT_FAILED.GetMac()Gets the radio MAC address.Syntax: UINT GetMac( TCHAR * );Parameters: Pointer to a character array, which is populated with MAC addresses.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetBSSID()Gets the associated access point name, the BSSID.Syntax: UINT GetBSSID( TCHAR * );Parameters: Pointer to a character array, which is populated with the current BSSID.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failedGetSSID()Gets the current SSID (network name).Syntax: UINT GetSSID( TCHAR * );Parameters: Pointer to a character array, which is populated with the current SSID.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.
Network SupportChapter —4102 700 Series Color Mobile Computer User’s ManualGetLinkSpeed()Retrieves the current link speed of the radio connection.Syntax: UINT GetLinkSpeed( int &);Parameters: &References an integer.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetNetworkType()Retrieves the network type.Syntax: UINT GetNetworkType( ULONG &);Parameters: &References a ULONG value, populated with one of the following:NDIS_NET_TYPE_FH Frequency Hopping RadioNDIS_NET_TYPE_DS Direct Sequence RadioNDIS_NET_TYPE_UNDEFINEDUnknown or information not available.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetTXPower()Gets the current TX power of the radio in milliwatts.Syntax: UINT GetTXPower( ULONG &);Parameters: &References a ULONG value, populated with one of the followingin milliwatts (mW):NDIS_POWER_LEVEL_63 63 mW.NDIS_POWER_LEVEL_30 30 mW.NDIS_POWER_LEVEL_15 15 mW.NDIS_POWER_LEVEL_5 5mW.NDIS_POWER_LEVEL_1 1mW.NDIS_POWER_LEVEL_UNKNOWNUnknown Value or Error.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.
Network Support—Chapter 4103700 Series Color Mobile Computer User’s ManualGetNetworkMode()Retrieves the network mode.Syntax: UINT GetNetworkMode( ULONG &);Parameters: &References a ULONG value, populated with one of the following:NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode.NDIS_NET_MODE_ESS 802.11 Infrastructure Mode.NDIS_NET_MODE_UNKNOWN Unknown Value or Error.NDIS_NET_AUTO_UNKNOWNAutomatic Selection. Use of this option is not recommended.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.SetNetworkMode()Sets the radio and updates the CE registry.Syntax: UINT SetNetworkMode( ULONG &);Parameters: &References a ULONG value, populated with one of the values definedin GetNetworkMode().Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.AddWep()Adds a WEP key to the radio configuration.Syntax: UINT AddWep( ULONG 1, BOOL 2, TCHAR * 3);Parameters: ULONG Pointer that identifies what key to be set.BOOL Specifies whether the key being set is the default TX key.TCHAR Pointer that specifies the key data either in hex (stringlengths of 10 or 26) or ASCII (string lengths of 5 or 13).Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetRSSI()Sets the current RSSI (Received Signal Strength Indication).Syntax: UINT GetRSSI( ULONG & );Parameters: &References a ULONG value.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.
Network SupportChapter —4104 700 Series Color Mobile Computer User’s ManualGetAssociationStatus()Gets the current connection, or association status.Syntax: UINT GetAssociationStatus( ULONG &);Parameters: &References a ULONG value, a current connection status as follows:NDIS_RADIO_ASSOCIATED Radio is associated w/access point.NDIS_RADIO_SCANNING Radio is scanning for network.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetWepStatus()Gets the current WEP status.Syntax: UINT GetWepStatus( ULONG &);Parameters: &References a ULONG status value which include the following:NDIS_RADIO_WEP_ENABLED WEP is currently enabled.NDIS_RADIO_WEP_DISABLED WEP is currently disabled.NDIS_RADIO_WEP_ABSENT WEP key is absent.NDIS_RADIO_WEP_NOT_SUPPORTEDWEP is not supported.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetAuthenticationMode()Gets the current authentication mode.Syntax: UINT GetAuthenticationMode( ULONG &);Parameters: &References a ULONG value which include the following currentauthentication mode:NDIS_RADIO_AUTH_MODE_OPEN Open System is in use.NDIS_RADIO_AUTH_MODE_SHARED Shared Key is in use.NDIS_RADIO_AUTH_MODE_AUTO Automatic Detection.NDIS_RADIO_AUTH_MODE_ERROR Unknown value/Error.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.SetAuthenticationMode()Sets the radio authentication mode with a value defined in theGetAuthenticationMode() function.Syntax: UINT SetAuthenticationMode( ULONG );Parameters: Passes in a ULONG set to one of the values as defined inGetAuthenticationMode().Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.
Network Support—Chapter 4105700 Series Color Mobile Computer User’s ManualSetChannel()Sets the radio channel, ranging from 1 to 14.Syntax: UINT SetChannel( USHORT );Parameters: USHORT set to a desired channel (1-14).Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.EnableWep()Enables or disables WEP encryption.Syntax: UINT EnableWep( BOOL );Parameters: Set to TRUE (0) to enable WEP encryption or FALSE (1) to disabledWEP encryption.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.GetPowerMode()Gets the current power management mode of the radio.Syntax: UINT GetPowerMode( ULONG &);Parameters: &References a ULONG value which include the following current radiopower management mode:NDIS_RADIO_POWER_MODE_CAMContinuous Access Mode (uses most power).NDIS_RADIO_POWER_MODE_MAXMaximum Power Savings.NDIS_RADIO_POWER_MODE_PSPPower Saving Mode, best balance of power and performance.NDIS_RADIO_POWER_UNKNOWNUnknown mode reported or error.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.SetSSID()Passes the desired SSID (network name).Syntax: UINT SetSSID( TCHAR * );Parameters: Pointer to a character array that contains the desired SSID.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.
Network SupportChapter —4106 700 Series Color Mobile Computer User’s ManualisOrinoco()Confirms whether the present radio is an ORiNOCO radio.Syntax: UINT isOrinoco( );Parameters: None.Returns: TRUE when an ORiNOCO radio.FALSE when other than an ORiNOCO radio.EncryptWepKeyForRegistry()Encrypts a key for registry storage. Requires TCHAR pointers for a des-tination and a source.Syntax: UINT EncryptWepKeyForRegistry( TCHAR * szDest, TCHAR *szSource );Parameters: szDest String for the destination.szSource String for the source.Returns: ERROR_SUCCESS when successful,ERR_QUERY_FAILED when the query failed, orERR_CONNECT_FAILED if a connection with the radio failed.SetRTSThreshold()Sets the radio RTS (Request To Send) threshold.Syntax: UINT SetRTSThreshold( USHORT &);Parameters: &References a USHORT value.Returns: None.GetRTSThreshold()Gets the radio RTS threshold.Syntax: UINT GetRTSThreshold( USHORT &);Parameters: &References a USHORT value.Returns: None.ConfigureProfile()If using the Intermec 802.11b Profile Management system, you can pro-gram the API to configure the radio to a specific profile by passing the pro-file name.Syntax: UINT ConfigureProfile( TCHAR * );Parameters: Pointer to a string that contains the name of the profile to be activated.Returns: None.
Network Support—Chapter 4107700 Series Color Mobile Computer User’s ManualStartScanList()If a scan list is configured, this will start the API looking for a network onthat scan list and configuring the radio appropriately. This call can take along time to process.Syntax: UINT StartScanList( );Parameters: None.Returns: None.802.11b Radio CORE ModuleThe 802.11b radio CORE module displays helpful information about the802.11b radio option built into your 700 Series Computer.Note that you can configure the 802.11b radio module from this COREapplication. Select Configure →Configure 802.11 CF from the bottommenu bar to access the Profile Wizard application. Information about thisapplication starts on page 87.Select Modules →Intermec 802.11 CF Help for more information onthe contents of this CORE module.GeneralBelow are descriptions and meanings for each piece of information pro-vided via the General tab, reading from top to bottom starting on the left.SESS 802.11 Station:This identifies the type of network to which you are attached, either anESS (Embedded Security Subsystem) Station, or Ad-hoc.SAdapter MAC:This identifies the MAC address for this 802.11b adapter.SScanning:Status of association. When connected to a network, this changes to“Connected to NET” with NET being the name of the network towhich you are connected.
Network SupportChapter —4108 700 Series Color Mobile Computer User’s ManualSEncryption:This indicates whether WEP encryption is “Enabled” or “Disabled(Open).” See page 90 for more information.SLink:This indicates the speed at which a connection is made.STX Power:This shows the speed (in milliwatts) at which transmissions are made.SSignal:This identifies the radio signal strength (in dBm).SAntenna:This identifies the antenna being used with the assigned profile.SAP Mac:This identifies the MAC address of the access point to which this 700Series Computer is connected.SIP:This provides the IP address which can be set as either DHCP (Dynam-ic Host Configuration Protocol) or statically.SPower:This indicates the power status of this 700 Series Computer: “AlwaysOn” is the default.SHistory:This bar graph displays an active history of this radio module’ s qualityof connections.SFriendly Indicator:If the radio stack is loaded, then all three dots are filled. These dots areleft empty if the stack is not loaded. These dots do vary based on theCORE application’ s perception of the overall connection quality.
Network Support—Chapter 4109700 Series Color Mobile Computer User’s ManualDetailsBelow are descriptions and meanings for each piece of information pro-vided via the Details tab, reading from top to bottom.SAttach-Roam Cnt:This includes the number of new associations made during the currentsession, including any found roaming.SScanlist:This indicates whether the Scan List option was enabled or disabled. Seepage 97 for more information.SWatchdog Status:This monitors the activity of the Scan List: “Running” or “Stopped.”SSupplicant:This monitors the 802.1x security activity on the client: “Running” or“Stopped.”
Network SupportChapter —4110 700 Series Color Mobile Computer User’s ManualWWAN Radio OptionsThe 700 Series Computer can integrate either the GSM/GPRS or theCDMA/1xRTT radio along with the 802.11b radio and the WirelessPrinting option. The WWAN radio option accommodates any WirelessWAN requirements, such as taking the 700 Series Computer off the prem-ises in a delivery vehicle to cover a much larger area.GSM/GPRSThe GSM (Global System for Mobile communications) and GPRS (Gen-eral Packet Radio Service) wireless infrastructure increases voice capacity,enables personalized “user-aware” services, and creates networking efficien-cies to help wireless service providers drive reduced operating costs.SGSM is an open, nonproprietary system. One of its great strengths isthe international roaming capability. This provides seamless and same-standardized same-number contactability world-wide. GSM satelliteroaming has extended service access to areas with unavailable terrestrialcoverage.SGPRS is the high-speed data evolution of GSM. GPRS supports Inter-net Protocol (IP), enabling access to Internet and intranet content andapplications from GPRS wireless devices. The anticipated data rate forGPRS is 115 Kbps and throughput rates of 30-60 Kbps have beenachieved initially. This high speed capability enables vehicle applicationsto become real-time and to use the Internet for access to corporate dataor information in the form of traffic or navigation.CDMA/1xRTT SB555Code Division Multiple Access (CDMA) is a form of “spread-spectrum,” afamily of digital communication techniques used in military applicationsfor years. The core principle of spread-spectrum is the use of noise-likecarrier waves, and, as the name implies, bandwidths much wider than thatrequired for simple point-to-point communication at the same data rate.S1XRTT, the first phase of CDMA2000, is designed to support up to144 KB per second packet data transmission and to double the voicecapacity of current generation CDMA networks.SSB555 Embedded Module, from Sierra Wireless, provides completewireless functionality and integrates easily into the most compact andslender mobile applications with its small flexible design. The SB555offers maximum coverage and access to entire CDMA networks.
Network Support—Chapter 4111700 Series Color Mobile Computer User’s ManualWAN Radio CORE ModuleThe WAN radio CORE module displays helpful information about eitherthe GSM/GPRS radio or the CDMA/1xRTT radio option built into your700 Series Computer. The following illustrations are for a GSM/GPRSGEM350X radio.GeneralBelow are descriptions and meanings for each piece of information pro-vided via the General tab, reading from top to bottom starting on the left.The information applies to both the GSM/GPRS and the CDMA/1xRTT ra-dio modules unless otherwise indicated.SNetwork Type:This is the network type which would list either “GSM-GPRS” or“CDMA-1XRTT.” Scatternets are not supported.SIWS (GSM/GPRS) or Sprint PCS Network (CDMA/1xRTT):This lists the name of the wireless network provider, such as T-Mobile,Voicestream, AT&T Wireless, etc. “IWS” is short for the Iowa WirelessService carrier.SRegistered on home network:If the WAN radio module has registered with a service provider net-work, then one of the following will appear:SRegistered on home network:The radio module is registered on its “home” network.SRegistered on roamed network:The radio module is registered on another service provider’ s network.SRadio Not Registered:There is no network within range of this radio module.SRadio ESN:This displays the Electronic Serial Number (ESN) assigned to this radiomodule or lists “Unavailable” if a number cannot be read from the ra-dio.
Network SupportChapter —4112 700 Series Color Mobile Computer User’s ManualSRSSI:This displays the Received Signal Strength Indicator (RSSI) frequency orlists “Unavailable” if there is no signal or the signal cannot be retrievedfrom the radio module.SBER (GSM/GPRS GEM 350X, CDMA/1xRTT):This shows the Bit Error Rate (BER), the percentage of bits with errorsdivided by the total number of bits transmitted, received, or processedover a given period of time.Sf/w:This identifies the firmware version, if available.Sh/w:This identifies the hardware version, if available.SSerial Status:This indicates whether serial communications passed (“Serial com OK”)or failed (“Serial com FAIL”) in its last transaction. A status of “Serialcom FAIL” typically indicates that the 700 Series Computer is unable toestablish communication with the radio module installed within.SXircom GEM3503 (GSM/GPRS),Siemens MC45 (GSM/GPRS),orSierra Wireless SB555 (CDMA/1xRTT):This identifies the product name for this radio module.SBand (GSM/GPRS) or Channel (CDMA/1xRTT):This identifies the bandwidth or channel available for this radio module,if any.SHistory:This bar graph displays an active history of this radio module’ s qualityof connections.SFriendly Indicator:Usually indicates the signal strength for this radio module. Three filleddots indicate a high quality or strong signal. Three empty dots indicatethat the signal is out of range or there is no signal detected.
Network Support—Chapter 4113700 Series Color Mobile Computer User’s ManualDetailsBelow are descriptions and meanings for each piece of information pro-vided via the Details tab, reading from top to bottom. Most of this is simi-lar to what is shown under the General tab. The information applies to boththe GSM/GPRS and the CDMA/1xRTT radio modules unless otherwise indi-cated.SSerial Status:This indicates whether serial communications passed (“PASS”) or failed(“FAIL”) in its last transaction. A status of “FAIL” typically indicatesthat the 700 Series Computer is unable to establish communicationwith the radio module installed within.SManufacturer:This lists the name of the manufacturer that developed this radio mod-ule, such as “Xircom, an Intel Corporation,” “Siemens,” or “Sierra Wire-less.”SModel:This identifies the product name for this radio module, such as“SB555,” “GEM350X,” or “MC45.”SIMEI # (GSM/GPRS):This is the IMEI (International Mobile station Equipment Identity) se-rial number of the GSM/GPRS radio module.SRSSI:This displays the RSSI frequency or lists “Unavailable” if there is no sig-nal or the signal cannot be retrieved from the radio module.SOperator:This lists the name of the service providing the network support.SSIM Status (GSM/GPRS MC45):Identifies whether a Subscriber Identity Module (SIM) card is installedin this 700 Series Computer.
Network SupportChapter —4114 700 Series Color Mobile Computer User’s ManualSBand (CDMA/1xRTT):This identifies the frequency bands used by this radio module.SIMSI # (GSM/GPRS):This shows the IMSI (International Mobile Subscriber Identity) numberassigned to the SIM card installed in this 700 Series Computer.SRadio Temp (CDMA/1xRTT):This identifies the temperature of the radio module, or lists “Unavail-able degrees” if there is no information or the temperature cannot bemeasured.SFirmware Rev:This identifies the firmware version, if available.SFirmware Date (GSM/GPRS):This provides the last date when this firmware was updated, if available.Terminal ApplicationTap Terminal App from the Details page to send standard AT commands.Information about these AT commands are available under “AT CommandInterface” on page 115.Select an AT command from the drop-down list, then tap Send. The re-sults of each test appears in the text box. Tap Exit or ok to close this screenand return to the Details page.
Network SupportChapter —4116 700 Series Color Mobile Computer User’s ManualNote: You will need the Adobe Acrobat Reader application to view a PDFdocument.Goto“http://www.adobe.com/prodindex/acrobat/readstep.html”to install or download the latest Adobe Acrobat Reader according toAdobe’ s instructions.Command Set for Sierra Wireless SB555Use the AT command interface from Sierra Wireless to program theCDMA/1xRTT SB555 radio module. Documentation for this interface isavailable via the following URL. Click the “General AT command refer-ence” link for a PDF document, which is 680 KB in size. Note that thisURL is subject to change.http://www.sierrawireless.com/ProductsOrdering/embedded_docs.htmlCommand Set for Xircom/Intel GEM350XUse the GEM350X AT command list from Intel Corporation to programthe GPRS/GSM GEM350X radio module. The “GEM350X Programmer’ sReference” is available either from Intermec Technologies or from IntelCorporation. Contact either your Intermec representative or the Intel Cor-poration support personnel at the following URL for more information.Note that this URL is subject to change.http://support.intel.com/sites/support/index.htm?iid=intelhome1+support&Command Set for Siemens MC45Use the MC45 AT command interface from Siemens AG to program theGPRS/GSM MC45 radio module. The “MC45 Siemens Cellular EngineAT Command Set” is available either from Intermec Technologies or fromSiemens AG. Contact either your Intermec representative or the SiemensAG support personnel at the following URL for more information. Notethat this URL is subject to change.http://www.siemens-mobile.com/btob/CDA/presentation/ap_btob_cda_presentation_frontdoor/0,2950,12,FF.html
Network Support—Chapter 4117700 Series Color Mobile Computer User’s ManualTesting the AT CommandsThese commands can be sent to either WAN radio by setting up a dial-upnetworking connection to COM4. Do the following to initiate this con-nection and test these commands to your radio:1From the 700 Series Computer, select Start →Settings →theConnections tab →the Connections icon.2Tap Modify beneath the Internet Settings drop-down list.3Tap New.. to make a new connection.
Network SupportChapter —4118 700 Series Color Mobile Computer User’s Manual4Enter a name for the connection, select “WANA on COM4” from theSelect a modem drop-down list, and select “115200” from the Baudrate drop-down list. Tap Advanced to continue.5On the Port Settings tab, check Enter dialing commands manually,then tap ok,Next, then Finish to return to the Internet Settings screenwith your new connection.
Network Support—Chapter 4119700 Series Color Mobile Computer User’s Manual6Press and hold the new connection for a pop-up menu, then tapConnect to initiate the connection. Wait for about ten seconds for theNetwork Log On screen, then tap OK.Note: You do not need to enter anyinformation within the Network Log On screen.7Use either the onscreen keyboard, or press the keys to type any of theAT commands provided by Sierra Wireless. Press or tap Enter to sendeach command. The results of each command sent will print onscreen -see the sample illustration below. Note that each “AT” command muststart with either the “at” or “at+” characters.STo see what you typed onscreen, type “ate1” to initiate the AT Echocommand, then press Enter.
Network SupportChapter —4120 700 Series Color Mobile Computer User’s ManualWireless PrintingThe 700 Series Computer can integrate the Wireless Printing option(which is equipped with a Bluetooth qualified module by Socket Communica-tions) along with either the GSM/GPRS or the CDMA/1xRTT radio andthe 802.11b radio. This option uses the network to print informationstored on the 700 Series Computer.“Bluetooth” is the name given to a technology standard using short-rangeradio links, intended to replace the cables connecting portable and fixedelectronic devices. The standard defines a uniform structure for a widerange of devices to communicate with each other, with minimal user ef-fort. Its key features are robustness, low complexity, low power, and lowcost. The technology also offers wireless access to LANs, the mobile phonenetwork, and the internet for a host of home appliances and portablehand-held interfaces.DocumentationInformation about additional “Bluetooth” software, including the Blue-tooth Device Manager and the BTctrl program, can be found within theWireless Printing SDK. This is located on the 700C Software Tools CD,via the directory off the root of the toolkit called “Wireless Printing SDK.”It also can be found in the Wireless Printing Development Guide,alsoonthe700C Tools CD.Bluealps CORE ModuleThe Bluealps CORE module displays helpful information about this Wire-less Printing option within your 700 Series Computer. Below are descrip-tions and meanings for each piece of information provided via the Generaltab, reading from top to bottom starting on the left.
Network Support—Chapter 4121700 Series Color Mobile Computer User’s ManualSBluetooth Point to Point:This is the network type. “Point to Point” is the type of connection sup-ported as of this publication. Scatternets are not supported. The only sup-ported application is wireless printing to Intermec wireless printers, suchas the 781T Belt-Mount Printer.SDevice Address:This provides the network address, which in this case, will be replacedby the device address of the Bluetooth compatible module within your700 Series Computer. Note that this address is universally unique.SDiscoverable:The following is displayed depending on whether the 700 Series Com-puter is configured to be discoverable:“Gen” Generally discoverable“Lim” Limited discovery“No” Not discoverableSConnectable:This defines whether the 700 Series Computer is able to accept otherdevices with Bluetooth compatible modules connecting to it. “Yes” if theconnection is doable, “No” if not.SBondable:This defines the security element of the 700 Series Computer, which isthe bondable setting. If the unit is bondable, then “Yes” is displayed,otherwise “No” is displayed.SModule Firmware:This reflects the firmware (hardware) version of the 700 Series Comput-er. When the CORE module first installs onto the unit, the firmwarelevel is unknown, thus “...reading” is displayed. Once the firmware levelis read from the unit, then a three-digit decimal is displayed.SStack [Stack Version] [loaded/not loaded]:[Stack Version] displays the Bluetooth stack version, which appears in the“1.2.3.4” format. If the stack is loaded, then “loaded” is displayed afterthe stack version, otherwise “not loaded” is displayed.SDevice Name:This displays the device name as assigned to the Bluetooth compatiblemodule by the end-user. If the configured name is longer than the spaceallowed, it will be truncated.SBTpak Version:This displays the driver version of additional Bluetooth componentswithin the 700 Series Computer and is usually presented in the “1.2.3”format. The version may also contain a letter at either end.SHistory:This bar graph displays an active history of this wireless printer driver’ squality of connections.SFriendly Indicator:If the Bluetooth stack is loaded, then all three dots are filled. These dotsare left empty if the stack is not loaded. These dots do vary based on theCORE application’ s perception of the overall connection quality.
Network SupportChapter —4122 700 Series Color Mobile Computer User’s ManualAutoIP/DHCPAutomatic Private IP Addressing (AutoIP) is enabled by default in PocketPC 2002. To remain compatible with other Pocket PC devices, this settingneeds to be enabled. You can configure the registry settings in thefollowing to set the required AutoIP/DHCP behavior:SFor Ethernet: HKEY_LOCAL_MACHINE\Comm\LAN9001\TcpIpSFot 802.11b: HKEY_LOCAL_MACHINE\Comm\NETWLAN1\TcpIpOther registry keys that can modify the behavior of AutoIP are as follows.You can find the appropriate settings and behavior of each of these keys inMicrosoft Help.SAutoIntervalSAutoMaskSAutoSubnetSAutoIPSAutoSeedWhen a TCP/IP client cannot find a DHCP server, it generates an AutoIPaddress from the 169.254.xxx.xxx block. The client then tries to check fora DHCP server every 300 seconds (5 minutes) and if a DHCP server isfound, the client drops the AutoIP address and uses the address from theDHCP server.In the MSDN Windows CE documentation, see “Automatic Client Config-uration” for more information on AutoIP.To disable AutoIP, set the AutoCfg registry entry to “0.” If a DHCP servercannot be found, instead of using AutoIP, the system will display the “Un-able to obtain a server assigned IP address” message.Note: If AutoIP is defined using CAB files, the EnableDHCP registry keymust also be defined and set to “1” before the system will attempt to ob-tain a DHCP address.To extend the number of attempts that a DHCP client makes to get aDHCP address, use the DhcpRetryDialogue and DhcpMaxRetry registrysettings.Change the AutoInterval registry key value to make the client retry moreoften to obtain a DHCP address.
Network Support—Chapter 4123700 Series Color Mobile Computer User’s ManualSNMP ConfigurationSimple Network Management Protocol (SNMP) was developed in the late1980s to provide a general-purpose internetworking management protocol.Its primary goal was to be simple so nothing would stand in the way of itsubiquitous deployment. To this end, it has been very successful as it is cur-rently deployed in almost every major internetworking product on themarket. However, like many achieved goals, the primary strength can alsobecome a weakness.The Focus was “Simple”An extreme example of simplicity versus power can be realized by compar-ing SNMP against the Common Management Information Protocol(CMIP), the ISO entry to the standard management protocol world.CMIP has a very rich set of primitives and a core set of data elements.However, to implement CMIP, a subset of the protocol must be selected.Then, to achieve interoperability, this subset must be agreed upon withother implementors. As SNMP was specified completely and with no op-tions, one implemented what was there and interoperability was assured.Returning to simplicity, SNMP was built simply for a number of reasonsother than time to market: robustness in the face of network failure, lowoverhead in the devices running the protocol; and ease of debugging theprotocol itself (the last thing you want to debug is the management protocolthat is supposed to be helping you debug your network). Thus, the SNMPlimited itself to the User Datagram Protocol (UDP). This gave theimplementor the ability and responsibility to manage lost packets andperform any necessary retransmissions. As network debugging in the faceof changing routes will certainly mean losing packets, retaining this controlfrom the transport service (layer 4) was considered essential. Since anetwork management protocol will run continuously, it is mandatory thatit consume as minimal a network resource as possible. UDP allows thenecessary control over packet transmissions, packet size and content(packetization). It is a natural choice.Using SNMPSNMP has three control primitives that initiate data flow from therequester (get, get-next, and set). There are two control primitives theresponder uses to reply. One is used in response to the requester’ s directquery (get-response) and the other is an asynchronous response to obtainthe requester’ s attention (trap). All five of these primitives are carried byUDP and are thus limited in size by the amount of data that can fit into asingle UDP packet. The relatively small message size was a goal of thedesign but for some reasonable set of network management functions, itimposes a limitation.Often in network management, it is necessary to obtain bulk informationwithout knowing at first what is in that bulk. In one case, there is a set ofproblems having to do with packets not going where they are supposed to,due to device misconfiguration that prevents proper protocol operationwhere one needs to view the entire set of data.
Network SupportChapter —4124 700 Series Color Mobile Computer User’s ManualRetrieval of Management InformationSNMP has the get-next primitive which permits the viewing of datawithout requiring prior knowledge. If you know what you are looking for,the get primitive will return it. When you want an entire table ofinformation, the get-next primitive will obtain it. However, unlessemployed with care, the get-next primitive can be extremelyresource-intensive in real time, network bandwidth, and the agent’ s CPUtime. The simplest use of the get-next primitive is to start at the beginningof a table, await the response and then issue another get-next with thename returned. As an example, say you wanted the next-hop address,next-hop interface, and route-type from a routing table containing 1000entries. Using the simplest form of get-next, this would require 2x3x1000or 6000 packets (get-next and get-response packets, columns, and rows).Astraight-forward optimization would be to request the three columns in asingle packet. This puts the number of packets at 2x1000 or 2000 packets.In real time, it is the product of the round trip by the number of request.In agent CPU time, this is still 6000 lookups in the routing table for bothcases.An Early Approach to Getting More than One Item at a TimeThe ability to retrieve only one piece or object at a time has been aproblem for SNMP. This is particularly an issue with the use of thisprotocol in wireless environments where the wireless datapipe is small andoverhead due to network management it is considered overhead. Oneapproach creates multiple get-next requests running concurrently. A secondalgorithm, reduces the packet count by combining the multiple concurrentget-nexts into a single packet. Neither approach has been implementedwhich makes network management in wireless environment, thoughessential to the success of the operation, tenuous. The issue has beenresolved in SNMP V2 protocol where a get-bulk primitive has beendefined.ConclusionSoftware development moves forward by evolving the unknown into theknown and wireless environments are moving from vertical onlyapplication to wide spread implementation. At the time of the SNMPinception, it was not possible to conceive of a reliable transport basednetwork management protocol. Today’ s problems require moresophisticated data to analyze a problem. This puts the burden back on theprotocol to send and receive data quickly and efficiently. Work continuesin subcommittees to improve SNMP and resolve the issues that aredeveloping with new applications and new network architectures.
Network Support—Chapter 4125700 Series Color Mobile Computer User’s ManualSNMP Configuration on the 700 Series ComputerIn short, SNMP is an application-layer protocol that facilitates the ex-change of management information between network devices. The 700Series Computer is such an SNMP-enabled device. Use SNMP to controland configure the 700 Series Computer anywhere on an SNMP-enablednetwork.The 700 Series Computer supports four proprietary Management Infor-mation Bases (MIBs) and Intermec Technologies provides SNMP supportfor MIB-II through seven read-only MIB-II (RFC1213-MIB) ObjectIdentifiers (OIDs).Note: You can only query these seven OIDs through an SNMP manage-ment station, these are not available in the Unit Manager applications.Management Information BaseThe Management Information Base is a database that contains informationabout the elements to be managed. The information identifies the manage-ment element and specifies its type and access mode (Read-Only, Read-Write). MIBs are written in ASN.1 (Abstract Syntax Notation.1) - a ma-chine independent data definition language. Note: Elements to be managedare represented by objects. The MIB is a structured collection of such objects.You will find the following MIB files either on the 700C Tools CD or onthe web via http://www.intermec.com:SINTERMEC.MIBDefines the root of the Intermec MIB tree.SITCADC.MIBDefines objects for Automated Data Collection (ADC), such as bar codesymbologies.SITCSNMP.MIBDefines objects for Intermec SNMP parameters and security methods,such as an SNMP security IP address.SITCTERMINAL.MIBDefines objects for 700 Series parameters, such as key clicks.
Network SupportChapter —4126 700 Series Color Mobile Computer User’s ManualObject IdentifiersEach object has a unique identifier called an OID. OIDs consist of a se-quence of integer values represented in dot notation. Objects are stored ina tree structure. OIDs are assigned based on the position of the object inthe tree. Seven MIB OIDs are shown in the followig table.ExampleThe internet OID = 1.3.6.1.MIB Object IdentifiersMIB-II Item OID Group or Table DescriptionifNumber 1.3.6.1.2.1.2.1.0 Interfaces Group Indicates the number of adapterspresent in the system. For the 700Series Computer, if one adapter ispresent in the system, then ifNum-ber =1andifIndex=1.ifIndex 1.3.6.1.2.1.2.2.1.1.ifIndex Inter face s Ta ble (i fTable ) A unique value for each interface.The value ranges between 1 and thevalue of ifNumber.ifDescr 1.3.6.1.2.1.2.2.1.2.ifIndex Interfaces Table (ifTable) A textual string containing informa-tion about the interface.ifType 1.3.6.1.2.1.2.2.1.3.ifIndex Interfaces Ta ble (if Table ) An integer containing informationabout the type of the interface. It isequal to 1 for Other.ipAdEntAddr 1.3.6.1.2.1.4.20.1.1.IpAddress IP address Table(ipAddrTable)The IP address to which this entry’ saddressing information pertains(same as 700 IP address), where IPAddress is the valid non-zero IP ad-dress of the 700 Series Computer.ipAdEntIfIndex 1.3.6.1.2.1.4.20.1.2.IpAddress IP address Table(ipAddrTable)The index value that uniquely iden-tifies the interface to which thisentry is applicable (same as ifIndex).ipAdEntNetMask 1.3.6.1.2.1.4.20.1.3.IpAddress IP address Table(ipAddrTable)The subnet mask associated withthe IP address of this entry (same asSubnet Mask).Configuring with SNMPThe community string allows an SNMP manager to manage the 700 SeriesComputer with a specified privilege level. The default read-only communi-ty string is “public” and “private” is the default read/write communitystring. See the specific configuration parameter to find its OID. To config-ure the 700 Series Computers using SNMP:1Configure 700 Series Computers for RF or Ethernet communications.2Determine the OID (Object Identifier) for the parameter to be chan-ged. The Intermec base OID is 1.3.6.1.4.1.1963.3Use your SNMP management station to get and set variables that aredefined in the Intermec MIBs. You can set the traps, identification, orsecurity configuration parameters for SNMP. See Appendix A, “ControlPanel Applets,” to learn more about these parameters.

Navigation menu