Intermec Technologies SMC46 GSM Radio Module in 700C Host User Manual legal
Intermec Technologies Corporation GSM Radio Module in 700C Host legal
Contents
User manual part 2
Scanner Support The 700 Series Color Mobile Computer is available with imaging or laser scanning technologies, including the following: APS Linear Imager: (standard for 730 Computers) — includes the EV10 Scan Engine Reads 1D symbologies and PDF417 bar codes. Linear imaging using Vista Scanning technology reads low-contrast bar codes, laminated bar codes, and bar codes displayed on CRT or TRT displays. This imaging uses harmless LEDs for illumination and does not require any warning labels. Vista Scanning is more reliable than lasers as it is a completely solid state with no moving parts or oscillating mirrors. 2D Imager: (not supported on 730 Computers) — includes the IT4000 Scan Engine This decodes several stacked 1D and 2D symbologies, including PDF417, Data Matrix, and MaxiCode without “painting.” It can also read 1D codes from any orientation, for example the scan beam does not need to align perpendicular to the symbol to read it. Photography is a secondary application; the lens in the device favors bar code reading. Photos are 640x480, 256 gray-scale. 1D Laser Scanner: (not supported on 730 Computers) — includes the SE900, SE900HS, SE900-S6, and SE900HS-S6 scan engines Traditional laser scanner that decodes 1D bar codes. PDF417 Laser Scanner: (not supported on 730 Computers) Higher speed laser scanner that can read PDF417 labels by “painting” the label. A 700 Color Imager Demo application demonstrates the more common features of the 700 Color Computer imager. See the Imager Demo V1.0 User’s Guide on the Intermec Developer’s Library CD for information. Note: “700 Color” pertains to 740, 741, 750, 751, 760, and 761 Computers unless otherwise noted. 700 Series Color Mobile Computer User’s Manual 199 Chapter 6 — Scanner Support Scanner Control and Data Transfer Note: To use the methods described below, enable Data Collection functionality on the 700 Computer using the bootloader configuration menu. The Data Server and associated software provide several ways to manipulate scanner control and data transfer between the scanner subsystem and user applications: S Automatic Data Collection COM Interfaces: These COM interfaces allow user applications to receive bar code data, and configure and control the bar code reader engine. S ITCAxBarCodeReaderControl functions: These ActiveX controls allow user applications to collect bar code data from the scanner, to configure the scanner, and to configure audio and visual notification when data arrives. S ITCAxReaderCommand functions: Use these ActiveX controls to modify and retrieve configuration information using the reader interface commands. S Scanning EasySet bar code labels: You can use the EasySetR bar code creation software from Intermec Technologies Corporation to print configuration labels. Scan the labels to change the scanner configuration and data transfer settings. Use the Intermec EasySet software to print configuration labels you can scan to change your configuration settings. For more information, see the EasySet online help. EasySet is available from the Intermec Data Capture web site. For more information, see the SDK User’s Manual provided with your Windows CE/PocketPC SDK. 200 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support Data Collection Configuration For Units with PSM Builds Older than 3.00 Scanner settings for the 700 Color Computer can be configured via the Data Collection control panel applet. From the 700 Color Computer, tap Start > Settings > the System tab > Data Collection. See Appendix A, “Configurable Settings” for more information about the following parameters. Note that these are in alphabetical order. S Codabar (page 298) S Code 11 (page 312) S Code 128 (page 301) S Code 128 Options (page 302) S Code 128 FNC1 Character (page 303) S Code 39 (page 296) S Code 93 (page 300) S Code 93 Length (page 300) S Data Matrix (page 314) S Interleaved 2 of 5 (page 309) S Matrix 2 of 5 (page 310) S MaxiCode (page 315) S MSI (page 305) S PDF417 (page 306) S Macro PDF (page 306) S Micro PDF417 (page 308) S Plessey (page 304) S QR Code (page 313) S Standard 2 of 5 (page 297) S Telepen (page 311) S UPC/EAN (page 299) For Units With PSM Build 3.00 or Newer You can configure scanner settings for the 700 Color Computer via the Intermec Settings control panel applet. From the 700 Color Computer, tap Start > Settings > the System tab > the Intermec Settings icon. See the Intermec Computer Command Reference Manual (P/N: 073529) for information about the settings you can configure with this applet. This online manual is available from the Intermec web site at www.intermec.com. 700 Series Color Mobile Computer User’s Manual 201 Chapter 6 — Scanner Support Internal Scanners The Intermec Internal Scanner feature allows Automatic Data Collection (ADC) by accepting data from the COM1 port and wedging it into the keyboard interface. You can enable or disable this feature from the Today screen on the 700 Color Computer. For Units With PSM Build 3.00 or Newer Do the following before you configure your internal scanner from the Intermec Settings control panel applet. Information about the settings you can configure with this applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. 1 From the 700 Color Computer, tap Start > Settings > the System tab > the Intermec Settings icon. 2 Tap the Scanners, Symbologies option, then tap (+) to expand Internal Scanner. This sample screen is for the IT4000 scan engine. 202 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support Scanner and Imager Settings Depending on what is selected as the scanner model, image settings, decode security, scanner settings, and virtual wedge are configured from the Intermec Settings applet. See the the Intermec Computer Command Reference Manual, available from the Intermec web site at www.intermec.com, for more information about each enabled option. Internal Scanner Supported Symbologies See the following table for a guideline and Appendix B, “Bar Code Symbologies” for more information on each supported symbology: Symbologies EV10 IT4000 SE900 SE900HS SE900-S6 SE900HS-S6 Code39 UPC/EAN Code 128 Interleaved 2 of 5 Code 93 Codabar Code 2 of 5 MSI Plessey Code 11 Matrix 2 of 5 Telepen PDF417 Micro PDF417 MaxiCode Data Matrix QR Code RSS 14 Available in f/w Sxxp304 Available in f/w Sxxp304 RSS Limited Available in f/w Sxxp304 Available in f/w Sxxp304 RSS Expanded Available in f/w Sxxp304 Available in f/w Sxxp304 Codablock A Codablock F UCC Composite 700 Series Color Mobile Computer User’s Manual 203 Chapter 6 — Scanner Support Tethered Scanners The Intermec Tethered Scanner feature allows Automatic Data Collection (ADC) by accepting data from the COM1 port and wedging it into the keyboard interface. You can enable or disable this feature from the Today screen on the 700 Color Computer. The following information is divided between units with PSM Builds older than 3.00 (next paragraph) or units with PSM Builds 3.00 or newer (starting on page 209). For Units With PSM Builds Older than 3.00 Enabling and Disabling On the 700 Color Computer, tap Start > Today. Tap the bar code scanner icon in the System Tray (circled below). Initially, the bar code scanner icon indicates that this feature is disabled (shown to the left). S Select Comm Port Wedge to send any data, coming into the 700 Color Computer through the COM1 port from an external input device, as keyboard data to an application on the desktop. For example, if you have Pocket Word running on your 700 Color Computer desktop, information scanned with a scanner connected to the COM1 port appears in the Word document. If another data collection application is running and is active on the 700 Color Computer, the scanned information appears in that application. Note: When Comm Port Wedge is selected, regardless of the data sent by the external input device, you cannot control the device or the data format using any of the Intermec scanner control or data transfer APIs from the SDK or the internal Data Collection software. The external input device is governed by what software it has onboard to tell it how to scan, take pictures, or send the data elsewhere. 204 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support S Select 1551/1553 to enable the Sabre 1551E or 1553 Tethered Scanner to scan, then send data as keyboard data. The 1551/1553 Tethered Scanner has software onboard that translates scanned data into characters, so the running/active application does not need to know how to do that. All the scanner control and data transfer APIs will work with the 1551/1553 Tethered Scanner, so you can control the device. S Select Disable All to disable this feature and use the COM1 port for another application, such as ActiveSync. An error message will result if this option were not selected, but this action was attempted. Similarly, if ActiveSync is using the COM1 port, and you select Comm Port Wedge or 1551/1553, an error message will result. See “Error Message” for more information. Error Message If the COM1 port is used by another application, such as ActiveSync, neither the Comm Port Wedge nor the 1551/1553 Tethered Scanner can be enabled. As a result, the following message may appear. Note that this message is for the Comm Port Wedge. You must disable that application to free up the COM1 port before you can enable either the wedge or the scanner. Changing Comm Settings Tap Change Comm Settings to configure the settings for the COM1 port. Current settings are restored after a warm-boot is performed, but are lost after a cold-boot is performed. When these settings are not changed, the OK button is disabled (grayed out). When changes are made, tap OK after it is enabled to accept these changes. S Baud Rate: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 S Data Bits: 7 or 8 S Parity: None, Odd, Even, Mark, Space S Stop Bits: 1 or 2 S Flow Control: None or Hardware 700 Series Color Mobile Computer User’s Manual 205 Chapter 6 — Scanner Support Tethered Scanner Default settings for the Tethered Scanner are shown in this illustration: Sabre 1551E or 1553 Tethered Scanner The default communication configuration for the Sabre 1551E or 1553 Tethered Scanner is shown in the following illustration. Scan the EasySet Reset Factory Defaults label to set the Sabre 1551E or 1553 tethered scanner communications settings to this configuration. The COM1 port configuration settings must also match those of the scanner to scan labels. Welch Allyn 1470 Imager Settings You can set the Welch Allyn 1470 Imager to this configuration by scanning the Factory Default Settings label. 206 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support Scanner Cabling A null modem cable is required for the Welch Allyn 1470 Imager to communicate with the 700 Color Computer when using the 700 Color Serial Cable (P/N: 226-999-001). Sabre 1551E / 1553 Cables connect directly to the Model 700 COM Port. Limitations and Capabilities The Tethered Scanner has the following limitations: S No auto detection of a scanner’s physical connection to COM1 port. User needs to ensure the communication settings of COM1 port matched the settings of the device. S The Pocket PC Pocket Office applications misbehave when control characters such as carriage return are wedged. This is a known Pocket PC problem, which is being worked with Microsoft and for which a work around is being developed. S Communications port is COM1 and cannot be changed. S A complete bar code label is detected when the time between bytes (the inter-byte gap) exceeds 100 ms. This allows that data could be concatenated if two labels were received while the Comm Port Wedge or the 1551/1553 Tethered Scanner was not performing a read. That is, it could be wedging data just read or the read thread could be preempted. Also, the labels could appear concatenated if the scanner itself were to buffer the labels before transmitting them. When enabled, the “Comm Port Wedge” menu option has this limitation: S There is no bar code API to get bar code data from the bar code scanner. The Comm Port Wedge transmits the data through the keyboard interface only. When enabled, the “1551/1553” menu option has these capabilities: S Grid Data Editing is available. S The source of the symbology configurations is only available via the Easy Set command labels. You can only configure the Virtual Wedge configurations via the Data Collection control panel applet Virtual Wedge page. See Appendix A, “Configurable Settings,” for information. S May transmit the data through the keyboard interface (via the Virtual Wedge). 700 Series Color Mobile Computer User’s Manual 207 Chapter 6 — Scanner Support S The bar code APIs, defined in the IADC interface, are available to get bar code data from the bar code scanner. The following example shows how to programmatically collects bar code data: #include “IADC.h” #include “ITCAdcMgmt.h” // Linked with ITCUUID.LIB // Linked with ITCAdcDevMgmt.lib IADC* pIADC; HRESULT hrStatus = S_OK; // Create a ADC COM interface to collect bar code data from the 1551E/1553 // when the 1551/1553 menu option is enabled. hrStatus = ITCDeviceOpen(TEXT(“ExtScanner”), // Name of the ADC device. IID_IADC, // COM interface to return ITC_DHDEVFLAG_READAHEAD, // Device’s Flags (LPVOID *) &pIADC); // the returned interface if( SUCCEEDED(hrStatus) ) BYTE byteBuffer[MAX_LABEL_SIZE]; DWORD dwLength = 0; HRESULT hr = pIDC->Read( byteBuffer, // MAX_LABEL_SIZE, // &dwLength, // NULL, // INFINITE // ); Buffer to put the ADC data. Size of pDataBuffer in bytes. Number bytes returned. Time stamp of the received data. NULL. Number of milliseconds to wait. when done using this COM interface, delete it: ITCDeviceClose( (IUnknown **) pIADC); 208 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support For Units With PSM Build 3.00 or Newer Configuring the Tethered Scanner Do the following before you configure your tethered scanner from the Intermec Settings control panel applet. Information about the settings you can configure with this applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. 1 Connect your tethered scanner to the tethered scanner port. 2 From the 700 Color Computer, tap Start > Settings > the System tab > the Intermec Settings icon. 3 Tap the Scanners, Symbologies option, then tap (+) to expand Dock Tethered Scanner. 700 Series Color Mobile Computer User’s Manual 209 Chapter 6 — Scanner Support 4 Tap Scanner model for a drop-down list, then select the applicable scanner, such as “1551E” or “1553” in this sample screen. 5 Make sure a scanner is connected to your 700 Computer properly. Then, tap to check Enable scanner port, then tap File > Save Settings from the bottom of the screen. These changes take several moments to reset. 210 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support 1551E or 1553 Selected for Scanner Model When “1551E” or “1553” is selected from the Scanner model option (see step 4 above), and the port state is already enabled (see step 5), the process will take several moments to reset. When 1551E or 1553 is successfully connected during this step, the unit will emit some beeps. Here, the terminal is initializing the scanner at 9600 for the baud rate, 7 data bits, even parity, and 2 stop bits and synchronizing the terminal’s configuration with the attached scanner. With “1551E” or “1553” selected, Symbologies, Symbology Options, Hardware Trigger, and Scanner Port settings are configured from the Intermec Settings applet. See the the Intermec Computer Command Reference Manual, available from the Intermec web site at www.intermec.com, for more information about each enabled option. ASCII Selected for Scanner Model To send data coming into the 700 Color Computer through the COM1 port from an external input device, as keyboard data to an application on the desktop, do the following: 1 Select “ASCII” from the Scanner model option. 2 Tap to check Enable scanner port. 3 Tap File > Save Settings from the bottom of the screen. With “ASCII” selected, Symbology Options, Hardware Trigger, and Scanner Port settings are configured from the Intermec Settings applet. See the the Intermec Computer Command Reference Manual, available from the Intermec web site at www.intermec.com, for more information about each enabled option. 700 Series Color Mobile Computer User’s Manual 211 Chapter 6 — Scanner Support Note: When selecting either the 1551E or the 1553 Scanner or enabling the scanner port for these scanners, the 700 Computer tries to communicate with the attached scanner. If the scanner is not powered, if the cable is not connected properly, the wrong cable is used, or if the scanner firmware is older than 2.0, and the “Failed to save one or more settings” message appears, then this step failed. This process can take time as the terminal is going through a group of RS-232 settings to communicate with the scanner. After successful communicated with the scanner (about eight beeps are generated), it initializes the scanner with the 700 Computer’s current settings. This process might generate a series of beeps pending on the firmware version installed in the scanner. These beeps are suppressed in firmware versions 2.08 or greater. Troubleshooting the 1551E/1553 Tethered Scanner Do the following to troubleshoot your 1551/1553 Tethered Scanner: 1 Ensure the correct cable is used for the scanner on the tethered scanner port. Note the 700 Computer cannot supply power to the scanner. 2 Perform a quick test to determine whether the connection is good. Temporary select the scanner model as “ASCII,” then enable the scanner port state. Go to a command prompt or a notepad and scan a data label. If a label is wedged into the command prompt or notepad, then the connection is good. 3 If step 2 passes, reset the scanner configurations to their defaults (scan the Reset Factory Defaults label on the next page) to prevent miscommunication, then reenable the scanner port state. 4 If step 2 fails, then the firmware installed in the tethered scanner may be older than version 2.0. Upgrade your scanner firmware. Reset Factory Defaults Scan the EasySet software bar code label “Reset Factory Default” to restore all of your scanner’s configurations to their factory defaults. When this command label is scanned, reinitialize the tethered scanner (such as disable the scanner port state, then enable it) on the 700 Computer. Otherwise, the online configuration and scanning on the 700 Computer are not functional. In general, scan this label only to initially reset the scanner. Do not scan EasySet command labels to change the following settings: S Symbologies code mark S Code 128, EAN29 Identifier S Preamble and Postamble S Enable/Disable symbologies S Symbology ID transmit option In some cases, scanning EasySet Command labels cause the current setting on the user interface to be out of sync with the scanner settings. However, in some cases, scanning these labels does corrupt scanned data. The “Open COMx error: 0x00000037” message appears if the COM port cannot open due to another application using the port. Disable that application to free up the COM1 port before you can enable the scanner. “x” is the COM port number, such as 1, 2, or 3. 212 700 Series Color Mobile Computer User’s Manual Chapter 6 — Scanner Support Tethered Scanner Supported Symbologies The user interface may allow configuration of PDF417, Micro PDF417, RSS, and Codablock bar code symbologies. However, these symbologies are dependant on what scanner models and firmware versions are in use. See the following table for a guideline and Appendix B, “Bar Code Symbologies” for more information on each supported symbology: You can use a generic ASCII scanner with the 700 Color Computer. Pending on the scanner, linear symbologies such as Code39, should decode correctly. However, 2D symbologies such as PDF417 may not decode correctly. Symbologies 1551E 1553 Code39 UPC/EAN Code 128 Interleaved 2 of 5 Code 93 Codabar Code 2 of 5 MSI Plessey Code 11 Matrix 2 of 5 Telepen PDF417 Available in 1551 0808 PDF Micro PDF417 Available in 1551 0808 PDF, Sxxp217_ or later MaxiCode Data Matrix QR Code RSS 14 F/w version 2.15 or later F/w version 2.15 or later RSS Limited F/w version 2.15 or later F/w version 2.15 or later RSS Expanded F/w version 2.15 or later F/w version 2.15 or later Codablock A Available in 1551 0808 PDF Codablock F Available in 1551 0808 PDF UCC Composite 700 Series Color Mobile Computer User’s Manual 213 Chapter 6 — Scanner Support 214 700 Series Color Mobile Computer User’s Manual 7 Programming The following programming information pertains to the 700 Series Color Mobile Computer: S Creating CAB Files (page 216) S Customization and Lockdown (page 233) S FTP Server (page 234) S Kernel I/O Control Functions (page 242) S Network Selection APIs (page 258) S Notifications (page 281) S Reboot Functions (page 283) S Remapping the Keypad (page 284) Note: “700 Color” pertains to 740, 741, 750, 751, 760, and 761 Computers unless otherwise noted. 700 Series Color Mobile Computer User’s Manual 215 Chapter 7 — Programming Creating CAB Files The Windows CE operating system uses a .CAB file to install an application on a Windows CE-based device. A .CAB file is composed of multiple files that are compressed into one file. Compressing multiple files into one file provides the following benefits: S All application files are present. S A partial installation is prevented. S The application can be installed from several sources, such as a desktop computer or a Web site. Use the CAB Wizard application (CABWIZ.EXE) to generate a .CAB file for your application. Creating Device-Specific CAB Files Do the following to create a device-specific .CAB file for an application, in the order provided: 1 Create an .INF file with Windows CE-specific modifications (page 216). 2 Optional Create a SETUP.DLL file to provide custom control of the installation process (page 228). 3 Use the CAB Wizard to create the .CAB file, using the .INF file, the optional SETUP.DLL file, and the device-specific application files as parameters (page 231). Creating an .INF File An .INF file specifies information about an application for the CAB Wizard. Below are the sections of an .INF file: [Version] This specifies the creator of the file, version, and other relevant information. Required? Yes S Signature: “signature_name” “$Windows NT$” S Provider: “INF_creator” The company name of the application, such as “Microsoft.” S CESignature “$Windows CE$” Example [Version] Signature = “$Windows NT$” Provider = “Intermec” CESignature = “$Windows CE$” 216 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming [CEStrings] This specifies string substitutions for the application name and the default installation directory. Required? Yes S AppName: app_name Name of the application. Other instances of %AppName% in the .INF file are replaced with this string value, such as RP32. S InstallDir: default_install_dir Default installation directory on the device. Other instances of %InstallDir% in the .INF file are replaced with this string value. Example: \SDMMC_Disk\%AppName% Example [CEStrings] AppName=“Game Pack” InstallDir=%CE1%\%AppName% [Strings] This section is optional and defines one or more string keys. A string key represents a string of printable characters. Required? No S string_key: value String consisting of letters, digits, or other printable characters. Enclose value in double quotation marks ““”” if the corresponding string key is used in an item that requires double quotation marks. No string_keys is okay. Example [Strings] reg_path = Software\Intermec\My Test App 700 Series Color Mobile Computer User’s Manual 217 Chapter 7 — Programming [CEDevice] Describes the platform for the targeted application. All keys in this section are optional. If a key is nonexistent or has no data, Windows CE does not perform any checking with the exception being UnsupportedPlatforms. If the UnsupportedPlatforms key exists but no data, the previous value is not overridden. Required? Yes S ProcessorType : processor_type The value that is returned by SYSTEMINFO.dwProcessorType.For example, the value for the ARM CPU is 2577 S UnsupportedPlatforms: platform_family_name This lists known unsupported platform family names. If the name specified in the [CEDevice.xxx] section is different from that in the [CEDevice] section, both platform_family_name values are unsupported for the microprocessor specified by xxx. That is, the list of unsupported platform family names is appended to the previous list of unsupported names. Application Manager will not display the application for an unsupported platform. Also, a user will be warned during the setup process if the .CAB file is copied to an unsupported device. Example [CEDevice] UnsupportedPlatforms = pltfrm1 ; pltfrm1 is unsupported [CEDevice.SH3] UnsupportedPlatforms = ; pltfrm1 is still unsupported S VersionMin: minor_version Numeric value returned by OSVERSIONINFO.dwVersionMinor. The .CAB file is valid for the currently connected device if the version of this device is greater than or equal to VersionMin. S VersionMax: major_version Numeric value returned by OSVERSIONINFO.dwVersionMajor. The .CAB file is valid for the currently connected device if the version of this device is less than or equal to VersionMax. S BuildMin: build_number Numeric value returned by OSVERSIONINFO.dwBuildNumber. The .CAB file is valid for the currently connected device if the version of this device is greater than or equal to BuildMin. S BuildMax: build_number Numeric value returned by OSVERSIONINFO.dwBuildNumber. The .CAB file is valid for the currently connected device if the version of this device is less than or equal to BuildMax. 218 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Example The following code example shows three [CEDevice] sections: one that gives basic information for any CPU and two that are specific to the SH3 and the MIPS microprocessors. [CEDevice] UnsupportedPlatforms = pltfrm1 ; A “template” for all platforms ; Does not support pltfrm1 ; The following specifies version 1.0 devices only. VersionMin = 1.0 VersionMax = 1.0 [CEDevice.ARM] ; Inherits all [CEDevice] settings ; This will create a .CAB file specific to ARM devices. ProcessorType = 2577 ; ARM .cab file is valid for ARM microprocessors. UnsupportedPlatforms = ; pltfrm1 is still unsupported ; The following overrides the version settings so that no version checking is performed. VersionMin = VersionMax = [CEDevice.MIPS] ; Inherits all [CEDevice] settings ; This will create a .CAB file specific to “MIPS” devices. ProcessorType = 4000 ; MIPS .CAB file is valid for MIPS microprocessor. UnsupportedPlatforms =pltfrm2 ; pltfrm1, pltfrm2 unsupported for MIPs .CAB file. Note: To create the two CPU-specific .CAB files for the SETUP.INF file in the previous example, run the CAB Wizard with the “/cpu arm mips” parameter. 700 Series Color Mobile Computer User’s Manual 219 Chapter 7 — Programming [DefaultInstall] This describes the default installation of your application. Note that under this section, you will list items expanded upon later in this description. Required? Yes S Copyfiles: copyfile_list_section Maps to files defined later in the .INF file, such as Files.App, Files.Font, and Files.Bitmaps. S AddReg: add_registry_section Example: RegSettings.All S CEShortcuts: shortcut_list_section String that identifies one more section that defines shortcuts to a file, as defined in the [CEShortcuts] section. S CESetupDLL: setup_DLL Optimal string that specifies a SETUP.DLL file. It is written by the Independent Software Vendor (ISV) and contains customized functions for operations during installation and removal of the application. The file must be specified in the [SourceDisksFiles] section. S CESelfRegister: self_reg_DLL_filename String that identifies files that self-register by exporting the DllRegisterServer and DllUnregisterServer Component Object Model (COM) functions. Specify these files in the [SourceDiskFiles] section. During installation, if installation on the device fails to call the file’s exported DllRegisterServer function, the file’s exported DllUnregisterServer function will not be called during removal. Example [DefaultInstall] AddReg = RegSettings.All CEShortcuts = Shortcuts.All [SourceDiskNames] This section describes the name and path of the disk on which your application resides. Required? Yes S disk_ordinal: disk_label,,path 1=,“App files” , C:\Appsoft\RP32\... 2=,“Font files”,,C:\RpTools\... 3=,“CE Tools” ,,C:\windows ce tools... S CESignature: “$Windows CE$” Example [SourceDisksNames] 1 = ,“Common files”,,C:\app\common [SourceDisksNames.SH3] 2 = ,“SH3 files”,,sh3 [SourceDisksNames.MIPS] 2 = ,“MIPS files”,,mips 220 ; Required section ; Using an absolute path ; Using a relative path ; Using a relative path 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming [SourceDiskFiles] This describes the name and path of the files in which your application resides. Required? Yes S filename: disk_number[,subdir] RPM.EXE = 1,c:\appsoft\... WCESTART.INI = 1 RPMCE212.INI = 1 TAHOMA.TTF = 2 Note: [,subdir] is relative to the location of the INF file. Example [SourceDisksFiles] ; Required section begin.wav = 1 end.wav = 1 sample.hlp = 1 [SourceDisksFiles.SH3] sample.exe = 2 ; Uses the SourceDisksNames.SH3 identification of 2. [SourceDisksFiles.MIPS] sample.exe = 2 ; Uses the SourceDisksNames.MIPS identification of 2. 700 Series Color Mobile Computer User’s Manual 221 Chapter 7 — Programming [DestinationDirs] This describes the names and paths of the destination directories for the application on the target device. Note Windows CE does not support directory identifiers. Required? Yes S file_list_section: 0,subdir String that identifies the destination directory. The following list shows the string substitutions supported by Windows CE. Use these only for the beginning of the path. \ %CE1% \Program Files %CE2% \Windows %CE3% \My Documents %CE4% \Windows\Startup %CE5% \My Documents %CE6% \Program Files\Accessories %CE7% \Program Files\Communication %CE8% \Program Files\Games %CE9% \Program Files\Pocket Outlook %CE10% \Program Files\Office %CE11% \Windows\Start Menu\Programs %CE12% \Windows\Start Menu\Programs\Accessories %CE13% \Windows\Start Menu\Programs\Communications %CE14% \Windows\Start Menu\Programs\Games %CE15% \Windows\Fonts %CE16% \Windows\Recent %CE17% \Windows\Start Menu %InstallDir% Contains the path to the target directory selected during installation. It is declared in the [CEStrings] section %AppName% Contains the application name defined in the [CEStrings] section. Example [DestinationDirs] Files.Common = 0,%CE1%\My Subdir Files.Shared = 0,%CE2% 222 ; \Program Files\My Subdir ; \Windows 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming [CopyFiles] This section, under the [DefaultInstall] section, describes the default files to copy to the target device. Within the [DefaultInstall] section, files were listed that must be defined elsewhere in the INF file. This section identifies that mapping and may contain flags. Required? Yes S copyfile_list_section: destination_filename,[source_filename] The source_filename parameter is optional if it is the same as destination_filename. S copyfile_list_section: flags The numeric value that specifies an action to be done while copying files. The following table shows values supported by Windows CE. Flag Value Description COPYFLG_WARN_IF_SKIP 0x00000001 Warn user if skipping a file is attempted after error. COPYFLG_NOSKIP 0x00000002 Do not allow a user to skip copying a file. COPYFLG_NO_OVERWRITE 0x00000010 Do not overwrite files in destination directory. COPYFLG_REPLACEONLY 0x00000400 Copy the source file to the destination directory only if the file is already in the destination directory. CE_COPYFLG_NO_DATE_DIALOG 0x20000000 Do not copy files if the target file is newer. CE_COPYFLG_NODATECHECK 0x40000000 Ignore date while overwriting the target file. CE_COPYFLG_SHARED 0x80000000 Create a reference when a shared DLL is counted. Example [DefaultInstall.SH3] CopyFiles = Files.Common, Files.SH3 [DefaultInstall.MIPS] CopyFiles = Files.Common, Files.MIPS 700 Series Color Mobile Computer User’s Manual 223 Chapter 7 — Programming [AddReg] This section, under the [DefaultInstall] section, is optional and describes the keys and values that the .CAB file adds to the device registry. Within the [DefaultInstall] section, a reference may have been made to this section, such as “AddReg=RegSettings.All”. This section defines the options for that setting. Required? No S add_registry_section: registry_root_string String that specifies the registry root location. The following list shows the values supported by Windows CE. S HKCR Same as HKEY_CLASSES_ROOT S HKCU Same as HKEY_CURRENT_USER S HKLM Same as HKEY_LOCAL_MACHINE S add_registry_section: value_name Registry value name. If empty, the “default” registry value name is used. S add_registry_section: flags Numeric value that specifies information about the registry key. The following table shows the values that are supported by Window CE. Flag Value Description FLG_ADDREG_NOCLOBBER 0x00000002 If the registry key exists, do not overwrite it. Can be used with any of the other flags in this table. FLG_ADDREG_TYPE_SZ 0x00000000 REG_SZ registry data type. FLG_ADDREG_TYPE_MULTI_SZ 0x00010000 REG_MULTI_SZ registry data type. Value field that follows can be a list of strings separated by commas. FLG_ADDREG_TYPE_BINARY 0x00000001 REG_BINARY registry data type. Value field that follows must be a list of numeric values separated by commas, one byte per field, and must not use the 0x hexadecimal prefix. FLG_ADDREG_TYPE_DWORD 0x00010001 REG_DWORD data type. The noncompatible format in the Win32 Setup .INF documentation is supported. Example AddReg = RegSettings.All [RegSettings.All] HKLM,%reg_path%,,0x00000000,alpha HKLM,%reg_path%,test,0x00010001,3 HKLM,%reg_path%\new,another,0x00010001,6 224 ;= “alpha” ; Test = 3 ; New\another = 6 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming [CEShortCuts] This section, a Windows CE-specific section under the [DefaultInstall] section, is optional and describes the shortcuts that the installation application creates on the device. Within the [DefaultInstall] section, a reference may have been made to this section, such as “ShortCuts.All”. This section defines the options for that setting. Required? No S shortcut_list_section: shortcut_filename String that identifies the shortcut name. It does not require the .LNK extension. S shortcut_list_section: shortcut_type_flag Numeric value. Zero or empty represents a shortcut to a file; any nonzero numeric value represents a shortcut to a folder. S shortcut_list_section: target_file_path String value that specifies the destination location. Use the target file name for a file, such as MyApp.exe, that must be defined in a file copy list. For a path, use a file_list_section name defined in the [DestinationDirs] section, such as DefaultDestDir, or the %InstallDir% string. S shortcut_list_section: standard_destination_path Optional string value. A standard %CEx% path or %InstallDir%. If no value is specified, the shortcut_list_section name of the current section or the DefaultDestDir value from the [DestinationDirs] section is used. Example CEShortcuts = Shortcuts.All [Shortcuts.All] Sample App,0,sample.exe App,0,sample.exe,%InstallDir% ; Uses the path in DestinationDirs. Sample ; The path is explicitly specified. Sample .INF File [Version] ; Required section Signature = “$Windows NT$” Provider = “Intermec Technologies Corporation” CESignature = “$Windows CE$” ;[CEDevice] ;ProcessorType = [DefaultInstall] ; Required section CopyFiles = Files.App, Files.Fonts, Files.BitMaps, Files.Intl, Files.TelecomNcsCE, Files.Windows, Files.Import, Files.Export, Files.Work, Files.Database, Files.WinCE AddReg = RegSettings.All ;CEShortcuts = Shortcuts.All [SourceDisksNames] ; Required section 1 = ,“App files” ,,c:\appsoft\... 2 = ,”Font files” ,,c:\WinNT\Fonts 3 = ,”CE Tools” ,,c:\windows ce tools\wce400\700ie\mfc\lib\x86 [SourceDisksFiles] ; Required section rpm.exe = 1,C:\Appsoft\program\wce400\WCEX86Rel700 wcestart.ini = 1 700 Series Color Mobile Computer User’s Manual 225 Chapter 7 — Programming rpmce212.ini = 1 intermec.bmp = 1 rpmlogo.bmp = 1 rpmname.bmp = 1 import.bmp = 1 export.bmp = 1 clock.bmp = 1 printer.bmp = 1 filecopy.bmp = 1 readme.txt = 1 lang_eng.bin = 1 rpmdata.dbd = 1,database\wce1 tahoma.ttf = 2 mfcce212.dll = 3 olece212.dll = 3 olece211.dll = 1,c:\windows ce tools\wce400\NMSD61102.11\mfc\lib\x86 rdm45wce.dll = 1,c:\rptools\rdm45wce\4_50\lib\wce400\wcex86rel picfmt.dll = 1,c:\rptools\picfmt\1_00\wce400\wcex86rel6110 fmtctrl.dll = 1,c:\rptools\fmtctrl\1_00\wce400\wcex86rel6110 ugrid.dll = 1,c:\rptools\ugrid\1_00\wce400\wcex86rel6110 simple.dll = 1,c:\rptools\pspbm0c\1_00\wce400\wcex86rel psink.dll = 1,c:\rptools\psink\1_00\wce400\WCEX86RelMinDependency pslpwce.dll =1,c:\rptools\pslpm0c\1_00\wce400\WCEX86RelMinDependency npcpport.dll = 1,c:\rptools\cedk\212_03\installable drivers\printer\npcp ;dexcom.dll = 1,c:\rptools\psdxm0c\1_00\x86 ncsce.exe = 1,c:\rptools\ncsce\1_04 nrinet.dll = 1,c:\rptools\ncsce\1_04 [DestinationDirs] ; Required section ;Shortcuts.All = 0,%CE3% ; \Windows\Desktop Files.App = 0,%InstallDir% Files.DataBase = 0,%InstallDir%\DataBase Files.BitMaps = 0,%InstallDir%\Bitmaps Files.Fonts = 0,%InstallDir%\Fonts Files.Intl = 0,%InstallDir%\Intl Files.TelecomNcsCE = 0,%InstallDir%\Telecom\NcsCE Files.Windows = 0,%InstallDir%\Windows Files.Import = 0,%InstallDir%\Import Files.Export = 0,%InstallDir%\Export Files.Work = 0,%InstallDir%\Work Files.WinCE = 0,\storage_card\wince [CEStrings] ; Required section AppName = Rp32 InstallDir = \storage_card\%AppName% [Strings] ; Optional section ;[Shortcuts.All] ;Sample App,0,sample.exe ;Sample App,0,sample.exe,%InstallDir% ; Uses the path in DestinationDirs. ; The path is explicitly specified. [Files.App] rpm.exe,,,0 rpm.ini,rpmce212.ini,,0 mfcce212.dll,,,0 olece212.dll,,,0 olece211.dll,,,0 rdm45wce.dll,,,0 picfmt.dll,,,0 226 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming fmtctrl.dll,,,0 ugrid.dll,,,0 simple.dll,,,0 psink.dll,,,0 pslpwce.dll,,,0 npcpport.dll,,,0 ;dexcom.dll,,,0 [Files.DataBase] rpmdata.dbd,,,0 [Files.Fonts] tahoma.ttf,,,0 [Files.BitMaps] intermec.bmp,,,0 rpmlogo.bmp,,,0 rpmname.bmp,,,0 import.bmp,,,0 export.bmp,,,0 clock.bmp,,,0 printer.bmp,,,0 filecopy.bmp,,,0 [Files.Intl] lang_eng.bin,,,0 [Files.TelecomNcsCE] ncsce.exe,,,0 nrinet.dll,,,0 [Files.Windows] readme.txt,,,0 [Files.Import] readme.txt,,,0 [Files.Export] readme.txt,,,0 [Files.Work] readme.txt,,,0 [Files.WinCE] wcestart.ini,,,0 [RegSettings.All] HKLM,”SOFTWARE\Microsoft\Shell\AutoHide”,,0x00010001,1 ; Autohide the taskbar HKLM,”SOFTWARE\Microsoft\Shell\OnTop”,,0x00010001,0 ; Shell is not on top HKLM,”SOFTWARE\Microsoft\Clock”,SHOW_CLOCK,0x00010001,0 ; Clock is not on taskbar 700 Series Color Mobile Computer User’s Manual 227 Chapter 7 — Programming Using Installation Functions in SETUP.DLL SETUP.DLL is an optional file that enables you to perform custom operations during installation and removal of your application. The following list shows the functions that are exported by SETUP.DLL. Install_Init Called before installation begins. Use this function to check the application version when reinstalling an application and to determine if a dependent application is present. Install_Exit Called after installation is complete. Use this function to handle errors that occur during application installation. Uninstall_Init Called before the removal process begins. Use this function to close the application, if the application is running. Uninstall_Exit Called after the removal process is complete. Use this function to save database information to a file and delete the database and to tell the user where the user data files are stored and how to reinstall the application. Note; Use [DefaultInstall] > CESelfRegister (page 220) in the .INF file to point to SETUP.DLL. After the CAB File Extraction Cab files that need to cause a warm reset after cab extraction will need to create the __RESETMEPLEASE__.TXT file in the “\Windows” directory. The preferred method to create this file is within the DllMain portion of the SETUP.DLL file. It looks like this: #include #include #include #include // in the public SDK dir #define IOCTL_TERMINAL_RESET CTL_CODE (FILE_DEVICE_UNKNOWN,FILE_ANY_ACCESS, 2050, METHOD_NEITHER) BOOL APIENTRY DllMain( HANDLE h, DWORD reason, LPVOID lpReserved ) return TRUE; } // DllMain //************************************************************************ // $DOCBEGIN$ // BOOL IsProcessRunning( TCHAR * pname ); // // Description: Get process table snapshot, look for pname running. // // Arguments: pname - pointer to name of program to look for. // for example, app.exe. // // Returns: TRUE - process is running. // FALSE - process is not running. // $DOCEND$ //************************************************************************ BOOL IsProcessRunning( TCHAR * pname ) HANDLE hProcList; 228 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming PROCESSENTRY32 peProcess; DWORD thDeviceProcessID; TCHAR lpname[MAX_PATH]; if ( !pname || !*pname ) return FALSE; _tcscpy( lpname, pname ); _tcslwr( lpname ); hProcList = CreateToolhelp32Snapshot( TH32CS_SNAPPROCESS, 0 ); if ( hProcList == INVALID_HANDLE_VALUE ) { return FALSE; } // end if memset( &peProcess, 0, sizeof(peProcess) ); peProcess.dwSize = sizeof(peProcess); if ( !Process32First( hProcList, &peProcess ) ) { CloseToolhelp32Snapshot( hProcList ); return FALSE; } // end if thDeviceProcessID = 0; do { _tcslwr( peProcess.szExeFile ); if ( _tcsstr( peProcess.szExeFile, lpname ) ) { thDeviceProcessID = peProcess.th32ProcessID; break; } // end if } while ( Process32Next( hProcList, &peProcess ) ); if ( ( GetLastError() == ERROR_NO_MORE_FILES ) && ( thDeviceProcessID == 0 ) ) { CloseToolhelp32Snapshot( hProcList ); return FALSE; } // end if CloseToolhelp32Snapshot( hProcList ); return TRUE; } // IsProcessRunning codeINSTALL_INIT Install_Init( HWND hwndParent, BOOL fFirstCall, BOOL fPreviouslyInstalled, LPCTSTR pszInstallDir ) return codeINSTALL_INIT_CONTINUE; codeINSTALL_EXIT Install_Exit ( HWND hwndParent, LPCTSTR pszInstallDir, WORD cFailedDirs, WORD cFailedFiles, WORD cFailedRegKeys, 700 Series Color Mobile Computer User’s Manual 229 Chapter 7 — Programming WORD cFailedRegVals, WORD cFailedShortcuts ) HANDLE h; TCHAR srcfile[MAX_PATH]; TCHAR dstfile[MAX_PATH]; if (cFailedDirs || cFailedFiles || cFailedRegKeys || cFailedRegVals || cFailedShortcuts) return codeINSTALL_EXIT_UNINSTALL; if ( IsProcessRunning( L”autocab.exe” ) ) h = CreateFile( L”\\Windows\\__resetmeplease__.txt”, (GENERIC_READ | GENERIC_WRITE), 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_HIDDEN, NULL ); if ( h != INVALID_HANDLE_VALUE ) CloseHandle( h ); else // Couldn’t create the file. If it failed because the file already exists, it is not fatal. // Otherwise, notify user of the inability to reset the device and they will have to // perform it manually after all of the installations are complete. } // end if else DWORD dret; h = CreateFile( L”SYI1:”, (GENERIC_WRITE | GENERIC_READ), 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL ); // Force a warm start NOW. if ( h != INVALID_HANDLE_VALUE ) DeviceIoControl( h, IOCTL_TERMINAL_RESET, NULL, 0, NULL, 0, &dret, NULL); // Won’t return, but we’ll show clean up anyway CloseHandle( h ); else // Couldn’t access SYSIO. Notify user. } // end if } // end if return codeINSTALL_EXIT_DONE; codeUNINSTALL_INIT Uninstall_Init( HWND hwndParent, LPCTSTR pszInstallDir ) { 230 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming // TODO: Perform the reverse of INSTALL_INIT here return codeUNINSTALL_INIT_CONTINUE; codeUNINSTALL_EXIT Uninstall_Exit(HWND hwndParent) { // TODO: Perform the reverse of INSTALL_EXIT here return codeUNINSTALL_EXIT_DONE; The system software looks for the following directory structure and files on the installed media card whether it be an SD card or CF card or embedded flash file system. No other folders need exist. \2577\autorun.exe \2577\autorun.dat \2577\autocab.exe \2577\autocab.dat \cabfiles\*.cab Creating CAB Files with CAB Wizard After you create the .INF file and the optional SETUP.DLL file, use the CAB Wizard to create the .CAB file. The command-line syntax for the CAB Wizard is as follows: cabwiz.exe “inf_file” [/dest dest_directory] [/err error_file] [/cpu cpu_type [cpu_type]] A batch file, located in directory, with the following commands, works well: cabwiz.exe c:\appsoft\ \ cd \appsoft\ “inf_file” The SETUP.INF file path. dest_directory The destination directory for the .CAB files. If no directory is specified, the .CAB files are created in the “inf_file” directory. error_file The file name for a log file that contains all warnings and errors that are encountered when the .CAB files are compiled. If no file name is specified, errors are displayed in message boxes. If a file name is used, the CAB Wizard runs without the user interface (UI); this is useful for automated builds. cpu_type Creates a .CAB file for each specified microprocessor tag, which is a label used in the Win32 SETUP.INF file to differentiate between different microprocessor types. The /cpu parameter, followed by multiple cpu_type values, must be the last qualifier in the command line. Example This example creates .CAB files for the ARM and MIPS microprocessors, assuming the Win32 SETUP.INF file contains the ARM and MIPS tags: cabwiz.exe “c:\myfile.inf” /err myfile.err /cpu arm mips Note: CABWIZ.EXE, MAKECAB.EXE, and CABWIZ.DDF (Windows CE files available on the Windows CE Toolkit) must be installed in the same directory on the desktop computer. Call CABWIZ.EXE using its full path for the CAB Wizard application to run correctly. 700 Series Color Mobile Computer User’s Manual 231 Chapter 7 — Programming Troubleshooting the CAB Wizard To identify and avoid problems that might occur when using the CAB Wizard, follow these guidelines: S Use %% for a percent sign (%) character when using this character in an .INF file string, as specified in Win32 documentation. This will not work under the [Strings] section. S Do not use .INF or .CAB files created for Windows CE to install applications on Windows-based desktop platforms. S Ensure the MAKECAB.EXE and CABWIZ.DDF files, included with Windows CE, are in the same directory as CABWIZ.EXE. S Use the full path to call CABWIZ.EXE. S Do not create a .CAB file with the MAKECAB.EXE file included with Windows CE. You must use CABWIZ.EXE, which uses MAKECAB.EXE to generate the .CAB files for Windows CE. S Do not set the read-only attribute for .CAB files. 232 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Customization and Lockdown Pocket PC (Windows Mobile) is a hardware specification created by Microsoft Corporation. Devices that wish to carry the Pocket PC logo must meet the minimum hardware requirements set in the Pocket PC specification. Manufacturers are free to add extra hardware functionality. Pocket PC devices also use a specialized version of the CE operating system. This operating system is built from Windows CE 4.2 but contains customizations, most notably the lack of a desktop and the addition of the Today Screen. To carry the Pocket PC logo, all devices must be tested at an Independent Test Laboratory. The ITL testing is done based on Microsoft requirements. The test lab then reports the findings back to Microsoft Corporation and Intermec Technologies. If the 700 Color Computer passed all tests, Intermec is allowed to ship the device with the Pocket PC logo. Each time the operating system is modified, Intermec must resubmit to ITL testing. This means we cannot change the operating system much and still be a Pocket PC device. For example, if we remove Word from the Start menu, the device would fail ITL testing and we would not be able to ship devices with the Pocket PC logo. Although many customers want a Pocket PC device, some customers would prefer that their users not have access to all of the Pocket PC features. Intermec cannot customize the operating system in any way but a custom application can: Delete items from the Start menu, and Programs folder. These items are just shortcuts in the file system so the application is not really being deleted. Cold booting the device will bring these items back so the application will need to be run on every cold boot. Use the RegFlushKey() API to save a copy of the registry to a storage device. See the 700 Color Management Tools portion of the Intermec Developer’s Library CD for more information on how to do this. Saving a copy of the registry restores most system settings in a cold boot situation. Use the SHFullScreen() API in conjunction with other APIs to make the application take up the entire display and prevent the start menu from being available. Remap keys and disable keys on the keypad. Create a custom SIP. Make changes to the registry to configure the device. Should you want your 700 Color Computer to display a full screen, keep in mind that your computer is Pocket-PC certified by Microsoft Corporation. Check out resources on programming for the Pocket PC, using the following links. These give full instructions on how to display full screen. S Instructions on how to create a full screen application for eVC++ applications using an SHFullScreen() API: http://support.microsoft.com/support/kb/articles/Q266/2/44.ASP S Instructions on how to create a full screen application for eVB applications also using the SHFullScreen() API: http://support.microsoft.com/support/kb/articles/Q265/4/51.ASP 700 Series Color Mobile Computer User’s Manual 233 Chapter 7 — Programming FTP Server FTP support is provided through the FTP Server application FTPDCE.EXE (MS Windows CE Versions) which is provided as part the base system. FTPDCE is the Internet File Transfer Protocol (FTP) server process. The server can be invoked from an application or command line. Besides servicing FTP client requests the FTP Server also send a “network announcement” to notify prospective clients of server availability. Note: You should consult the RFC959 specification for proper use of some of these commands at the following URL: S http://www.ietf.org/rfc/rfc959.txt for the text version, or S http://www.w3.org/Protocols/rfc959/ for an html version Do the following to send commands: 1 Start an FTP client and connect to the device FTP server. 2 Log in with “intermec” as the user name and “cr52401” for the password. 3 From the FTP client, send the command. 4 Wait for a response. Synopsis ftpdce [ options ] Options –Aaddr (where addr is in the form of a.b.c.d) Sets the single target address to which to send the network announcement. Default is broadcast. –Bbyte Sets the FTP data block size. Smaller sizes may be useful over slower links. Default is 65536. –Cname Sets the device name. Used by Intermec management software. –Fvalue Disables the default Intermec account. A value of “0” disables the account. Default is “1”. Note that disabling the default account without providing a working access control list on the server will result in a device that will not accept any FTP connections. –Hsec Sets the interval between network announcements in seconds.A value of “0” turns the network announcement off. Default is 30 seconds. –Iaddr (where addr is in the form of a.b.c.d) Sets the preferred 6920 Communications Server (optional). –Llog (where log is either “0” or “1”) Sets the state of logging. Default is 0 (disabled). –Nsec Specifies the number of seconds to wait before initially starting FTP server services. –Pport Sets the UDP port on which the network announcement will be sent. Default port is 52401. –Qport Sets the port on which the FTP Server will listen for connections. Default port is 21. –Rdir Sets the FTP mount point to this directory. Default is the root folder of the object store. –Tscrip Sets the script name for the 6920 Communications Server to process. –Uurl Sets the default URL for this device. –Z“parms” Sets extended parameters to be included in the network announcement. 234 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Configurable Parameters Via the Registry Editor The following parameters receive default values during the installation of the Intermec FTP Server components. A few of the parameters are visible in the registry by default, but most must be created in order to modify the default behavior of the FTP server. BlockSize Setting this parameter configures the Intermec FTP Server to transmit and receive Ethernet packets using the specified data block size. By default, the FTP server transmits and receives data using a 64K data block size. Adjusting this value may be useful in certain wireless TCP/IP installations. Key HKLM\Software\Intermec\IFTP Value Type REG_DWORD - data block size, in bytes. Valid Range 0x100-0x10000 (256-65536 decimal). Default 65536 DeviceName This parameter configures the Intermec FTP Server to include the specified device name in the Intermec Device Network Announcement (IDNA). Adjusting this value may be useful in assigning a symbolic name to this device for asset tracking. Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default None. DeviceURL This parameter configures the Intermec FTP Server to transmit the specified URL in the IDNA. This can be used by Intermec management software for asset management. Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default None. 700 Series Color Mobile Computer User’s Manual 235 Chapter 7 — Programming IDNATarget This parameter configures the Intermec FTP Server to transmit the IDNA to a specific destination instead of a general UDP broadcast. This parameter is useful on networks that do not allow UDP broadcasts to be routed between subnets. The use of this parameter restricts the reception of the IDNA to the target destination only. Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default None. ManifestName This parameter configures the Intermec FTP Server to transmit the specified manifest name in the IDNA. This parameter is used by the Intermec 6920 Communications Server for communication transactions. See the 6920 Communications Server documentation for proper use of this parameter. Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default iftp.ini PauseAtStartup This parameter configures the Intermec FTP Server to sleep for the specified number of seconds before making the FTP service available on the device. Key HKLM\Software\Intermec\IFTP Value Type REG_DWORD - stored in seconds. Valid Range None. Default Root This parameter configures the Intermec FTP Server to set the root of the FTP mount point to the specified value. Note that this must map to an existing directory or you will not be able to log into the FTP Server. 236 Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Transferring Files Over TCP/IP Networks The File Transfer Protocol (FTP) server transfers files over TCP/IP networks. The FTPDCE.EXE program is a version that does not display a window, but can run in the background. FTPDCE is the Internet File Transfer Protocol (FTP) server process. The server can be invoked from an application or command line. Besides servicing FTP client requests, the FTP Server also sends a “network announcement” to notify prospective clients of server availability. Remarks The FTP Server currently supports the following FTP requests: CDUP Changes to the parent directory of the current working directory. CWD Changes working directory. DELE Deletes a file. HELP Gives help information. LIST (This FTP request is the same as the ls -lgA command). Gives list files in a directory. MKD Makes a directory. MODE (Always Uses Binary). Specifies data transfer mode. NLST (Not supported) Gives a name list of files in directory (this FTP request is the same as the ls command). NOOP Does nothing. PASS Specifies a password. PWD Prints the current working directory. QUIT Terminates session. RETR Retrieves a file. RMD Removes a directory. RNFR Specifies rename-from file name. RNTO Specifies rename-to file name. STOR Stores a file. SYST Shows the operating system type of server system. TYPE (Binary transfers only.) Specifies the data transfer type with the Type parameter. USER Specifies user name. XCUP (Not Normally Used) Changes the parent directory of the current working directory. XCWD (Not Normally Used) Changes the current directory. XMKD (Not Normally Used) Creates a directory. XPWD (Not Normally Used) Prints the current working directory. XRMD (Not Normally Used) Removes a directory. 700 Series Color Mobile Computer User’s Manual 237 Chapter 7 — Programming SITE The following extended OEM commands are supported by the SITE request. For Microsoft FTP clients, you can send site commands by preceding the command with “quote” such as “quote site status.” ATTRIB Gets or sets the attributes of a given file. (SITE ATTRIB) Usage QUOTE SITE ATTRIB [+R | -R] [+A | -A ] [+S | -S] [+H | -H] [[path] filename] + Sets an attribute. – Clears an attribute. R Read-only file attribute. A Archive file attribute. S System file attribute. H Hidden file attribute. To retrieve the attributes of a file, only specify the file. The server response will be: 200-AD SHRCEIX filename If the flag exists in its position shown above, it is set. Also, in addition to the values defined above, there is also defined: C Compressed file attribute. E Encrypted file attribute. I INROM file attribute. X XIP file attribute (execute in ROM, not shadowed in RAM). BOOT Reboots the server OS. This will cause the system on which the server is executing to reboot. The FTP Server will shut down cleanly before reboot. All client connections will be terminated. Cold boot is default except for the PocketPC build in which the default is warm boot. (SITE BOOT) Usage: COPY QUOTE SITE BOOT [WARM | COLD] Copies a file from one location to another. (SITE COPY) Usage: QUOTE SITE COPY [source] [destination] Example: QUOTE SITE COPY ‘\Storage Card\one.dat’ ‘\Storage Card\two.dat’ EXIT Exits the FTP Server. This command will shut down the FTP Server thus terminating all client connections. (SITE EXIT) Usage: HELP Gives site command help information. (SITE HELP) Usage: KILL QUOTE SITE LOG [open [filename]| close] Lists the running processes (SITE PLIST) Usage: RUN QUOTE SITE KILL [program | pid] Opens or closes the program log. (SITE LOG) Usage: PLIST QUOTE SITE HELP [command] Terminates a running program. (SITE KILL) Usage: LOG QUOTE SITE EXIT QUOTE SITE PLIST Starts a program running. If the program to run has spaces in path or filename, wrapping the name with single quotes is required. Usage: QUOTE SITE RUN [program] Example: QUOTE SITE RUN ‘\Storage Card\app.exe’ 238 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming STATUS Returns the current settings of the FTP Server. MAC, serial number, model, IP address, network announcement information as well as OS memory usage are returned. (SITE STATUS) Usage: TIMEOUT Toggles idle timeout between 120 to 1200 seconds (2 to 20 minutes). If this timer expires with no activity between the client and the server, the client connection will be disconnected. If the optional seconds argument is supplied, the server will set the connection timeout to the number of seconds specified. Default is 120 seconds or 2 minutes. (SITE TIMEOUT) Usage: EKEY QUOTE SITE EVAL [command] Gives site command general value information. (SITE HELP) Usage: PVAL QUOTE SITE EKEY [command] Gives site command electronic value information. (SITE HELP) Usage: GVAL QUOTE SITE TIMEOUT [seconds] Gives site command electronic key information. (SITE HELP) Usage: EVAL QUOTE SITE STATUS QUOTE SITE GVAL [command] Gives site command value information. (SITE HELP) Usage: QUOTE SITE PVAL [command] The remaining FTP requests specified in RFC 959 are recognized, but not implemented. The banner returned in the parenthetical portion of its greeting shows the version number of the FTP Server as well as the MAC address, serial number and operating system of the machine hosting the server. The FTP Server supports browsing from the latest Netscape and Microsoft web browsers. Drag-and-drop capability is available using this environment. The FTPDCMDS subdirectory contains commands to use from the web browser. S Click EXITME.BIN to execute a SITE EXIT command. S Click REBOOTME.BIN to execute SITE BOOT command. S Use the GET command on these files to have the FTP Server execute these commands. S Security: A customer configurable access control list may be installed on the 700 Color Computer. This list will allow customers to restrict access via the FTP Server to users they wish and is in addition to default Intermec accounts that are disabled using the -F0 option at runtime. The access control list is named FTPDCE.TXT and is placed in the same directory on the 700 Color Computer as the FTPDCE.EXE server. The FTP Server encrypts this file to keep the information safe from unauthorized users. This file is encrypted when the FTP Server is started so a file that is placed onto the 700 Color Computer after the FTP Server starts will require a restart of the FTP Server to take effect. 700 Series Color Mobile Computer User’s Manual 239 Chapter 7 — Programming The format of the FTPDCE.TXT is as follows: FTPDCE:user1!passwd1 user2!passwd2 user3 !passwd3 ... Note: The user accounts and passwords are case sensitive. Once the access control list is encrypted on the 700 Color Computer, the FTP Server hides this file from users. Once an access control list is installed on the 700 Color Computer, a new one is not accepted by the FTP Server until the previous one is removed. Encrypted access control lists are not portable between 700 Color Computers. Stopping the FTP Server from Your Application To allow application programmers the ability to programmatically shut down the FTP Server, the FTP Server periodically tests to see if a named event is signaled. The name for this event is “ITC_IFTP_STOP” (no quotes). For examples on how to use events, consult the Microsoft Developer Network Library at http://www.msdn.com. The MSDN Library is an essential resource for developers using Microsoft tools, products, and technologies. It contains a bounty of technical programming information, including sample code, documentation, technical articles, and reference guides. Autostart FTP This automatically starts the FTP Server (FTPDCE.EXE) when the 700 Color Computer is powered on. This is provided with the NDISTRAY program (the Network Driver Interface Specification tray application), which displays the popup menu that currently allows you to load and unload the network drivers. Tap the antenna icon in the System Tray of the Today screen (a sample antenna icon is circled below) for this pop-up menu. 240 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming The default is to start the FTP Server at boot time, unless the following registry entry is defined and set to “0” which disables AutoFTP. “1” enables the AutoFTP. The entry can be set from the NDISTRAY pop-up menu by selecting either AutoFTP On or AutoFTP Off. HKEY_LOCAL_MACHINE\Software\Intermec\Ndistray\StartupIFTP These new entries are located below the selections to load the network drivers. If the StartupIFTP registry key is not defined, the FTP Server is loaded by default, to provide “out-of-the-box” capability for customers who want to begin loading files to the 700 Color Computer without any prior configuration. Note: If a network driver is unloaded using the NDISTRAY popup menu, and the FTP Server is running, the FTP Server is stopped. On a resume, if AutoFTP is enabled and the FTP Server is running, it is stopped and restarted. NDISTRAY uses a helper application named RESETIFTP to implement the restart on resume feature. To do an AutoFTP Installation Check: 1 Ensure the FTP Server is running “out-of-the-box” the first time. 2 Tap Start > Today to access the Today screen, then tap the antenna icon in the System Tray to bring up the NDISTRAY pop-up menu. Select AutoFTP Off to disable AutoFTP. Do a warm boot and confirm the FTP Server is not running. 3 Tap Start > Today to access the Today screen, then tap the antenna icon in the System Tray to bring up the NDISTRAY pop-up menu. Select AutoFTP On to enable AutoFTP, reboot, confirm it is running. 4 Unload the network driver when the FTP Server is running and confirm that it is not running any more. 5 Load the FTP Server, establish a connection, then suspend and resume. The server should still run, but the FTP connection to the client should be dropped. 700 Series Color Mobile Computer User’s Manual 241 Chapter 7 — Programming Kernel I/O Controls This describes the KernelIoControl() functions available to application programmers. Most C++ applications will need to prototype the function as the following to avoid link and compile errors. extern “C” BOOL KernelIoControl(DWORD dwIoControlCode, LPVOID lpInBuf, DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned); IOCTL_HAL_GET_DEVICE_INFO This IOCTL returns either the platform type or the OEMPLATFORM name based on an input value. Syntax BOOL KernelIoControl( IOCTL_HAL_GET_DEVICE_INFO, LPVOID lpInBuf, DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned ); Parameters lpInBuf Points to a DWORD containing either the SPI_GETPLATFORMTYPE or SPI_GETOEMINFO value. lpInBufSize Must be set to sizeof(DWORD). lpOutBuf Must point to a buffer large enough to hold the return data of the function. If SPI_GETPLATFORMTYPE is specified in lpInBuf, then the “PocketPC\0” Unicode string is returned. If SPI_GETOEMINFO is specified in lpInBuf, then the “Intermec 700\0” Unicode string is returned. nOutBufSize The size of lpOutBuf in bytes. Must be large enough to hold the string returned. lpBytesReturned The actual number of bytes returned by the function for the data requested. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 242 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_ITC_READ_PARM Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_ITC_READ_PARM,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Points to this structure. See “ID Field Values” below. struct PARMS { BYTE id; BYTE ClassId; }; nInBufSize Must be set to the size of the PARMS structure. lpOutBuf Must point to a buffer large enough to hold the return data of the function. If this field is set to NULL and nOutBufSize is set to zero when the function is called the function will return the number bytes required by the buffer. nOutBufSize The size of lpOutBuf in bytes. lpBytesReturned Number of bytes returned by the function for the data requested. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the error value. Either ERROR_INVALID_PARAMETER or ERROR_INSUFFICIENT_BUFFER may be returned when this function is used to get the error. ID Field Values The id field of the PARMS structure may be one of the following values: ID Field Values ITC_NVPARM_ETHERNET_ID This IOCTL returns the Ethernet 802.11b or 802.11b/g MAC Address. Six bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_SERIAL_NUM This IOCTL returns the serial number of the device in BCD format. Six bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_MANF_DATE This IOCTL returns the device date of manufacture in the BCD YYYY/MM/DD format. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_SERVICE_DATE This IOCTL returns the device’s date of last service in BCD YYYY/MM/DD format. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. 700 Series Color Mobile Computer User’s Manual 243 Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_DISPLAY_TYPE This IOCTL returns the device’s display type. One byte is returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_EDG_IP This IOCTL returns the device Ethernet debug IP address. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_EDBG_SUBNET This IOCTL returns the device Ethernet debug subnet mask. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_ECN This IOCTL returns ECNs applied to the device in a bit array format. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_CONTRAST This IOCTL returns the device default contrast setting. Two bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_MCODE This IOCTL returns the manufacturing configuration code for the device. Sixteen bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_VERSION_NUMBER This IOCTL returns the firmware version for various system components. These values for the ClassId field of the PARMS structure are allowed when ITC_NVPARM_VERSION_NUMBER is used in the id field: S VN_CLASS_KBD Returns a five-byte string, including null terminator, that contains an ASCII value which represents the keypad microprocessor version in the system. The format of the string is x.xx with a terminating null character. S VN_CLASS_ASIC Returns a five-byte string, including null terminator, that contains an ASCII value which represents the version of the FPGA firmware in the system. The format of the string is x.xx with a terminating null character. S VN_CLASS_BOOTSTRAP Returns a five-byte string, including null terminator, that contains an ASCII value which represents the version of the Bootstrap Loader firmware in the system. The format of the string is x.xx with a terminating null character. ITC_NVPARM_INTERMEC_SOFTWARE_CONTENT This IOCTL reads the manufacturing flag bits from the non-volatile data store that dictates certain software parameters. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer that indicates if Intermec Content is enabled in the XIP regions. TRUE indicates that it is enabled. FALSE indicates that it is not enabled. ITC_NVPARM_ANTENNA_DIVERSITY This IOCTL reads the state of the antenna diversity flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer that indicates if there is a diversity antenna installed. TRUE indicates that it is installed. FALSE indicates that it is not installed. ITC_NVPARM_WAN_RI This IOCTL reads the state of the WAN ring indicator flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer that indicates the polarity of the WAN RI signal. TRUE indicates active high. FALSE indicates active low. 244 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_RTC_RESTORE This IOCTL reads the state of the real-time clock restore flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the RTC is restored upon a cold boot. FALSE indicates that the RTC is not restored. ITC_NVPARM_INTERMEC_DATACOLLECTION_SW This IOCTL reads the state of the data collection software enabled flag. A BOOLEAN DWORD is returned in the buffer pointer to by lpOutBuffer that indicates the data collection software is to install at boot time. FALSE indicates the data collection software should not install. ITC_NVPARM_INTERMEC_DATACOLLECTION_HW This IOCTL reads the data collection hardware flags. A BYTE is returned in the buffer pointer to by lpOutBuffer that indicates the type of data collection hardware installed. The maximum possible value returned is ITC_DEVID_SCANHW_MAX. S ITC_DEVID_SCANHW_NONE No scanner hardware is installed. S ITC_DEVID_OEM2D_IMAGER OEM 2D imager is installed. S ITC_DEVID_INTERMEC2D_IMAGER Intermec 2D imager is installed. S ITC_DEVID_SE900_LASER SE900 laser is installed. S ITC_DEVID_SE900HS_LASER SE900HS laser is installed. S ITC_DEVID_INTERMEC_EVIO EVIO linear imager is installed. The high bit indicates whether the S6 scanning engine is installed. The bit mask for this is ITC_DEVID_S6ENGINE_MASK. A non-zero value indicates that the S6 scanning engine is installed. ITC_NVPARM_WAN_INSTALLED This IOCTL reads the state of the WAN radio installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the WAN radio is installed. FALSE indicates that no WAN radio is installed. ITC_NVPARM_WAN_FREQUENCY This IOCTL reads the state of the WAN radio frequency flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the WAN radio frequency is United States. FALSE indicates that the WAN radio frequency is European. ITC_NVPARM_WAN_RADIOTYPE This IOCTL reads the WAN radio ID installed by manufacturing. A BYTE is returned in the buffer pointer to by lpOutBuffer which indicates the type of WAN radio hardware installed. The maximum possible value returned is ITC_DEVID_WANRADIO_MAX. The current definitions are: S ITC_DEVID_WANRADIO_NONE No WAN radio installed. S ITC_DEVID_WANRADIO_SIERRA_SB555 CDMA Sierra Wireless radio. S ITC_DEVID_WANRADIO_XIRCOM_GEM3503 GSM/GPRS Intel (Xircom) radio. S ITC_DEVID_WANRADIO_SIEMENS_MC45 GSM/GPRS Siemens radio. S ITC_DEVID_WANRADIO_SIEMENS_MC46 GSM/GPRS Siemens radio. ITC_NVPARM_80211_INSTALLED This IOCTL reads the state of the 802.11b or 802.11b/g radio installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the 802.11b or 802.11b/g radio is installed. FALSE indicates that no 802.11b or 802.11b/g radio is installed. ITC_NVPARM_80211_RADIOTYPE This IOCTL reads the 802.11b or 802.11b/g radio ID installed by manufacturing. A BYTE is returned in the buffer pointer to by lpOutBuffer that indicates the type of 802.11b or 802.11b/g radio hardware installed. The maximum possible value returned is ITC_DEVID_80211RADIO_MAX. The current definitions are: S ITC_DEVID_80211RADIO_NONE No 802.11b or 802.11b/g radio installed. S ITC_DEVID_80211RADIO_INTEL_2011B Intel 2011B radio installed. 700 Series Color Mobile Computer User’s Manual 245 Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_BLUETOOTH_INSTALLED This IOCTL reads the state of the Bluetooth radio installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the Bluetooth radio is installed. FALSE indicates that no Bluetooth radio is installed. ITC_NVPARM_SERIAL2_INSTALLED This IOCTL reads the state of the serial 2 (COM2) device installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the serial 2 device is installed. FALSE indicates that no serial 2 device is installed. ITC_NVPARM_VIBRATE_INSTALLED This IOCTL reads the state of the vibrate device installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the vibrate device is installed. FALSE indicates that no vibrate device is installed. ITC_NVPARM_LAN9000_INSTALLED This IOCTL reads the state of the Ethernet device installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the Ethernet device is installed. FALSE indicates that no Ethernet device is installed. ITC_NVPARM_SIM_PROTECT_HW_INSTALLED This IOCTL reads the state of the SIM card protection hardware installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the SIM card protection hardware is installed. FALSE indicates that no SIM card protection hardware is installed. ITC_NVPARM_SIM_PROTECT_SW_INSTALLED This IOCTL reads the state of the SIM card protection software installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the SIM card protection software is installed. FALSE indicates that no SIM card protection software is installed. ITC_NVPARM_SIM_PROTECT_SW_INSTALLED This IOCTL reads the state of the SIM card protection software installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the SIM card protection software is installed. FALSE indicates that no SIM card protection software is installed. 246 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_ITC_WRITE_SYSPARM Describes and enables the registry save location. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_ITC_WRITE_SYSPARM,LPVOID lpInBuf,DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned ); Parameters lpInBuf A single byte that may be one of the id values. See “ID Field Values” on the next page. nInBufSize Must be set to the size of the lpInBuf in bytes. lpOutBuf Must point to a buffer large enough to hold the data to be written to the non-volatile data store. nOutBufSize The size of lpOutBuf in bytes. lpBytesReturned The number of bytes returned by the function. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the error value. Either ERROR_INVALID_PARAMETER or ERROR_INSUFFICIENT_BUFFER may be returned when this function is used to get the error. 700 Series Color Mobile Computer User’s Manual 247 Chapter 7 — Programming ID Field Values The id field of lpInBuf may be one of the following values: ID Field Values ITC_REGISTRY_SAVE_ENABLE This function enables or disables the save registry to non-volatile media feature of the RegFlushKey() function. lpOutBuf must be set to zero (FALSE) if the feature is to be disabled or one (TRUE) if the feature is to be enabled. ITC_ DOCK_SWITCH This IOCTL sets a position of the dock switch. The dock switch may be set to either “modem” or “serial” positions. lpOutBuf must point to a buffer that contains a byte value of either DOCK_MODEM or DOCK_SERIAL as defined in OEMIOCTL.H; the value specifies the position the switch is to be set. The call appears as follows: // port = DOCK_MODEM or DOCK_SERIAL as defined in oemioctl.h BOOL SetDockSwitch( BYTE port) DWORD cmd = ITC_DOCK_SWITCH; DWORD cbRet; return KernelIoControl(IOCTL_HAL_ITC_WRITE_SYSPARM,&cmd, sizeof(cmd), &port,sizeof(port),&cbRet) ITC_ WAKEUP_MASK This IOCTL sets a bit mask that represents the mask for the five programmable wakeup keys. The I/O key is not a programmable wakeup key. By default it is always the system resume key and all other keys are set to disable key wakeup. A zero in a bit position masks the wakeup for that key. A one in a bit position enables wakeup for that key. lpOutBuf must point to a buffer that contains a byte value of a wakeup mask consisting of the OR’ed constants as defined in OEMIOCTL.H. Only the following keys are programmable as wakeup events. #define SCANNER_TRIGGER 1 #define SCANNER_LEFT #define SCANNER_RIGHT #define GOLD_A1 #define GOLD_A2 0x10 ITC_AMBIENT_KEYBOARD (does not apply to the 730 Computer) This IOCTL sets the threshold for the keypad ambient sensor. This can be a value from 0 (always off) to 255 (always on). lpOutBuf must point to a buffer that contains a byte value of the desired setting. ITC_AMBIENT_FRONTLIGHT (does not apply to the 730 Computer) This IOCTL sets the threshold for the frontlight ambient sensor. This can be a value from 0 (always off) to 255. lpOutBuf must point to a buffer that contains a byte value of the desired setting. 248 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_GET_DEVICEID This IOCTL returns the device ID. There are two types of device IDs supported, which are differentiated based on the size of the output buffer. The UUID is returned if the buffer size is set to sizeof(UNIQUE_DEVICEID), otherwise the oldstyle device ID is returned. Usage #include “pkfuncs.h” #include “deviceid.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_DEVICEID,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. STRICT_ID settings are not supported. lpInBufSize Should be set to zero. lpOutBuf Must point to a UNIQUE_DEVICEID structure as defined by DEVICEID.H if the UUID is to be returned nOutBufSize The size of the UNIQUE_DEVICEID in bytes if the UUID is to be returned. A DEVICE_ID as defined by PKFUNCS.H is returned if the size in bytes is greater than or equal to sizeof(DEVICE_ID). lpBytesReturned The number of bytes returned by the function. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 700 Series Color Mobile Computer User’s Manual 249 Chapter 7 — Programming IOCTL_HAL_GET_OAL_VERINFO Returns the HAL version information of the Pocket PC image. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_OAL_VERINFO,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a VERSIONINFO structure as defined by OEMIOCTL.H. The fields should have these values: S cboemverinfo sizeof (tagOemVerInfo); S verinfover S sig; “ITC\0” S id; ‘N’ S tgtcustomer “” S tgtplat SeaRay S tgtplatversion Current build version number S tgtcputype[8]; “Intel\0” S tgtcpu “PXA255\0”; S tgtcoreversion “” S date Build time S time Build date nOutBufSize The size of VERSIONINFO in bytes. lpBytesReturned Returns sizeof(PVERSIONINFO). Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 250 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_GET_BOOTLOADER_VERINFO Returns the HAL version information of the Pocket PC image. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_OAL_VERINFO,LPVOID lpInBuf, DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. nInBufSize Should be set to zero. lpOutBuf Must point to a VERSIONINFO structure as defined by OEMIOCTL.H. The fields should have these values: S cboemverinfo Sizeof (tagOemVerInfo); S verinfover S sig; “ITC\0” S id; ‘B’ S tgtcustomer “” S tgtplat SeaRay S tgtplatversion Current build version number of the bootstrap loader S tgtcputype[8]; “Intel\0”; S tgtcpu “PXA255\0” S tgtcoreversion “” S date Build time S time Build date nOutBufSize The size of VERSIONINFO in bytes. lpBytesReturned The number of bytes returned to lpOutBuf. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 700 Series Color Mobile Computer User’s Manual 251 Chapter 7 — Programming IOCTL_HAL_WARMBOOT Causes the system to perform a warm-boot. The object store is retained. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_WARMBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Should be NULL. nOutBufSize Should be zero. Return Values None. IOCTL_HAL_COLDBOOT Causes the system to perform a cold-boot. The object store is cleared. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_COLDBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Should be NULL. nOutBufSize Should be zero. Return Values None. 252 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_GET_RESET_INFO This IOCTL code allows software to check the type of the most recent reset. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_RESET_INFO,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a HAL_RESET_INFO structure. See sample below. nOutBufSize The size of HAL_RESET_INFO in bytes. lpBytesReturned The number of bytes returned by the function. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. Sample typedef struct { DWORD ResetReason; DWORD ObjectStoreState; } HAL_RESET_INFO, * PHAL_RESET_INFO; // most recent reset type // state of object store // Reset reason types #define HAL_RESET_TYPE_UNKNOWN #define HAL_RESET_REASON_HARDWARE #define HAL_RESET_REASON_SOFTWARE #define HAL_RESET_REASON_WATCHDOG #define HAL_RESET_BATT_FAULT #define HAL_RESET_VDD_FAULT 16 // Object store state flags #define HAL_OBJECT_STORE_STATE_UNKNOWN #define HAL_OBJECT_STORE_STATE_CLEAR 700 Series Color Mobile Computer User’s Manual // cold // suspend // power fail // warm boot 253 Chapter 7 — Programming IOCTL_HAL_GET_BOOT_DEVICE This IOCTL code allows software to check which device CE booted from. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_BOOT_DEVICE,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a buffer large enough to hold a DWORD (4 bytes) that contains the boot device. The following boot devices are supported: #define HAL_BOOT_DEVICE_UNKNOWN #define HAL_BOOT_DEVICE_ROM_XIP #define HAL_BOOT_DEVICE_ROM #define HAL_BOOT_DEVICE_PCMCIA_ATA #define HAL_BOOT_DEVICE_PCMCIA_LINEAR 4 #define HAL_BOOT_DEVICE_IDE_ATA #define HAL_BOOT_DEVICE_IDE_ATAPI nOutBufSize The size of lpOutBuf in bytes (4). lpBytesReturned The number of bytes returned by the function. Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 254 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_HAL_REBOOT Causes the system to perform a warm-boot. The object store is retained. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_REBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Should be NULL. nOutBufSize Should be zero. Return Values None. 700 Series Color Mobile Computer User’s Manual 255 Chapter 7 — Programming IOCTL_PROCESSOR_INFORMATION Returns processor information. Usage #include “pkfuncs.h” Syntax BOOL KernelIoControl( IOCTL_PROCESSOR_INFORMATION,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. nInBufSize Should be set to zero. lpOutBuf Should be a pointer to the PROCESSOR_INFO structure. The PROCESSOR_INFO structure stores information that describes the CPU more descriptively. typedef __PROCESSOR_INFO { WORD wVersion; WCHAR szProcessorCore[40]; WORD wCoreRevision; WCHAR szProcessorName[40]; WORD wProcessorRevision; WCAHR szCatalogNumber[100]; WCHAR szVendor[100]; DWORD dwInstructionSet; DWORD dwClockSpeed; // // // // // // // // // Set to value 1 “ARM\0” “PXA255\0” “Intel Corporation\0” 400 nOutBufSize Should be set to sizeof(PROCESSOR_INFO) in bytes. lpBytesReturned Returns sizeof(PROCESSOR_INFO); Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 256 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming IOCTL_GET_CPU_ID Returns Xscale processor ID. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_GET_CPU_ID,LPVOID lpInBuf, DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should point to a CPUIdInfo structure defined in OEMIOCTL.H. lpInBufSize Should be sizeof(CPUIdInfo). lpOutBuf Should be NULL. nOutBufSize Should be set to 0. lpBytesReturned Returns sizeof(PROCESSOR_INFO); Return Values Returns TRUE if function succeeds. Returns FALSE if the function fails. GetLastError() may be used to get the extended error value. 700 Series Color Mobile Computer User’s Manual 257 Chapter 7 — Programming Network Selection APIs The Network Selection APIs change the network adapter configuration programmatically. Both drivers support the same IOCTL function numbers for loading and unloading the drivers. Loading and unloading of the 802.11b or 802.11b/g driver is performed by the FWL1: device in the system by performing DeviceIOControl() calls to the driver. Loading and unloading of the driver for the built-in Ethernet adapter is performed by the SYI1: device in the system by performing DeviceIOControl() calls to the driver. S For loading an NDIS driver associated with an adapter, the IOCTL is IOCTL_LOAD_NDIS_MINIPORT. S For unloading NDIS drivers associated with an adapter the IOCTL is IOCTL_UNLOAD_NDIS_MINIPORT. Example #include #include “sysio.h” void DoLoad(int nDevice) { LPTSTR devs[] = { _T(“SYI1:”), _T(“FWL1:”) }; 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(“Network loader”),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(“FWL1:”) }; 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(“Network loader”),MB_ICONHAND); if (hLoaderDev!=INVALID_HANDLE_VALUE) CloseHandle(hLoaderDev); hLoaderDev = INVALID_HANDLE_VALUE; // bad handle }else { CloseHandle(hLoaderDev); 258 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming The API provided by Intermec Technologies exposes a limited set of routines that allows a programmer to access and affect the 802.11b or 802.11b/g network interface card from within their application. The routines provided also reads/writes values to the CE registry that pertain to the 802.11b or 802.11b/g radio driver. By using the provided functions, a programmer can alter the 802.11b or 802.11b/g parameters of Network Name (SSID), WEP keys, infrastructure modes, radio channel, and power management modes. A programmer can also retrieve network connect status and signal strength indication from the RF network card. The API is contained within the 80211API.DLL file that should be present in any load with the 802.11b or 802.11b/g networking installed. NETWLAN.DLL PRISMNDS.DLL This file is the 802.11b or 802.11b/g driver. It is present in all 700 CE loads that use the 802.11b or 802.11b/g network interface card. 80211API.DLL This file is an Intermec authored file that provides the programmer with a set of API calls to configure or monitor status of the 802.11b or 802.11b/g network. MOD80211.DLL The CORE module for the 802.11 NIC. It provides the 802.11b or 802.11b/g status information displayed when the CORE application is running. 80211CONF.EXE This is the “Control Panel” for configuring the 802.11b or 802.11b/g network parameters. Note that it is an EXE file and is actually called by CPL802.CPL (see below). It is also called by the CORE application when the “Configuration” button is pressed. CPL802.CPL A control panel application that does nothing but call 80211CONF.EXE. 80211SCAN.EXE Internally manages the Scan List activity. 802PM.DLL This handles profile management for radio configurable values. URODDSVC.EXE This handles radio configuration and security authentication based on a selected profile. The Profile Manager supports up to four radio configuration profiles. These profiles are the same as those set by the Wireless Network control panel applet that runs on the Windows CE unit. You can configure different 802.11b or 802.11b/g profiles and switch between them using the 802.11 API. See the ConfigureProfile() function on page 275 for more information. 700 Series Color Mobile Computer User’s Manual 259 Chapter 7 — Programming Basic Connect/Disconnect Functions Below are functions available for the 700 Color Computer when enabled with the 802.11b or 802.11b/g radio module. RadioConnect() Connects to the available radio. Use this function if you plan on using a lot of API calls that talk directly to the radio. Note that the 802.11b or 802.11b/g radio must be enabled via NDISTRAY before you can connect to it. Syntax UINT RadioConnect( ); Parameters None. Return Values ERROR_SUCCESS when successful, otherwise ERR_CONNECT_FAILED Remarks Call this function before you call any other function found within this API. It hunts out and connects to the 802.11b or 802.11b/g radio available on the system. Check extended error codes if it returns anything else for information. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_RadioConnect)(); #else UINT RadioConnect(); #endif RadioDisconnect() Call this function when done using the 802.11 API to clean up a connection from a previous RadioConnect() call. If you do not call this function, you may leave memory allocated. 260 Syntax UINT RadioDisconnect( ); Parameters None. Return Values ERROR_SUCCESS when successful, otherwise ERR_CONNECT_FAILED. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_RadioDisconnect)(); #else UINT RadioDisconnect(); #endif 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming RadioDisassociate() Call this function to have the 802.11b or 802.11b/g radio disassociate from the current service set. The radio then enters an “off” mode until it is woken again by setting the Service Set Identifier (SSID). Also, the NDIS driver generates an NDIS media disconnect event. Syntax UINT RadioDisassociate( ); Parameters None. Return Values ERROR_SUCCESS when successful, otherwise ERR_CONNECT_FAILED. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_RadioDisassociate)(); #else UINT RadioDisassociate(); #endif Query Information Functions GetAssociationStatus() Call this function to obtain the radio’s current association status with a service set. Syntax UINT GetAssociationStatus( ULONG & ); Parameters NDIS_RADIO_ASSOCIATED Indicates the radio is associated with an access point NDIS_RADIO_SCANNING Indicates the radio is looking for an access point with which to associate Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Data is only valid if the function returns ERROR_SUCCESS. Also, if ERROR_SUCCESS is returned, your ULONG reference is populated by one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetAssociationStatus)(ULONG &); #else UINT GetAssociationStatus(ULONG &); #endif 700 Series Color Mobile Computer User’s Manual 261 Chapter 7 — Programming GetAuthenticationMode() Call this function to obtain the radio’s current authentication mode. Syntax UINT GetAuthenticationMode( ULONG & ); Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11 Open Authentication. Indicates that the radio is using an open system. NDIS_RADIO_AUTH_MODE_SHARED 802.11 Shared Authentication. Indicates that the radio is using a shared key. NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates automatic detection is used when available. NDIS_RADIO_AUTH_MODE_ERROR Defined as error value. Indicates the authentication mode was not determined at this time or is unknown. NDIS_RADIO_AUTH_MODE_WPA WPA Authentication NDIS_RADIO_AUTH_MODE_WPA_PSK WPA Preshared Key Authentication NDIS_RADIO_AUTH_MODE_WPA_NONE WPA None Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Data is only valid if ERROR_SUCCESS is returned. Also, if ERROR_SUCCESS is returned, your USHORT reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetAuthenticationMode)(ULONG &); #else UINT GetAuthenticationMode(ULONG &); #endif GetBSSID() Call this function to get the current MAC address (BSSID) of the service set. In ESS mode, this is the MAC address of the access point the radio is associated with. In IBSS mode, this is a randomly generated MAC address, and serves as the ID for the IBSS. Syntax UINT GetBSSID( TCHAR * ); Parameters Pointer to a character array, which is populated with the current BSSID after a successful call. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with the BSSID of the current service set: xx-xx-xx-xx-xx-xx Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetBSSID)(TCHAR *); #else UINT GetBSSID(TCHAR *); #endif 262 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming GetDiversity() Call this function to get the current diversity setting of your 802.11b or 802.11b/g radio. This uses an optional NDIS5.1 OID to query the radio, of which a large number of 802.11b or 802.11b/g devices do not support. This may be inaccurate. Syntax UINT GetDiversity(USHORT *); Parameters ANT_PRIMARY The primary antenna is selected. ANT_SECONDARY The secondary antenna is selected. ANT_DIVERSITY The radio is in diversity mode, and uses both antennas Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your USHORT reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetDiversity)(USHORT *); #else UINT GetDiversity(USHORT *); #endif GetLinkSpeed() Call this function to get the current link speed of the 802.11b or 802.11b/g radio. Syntax UINT GetLinkSpeed( int & ); Parameters This function accepts an int reference, and your int is populated with the current link speed, in Mbps, rounded to the nearest whole integer, for example: 1, 2, 5, 11, etc. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Data returned is valid if ERROR_SUCCESS is returned. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetLinkSpeed)(int &); #else UINT GetLinkSpeed(int &); #endif 700 Series Color Mobile Computer User’s Manual 263 Chapter 7 — Programming GetMac() Call this function to get the MAC address of the 802.11b or 802.11b/g radio. Syntax UINT GetMac( TCHAR * ); Parameters Pointer to a character array, which is populated with the MAC address after a successful call. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with the formatted MAC address of the adapter, as follows: xx-xx-xx-xx-xx-xx Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetMac)(TCHAR *); #else UINT GetMac(TCHAR *); #endif Note: Be sure to call RadioConnect() before calling this function for this function to work properly. GetNetworkMode() Call this function to get the current Network Mode (SSID) for the 802.11b or 802.11b/g radio. Syntax UINT GetNetworkMode( ULONG & ); Parameters NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode. NDIS_NET_MODE_ESS 802.11 Infrastructure Mode. NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supported or recommended. NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps NDIS_NET_TYPE_OFDM_2_4G 802.11 2.4 Gigahertz Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetNetworkMode)(ULONG &); #else UINT GetNetworkMode(ULONG &); #endif 264 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming GetNetworkType() Call this function to get the current network type of the radio. Do not confuse this with GetNetworkMode(). Syntax UINT GetNetworkType( ULONG & ); Parameters NDIS_NET_TYPE_FH Indicates this is a frequency hopping radio. NDIS_NET_TYPE_DS Indicates that this is a direct sequence radio. NDIS_NET_TYPE_UNDEFINED Indicates this radio type is unknown or undefined. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetNetworkType)(ULONG &); #else UINT GetNetworkType(ULONG &); #endif GetSSID() Call this function to get the desired SSID of the 802.11b or 802.11b/g radio. Syntax UINT GetSSID( TCHAR * ); Parameters Pointer to a character array, which is populated with the current SSID when successful. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with the desired SSID. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetSSID)(TCHAR *); #else UINT GetSSID(TCHAR *); #endif Note: Call RadioConnect() before this function for this function to work properly. 700 Series Color Mobile Computer User’s Manual 265 Chapter 7 — Programming GetPowerMode() Call this function to get the current power savings mode of the radio. Syntax UINT GetPowerMode( ULONG & ); Parameters NDIS_RADIO_POWER_MODE_CAM Continuous Access Mode (ie: always on). NDIS_RADIO_POWER_MODE_PSP Power Saving Mode. NDIS_RADIO_POWER_UNKNOWN Unknown power mode. NDIS_RADIO_POWER_AUTO Auto. (Available for 730 Mobile Computers) NDIS_RADIO_POWER_MODE_FAST_PSP Fast PSP, good savings, fast Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetPowerMode)(ULONG &); #else UINT GetPowerMode(ULONG &); #endif Note: Do not use Automatic Switching mode at this time. GetRSSI() Call this function to get the current RSSI (Radio Signal Strength Indicator), in Dbm. Syntax UINT GetRSSI( ULONG & ); Parameters References a ULONG that is populated with the current RSSI after a successful call. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference contains the RSSI. Valid RSSI range is from –100 Dbm to –30 Dbm. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetRSSI)(ULONG &); #else UINT GetRSSI(ULONG &); #endif 266 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming GetTXPower() Call this function to get the current transmit power of the radio. Syntax UINT GetTXPower( ULONG & ); Parameters NDIS_POWER_LEVEL_63 63 mW NDIS_POWER_LEVEL_30 30 mW NDIS_POWER_LEVEL_15 15 mW NDIS_POWER_LEVEL_5 5 mW NDIS_POWER_LEVEL_1 1 mW NDIS_POWER_LEVEL_UNKNOWN Unknown Value or Error. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with the TX power in milliwatts (mW). Valid ranges are from 5 mW to 100 mW. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetTXPower)(ULONG &); #else UINT GetTXPower(ULONG &); #endif 700 Series Color Mobile Computer User’s Manual 267 Chapter 7 — Programming GetWepStatus() Call this function to get the current state of the radio’s WEP and encryption levels. Syntax UINT GetWepStatus( ULONG & ); Parameters NDIS_ENCRYPTION_1_ENABLED WEP is enabled; TKIP and AES are not enabled, and a transmit key may or may not be available. (same as NDIS_RADIO_WEP_ENABLED) NDIS_ENCRYPTION_DISABLED Indicates that AES, TKIP, and WEP are disabled, and a transmit key is available. (Same as NDIS_RADIO_WEP_DISABLED) NDIS_ENCRYPTION_NOT_SUPPORTED Indicates encryption (WEP, TKIP, AES) is not supported. (Same as NDIS_RADIO_WEP_NOT_SUPPORTED) NDIS_ENCRYPTION_1_KEY_ABSENT Indicates that AES, TKIP, and WEP are disabled, and a transmit key is not available. (Same as NDIS_RADIO_WEP_ABSENT) NDIS_ENCRYPTION_2_ENABLED Indicates that TKIP and WEP are enabled; AES is not enabled, and a transmit key is available. NDIS_ENCRYPTION_2_KEY_ABSENT Indicates that there are no transmit keys available for use by TKIP or WEP, TKIP and WEP are enabled; and AES is not enabled. NDIS_ENCRYPTION_3_ENABLED Indicates that AES, TKIP, and WEP are enabled, and a transmit key is available. NDIS_ENCRYPTION_3_KEY_ABSENT Indicates that there are no transmit keys available for use by AES, TKIP, or WEP, and AES, TKIP, and WEP are enabled. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of the parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetWepStatus)(ULONG &); #else UINT GetWepStatus(ULONG &); #endif 268 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming GetRadioIpAddress() Call this function to obtain a formatted string indicating whether DHCP is enabled, and what is the current adapters IP address. Syntax UINT GetRadioIpAddress( TCHAR * ); Parameters Pointer to a character array that contains the formatted string of the IP address and static/DHCP information. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your TCHAR array contains a string formatted as follows: IP: DHCP Enabled\nxxx.xxx.xxx.xxx\n or IP: DHCP Disabled\nxxx.xxx.xxx.xxx\n Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetRadioIpAddress)(TCHAR *); #else UINT GetRadioIpAddress(TCHAR *); #endif GetCCXStatus() Call this function to get information about the current CCX status of the adapter. Syntax UINT GetCCXStatus( ULONG & ); Parameters NDIS_NETWORK_EAP_MODE_OFF Disable EAP mode. NDIS_NETWORK_EAP_MODE_ON Enable EAP mode. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference is populated with one of parameters listed above. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetCCXStatus)(ULONG &); #else UINT GetCCXStatus(ULONG &); #endif 700 Series Color Mobile Computer User’s Manual 269 Chapter 7 — Programming Set Information Functions AddWep() Call this function to add a WEP key to the radio. Call this function multiple times when adding more than one WEP key. Save the “default” key for last. For example, when adding four keys, and the second key is the default transmit key, add keys 1, 3 and 4 before you add key 2. Note: Add the default transmit key last. Syntax UINT AddWep( ULONG, BOOL, TCHAR * ); Parameters ULONG Specifies the key index to be set. Valid values are 0–3. BOOL When set to TRUE, specifies that this key is the default transmit key. TCHAR Pointer to a character array that specifies the key data in either HEX (length of 10 or 26) or ASCII (length of 5 or 13). This string must be null-terminated. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks When adding WEP keys to the radio, turn off encryption before you add the keys, then turn encryption back on afterwards. Also, be sure to add the TRANSMIT KEY last. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_AddWep)(ULONG, BOOL, TCHAR *); #else UINT AddWep(ULONG, BOOL, TCHAR *); #endif EnableWep() Enables or disables WEP encryption on the radio (TRUE/FALSE). Syntax UINT EnableWep( BOOL ); Parameters Set BOOL to TRUE to enable WEP encryption, or FALSE to disable WEP encryption. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Call this function with TRUE as the parameter to enable WEP encryption. Call this function with the FALSE parameter to disable WEP encryption. This call is an alias for EncryptionStatus(). See the following: EnableWEP(TRUE) = EncryptionStatus(NDIS_ENCRYPTION_1_ENABLED) EnableWEP(FALSE) = EncryptionStatus(NDIS_ENCRYPTION_DISABLED) Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_EnableWep)(BOOL); #else UINT EnableWep(BOOL); #endif 270 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming EncryptionStatus() Call this function to set the desired encryption status. Syntax UINT EncryptionStatus( UINT mode ); Parameters NDIS_ENCRYPTION_1_ENABLED WEP is enabled; TKIP and AES are not enabled, and a transmit key may or may not be available. (same as NDIS_RADIO_WEP_ENABLED) NDIS_ENCRYPTION_DISABLED Indicates that AES, TKIP, and WEP are disabled, and a transmit key is available. (Same as NDIS_RADIO_WEP_DISABLED) NDIS_ENCRYPTION_NOT_SUPPORTED Indicates that encryption (WEP, TKIP, and AES) is not supported. (Same as NDIS_RADIO_WEP_NOT_SUPPORTED) NDIS_ENCRYPTION_1_KEY_ABSENT Indicates that AES, TKIP, and WEP are disabled, and a transmit key is not available. (Same as NDIS_RADIO_WEP_ABSENT) NDIS_ENCRYPTION_2_ENABLED Indicates that TKIP and WEP are enabled; AES is not enabled, and a transmit key is available. NDIS_ENCRYPTION_2_KEY_ABSENT Indicates that there are no transmit keys available for use by TKIP or WEP, TKIP and WEP are enabled; and AES is not enabled. NDIS_ENCRYPTION_3_ENABLED Indicates that AES, TKIP, and WEP are enabled, and a transmit key is available. NDIS_ENCRYPTION_3_KEY_ABSENT Indicates that there are no transmit keys available for use by AES, TKIP, or WEP, and AES, TKIP, and WEP are enabled. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_EncryptionStatus)(UINT mode); #else UINT EncryptionStatus(UINT mode); #endif 700 Series Color Mobile Computer User’s Manual 271 Chapter 7 — Programming SetAuthenticationMode() Call this function to set the desired authentication mode. Syntax UINT SetAuthenticationMode( ULONG ); Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11 Open Authentication. Indicates that the radio is using an open system. NDIS_RADIO_AUTH_MODE_SHARED 802.11 Shared Authentication. Indicates that the radio is using a shared key. NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates automatic detection is used when available. NDIS_RADIO_AUTH_MODE_ERROR Defined as error value. Indicates the authentication mode was not determined at this time or is unknown. NDIS_RADIO_AUTH_MODE_WPA WPA Authentication NDIS_RADIO_AUTH_MODE_WPA_PSK WPA Preshared Key Authentication NDIS_RADIO_AUTH_MODE_WPA_NONE WPA None Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetAuthenticationMode)(ULONG); #else UINT SetAuthenticationMode(ULONG); #endif SetChannel() This function is currently not implemented. Ad-hoc networks automatically select a channel or use the already existing channel. Syntax UINT SetChannel( USHORT ); Parameters USHORT value that should populate with the desired channel (1–14). Return Values None. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetChannel)(USHORT); #else UINT SetChannel(USHORT); #endif 272 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming SetNetworkMode() Call this function to set the desired Network Mode. Syntax UINT SetNetworkMode( ULONG ); Parameters NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode. NDIS_NET_MODE_ESS 802.11 Infrastructure Mode. NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supported or recommended. NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps NDIS_NET_TYPE_OFDM_2_4G 802.11 2.4 Gigahertz Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetNetworkMode)(ULONG); #else UINT SetNetworkMode(ULONG); #endif SetPowerMode() Call this function to set the desired power mode. Syntax UINT SetPowerMode( ULONG mode ); Parameters NDIS_RADIO_POWER_MODE_CAM Continuous Access Mode (ie: always on). NDIS_RADIO_POWER_MODE_PSP Power Saving Mode. NDIS_RADIO_POWER_UNKNOWN Unknown power mode. NDIS_RADIO_POWER_AUTO Auto. (Available for 730 Computers) NDIS_RADIO_POWER_MODE_FAST_PSP Fast PSP, good savings, fast Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetPowerMode)(ULONG mode); #else UINT SetPowerMode(ULONG mode); #endif 700 Series Color Mobile Computer User’s Manual 273 Chapter 7 — Programming SetSSID() Call this function with a pointer to a null-terminated TCHAR array containing the desired SSID to set the desired SSID of the adapter. Syntax UINT SetSSID( TCHAR * ); Parameters Pointer to a character array that contains the desired SSID. This should be null-terminated. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If an “ANY” network is desired, pass in _T(“ANY”). Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetSSID)(TCHAR *); #else UINT SetSSID(TCHAR *); #endif SetCCXStatus() Call this function to set the desired CCX / Network EAP status. Syntax UINT SetCCXStatus( ULONG ); Parameters NDIS_NETWORK_EAP_MODE_OFF Disable Network EAP / CCX NDIS_NETWORK_EAP_MODE_ON Enable Network EAP / CCX Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetCCXStatus)(ULONG); #else UINT SetCCXStatus(ULONG); #endif SetMixedCellMode() Call this function to set the desired mixed cell mode. Syntax UINT SetMixedCellMode( ULONG ); Parameters NDIS_MIXED_CELL_OFF Disable Mixed Cell NDIS_MIXED_CELL_ON Enable Mixed Cell Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SetMixedCellMode)(ULONG); #else UINT SetMixedCellMode(ULONG); #endif 274 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming RemoveWep() Call this function with a key index of 0–3 to remove the WEP key at that index. Syntax UINT RemoveWep( ULONG ); Parameters ULONG value that specifies the key index to set. Valid values are 0–3. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks On disassociation with all BSSIDs of the current service set, WEP key is removed by the adapter. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_RemoveWEP)(ULONG); #else UINT RemoveWEP(ULONG); #endif Helper Functions ConfigureProfile() If using the Intermec 802.11 Profile Management system, you can program the API to configure the radio to a specific profile by passing the profile name. Syntax UINT ConfigureProfile( TCHAR * ); Parameters Pointer to a character array that contains the profile name. This should be null-terminated. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Call this function with a pointer to a null-terminated TCHAR array that contains the name of the profile you wish to configure. This function reads profile data from the profile manager, sets that profile as the default active profile, and configures the radio appropriately. If needed, the supplicant and any other related services are automatically started and stopped. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_ConfigureProfile)(TCHAR *); #else UINT ConfigureProfile(TCHAR *); #endif 700 Series Color Mobile Computer User’s Manual 275 Chapter 7 — Programming EnableZeroConfig() This enables or disables the Wireless Zero Configuration Wizard from Microsoft. After calling this function, a warm-boot is required for the change to take effect. Note: Enabling this function effectively disables all the SET commands in this API. Syntax UINT EnableZeroConfig( USHORT ); Parameters TRUE Enable Wireless Zero Config FALSE Disable Wireless Zero Config Return Values ERROR_SUCCESS when successful, ERR_ZERO_CONFIG_CHANGE_FAILED when the query failed. Remarks Call this function to set the desired Zero Config status. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_EnableZeroConfig)(USHORT); #else UINT EnableZeroConfig(USHORT); #endif isZeroConfigEnabled() Call this function to determine whether Zero Config is currently enabled. Syntax UINT isZeroConfigEnabled( ); Parameters None. Return Values TRUE if ZeroConfig is enabled, and FALSE if it is disabled. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_isZeroConfigEnabled)(); #else UINT isZeroConfigEnabled(); #endif isOrinoco() Call this function to determine whether the current radio is an ORiNOCO, Lucent, or WaveLAN radio. Syntax UINT isOrinoco( ); Parameters None. Return Values TRUE if this is an ORiNOCO radio, and FALSE if it is not. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_isOrinoco)(); #else UINT isOrinoco(); #endif 276 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming isSupplicantRunning() Call this function to determine whether the security supplicant is running. Syntax UINT isSupplicantRunning( ); Parameters None. Return Values TRUE if the security supplicant is running, FALSE if it is not running. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_isSupplicantRunning)(); #else UINT isSupplicantRunning(); #endif StartScanList() If a scan list is configured on the system, this causes the API to begin the process of scanning for an available network. This call can take quite a while to process (depending upon the length of the scan list and how long it takes to find a valid network), you may wish to call it from a separate thread. Syntax UINT StartScanList( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks Call this function to start the scan list functionality of the system. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_StartScanList)(); #else UINT StartScanList(); #endif StartSupplicant() Call this function to start the supplicant service if it is installed on the system. Syntax UINT StartSupplicant( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_StartSupplicant)(); #else UINT StartSupplicant(); #endif 700 Series Color Mobile Computer User’s Manual 277 Chapter 7 — Programming StopSupplicant() Call this function to stop the supplicant service. Syntax UINT StopSupplicant( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_StopSupplicant)(); #else UINT StopSupplicant(); #endif isDHCPEnabled() Call this function to determine whether DHCP is enabled on the current adapter. Syntax UINT isDHCPEnabled( ); Parameters None. Return Values TRUE if DHCP is enabled, FALSE if it is not. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_isDHCPEnabled)(); #else UINT isDHCPEnabled(); #endif RenewDHCP() Call this function to force a DHCP renewal on the current network adapter. Syntax UINT RenewDHCP( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks You should not have to call this function on Microsoft PocketPC 2003 or Microsoft Windows CE 4.2 .NET and later devices. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_RenewDHCP)(); #else UINT RenewDHCP(); #endif 278 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming GetCurrentDriverName() Call this function to populate the TCHAR array with the driver name. Syntax UINT GetCurrentDriverName( TCHAR * ); Parameters Pointer to a TCHAR array which contains the name of the driver when successful. Return Values ERROR_SUCCESS when successful. Remarks This function is called with a pointer to a TCHAR array that is large enough to hold the name of the driver PLUS the null terminator. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_GetCurrentDriverName)(TCHAR *); #else UINT GetCurrentDriverName(TCHAR *); #endif ResetRadioToSystemSave() Call this function to force the radio to reset to the last desired active profile. Syntax UINT ResetRadioToSystemSave( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_ResetRadioToSystemSave)(); #else UINT ResetRadioToSystemSave(); #endif EnableSuppLogging() Call this function to set the desired supplicant logging mode. Syntax UINT EnableSuppLogging( ULONG ); Parameters NDIS_SUPP_LOGGING_ON Supplicant Logging Enabled NDIS_SUPP_LOGGING_OFF Supplicant Logging Disabled Return Values ERROR_SUCCESS when successful. Remarks None. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_EnableSuppLogging)(ULONG); #else UINT EnableSuppLogging(ULONG); #endif 700 Series Color Mobile Computer User’s Manual 279 Chapter 7 — Programming SwitchPacketDriver() Call this function to switch between available packet drivers on the system. Syntax UINT SwitchPacketDriver( USHORT ); Parameters INTERMEC_PACKET_DRIVER Intermec Packet Driver (ZNICZIO) NDISUIO_PACKET_DRIVER Microsoft Packet Driver (NDISUIO) Return Values ERROR_SUCCESS when successful. Remarks After switching to a new packet driver, perform a warm boot for changes to take effect. Definitions #ifdef DYNAMIC_LOADING typedef UINT (*PFN_SwitchPacketDriver)(USHORT); #else UINT SwitchPacketDriver(USHORT); #endif Deprecated Functions The following functions are deprecated. While these are not removed from the API, these are no longer supported. Their parameters are no longer applicable and the return value for all of these functions is: ERR_FUNCTION_DEPRECATED Function Syntax GetRTSThreshold(Deprecated) UINT GetRTSThreshold( USHORT & ); GetMedia(Deprecated) UINT GetMedia( ULONG & ); GetMedium(Deprecated) UINT GetMedium( ULONG & ); GetNicStats(Deprecated) UINT GetNicStats( NDIS_802_11_STATISTICS & ); SetRTSThreshold(Deprecated) UINT SetRTSThreshold( USHORT & ); SetTXRate(Deprecated) UINT SetTXRate( UCHAR ); EncryptWepKeyForRegistry(Deprecated) UINT EncryptWepKeyForRegistry( TCHAR * szDest, TCHAR * szSource ); SetDiversity(Deprecicated) 280 UINT SetDiversity( USHORT ); 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Notifications Use the following information to programmatically control the vibrator, to write an application to turn on the vibrator when a message is received via the WLAN radio link, and turn it off when the user hits a key. Vibrator support is implemented in the NLED driver as a false LED. The vibrator is LED 5 and is identified with an CycleAdjust of –1. The vibrate option is only available in the notifications panel when the vibrator is present in the system. Regarding an applications interface to NLED.DLL, LEDs must be available for use by applications. This is possible via two functions exported by the COREDLL.DLL file. To use the LED functions, declare these as extern ”C” as follows: extern ”C” BOOL WINAPI NLEDGetDeviceInfo(UINT nInfoId, void *pOutput); extern ”C” BOOL WINAPI NLEDSetDevice( UINT nDeviceId, void *pInput); The LEDs are enumerated for access through the data structures associated with these APIs: S Notification LED S Radio On LED 1 (does not apply to the 730 Computer) S Alpha Lock LED S Scanner LED S Low Battery S Vibrator 5 (does not apply to the 730 Computer) 700 Series Color Mobile Computer User’s Manual 281 Chapter 7 — Programming NLEDGetDeviceInfo Usage #include “nled.h” Syntax BOOL NLEDGetDeviceInfo ( UINT nInfoId, void *pOutput ); Parameters nInfoId pOutput Integer specifying the information to return. These values are defined: NLED_COUNT_INFO Indicates the pOutput buffer specifies the number of LEDs on the device. NLED_SUPPORTS_INFO_ID Indicates the pOutput buffer specifies information about the capabilities supported by the LED. NLED_SETTINGS_INFO_ID Indicates the pOutput buffer contains information about the LED current settings. Pointer to the buffer to which the information is returned. The buffer points to various structure types defined in “nled.h”, depending on the value of nId, as detailed in the following table: Value of nID Structure in pOutput LED_COUNT_INFO NLED_COUNT_INFO NLED_SUPPORTS_INFO NLED_SUPPORTS_INFO NLED_SETTINGS_INFO NLED_SETTINGS_INFO NLEDSetDevice Usage #include “nled.h” Syntax BOOL NLEDSetDevice ( UINT nDeviceId, void *pInput ); Parameters nDeviceId Integer specifying the device identification. The following is defined: NLED_SETTINGS_INFO_ID pInput 282 Contains information about the desired LED settings. Pointer to the buffer that contains the NLED_SETTINGS_INFO structure. 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Reboot Functions There are several methods, via Kernel I/O Control functions, that an application program can use to force the 700 Color Computer to reboot. IOCTL_HAL_REBOOT IOCTL_HAL_REBOOT performs a warm-boot. See page 255. IOCTL_HAL_COLDBOOT Invoking the KernelIOControl function with IOCTL_HAL_COLDBOOT forces a cold reboot. This resets the 700 Color Computer and reloads Windows CE as if a power-up was performed. The contents of the Windows CE RAM-based object store are discarded. See page 252. IOCTL_HAL_WARMBOOT This function is supported on 700 Color Computers. It performs a warm boot of the system, preserving the object store. See page 252. 700 Series Color Mobile Computer User’s Manual 283 Chapter 7 — Programming Remapping the Keypad Note: Use caution when remapping the keypad. Improper remapping may render the keypad unusable. Data within the 700 Color Computer could also be lost, should any problems occur. Applications have the ability to remap keys on the 700 Color Numeric Keypad and 700 Color Alphanumeric Keypad. This will allow applications to enable keys that would otherwise not be available, such as the [F1] function key. Also, to disable keys that should not be available, such as the alpha key because no alpha entry is required. Care should be exercised when attempting to remap the keypad because improper remapping may cause the keypad to become unusable. This can be corrected by cold booting the device which will cause the default keymap to be loaded again. Note that remapping the keys in this way affects the key mapping for the entire system, not just for the application that does the remapping. There are three “planes” supported for the 700 Color Numeric Keypad and Alphanumeric Keypad. Keys that are to be used in more than one shift plane must be described in each plane. Unshifted Plane The unshifted plane contains values from the keypad when not pressed with other keys, such as the following: Press the Keys Numeric Keypad Alphanumeric Keypad To Enter This Gold Plane The gold plane contains values from the keypad when a key is simultaneously pressed with the [Gold] b key on the numeric keypad or the [Gold/White] c key on the alphanumeric keypad, such as the following: Press the Keys 284 Numeric Keypad Alphanumeric Keypad To Enter This [Gold] b 1 [Gold/White] c e Send [Gold] b 5 [Gold/White] c C A3 [Gold] b 9 [Gold/White] c P PgDn 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Alpha (Blue) Plane The alpha plane contains values from the keypad when the keypad has been placed in alpha mode by pressing the blue alpha key, such as the following: Press the Keys Numeric Keypad Alphanumeric Keypad To Enter This [Alpha] F 1 [Alpha] d g Caps [Alpha] F 5 [Alpha] d J [Alpha] F 9 [Alpha] d W Key Values Key values for each plane are stored in the registry. All units ship with a default key mapping already loaded in the registry. Applications that wish to change the default mapping need to read the appropriate key from the registry into an array of Words, modify the values required and then write the updated values back into the registry. The registry access can be done with standard Microsoft API calls, such as RegOpenKeyEx(), RegQueryValueEx(), and RegSetValueEx(). Numeric Keypad For the 700 Color Numeric Keypad, the following registry keys contain the plane mappings: S The unshifted plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\Vkey S The gold plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\VkeyGold S The alpha plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\VkeyAlpha Alphanumeric Keypad For the 700 Color Alphanumeric Keypad, the following registry keys contain the plane mappings: S The unshifted plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\Vkey S The gold plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\VkeyGold S The alpha plane mapping can be found in the registry at: HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\VkeyAlpha 700 Series Color Mobile Computer User’s Manual 285 Chapter 7 — Programming How Key Values Are Stored in Registry To know which fields to update in the registry, you must know what Scan Codes are assigned to each physical key (see the “Keypad Scan Codes and Meanings” table on the next page). The Scan Code is used at the lowest level of the system to let the keypad driver know which physical key has been pressed. The keypad driver takes that scan code and looks it up in a table (a copy of the one stored in the registry) to determine which values to pass on to the operating system. Each registry key is just an array that describes to the keypad driver what value needs to be passed for each physical key. The key values are indexed by the scan code, this is a zero-based index. For example in the unshifted plane, the [4] key has a scan code of 0x06. This means that the seventh word under the “Vkey” registry key will have the value for the [4] key. Taking a sample of the “Vkey” registry key shows the following values: 00,00,0B,05,02,03,C1,07,04,03,BE,00,34,00,00,00,. . . The value is 34,00. The values are in reverse byte order because that is the way the processor handles data. When writing an application, nothing needs to be done to swap the bytes, as this will happen automatically when the data is read into a byte value. This is something you just need to be aware of when looking at the registry. Knowing this, we can see that the value that the keypad driver will pass to the system is a hex 34. Looking that up on an UNICODE character chart, we see that it maps to a “4”. If you wanted the key, labeled “4”, to output the letter “A” instead, you would need to change the seventh word to “41” (the hexadecimal representation of “A” from the UNICODE chart), then put the key back into the registry. Note: Do not remap scan codes 0x01, 0x41, 0x42, 0x43, 0x44. Remapping these scan codes could render your 700 Color Computer unusable until a cold-boot is performed. If you wish to disable a certain key, remap its scan code to 0x00. Change Notification Just changing the registry keys will not immediately change the key mappings. To notify the keypad driver that the registry has been updated, signal the “ITC_KEYBOARD_CHANGE” named event using the CreateEvent() API. Advanced Keypad Remapping It is also possible to map multiple key presses to one button and to map named system events to a button. The multiple key press option could be useful to cut down on the number of keys needed to press in a given situation or to remap which key behaves like the action key. Mapping events to a button could be useful to change which buttons will fire the scanner, control volume, and allow for suspending and resuming the device. If you need help performing one of these advanced topics please contact Intermec Technical Support. 286 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Scan Codes At the lowest driver level, the 700 Color Numeric Keypad and the 700 Color Alphanumeric Keypad identifies keys as scan codes. These scan codes are sent via the keypad microcontroller, and cannot be changed without modifying the keypad firmware. Numeric Keypad The following scan codes pertain to the 700 Color Numeric keypad: Numeric Keypad Scan Codes and Meanings Press this Key Meaning ScanCode Reserved 0x00 I/O button 0x01 Scanner Handle Trigger 0x02 Scanner Left 0x03 Scanner Right 0x04 4/GHI/A2 0x06 None 0x07 Left arrow/Back Tab 0x08 None 0x09 BkSp// (forward slash) 0x0A [Gold] key 0x0B None 0x0C Esc/– (minus sign) 0x0D Down arrow/Volume decrease 0x0E 1/Caps/Send 0x0F 7/PQRS/PgUp 0x10 [Alpha] key 0x11 None 0x12 Up arrow/Volume increase 0x13 Right arrow/Tab 0x14 2/ABC/End 0x15 8/TUV/* (asterisk) 0x16 0/Win 0x17 5/JKL/A3 0x18 None 0x19 Action/+ (plus symbol) 0x1A 3/DEF/backlight 0x1B 9/WXYZ/PgDn 0x1C 700 Series Color Mobile Computer User’s Manual 287 Chapter 7 — Programming Numeric Keypad Scan Codes and Meanings (continued) Press this Key Meaning ScanCode Enter/@ (at symbol) 0x1D 6/MNO/A4 0x1E None 0x1F–0x40 Charge Detect 0x41 LCD frontlight 0x42 Ambient light 0x42 Threshold crossed 0x42 Headset detected 0x43 Keypad Backlight 0x44 Ambient Light 0x44 Threshold Crossed 0x44 Alphanumeric Keypad The following scan codes pertain to the 700 Color Alphanumeric keypad: Alphanumeric Keypad Scan Codes and Meanings Press this Key Meaning ScanCode Reserved 0x00 I/O button 0x01 Scanner Handle Trigger 0x02 Scanner Left 0x03 Scanner Right 0x04 A/A1 key 0x05 B/A2 key 0x06 Escape/Send 0x07 Left arrow/Back Tab 0x08 Up arrow/Volume increase 0x09 Down arrow/Volume decrease 0x0A Right arrow/Tab 0x0B Action/End 0x0C E/Win 0x0D F/= (equal sign) 0x0E G/* (asterisk) 0x0F C/A3 0x10 H// (forward slash) 0x11 D/A4 0x12 288 700 Series Color Mobile Computer User’s Manual Chapter 7 — Programming Alphanumeric Keypad Scan Codes and Meanings (continued) Press this Key Meaning ScanCode J/PgUp 0x13 K/@ (as symbol) 0x14 L/– (minus sign) 0x15 M/1 0x16 N/2 0x17 I/backlight 0x18 P/PgDn 0x19 Q/, (comma) 0x1A R/+ (plus sign) 0x1B S/4 0x1C T/5 0x1D O/3 0x1E Caps/Lock 0x1F BkSp 0x20 V/. (period) 0x21 W/7 0x22 X/8 0x23 U/6 0x24 Gold/White 0x25 NumLock 0x26 Space 0x27 Z/0 0x28 Enter 0x29 Y/9 0x2A None 0x2B–0x40 Charge Detect 0x41 LCD frontlight 0x42 Ambient light 0x42 Threshold crossed 0x42 Headset detected 0x43 Keypad Backlight 0x44 Ambient Light 0x44 Threshold Crossed 0x44 700 Series Color Mobile Computer User’s Manual 289 Chapter 7 — Programming Sample View of Registry Keys The following is a sample view of the current default key mapping for the 700 Color Numeric Keypad. See the registry on your device for the latest key mappings. [HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD] ”ResumeMask”=dword:7 ”Vkey”=hex: 00,00,0B,05,02,03,C1,07,04,03,BE,00,34,00,00,00,\ 25,00,00,00,08,00,03,02,00,00,1B,00,28,00,31,00,\ 37,00,01,02,00,00,26,00,27,00,32,00,38,00,30,00,\ 35,00,00,00,01,03,33,00,39,00,0D,00,36,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,07,05,01,05,03,05,02,05 ”VkeyGold”=hex: 00,00,0B,05,02,03,C1,07,04,03,BE,00,34,00,00,00,\ 09,01,00,00,BF,00,03,02,00,00,BD,00,75,00,72,00,\ 21,00,01,02,00,00,76,00,09,00,73,00,38,01,5B,00,\ 35,00,00,00,BB,01,09,05,22,00,32,01,36,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,07,05,01,05,03,05,02,05 ”VkeyAlpha”=hex: 00,00,0B,05,02,03,C1,07,04,03,BE,00,47,00,00,00,\ 25,00,00,00,08,00,03,02,00,00,1B,00,28,00,02,02,\ 50,00,01,02,00,00,26,00,27,00,41,00,54,00,20,00,\ 4A,00,00,00,01,03,44,00,57,00,0D,00,4D,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,\ 00,00,07,05,01,05,03,05,02,05 290 700 Series Color Mobile Computer User’s Manual A Configurable Settings This appendix contains information about the Data Collection, Intermec Settings, SNMP, Unit Information, Utilities, and Wireless Network control panel applets that may be on the 700 Series Color Mobile Computer. Note: “700 Color” pertains to 740, 741, 750, 751, 760, and 761 Computers unless otherwise noted. SNMP, Intermec Settings, and Data Collection settings that can appear under Settings are dependent on what hardware configuration is done for each 700 Color Computer at the time of shipment. These settings currently only appear if a scanner or an imager option is present. Likewise, other control panel applets that are specifically related to the 802.11b or 802.11b/g radio module will appear when a 802.11b or 802.11b/g radio module is installed in a 700 Color Computer. Control panel applets that are specific for Wireless Printing, CDMA/1xRTT, and GSM/GPRS radio modules will only appear when each respective hardware configuration is done on the 700 Color Computer. See Chapter 4, “Network Support,” for more information about the radio modules or the wireless printing. Information about using reader commands and configuration bar codes to configure some of your settings is also in this appendix. Note: Information about the settings you can configure with the Intermec Settings control panel applet is described in the Intermec Computer Command Reference Manual (P/N: 073529). The online manual is available from the Intermec web site at www.intermec.com. 700 Series Color Mobile Computer User’s Manual 291 Appendix A — Configurable Settings Configuration Parameters A configuration parameter changes the way the 700 Color Computer operates, such as configuring a parameter to have the 700 Color Computer emit a very loud beep in a noisy environment. Use any of the following methods to execute configuration parameters: S Change Data Collection and SNMP parameters via control panel applets later in this appendix. S Send parameters from an SNMP management station. See “SNMP Configuration on the 700 Color Computer” starting on page 187. S Scan EasySet bar codes. You can use the EasySet bar code creation software from Intermec Technologies Corporation to print configuration labels. Scan the labels to change the scanner configuration and data transfer settings. Use the Intermec EasySet software to print configuration labels you can scan to change your configuration settings. For more information, see the EasySet online help. EasySet is available from the Intermec Data Capture web site. Changing a Parameter Setting Menus of available parameters for each group are listed. Use the scroll bars to go through the list. Expand each menu (+) to view its parameter settings. Tap a parameter to select, or expand a parameter (+) to view its subparameters. Note that each parameter or subparameter is shown with its default setting or current setting in (< >) brackets. Tap a parameter or subparameter to select that parameter, then do any of the following to change its setting: Tap Apply to apply any changes. Note that these illustrations are from a Symbologies parameter. S Typing a new value in an entry field. S Choosing a new value from the drop-down list. S Selecting a different option. The selected option contains a bullet. S Tap Defaults, then Apply to restore factory-default settings. Tap Yes when you are prompted to verify this action. 292 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings S Tap Refresh to discard changes and start again. Tap Yes when you are prompted to verify this action. About Configuration Parameters You can find this information about each configuration parameter: S Name and Purpose: Describes the parameter and its function. S Action: Describes what to do with a parameter once that parameter is selected. S SNMP OID: Lists the SNMP OID for the parameter. S Syntax or Options: Syntax lists the two-character code for the parameter, if the parameter is configurable by scanning a bar code or by sending parameters through a network. Both Syntax and Options list acceptable values for the parameter. 700 Series Color Mobile Computer User’s Manual 293 Appendix A — Configurable Settings Data Collection Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM Build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the Data Collection applet. Information about the settings you can configure with the Intermec Settings applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. See “Scanner Control and Data Transfer” in the Intermec Windows CE/ Pocket PC Software Developer’s Kit (SDK) User’s Manual shipped with the Software Developer’s Kit (SDK) for information about data collection functions. Note that icons are shown to the left. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Data Collection to access its control panel applet. Use the left and right arrows to scroll through the tabs along the bottom of the control panel applet, then tap a tab to access its menus. These tabs represent the following groups of settings or parameters: S Symbologies (starting on page 295) S Symbology Options (starting on page 316) S Beeper/LED (starting on page 324) S Imager (starting on page 330) S Virtual Wedge (starting on page 335) 294 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Symbologies You can change bar code symbology parameter settings in your 700 Color Computer via the Data Collection control panel applet. The following parameters are for bar code symbologies. Additional information about the more common bar code symbologies are in Appendix B, “Bar Codes.” Note that these parameters are listed in the order of their appearance within this tab. Most of these symbologies apply to both the imager and the laser scanner tools. However, when using an imager, the Macro PDF (page 306), Micro PDF417 (page 308), Matrix 2 of 5 (page 310), Telepen (page 311), and Code 11 (page 312) symbologies are not supported. Likewise, when using a laser scanner, the QR Code (page 313), Data Matrix (page 314), and MaxiCode (page 315) symbologies are not supported. Note: The 730 Computer uses the EV10 APS linear imager which supports 1D symbologies. The following table shows which bar code symbologies are supported by an imager, a laser scanner, or the EV10 APS Linear Imager Bar Code Symbology Imager EV10 APS Laser Scanner Linear Imager Code 39 Interleaved 2 of 5 Standard 2 of 5 Matrix 2 of 5 Code 128 Code 93 Codabar MSI Plessey UPC EAN/EAN 128 Micro PDF417 Telepen Code 11 PDF417 Data Matrix QR Code MaxiCode 700 Series Color Mobile Computer User’s Manual 295 Appendix A — Configurable Settings Code 39 Code 39 is a discrete, self-checking, variable length symbology. The character set is uppercase A–Z, 0–9, dollar sign ($), period (.), slash (/), percent (%), space ( ), plus (+), and minus (-). Action Tap (+) to expand the Code 39 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.3.1 Options Decoding Not active Active (default) Format Standard 43 characters (default) Full ASCII Start/Stop Not transmitted (default) Transmitted Start/Stop characters (Not supported when using an imager) $ (dollar sign) only * (asterisk) only (default) $ and * (dollar sign and asterisk) Check digit Not used (default) Mod 43 transmitted Mod 43 not transmitted French CIP transmitted French CIP not transmitted Italian CPI transmitted Italian CPI not transmitted Bar code length Any length (default) Minimum length Minimum length 001–254 Minimum length 1–254 (default is 6) Note: If Bar code length = “1” then Minimum length is entered. 296 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Standard 2 of 5 Standard 2 of 5 is a discrete and self-checking symbology that uses the bars to encode information and the spaces to separate the individual bars. Action Tap (+) to expand the Standard 2 of 5 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.4.1 Options Decoding Not active (default) Active Format Identicon, 6 start/stop bars (default) Computer Identics, 4 start/stop bars Check digit Not used (default) Mod 10 transmitted Mod 10 not transmitted Bar code length Any length Minimum length (default) Fixed lengths Minimum length 001–254 Minimum length 1–254 (default is 6) Fixed length 1 000–254 Fixed bar code length 0–254 (default is 0) Fixed length 2 000–254 Fixed bar code length 0–254 (default is 0) Fixed length 3 000–254 Fixed bar code length 0–254 (default is 0) Note: If Bar code length = “1” then Minimum length is entered. If Bar code length = “2” then Fixed length 1, Fixed length 2, or Fixed length 3 is entered. 700 Series Color Mobile Computer User’s Manual 297 Appendix A — Configurable Settings Codabar Codabar is a self-checking, discrete symbology. Action Tap (+) to expand the Codabar parameter, select a setting to be changed, then select an option from the drop-down list to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.5.1 Options Decoding Not active (default) Active Start/Stop Not transmitted (default) abcd transmitted ABCD transmitted abcd/tn*e transmitted DC1–DC4 transmitted CLSI library system (Not supported when using an imager) Not active (default) Active Check digit Not used (default) Transmitted Not transmitted Bar code length Any length Minimum length (default) Fixed lengths Minimum length 003–254 Minimum length 3–254 (default is 6) Fixed length 1 000–254 Fixed bar code length 0–254 (default is 0) Fixed length 2 000–254 Fixed bar code length 0–254 (default is 0) Fixed length 3 000–254 Fixed bar code length 0–254 (default is 0) Note: If Bar code length = “1” then Minimum length is entered. If Bar code length = “2” then Fixed length 1, Fixed length 2, or Fixed length 3 is entered. 298 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings UPC/EAN UPC/EAN are fixed-length, numeric, continuous symbologies that use four element widths. Action Tap (+) to expand the UPC/EAN parameter, select the setting to be changed, then select an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.6.1 Options UPC A Not Active Active (default) UPC E Not Active Active (default) EAN 8 Not Active Active (default) EAN 13 Not Active Active (default) Add-on digits Not required (default) Required Add-on 2 digits Not active (default) Active Add-on 5 digits (Not supported when using an imager) Not active (default) Active UPC A check digit Not transmitted Transmitted (default) UPC E check digit Not transmitted Transmitted (default) EAN 8 check digit Not transmitted Transmitted (default) EAN 13 check digit Not transmitted Transmitted (default) UPC A number system Not transmitted Transmitted (default) UPC E number system Not transmitted Transmitted (default) UPC A re-encoding UPC A transmitted as UPC A UPC A transmitted as EAN 13 (default) UPC E re-encoding UPC E transmitted as UPC E (default) UPC E transmitted as UPC A EAN 8 re-encoding EAN 8 transmitted as EAN 8 (default) EAN 8 transmitted as EAN 13 700 Series Color Mobile Computer User’s Manual 299 Appendix A — Configurable Settings Code 93 Code 93 is a variable length, continuous symbology that uses four element widths. Action Tap the Code 93 parameter, then select an option to change this parameter setting. Tap (+) to access the Code 93 Lengths parameter. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.7.1 Options Not active (default) Active Code 93 Length Sets the Code 93 bar code length. Action Tap (+) to expand the Code 93 parameter, then tap (+) to expand the Code 93 Lengths parameter. Tap the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.19.1 Options Bar code length Any length Minimum length (default) Minimum length 001–254 Minimum length 1–254 (default is 6) Note: If Bar code length = “1” then Minimum length is entered. 300 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Code 128 Code 128 is a variable-length, continuous, high-density, alphanumeric symbology that uses multiple element widths and supports the extended ASCII character set. Action Tap the Code 128 parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.9.1 Options Not active (default) Active This illustration is from a 700 Color Computer using a laser scanner. 700 Series Color Mobile Computer User’s Manual 301 Appendix A — Configurable Settings Code 128 Options Set the following for the Code 128 parameter. Note that the EAN 128 ]C1 and CIP 128 French Pharmaceutical options are not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the Code 128 Options parameter, select a setting, then select an option to change this setting. SNMP OID None. Options EAN 128 ]C1 Identifier (Not supported when using an imager) Remove (default) Include CIP 128 French Pharmaceutical (Not supported when using an imager) Not active (default) Active Bar code length Any length (default) Minimum length Minimum length 001–254 Minimum length 1–254 (default is 6) This illustration is from a 700 Color Computer using a laser scanner. 302 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Code 128 FNC1 Character The Code 128 FNC1 character (EAN 128 norms) can be any ASCII character and is used as a separator when multiple identifiers and their fields are concatenated. Note that this is not available when you use an imager with your 700 Color Computer. Non-printable ASCII characters can be entered using the following syntax where HH is the hexadecimal value of the character. \xHH For example, the GS character, whose hexadecimal value is 1D, would be entered as \x1D. In addition,the following characters have their own identifiers: S BEL \a S BS \b S FF \f S LF \n S CR \r S HT \t S VT \v Action Tap (+) to expand the Code 128 parameter, then type the ASCII characters to be set for the Code 128 FNC1 character parameter. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.21.1 Options Any ASCII character (default is the GS function character — ID hex) 700 Series Color Mobile Computer User’s Manual 303 Appendix A — Configurable Settings Plessey Plessey is a pulse-width modulated symbology like most other bar codes. It includes a start character, data characters, an eight-bit cyclic check digit, and a termination bar. The code is continuous and not self-checking. You need to configure two parameters for Plessey code: Start Code and Check Digit. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the Plessey parameter, select the setting to be changed, then select an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.10.1 Options Decoding Not active (default) Active Check digit Not transmitted (default) Transmitted Bar code length Any length Minimum length (default) Minimum length 001–254 Minimum length 1–254 (default is 6) Note: If Bar code length = “1” then Minimum length is entered. 304 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings MSI MSI is a symbology similar to Plessey code (page 304) that includes a start pattern, data characters, one or two check digits, and a stop pattern. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the MSI parameter, select the setting to be changed, then select an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.15.1 Options Decoding Not active (default) Active Check digit Mod 10 transmitted (default) Mod 10 not transmitted Double Mod 10 transmitted Double Mod 10 not transmitted Bar code length Any length Minimum length (default) Minimum length 001–254 Minimum length 1–254 (default is 6) Note: If Bar code length = “1” then Minimum length is entered. 700 Series Color Mobile Computer User’s Manual 305 Appendix A — Configurable Settings PDF417 PDF417 is a stacked two-dimensional symbology that provides the ability to scan across rows of code. Each row consists of start/stop characters, row identifiers, and symbol characters, which consist of four bars and four spaces each and contain the actual data. This symbology uses error correction symbol characters appended at the end to recover loss of data. Because the virtual wedge translates incoming data into keypad input, the size of the keypad buffer limits the effective length of the label to 128 characters. Longer labels may be truncated. For PDF417 labels of more than 128 characters, you can develop an application that bypasses the keypad buffer. Action Tap the PDF417 parameter, then select an option to change this parameter setting. Tap (+) to access either the Macro PDF options parameter or the Micro PDF417 parameter. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.17.1 Options Not active Active (default) This illustration is from a 700 Color Computer using a laser scanner. Macro PDF options Macro PDF is used when a long message requires more than one PDF417 label. Note that this is not available when you use an imager with your 700 Color Computer. S Select Buffered to store a multi-label PDF417 message in the Sabre buffer, thus transmitting the entire message when all labels are read. 306 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings S Select Unbuffered for multi-label PDF417 messages that are too long for the Sabre buffer (memory overflow). Each part of the PDF417 label is transmitted separately, and the host application must then assemble the message using the macro PDF control header transmitted with each label. Control Header is only present in macro PDF codes and is always transmitted with unbuffered option. Action Tap (+) to expand the PDF417 parameter, tap (+) to expand the Macro PDF parameter, select a setting to be changed, then select an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.22.1 Options Macro PDF Unbuffered Buffered (default) Control header Not transmitted (default) Transmitted File name Not transmitted (default) Transmitted Segment count Not transmitted (default) Transmitted Time stamp Not transmitted (default) Transmitted Sender Not transmitted (default) Transmitted Addressee Not transmitted (default) Transmitted File size Not transmitted (default) Transmitted Checksum Not transmitted (default) Transmitted 700 Series Color Mobile Computer User’s Manual 307 Appendix A — Configurable Settings Micro PDF417 Micro PDF417 is a multi-row symbology derived from and closely based on PDF417 (page 306). A limited set of symbology sizes is available, together with a fixed level of error correction for each symbology size. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the PDF417 parameter, tap (+) to expand the Micro PDF417 parameter, select a setting to be changed, then select an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.27.1 Options 308 Decoding Not active (default) Active Code 128 Emulation Not active (default) Active 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Interleaved 2 of 5 Interleaved 2 of 5 (I 2 of 5) is a high-density, self-checking, continuous, numeric symbology used mainly in inventory distribution and the automobile industry. Note: An Interleaved 2 of 5 bar code label must be at least three characters long for the 700 Color Computer to scan and decode correctly. Action Tap (+) to expand the Interleaved 2 of 5 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.23.1 Options Decoding Not active (default) Active Check digit Not used (default) Mod 10 transmitted Mod 10 not transmitted French CIP transmitted French CIP not transmitted Bar code length Any length Minimum length (default) Fixed lengths Minimum length 003–254 Minimum length 3–254 (default is 6) Fixed length 1 003–254 Fixed bar code length 3–254 (default is 3) Fixed length 2 003–254 Fixed bar code length 3–254 (default is 3) Fixed length 3 003–254 Fixed bar code length 3–254 (default is 3) Note: If Bar code length = “1” then Minimum length is entered. If Bar code length =“2” then Fixed length 1, Fixed length 2, or Fixed length 3 is entered. 700 Series Color Mobile Computer User’s Manual 309 Appendix A — Configurable Settings Matrix 2 of 5 Matrix 2 of 5 is a numerical symbology. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the Matrix 2 of 5 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.24.1 Options Decoding Not active (default) Active Bar code length Any length Minimum length (default) Minimum length 001–254 Minimum length 1–254 (default is 6) Note: If Bar code length = “1” then Minimum length is entered. 310 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Telepen Telepen is an alphanumeric, case-sensitive, full ASCII symbology. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the Telepen parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.25.1 Options Decoding Not active (default) Active Format ASCII (default) Numeric 700 Series Color Mobile Computer User’s Manual 311 Appendix A — Configurable Settings Code 11 Code 11 is a high density, discrete numeric symbology that is extensively used in labeling telecommunications components and equipment. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap (+) to expand the Code 11 parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.26.1 Options 312 Decoding Not active (default) Active Check digit verification 1 digit (default) 2 digits Check digit transmit Disable Enable (default) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings QR Code QR Code (Quick Response Code) is a two-dimensional matrix symbology containing dark and light square data modules. It has position detection patterns on three of its four corners and features direct encodation of the Japanese Kana-Kanji character set. It can encode up to 2509 numeric or 1520 alphanumeric characters and offers three levels of error detection. Note that this is not available when you use a laser scanner with your 700 Color Computer or if you are using a 730 Computer. Action Tap (+) to expand the QR Code parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.35.1 Options Decoding 700 Series Color Mobile Computer User’s Manual Not active Active (default) 313 Appendix A — Configurable Settings Data Matrix A two-dimensional matrix symbology, which is made of square modules arranged within a perimeter finder pattern. The symbology utilizes Error Checking and Correcting (ECC) algorithm with selectable levels for data error recovery and Cyclic Redundancy Check algorithm to validate the data. The character set includes either 128 characters conforming to ISO 646 (ANSI X3.4 - 1986) or 256 extended character set. Maximum capacity of a symbol is 2335 alphanumeric characters, 1556 8-bit byte characters or 3116 numeric digits. Note that this is not available when you use a laser scanner with your 700 Color Computer or if you are using a 730 Computer. Action Tap (+) to expand the Data Matrix parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.34.1 Options Decoding 314 Not active Active (default) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings MaxiCode MaxiCode is a fixed-size 2-D matrix symbology which is made up of offset rows of hexagonal elements arranged around a unique circular finder pattern. ASCII data is encoded in six-bit symbol characters. The symbol contains 33 rows which are alternately 30 and 29 elements wide. There are five different code sets. A single MaxiCode symbol can encode up to 93 characters of data. Note that this is not available when you use a laser scanner with your 700 Color Computer or if you are using a 730 Computer. Action Tap (+) to expand the MaxiCode parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.33.1 Options Decoding 700 Series Color Mobile Computer User’s Manual Not active Active (default) 315 Appendix A — Configurable Settings Symbology Options To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > the Data Collection icon to access its control panel applet. Use the right and left arrows to scroll to the Symbology Options tab, then tap this tab to access its parameters. The following are parameters for bar code symbology options. Note that these are listed in the order of their appearance within the Symbology Options tab. Symbology ID Identifies the bar code symbology in which data is encoded by prepending a user-specified symbology identifier to the data. You can prepend one of these types of character strings to identify the symbology: S User-defined ASCII Character (Option 1): A user-defined symbology identifier is a single ASCII character. You can assign a custom identifier character to each bar code symbology. Note that this is not available when you use an imager with your 700 Color Computer. S AIM ISO/IEC Standard (Option 2 — Required to define symbology IDs): The AIM Standard has a three-character structure which indicates the symbology and optional features. See the AIM ISO/IEC Standard for information. Action Select Symbology ID, then select an option to change this parameter setting. Tap (+) to expand the Symbology ID parameter, then select any of the user ID parameters listed. See the top of the next page for a sample screen of the Code 39 user ID. SNMP OID 1.3.6.1.4.1.1963.15.3.3.4.1.22.1 Options 316 Disable (default) User defined (disabled when using an imager) ISO/IEC Standard 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Code 39 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 39 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Code 39 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.3.1 Options: x where x is a single ASCII character. Default is asterisk (*). Code 128 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 128 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Code 128 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.5.1 Options: x where x is a single ASCII character. Default is asterisk (*). Codabar User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Codabar bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Codabar user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.2.1 Options: x where x is a single ASCII character. Default is D. 700 Series Color Mobile Computer User’s Manual 317 Appendix A — Configurable Settings Code 93 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 93 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Code 93 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.4.1 Options: x where x is a single ASCII character. Default is asterisk (*). Interleaved 2 of 5 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Interleaved 2 of 5 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Interleaved 2 of 5 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.10.1 Options: x where x is a single ASCII character. Default is I (not lowercase L). PDF417 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify PDF417 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the PDF417 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.12.1 Options: x where x is a single ASCII character. Default is an asterisk (*). MSI User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify MSI bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the MSI user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.11.1 Options: x 318 where x is a single ASCII character. Default is D. 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Plessey User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Plessey bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Plessey user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.13.1 Options: x where x is a single ASCII character. Default is D. Standard 2 of 5 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Standard 2 of 5 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Standard 2 of 5 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.23.1 Options: x where x is a single ASCII character. Default is D. UPC A User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify UPC-A (Universal Product Code) bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the UPC A user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.6.1 Options: x where x is a single ASCII character. Default is A. UPC E User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify UPC-E bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the UPC E user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.7.1 Options: x where x is a single ASCII character. Default is E. 700 Series Color Mobile Computer User’s Manual 319 Appendix A — Configurable Settings EAN 8 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify EAN-8 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the EAN 8 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.8.1 Options: x where x is a single ASCII character. Default is \xFF. EAN 13 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify EAN-13 (European Article Numbering) bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the EAN 13 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.9.1 Options: x where x is a single ASCII character. Default is F. Matrix 2 of 5 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Matrix 2 of 5 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Matrix 2 of 5 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.24.1 Options: x where x is a single ASCII character. Default is D. Telepen User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Telepen bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Telepen user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.25.1 Options: x 320 where x is a single ASCII character. Default is an asterisk (*). 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Code 11 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 11 bar code data. Note that this is not available when you use an imager with your 700 Color Computer. Action: Tap (+) to expand the Symbology ID parameter, select the Code 11 user ID parameter, then enter a user ID value to change this parameter setting. SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.16.1 Options: x where x is a single ASCII character. Default is asterisk (*). 700 Series Color Mobile Computer User’s Manual 321 Appendix A — Configurable Settings Prefix Prepends a string of up to 20 ASCII characters to all scanned data. Action Tap the Prefix parameter, then enter a prefix value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.4.1.29.1 Options Acceptable values are up to 20 ASCII characters. Embedded null ( ) characters are not allowed. Default is no characters (disabled). 322 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Suffix Appends a string of up to 20 ASCII characters to all scanned data. Action Tap the Suffix parameter, then enter a suffix value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.4.1.30.1 Options Acceptable values are up to 20 ASCII characters. Embedded null ( ) characters are not allowed. Default is no characters (disabled). 700 Series Color Mobile Computer User’s Manual 323 Appendix A — Configurable Settings Beeper/LED To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > the Data Collection icon to access its control panel applet. Use the right and left arrows to scroll to the Beeper/LED tab, then tap this tab to access its parameters. Most of these functions are not available when using an imager. The following table shows which functions are supported either by an imager or by a laser scanner. Beeper Function Imager Beeper Laser Scanner Beeper Volume Beeper Frequency Good Read Beeps Good Read Beep Duration The following are parameters for features on the 700 Color Computer. Note that these are listed in the order of their appearance. 324 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Beeper Sets the volume for the good read beep. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the Beeper parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.1.4.1.6.1 Options Beeper (default) Vibrate (not supported on 730 Computers) 700 Color with Imager Screen 700 Series Color Mobile Computer User’s Manual 730 Screen 325 Appendix A — Configurable Settings Beeper Volume Sets the volume for the good read beep. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap the Beeper volume parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.1.4.1.6.1 Options Low High (default) Medium Off Vibrate Disabling the Volume To disable the beeper, tap Start > Settings > the Personal tab > Sounds & Notifications > the Volume tab, drag the System volume slider bar to the left “Silent” position, then tap ok to exit this applet. See Chapter 1, “Introduction“ for more information. 326 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Beeper Frequency Sets the frequency for the good read beep. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap the Beeper frequency parameter, then enter a frequency value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.1.4.1.7.1 Options 1000–4095 (default is 2090) 700 Series Color Mobile Computer User’s Manual 327 Appendix A — Configurable Settings Good Read Beeps Sets the number of good read beeps. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap the Good read beeps parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.1.4.1.8.1 Options 328 No beeps One beep (default) Two beeps 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Good Read Beep Duration Sets the duration of the good read beep. Note that this is not available when you use an imager with your 700 Color Computer. Action Tap the Good read beep duration parameter, then enter a duration value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.1.4.1.9.1 Options 0–2550 Beep duration in milliseconds. (default is 80) 700 Series Color Mobile Computer User’s Manual 329 Appendix A — Configurable Settings Imager Note: These instructions do not apply to the 730 Computer. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Data Collection to access its control panel applet. Use the right and left arrows to scroll to the Imager tab, then tap this tab to access its parameters. The following are parameters for the imager. Note that these are listed in the order of their appearance within the Imager tab. Aimer LED Duration The Aimer LED Duration controls the time the Aimer LED is turned on when the scan button is pressed. After this time, images are captured for decoding. The purpose is to position the Aimer LED on the bar code symbol before attempting to decode the bar code. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the Aimer LED Duration parameter, then enter a value to change this setting. Note that values must be in 50 ms increments, such as 500, 650, or 32500. Values not entered in 50 ms increments are rounded down. For example, 2489 ms is rounded down to 2450 ms, 149 ms is rounded down to 100 ms, etc.. SNMP OID 1.3.6.1.4.1.1963.15.3.3.3.1.1.21.1 Options 0–65500 ms (Default is 0) 330 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Sticky Aimer Duration The Sticky Aimer Duration controls the time the Aimer LED stays on after the a bar code read completes or after the trigger button is released. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the Sticky Aimer Duration parameter, then enter a value to change this setting. Note that values must be in 50 ms increments, such as 500, 650, or 32500. Values not entered in 50 ms increments are rounded down. For example, 2489 ms is rounded down to 2450 ms, 149 ms is rounded down to 100 ms, etc.. SNMP OID 1.3.6.1.4.1.1963.15.3.3.3.1.1.24.1 Options 0–65535 ms (Default is 1000) 700 Series Color Mobile Computer User’s Manual 331 Appendix A — Configurable Settings Image Dimension The image dimensions control the vertical size of the image for decoding. This can restrict the image to one bar code when otherwise, there might be more than one bar code in the image to be decoded. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the Image dimension parameter, select the position to be changed, then tap an option or enter a value to change this position. SNMP OID 1.3.6.1.4.1.1963.15.3.3.3.1.1.22.1 Options 332 Left position Not supported Right position Not supported Top position 0–478 Position in pixels (Default is 0) Bottom position 0–479 Position in pixels (Default is 479) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Lighting Mode The Lighting Mode sets the lighting mode of the imager. When set to “LED Priority,” the imager depends more on ambient lighting to illuminate the bar code for reading. When set to “Aperture Priority,” the imager uses its built-in LED to illuminate the bar code for reading. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the Lighting Mode parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.3.1.1.23.1 Options LED Priority (default) Aperture Priority 700 Series Color Mobile Computer User’s Manual 333 Appendix A — Configurable Settings 1D OmniDir Decode Enable The 1D OmniDir Decode Enable affects the scanning abilities of the IT4000 Imager. With 1D omni directional enabled, the imager is able to decode images and bar code labels regardless of the orientation of the label. With 1D omni directional disabled, the imager only decodes labels in the direction of the aimer LED. Note that this is not available when you use a laser scanner with your 700 Color Computer. Action Tap the 1D OmniDir Decode Enable parameter,then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.3.1.1.25.1 Options 334 Disabled Enabled (default) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Virtual Wedge To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Data Collection to access its control panel applet. Use the right and left arrows to scroll to the Virtual Wedge tab, then tap this tab to access its parameters. The following are parameters for the virtual wedge scanner. Note that these are listed in the order of their appearance within the Virtual Wedge tab. Virtual Wedge Enables or disables the virtual wedge for the internal scanner. The virtual wedge retrieves scanned Automatic Data Collection (ADC) data and sends it to the keypad driver so that the 700 Color Computer can receive and interpret the data as keypad input. Because the virtual wedge translates incoming data into keypad input, the size of the keypad buffer limits the effective length of the label to 128 characters. Longer labels may be truncated. For labels of more than 128 characters, you need to develop an application that bypasses the keypad buffer. Action Tap the Virtual Wedge parameter, then tap an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.2.1 Options Disable Enable (default) 700 Series Color Mobile Computer User’s Manual 335 Appendix A — Configurable Settings Preamble Sets the preamble that precedes any data you scan with the 700 Color Computer. Common preambles include a data location number or an operator number. Action Tap the Preamble parameter, then enter a preamble value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.3.1 Syntax ADdata where data is any acceptable values up to 31 ASCII characters. Embedded null ( ) characters are not allowed. Below are the non-printing characters you can use for Virtual Wedge Preambles. Default is blank. 336 \a Alert (bell) \b Backspace \f Form Feed \n New line/line feed \r Carriage return \t Horizontal tab \v Vertical tab \xnnnn nnnn is up to four HEX digits. Use leading zeros to fill out to four digits to ensure proper conversion. For example, to prepend the character M to scanned data, set the Preamble to either 1) M, or 2) x004D, where 4D is the HEX equivalent for an uppercase M. 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Note: When you enter the AD command without data, the preamble is disabled. If you want to use quotation marks or the following combinations of characters as part of the appended data, separate those characters from the AD command with quotes. If you do not use quotes as described here, the 700 Color Computer interprets the characters as another configuration command: AD AE AF KC BV EX DF Example To use the two-character string BV as a preamble, scan this command (as a Code 39 label) or send this command through the network: $+AD“BV” 700 Series Color Mobile Computer User’s Manual 337 Appendix A — Configurable Settings Postamble Sets the postamble that is appended to any data you scan with the 700 Color Computer. Common postambles include cursor controls, such as tabs or carriage return line feeds. Action Tap the Postamble parameter, then enter a postamble value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.4.1 Syntax AEdata where data is any acceptable values up to 31 ASCII characters. Embedded null ( ) characters are not allowed. Below are the non-printing characters you can use for Virtual Wedge Postambles: 338 \a Alert (bell) \b Backspace \f Form Feed \n New line/line feed \r Carriage return \t Horizontal tab (default) \v Vertical tab \xnnnn nnnn is up to four HEX digits. Use leading zeros to fill out to four digits to ensure proper conversion. For example, to prepend the character M to scanned data, set the Preamble to either 1) M, or 2) x004D, where 4D is the HEX equivalent for an uppercase M. 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Note: When you enter the AE command without data, the postamble is disabled. If you want to use quotation marks or the following combinations of characters as part of the appended data, separate those characters from the AE command with quotes. If you do not use quotes as described here, the 700 Color Computer interprets the characters as another configuration command. AD AE AF KC BV EX DF Example To use the two-character string BV as a postamble, scan this command (as a Code 39 label) or send this command through the network: $+AE“BV” 700 Series Color Mobile Computer User’s Manual 339 Appendix A — Configurable Settings Grid Sets the virtual wedge grid, which filters the data coming from this 700 Color Computer. The data server supports data filtering, which allows you to selectively send scanned data. The virtual wedge grid is similar to the “format” argument of the C Runtime Library scan function. Action Tap the Grid parameter, then enter a grid value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.5.1 Syntax AF filter-expression= > editing-expression where: S The AIM symbology ID (optional). S filter-expression Any character string that includes valid filter expression values. Go to the SDK User’s Manual provided with your Windows CE/PocketPC SDK for a list of valid filter expression values. S editing-expression Any character string that includes valid editing expression values. Go to the SDK User’s Manual provided with your Windows CE/PocketPC SDK for a list of valid editing expression values. 340 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Code Page Sets the virtual wedge code page. The code page controls the translation from the character set of the raw collected data to Unicode, which is the character set expected by Windows CE applications. The default code page is 1252, which is the Windows Latin 1 (ANSI) character set. Action Tap the Code Page parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.6.1 Options The only acceptable value for the code page parameter is “1252,” which is the default. 700 Series Color Mobile Computer User’s Manual 341 Appendix A — Configurable Settings Intermec Settings Control Panel Applet You may have the Intermec Settings control panel applet. Information about the settings you can configure with this applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. See “Scanner Control and Data Transfer” in the Intermec Windows CE/ Pocket PC Software Developer’s Kit (SDK) User’s Manual shipped with the Software Developer’s Kit (SDK) for information about data collection functions. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Intermec Settings to access its control panel applet. 342 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings SNMP Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the SNMP applet. Information about the settings you can configure with the Intermec Settings applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. Simple Network Management Protocol (SNMP) parameters include identification information, security encryption, security community strings, and traps. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > SNMP to access its control panel applet. Tap a tab to access its menus. These tabs represent three groups of settings or parameters: S Security (starting on the next page) S Traps (starting on page 349) S Identification (starting on page 351) 700 Series Color Mobile Computer User’s Manual 343 Appendix A — Configurable Settings Security To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > SNMP > the Security tab to access its parameters. The following are parameters that affect encryption and community strings. Note that these are listed in the order of their appearance within the Security tab. Read Only Community Sets the read-only community string for this 700 Color Computer, which is required for processing of SNMP get and get next requests. Action Tap the Read Only Community parameter, then enter a community string to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.1.2.0 Options The read-only community string can be up to 128 ASCII characters. Default is Public. 344 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Read/Write Community Sets the read/write community string, which is required for processing of SNMP set requests by this 700 Color Computer. An SNMP packet with this name as the community string will also process SNMP get and next requests. Action Tap the Read/Write Community parameter, then enter a community string to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.1.3.0 Options The read/write community string can be up to 128 ASCII characters. Default is Private. 700 Series Color Mobile Computer User’s Manual 345 Appendix A — Configurable Settings Read Encryption Sets the packet-level mode of security for SNMP read-only requests. If you enable read encryption, all received SNMP get and get next packets have to be encrypted or the packet will not be authorized. If encryption is enabled, you can only use software provided by Intermec Technologies. Note: To enable security encryption, you also need to set the Security Encryption Key (page 348). Action Tap the Read Encryption parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.1.4.0 Options 346 On SNMP get and get next packets must be encrypted Off SNMP packets do not have to be encrypted (default) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Write Encryption Sets the packet-level mode of security for SNMP read/write requests. If you enable write encryption, all SNMP packets that are received with the read/write community string have to be encrypted or the packet will not be authorized. You need to use software from Intermec Technologies that supports encryption. Note: To enable security encryption, you also need to set the Security Encryption Key (page 348). Action Tap the Write Encryption parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.1.5.0 Options On SNMP packets must be encrypted Off SNMP packets do not have to be encrypted (default) 700 Series Color Mobile Computer User’s Manual 347 Appendix A — Configurable Settings Encryption Key Identifies the key that this 700 Color Computer uses to encrypt or decipher SNMP packets. Encryption is used only by software provided by Intermec Technologies. If encryption is enabled, SNMP management platforms will not be able to communicate with the 700 Color Computer. The encryption key is returned encrypted. Action Tap the Encryption Key parameter, then enter a security encryption key value to change this parameter setting. Note: You also need to set either Read Encryption (page 346) or Write Encryption (page 347) or both. SNMP OID 1.3.6.1.4.1.1963.10.5.1.6.0 Options The encryption key can be from 4 to 20 ASCII characters. Default is NULL. 348 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Traps To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > SNMP > the Traps tab to access its parameters. The following are authentication and threshold parameters for traps. Note that these are listed in the order of their appearance within the Traps tab. Authentication Determines whether to send authentication traps. When trap authentication is enabled, an authentication trap is sent if an SNMP packet is received by the master agent with an invalid community string. Action Tap the Authentication parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.2.2.0 Options On (default) Off 700 Series Color Mobile Computer User’s Manual 349 Appendix A — Configurable Settings Threshold Determines the maximum number of traps per second that the master agent generates. If the threshold is reached, the trap will not be sent. Action Tap the Threshold parameter, then enter a threshold value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.2.3.0 Options Any positive integer value. Default is 10. 350 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Identification To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > SNMP > the Identification tab to access its parameters. The following are parameters for contact, location, and name information for support purposes. Note that these are listed in the order of their appearance within the Identification tab. Contact Sets the contact information for the person responsible for this 700 Color Computer. Action Tap the Contact parameter, then enter the name of your contact representative to change this parameter setting. SNMP OID 1.3.6.1.2.1.1.4.0 Options The identification contact may be up to 255 ASCII characters. Default is no characters or blank. 700 Series Color Mobile Computer User’s Manual 351 Appendix A — Configurable Settings Name Sets the assigned name for this 700 Color Computer. Action Tap the Name parameter, then enter the name of your 700 Color Computer to change this parameter setting. SNMP OID 1.3.6.1.2.1.1.5.0 Options The identification name may be up to 255 ASCII characters. Default is no characters or blank. 352 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Location Sets the identification location for this 700 Color Computer, such as “Shipping.” Action Tap the Location parameter, then enter the location of where your 700 Color Computer to change this parameter setting. SNMP OID 1.3.6.1.2.1.1.6.0 Options The identification location may be up to 255 ASCII characters. Default is no characters or blank. 700 Series Color Mobile Computer User’s Manual 353 Appendix A — Configurable Settings Unit Information Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the Unit Information applet. Information about the settings you can configure with the Intermec Settings applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com. Unit Information is a read-only control panel applet that provides information about your 700 Color Computer, such as software version builds, available CAB files, and the internal battery status. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Unit Information to access its control panel applet. Tap a tab to access its menus. These tabs represent three groups of settings or parameters: S Versions (next paragraph) S Battery Status (starting on page 355) S CAB Files (starting on page 356) Versions You can view the latest software build version on your 700 Color Computer by accessing the Unit Information control panel applet. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Unit Information > the Versions tab to view the latest software build version. Tap ok to exit this information. 700 Color Screen 354 730 Screen 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Battery Status You can view the battery status for your 700 Color Computer by accessing the Unit Information control panel applet. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Unit Information > the Battery Status tab to view the current status. Tap ok to exit this information. 700 Series Color Mobile Computer User’s Manual 355 Appendix A — Configurable Settings CAB Files You can view the latest developer or released version of each CAB file from Intermec Technologies Corporation that are installed in your 700 Color Computer via the Unit Information control panel applet. Custom CAB files are not displayed in this applet. See the Software Tools User’s Manual for more information about these files. To access the information from the 700 Color Computer, tap Start > Settings > the System tab > Unit Information > the CAB Files tab to view the current CAB file versions. Tap ok to exit this information. When a CAB file is built, a registry entry is created with a build number for that file. This CAB Files control panel applet looks for a registry key for each CAB file installed. When the registry entry is found, the CAB file name and version number information are displayed. If a CAB file has not been installed, then its information is not displayed. Below is a list of CAB files from Intermec Technologies that are available for your 700 Color Computer with their latest developer or released version of the software build. Should you need to add any of these to your 700 Color Computer, contact an Intermec representative. S BtMainStack: Installation of the Main Bluetooth Stack is handled automatically as part of the operating system boot-up procedure. See Chapter 4, “Network Support,” for more information about Bluetooth wireless printing. S Comm Port Wedge: The software build for the Comm Port Wedge. Note that the Comm Port Wedge CAB file is available on the Intermec Developer’s Library CD. S NPCPTest: This installs a Norand® Portable Communications Protocol (NPCP) Printing test application which will print to an Intermec® 4815, 4820, or 6820 Printer. See Chapter 5, “Printer Support,” for more information. 356 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings S S9C Upgrade: Installs the files needed to upgrade the S9C scanner firmware. See the 700 Color Management Tools portion of the Intermec Developer’s Library CD for more information about upgrading the firmware. S SDK: Installs the Intermec Software Developer’s Kit (SDK). See the SDK User’s Manual for more information. S WinCfg: Configures the NRINET.INI file, launches the NRINet client, and loads and unloads the LAN and WLAN device drivers. S Wireless Printing Sample: Installs a sample application that developers can use for reference when they are developing their own Wireless Printing applications. The source code for this application is included as part of the Wireless Printing SDK on the Intermec Developer’s Library CD. See the SDK User’s Manual for more information. S ActiveX Control Tools: This lists some of the CAB files that may be available with which to install ActiveX Control Tools. See the SDK Online Help for more information. S AXCommunication: Communication controls that transmit or receive messages from input connections. S AXFileTransfer: File transfer controls that transmit and receive files using the Trivial File Transfer Protocol (TFTP). S AXReaderCommand: Reader command functions that modify and retrieve configuration information from your 700 Color Computer. S AXVWedge: The virtual wedge control that retrieves scanned ADC data and sends it to the keyboard driver to interpret data as keyboard input. 700 Series Color Mobile Computer User’s Manual 357 Appendix A — Configurable Settings Utilities Control Panel Applet The Utilities control panel applet examines and modifies settings and operational modes of specific hardware and software on the 700 Color Computer, including the dock switch, registry storage, wakeup mask, and application launch keys. To access the settings from the 700 Color Computer, tap Start > Settings > the System tab > Utilities to access its control panel applet. Use the left and right arrows to scroll through the tabs along the bottom of the control panel applet, then tap a tab to access its menus. These tabs represent the following groups of settings or parameters: S Dock Switch (next paragraph) S Registry Save (page 359) S Wakeup Mask (page 360) S App Launch (page 361) Dock Switch From the 700 Color Computer, tap Start > Settings > the System tab > Utilities > the Dock Switch tab to access the Dock Switch control panel applet. Use this applet to control the position of the dock switch. This can be set either to a COM A (phone jack for a modem) position or to a COM B (serial) position. If switched to COM B and suspended, the terminal has the following behavior: S If the 700 Color Computer is on charge, the dock switch remains switched to COM B. S If the 700 Color Computer is off charge, the dock switch switches to COM A and remain in this position until the 700 Color Computer resumes charge. 358 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Registry Save From the 700 Color Computer, tap Start > Settings > the System tab > Utilities > the Registry Save tab to access the Registry Save control panel applet. For Windows Mobile 2003, the only medium available for saving the registry is the Flash File System (PSM). Registry data is stored in the “\Flash_File_Store\Registry” path. Check Enable Registry Storage to enable this function. To ensure that the 700 Color Computer restores the real-time clock after a cold-boot, check the Enable RTC Restore option. Note that this does not apply to the 730 Computer. 700 Color Screen 700 Series Color Mobile Computer User’s Manual 730 Screen 359 Appendix A — Configurable Settings Wakeup Mask From the 700 Color Computer, tap Start > Settings > the System tab > Utilities > the Wakeup Mask tab to access the Wakeup Mask control panel applet. This applet programs three scanner buttons and the A1 and A2 application keys to be “wakeup” or resume keys. That is, to prompt the 700 Color Computer to “wake up” or resume activity after going to “sleep” as a result of being inactive after a length of time. This information will remain between warm and cold boots. Check the appropriate box, then tap ok to apply your settings. Based on your setting, do the following to “wake up” the 700 Color Computer. If you select: Then do this on Numeric Keyboard Then do this on Alphanumeric Keyboard Middle Scanner Button Squeeze the button on the Scan Handle Squeeze the button on the Scan Handle Left Scanner Button Squeeze the left scanner button Squeeze the left scanner button Right Scanner Button Squeeze the right scanner button Squeeze the right scanner button GOLD + A1 (Application 1) Press [Gold] b a Press [Gold/White] c A GOLD + A2 (Application 2) Press [Gold] b 4 Press [Gold/White] c B 360 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings App Launch From the 700 Color Computer, tap Start > Settings > the System tab > Utilities , then scroll to the right to tap the App Launch tab to access the Application Launch control panel applet. This applet programs or maps two scanner buttons and four application keys to start up to six applications. Note that the left scanner button also acts as the record button. For 700 Color Computers with either a laser scanner or an imager, default mappings are shown in the following illustration. For 700 Color Computers without either a laser scanner or an imager, the default maps the Record, Calendar, Contacts, and Tasks applications the top four and the A3 and A4 buttons are ”unassigned” or available for two more applications. Note: Record, Calendar, Contacts, and Tasks are Pocket PC applications. See Chapter 2, “Windows Mobile 2003,” for more information about these applications. S To assign an application to a button, select an application from the applicable drop-down list box. S To assign a new application, select the “Add new application” option, which brings up an Open File dialog and browse SD or CF storage cards for new applications. S To disable or unmap a currently mapped application from a corresponding button, select “unassigned” from the applicable drop-down list. S To restore these buttons to their defaults, tap Defaults in the lower right corner. 700 Series Color Mobile Computer User’s Manual 361 Appendix A — Configurable Settings Note; You cannot map an application to more than one button. Should you assign the same application to two buttons, a verification prompt will appear after the second button to confirm whether you want to remap the application. If you tap Yes, the applet changes the first button to “unassigned” and map the application to the second button. Note: All changes are activated immediately upon selection. 362 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Wireless Network Control Panel Applet Note: See Chapter 4, “Network Support,” for information about the 802.11b or 802.11b/g radio module. About the Wireless Network Your wireless adapter (network interface card) connects to wireless networks of two types: infrastructure networks and ad-hoc networks. S Infrastructure networks get you onto your corporate network and the internet. Your 700 Color Computer establishes a wireless connection to an access point, which links you to the rest of the network. When you connect to a network via an access point, you are using the 802.11b or 802.11b/g infrastructure mode. S Ad-hoc networks are private networks shared between two or more clients, even with no access point. Each wireless network is assigned a name (or Service Set Identifier — SSID) to allow multiple networks to coexist in the same area without infringement. Intermec Technologies recommends using security measures with wireless networks to prevent unauthorized access to your network and to ensure your privacy of transmitted data. The following are required elements for secure networks: S Authentication by both the network and the user S Authentication is cryptographically protected S Transmitted data There are many schemes available for implementing these features. Terminology Below are terms you may encounter as you configure your wireless network: S CKIP (Cisco Key Integrity Protocol) This is Cisco’s version of the TKIP protocol, compatible with Cisco Airnet products. S EAP (Extensible Authentication Protocol) 802.11b or 802.11b/g uses this protocol to perform authentication. This is not necessarily an authentication mechanism, but is a common framework for transporting actual authentication protocols. Intermec Technologies provides a number of EAP protocols for you to choose the best for your network. 700 Series Color Mobile Computer User’s Manual 363 Appendix A — Configurable Settings S TKIP (Temporal Key Integrity Protocol) This protocol is part of the IEEE 802.11i encryption standard for wireless LANs., which provides per-packet key mixing, a message integrity check and a re-keying mechanism, thus overcoming most of the weak points of WEP. This encryption is more difficult to crack than the standard WEP. Weak points of WEP include: S No Installation Vector (IV) reuse protection S Weak keys S No protection against message replay S No detection of message tampering S No key updates S WEP (Wired Equivalent Privacy) encryption With preconfigured WEP, both the client 700 Color Computer and access point are assigned the same key, which can encrypt all data between the two devices. WEP keys also authenticate the 700 Color Computer to the access point — unless the 700 Color Computer can prove it knows the WEP key, it is not allowed onto the network. WEP keys are only needed if they are expected by your clients. There are two types available: 64-bit (5-character strings, 12345) (default) and 128-bit (13-character strings, 1234567890123). Enter these as either ASCII (12345) or Hex (0x3132333435). S WPA (Wi-Fi Protected Access) This is an enhanced version of WEP that does not rely on a static, shared key. It encompasses a number of security enhancements over WEP, including improved data encryption via TKIP and 802.11b or 802.11b/g authentication with EAP. WiFi Alliance security standard is designed to work with existing 802.11 products and to offer forward compatibility with 802.11i. 364 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Configuring Your Wireless Network To start 802.11b or 802.11b/g communications on the 700 Color Computer, tap Start > Settings > the System tab > Wireless Network to access the Profile Wizard for the 802.11b or 802.11b/g radio module. A profile contains all the information necessary to authenticate you to the network, such as login name, password or certificate, and protocols by which you are authenticated. You can have up to four profiles for different networks. For example, you may have different login names or passwords on different networks, or you may use a password on one network, and a certificate on another. Use the Profiles page to select and configure between the networking environments assigned to this 802.11b or 802.11b/g radio. S Profile: Tap the drop-down list to choose between four different profiles assigned to this unit, then tap Edit Select Profile, make the changes needed for this profile (starting on the next page), then tap OK to return to the Profiles page. S Enable Microsoft’s Wireless Zero Config Check this box to enable Microsoft’s Wireless Zero Config application. This effectively disables the Intermec software solution for 802.11b or 802.11b/g, including configuration via the CORE application and the Wireless Network control panel applet. 700 Series Color Mobile Computer User’s Manual 365 Appendix A — Configurable Settings Basic Use the Basic page to set the network type, name, and manage battery power for this profile. Tap ok or OK to return to the Profiles page. S Profile Label: Enter a unique name for your profile. S Network type: Tap the drop-down list to select either “Infrastructure” if your network uses access points to provide connectivity to the corporate network or internet; or “Ad-Hoc” to set up a private network with one or more participants. S Channel: If you selected “Ad-Hoc” for the network type, select the channel on which you are communicating with others in your network. There are up to 11 channels available. S SSID (Network Name): This assumes the profile name unless another name is entered in this field. If you want to connect to the next available network or are not familiar with the network name, enter “ANY” in this field. Consult your LAN administrator for network names. S Enable Power Management: Check this box to conserve battery power (default), or clear this box to disable this feature. 366 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Security The following are available from the 8021x Security drop-down list. Note that the last four methods are available if you have purchased the security package. Contact your Intermec representative for information. S None (below) S PEAP (page 370) S TLS (page 374) S TTLS (page 377) S LEAP (page 381) None Use “None” to disable 802.11b or 802.11b/g Security and enable either WEP or WPA-PSK encryption. To Disable 802.1x Security 1 Set 8021x Security as “None.” 2 Set Association to “Open.” 3 Set Encryption to “None.” 700 Series Color Mobile Computer User’s Manual 367 Appendix A — Configurable Settings To Enable WEP Encryption 1 Set 8021x Security as “None.” 2 Set Association to either “Open” if WEP keys are not required; or “Shared” when WEP keys are required for association. 3 Set Encryption to “WEP.” See page 364 for information about WEP encryption. 4 If you had set Association to “Shared,” then select a data transmission key from the Data TX Key drop-down list near the bottom of this screen, then enter the encryption key for that data transmission in the appropriate Key # field. 368 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings To Enable WPA Encryption Using a Preshared Key 1 Set 8021x Security as “None.” 2 Set Association to “WPA.” See page 364 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 364 for more information about TKIP. 4 Enter the temporal key as ASCII (12345) in the Pre-Shared Key field. 700 Series Color Mobile Computer User’s Manual 369 Appendix A — Configurable Settings PEAP (Protected EAP) This protocol is suitable for performing secure authentication against Windows domains and directory services. It is comparable to EAP-TTLS (see page 377), both in its method of operation and its security, though not as flexible. This does not support the range of inside-the-tunnel authentication methods supported by EAP-TTLS. Microsoft and Cisco both support this protocol. Use “PEAP” to configure the use of PEAP as an authentication protocol and to select “Open,” “WPA,” or “Network EAP” as an association mode. To Enable PEAP with an Open Association 1 Set 8021x Security as “PEAP.” 2 Set Association to “Open.” 3 Skip Encryption as it is automatically set to “WEP.” See page 364 for information about WEP encryption. 4 Enter your unique user name and password to use this protocol. Select Prompt for password to have the user enter this password each time to access the protocol; or leave Use following password as selected to automatically use the protocol without entering a password. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to assign an inner PEAP authentication and set options for server certificate validation and trust. See page 373 for more information. 370 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings To Enable PEAP with WPA Encryption 1 Set 8021x Security as “PEAP.” 2 Set Association to “WPA.” See page 364 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 364 for more information about TKIP. 4 Enter your unique user name and password to use this protocol. Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to assign an inner PEAP authentication and set options for server certificate validation and trust. See page 373 for more information. 700 Series Color Mobile Computer User’s Manual 371 Appendix A — Configurable Settings To Enable PEAP with Network EAP 1 Set 8021x Security as “PEAP.” 2 Set Association to “Network EAP.” See page 363 for information about EAP. 3 Set Encryption to either “WEP” or “CKIP.” See page 363 for information about CKIP and page 364 for information about WEP encryption. 4 Enter your unique user name and password to use this protocol. Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to assign an inner PEAP authentication and set options for server certificate validation and trust. See page 373 for more information. 372 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Additional Settings 1 Select an authentication method from the Inner PEAP Authentication drop-down list. EAP/MS-CHAP-V2 Authenticates against a Windows Domain Controller and other non-Windows user databases. This is Microsoft’s implementation of PEAP. EAP/Token Card Use with token cards. The password value entered is never cached. This is Cisco’s implementation of PEAP. EAP/MD5-Challenge Message Digest 5. A secure hashing authentication algorithm. 2 Check Validate Server Certificate to verify the identity of the authentication server based on its certificate when using TTLS or PEAP. 3 Enter the Common Names of trusted servers. Note that if these fields are left blank, the server certificate trust validation is not performed or required. 4 Click ok to return to the Security page. 700 Series Color Mobile Computer User’s Manual 373 Appendix A — Configurable Settings TLS (EAP-TLS) EAP-TLS is a protocol that is based on the TLS (Transport Layer Security) protocol widely used to secure web sites. This requires both the user and authentication server have certificates for mutual authentication. While cryptically strong, this requires corporations that deploy this to maintain a certificate infrastructure for all their users. Use “TLS” to configure the use of EAP-TLS as an authentication protocol, and select either “Open” or “WPA” as an association mode. To Enable TLS with an Open Association 1 Set 8021x Security as “TLS.” 2 Set Association to “Open.” 3 Skip Encryption as it is automatically set to “WEP.” See page 364 for information about WEP encryption. 4 Enter your unique Subject Name and User Name to use this protocol. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to set options for server certificate validation and trust. See page 376 for more information. 374 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings To Enable TLS with WPA Encryption 1 Set 8021x Security as “TLS.” 2 Set Association to “WPA.” See page 364 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.”See page 364 for more information about TKIP. 4 Enter your unique Subject Name and User Name as credentials for this profile. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to set options for server certificate validation and trust. See page 376 for more information. 700 Series Color Mobile Computer User’s Manual 375 Appendix A — Configurable Settings Additional Settings 1 Check Validate Server Certificate to verify the identity of the authentication server based on its certificate when using PEAP or TLS. 2 Enter the Common Names of trusted servers. Note that if these fields are left blank, the server certificate trust validation is not performed or required. 3 Click ok to return to the Security page. 376 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings TTLS (EAP-Tunneled TLS) This protocol provides authentication like EAP-TLS (see page 374) but does not require certificates for every user. Instead, authentication servers are issued certificates. User authentication is done using a password or other credentials that are transported in a securely encrypted “tunnel” established using server certificates. EAP-TTLS works by creating a secure, encrypted tunnel through which you present your credentials to the authentication server. Thus, inside EAP-TTLS there is another inner authentication protocol that you must configure via Additional Settings. Use “TTLS” to configure the use of EAP-TTLS as an authentication protocol, and select either “Open” or “WPA” as an association mode. To Enable TTLS with an Open Association (default configuration) 1 Set 8021x Security as “TTLS.” 2 Set Association to “Open.” 3 Skip Encryption as it is automatically set to “WEP.” See page 364 for information about WEP encryption. 4 Enter your unique user name and password to use this protocol. Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to assign an inner TTLS authentication and an inner EAP, and set options for server certificate validation and trust. See page 379 for more information. 700 Series Color Mobile Computer User’s Manual 377 Appendix A — Configurable Settings To Enable TTLS with WPA Encryption 1 Set 8021x Security as “TTLS.” 2 Set Association to “WPA.” See page 364 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 364 for more information about TKIP. 4 Enter your unique user name and password to use this protocol. Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 5 Tap Get Certificates to obtain or import server certificates. See page 380 for more information. 6 Tap Additional Settings to assign an inner TTLS authentication and an inner EAP, and set options for server certificate validation and trust. See page 379 for more information. 378 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Additional Settings 1 Select an authentication protocol from the Inner TTLS Authentication drop-down list: PAP Password Authentication Protocol. A simple authentication protocol that sends security information in the clear. CHAP Challenge Handshake Authentication Protocol. Use of Radius to authenticate a terminal without sending security data in the clear. Authenticates against non-Windows user databases. You cannot use this if authenticating against a Windows NT Domain or Active Directory. MS-CHAP; MS-CHAP-V2 Authenticates against a Windows Domain Controller and other non-Windows user databases. PAP/Token Card Use with token cards. The password value entered is never cached. EAP Extensible Authentication Protocol. See page 363 for information about EAP. 2 If you select “EAP” for the inner authentication protocol, then an inner EAP protocol from the Inner EAP drop-down list. 3 Enter the Common Names of trusted servers. Note that if these fields are left blank, the server certificate trust validation is not performed or required. 4 Check Validate Server Certificate to verify the identity of the authentication server based on its certificate when using TTLS, PEAP, and TLS. 5 Enter the Anonymous EAP-TTLS Name as assigned for public usage. Use of this outer identity protects your login name or identity. 6 Click ok to return to the Security page. 700 Series Color Mobile Computer User’s Manual 379 Appendix A — Configurable Settings To Get Certificates Certificates are pieces of cryptographic data that guarantee a public key is associated with a private key. They contain a public key and the entity name that owns the key. Each certificate is issued by a certificate authority. Use this page to import a certificate onto the 700 Color Computer. Root Certificates 1 Tap the <<< button next to the Import Root Certificate field to select the root certificate (DER-encoded .CER file) to import. 2 Click Import Root Cert to install the selected certificate. User Certificate 1 Tap the <<< button next to the Certificate Path field to select the user certificate (DER-encoded .CER file without the private key) to import. 2 Tap the <<< button next to the Key Path field to select the private key (.PVK file) which corresponds to the user certificate chosen in step 1. 3 Tap Import User Cert to install the selected certificate. Web Enrollment Tap Web Enrollment to obtain a user certificate over the network from an IAS Server. Tap ok to return to the Security page. 380 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings LEAP (Cisco Lightweight EAP) LEAP is the Cisco Lightweight version of EAP. See page 363 for information about EAP. Use “LEAP” to configure the use of LEAP as an authentication protocol, select “Open,” “WPA,” or “Network EAP” as an association mode, or assign Network EAP. Note that this defaults to the Network EAP. To Enable LEAP with an Open Association 1 Set 8021x Security as “LEAP.” 2 Set Association to “Open.” 3 Skip Encryption as it is automatically set to “WEP.” See page 364 for information about WEP encryption. 4 Enter your unique User Name to use this protocol. 5 Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 700 Series Color Mobile Computer User’s Manual 381 Appendix A — Configurable Settings To Enable LEAP with WPA Encryption 1 Set 8021x Security as “LEAP.” 2 Set Association to “WPA.” See page 364 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 364 for more information about TKIP. 4 Enter your unique User Name to use this protocol. 5 Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 382 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings To Enable LEAP with Network EAP 1 Set 8021x Security as “LEAP.” 2 Set Association to “Network EAP,” an EAP protocol for the network. See page 363 for information about EAP. 3 Set Encryption to either “WEP” or “CKIP.” See page 363 for information about CKIP and page 364 for information about WEP encryption. 4 Enter your unique User Name to use this protocol. 5 Select Prompt for password to have the user enter this password each time to access the protocol, or leave Use following password as selected to automatically use the protocol without entering a password. 700 Series Color Mobile Computer User’s Manual 383 Appendix A — Configurable Settings Advanced Use this page to configure additional settings for this profile. Tap ok or OK to return to the Profiles page. S Detect Rogue APs: Wireless NICs and APs associate based on the SSID configured for the NIC. Given an SSID, the BSSID with the strongest signal is often chosen for association. After association, 802.1x authentication may occur and during authentication credentials to uniquely identify a user — these are passed between the NIC and the AP. The base 802.1x technology does not protect the network from “rogue APs.” These can mimic a legitimate AP to authentication protocols and user credentials. This provides illegal users ways to mimic legitimate users and steal network resources and compromise security. Check this box to detect and report client behavior suspected of being rogue APs. Once a rouge AP is detected, your 700 Series Computer no longer associates with that AP until you perform a warm boot. Clear this box to solve AP connection problems that result when an AP gets put on the rogue AP list due to inadvertant failed authentications and not because it is a real rouge. S Enable mixed cell: Mixed cell is a profile-dependent setting. If enabled, you can connect to mixed cell without using WEP, then you can query the cell to determine whether you can use encryption. S Enable Logging: Check this box to log what activity incurs for this profile. 384 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Other Configurable Parameters The following parameters can be configured by sending reader commands through the network or from an application. See “Using Reader Commands” on page 387 for more information. Audio Volume Changes the volume of all audio signals. SNMP OID 1.3.6.1.4.1.1963.15.3.1.3.0 Options (Syntax Data for Reader Commands) Off Very quiet Quiet Normal (default) Loud Very loud Automatic Shutoff Sets the length of time the 700 Color Computer remains on when there is no activity. When you turn on the 700 Color Computer, it either resumes exactly where it was when you turned it off or boots and restarts your application. SNMP OID 1.3.6.1.4.1.1963.15.11.3.0 Options (Syntax Data for Reader Commands) 1 minute 2 minutes 3 minutes (default) 4 minutes 5 minutes 700 Series Color Mobile Computer User’s Manual 385 Appendix A — Configurable Settings Backlight Timeout Sets the length of time that the display backlight remains on. If you set a longer timeout value, you use the battery power at a faster rate. SNMP OID 1.3.6.1.4.1.1963.15.13.1.0 Options (Syntax Data for Reader Commands) 10 30 60 120 180 240 300 10 seconds 30 seconds 1 minute (default) 2 minutes 3 minutes 4 minutes 5 minutes Date/Time Sets the current date and time. SNMP OID Date: Time: 1.3.6.1.4.1.1963.15.501.2.1.0 1.3.6.1.4.1.1963.15.501.2.2.0 Options (Syntax Data for Reader Commands) Date Year Month Day Hour Minute Second Time 0000–9999 (1999) 1–12 (6) 1–31 (1) 0–23 (0) 0–59 (00) 0–59 (00) Key Clicks Enables or disables the keypad clicks. The 700 Color Computer emits a click each time you press a key or decode a row of a two-dimensional symbology. SNMP OID 1.3.6.1.4.1.1963.15.12.1.0 Options (Syntax Data for Reader Commands) 386 Disable clicks Enable soft key clicks Enable loud key clicks (default) 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Using Reader Commands After the 700 Color Computer is connected to your network, you can send the 700 Color Computer a reader command from an application to perform a task, such as changing the time and date. Some reader commands temporarily override the configuration settings and some change the configuration settings. Change Configuration The Change Configuration command must precede any configuration command. If you enter a valid string, the 700 Color Computer configuration is modified and the computer emits a high beep. To send the Change Configuration command through the network, use the $+ [command] syntax where command is the two-letter command syntax for the configuration command followed by the value to be set for that command. You can also make changes to several different commands by using the $+ [command]...[command n] syntax. There are seven configuration command settings that can be changed in this way. See each command for information on respective acceptable “data” values. Command Syntax Audio Volume BVdata Automatic Shutoff EZdata Backlight Timeout DFdata Key Clicks KCdata Virtual Wedge Grid AFdata Virtual Wedge Postamble AEdata Virtual Wedge Preamble ADdata Note: See pages 336 and 338 for more information about the Virtual Wedge Postamble and Virtual Wedge Preamble commands. Example 1 To change the Beep Volume to Off, you can send this string to the 700 Color Computer through the network: $+BV0 where: $+ Indicates Change Configuration. BV Specifies the Audio Volume parameter. Specifies a value of Off. Example 2 To change the Beep Volume to Very Quiet and the Virtual Wedge Grid to 123: $+BV1AF123 where: $+ Indicates Change Configuration BV1 Specifies Audio Volume, set to Very Quiet (1) AF123 Specifies Virtual Wedge Grid, set to a value of 123. 700 Series Color Mobile Computer User’s Manual 387 Appendix A — Configurable Settings Set Time and Date This command sets the date and time on the 700 Color Computer. The default date and time is June 1, 1999 at 12:00 AM. From the network, send the following: /+ yyyymmddhhmmss where acceptable values for the date are: yyyy mm dd hh mm ss 0000–9999 01–12 01–31 00–23 00–59 00–59 Year Month of the year Day of the month Hour Minutes Seconds You can also set the time and date by using Configuration Management in Unit Manager, or by using the Clock control panel applet in the Settings menu. To access this control panel applet, tap Start > Settings > the System tab > the Clock icon to access its control panel applet. 388 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Configuration Bar Codes You can change some settings on your 700 Color Computer by scanning the following Code 39 bar code labels. S You can use the Data Collection control panel to set the three Virtual Wedge parameters (starting on page 335). Note: When you use a bar code creation utility to make a scannable bar code label, the utility probably adds opening and closing asterisks automatically. Asterisks are included here for translation purposes. Audio Volume Note: The Audio Volume parameter information is on page 385. Turn Audio Off *$+BV0* *$+BV0* Set Audio Volume to very quiet *$+BV1* *$+VB1* Set Audio Volume to quiet *$+BV2* *$+BV2* Set Audio Volume to normal (default) *$+BV3* *$+BV3* Set Audio Volume to loud *$+BV4* *$+BV4* Set Audio Volume to very loud *$+BV5* *$+BV5* 700 Series Color Mobile Computer User’s Manual 389 Appendix A — Configurable Settings Automatic Shutoff Note: The Automatic Shutoff parameter information is on page 385. Set Automatic Shutoff to 1 minute *$+EZ1* *$+EZ1* Set Automatic Shutoff to 2 minutes *$+EZ2* *$+EZ2* Set Automatic Shutoff to 3 minutes (default) *$+EZ3* *$+EZ3* Set Automatic Shutoff to 4 minutes *$+EZ4* *$+EZ4* Set Automatic Shutoff to 5 minutes *$+EZ5* *$+EZ5* Backlight Timeout Note: The Backlight Timeout parameter information is on page 386. Backlight Timeout 10 seconds *$+DF10* *$+DF10* Backlight Timeout 30 seconds *$+DF30* *$+DF30* Backlight Timeout 1 minute (default) *$+DF60* *$+DF60* 390 700 Series Color Mobile Computer User’s Manual Appendix A — Configurable Settings Backlight Timeout 2 minutes *$+DF120* *$+DF120* Backlight Timeout 3 minutes *$+DF180* *$+DF180* Backlight Timeout 4 minutes *$+DF240* *$+DF240* Backlight Timeout 5 minutes *$+DF300* *$+DF300* Key Clicks Note: The Key Clicks parameter information is on page 386. Disable key clicks *$+KC0* *$+KC0* Enable soft key clicks *$+KC1* *$+KC1* Enable loud key clicks (default) *$+KC2* *$+KC2* 700 Series Color Mobile Computer User’s Manual 391 Appendix A — Configurable Settings Virtual Wedge Grid, Preamble, Postamble The following parameters are user-configurable strings. Refer to a full ASCII chart for more information. Grid For Virtual Wedge Grid, the first part of the bar code would be the following, which can include a string of up to 240 characters. Parameter information starts on page 340. *$+AF *$+AF Preamble For Virtual Wedge Preamble, the first part of the bar code would be below, followed by a string of up to 31 characters (no ) and an asterisk. Default is no characters. Parameter information is on page 336. *$+AD *$+AD Postamble For Virtual Wedge Postamble, the first part of the bar code would be below, followed by a string of up to 31 characters (no ) and an asterisk. Default is no characters. Parameter information is on page 338. *$+AE *$+AE 392 700 Series Color Mobile Computer User’s Manual B Bar Code Symbologies This appendix contains a brief explanation of some of the bar code symbologies that the 700 Series Color Mobile Computer decodes and explains some of the general characteristics and uses of these bar code types. The 700 Color Computer recognizes eleven of the most widely used bar code symbologies. With bar code symbologies, like languages, there are many different types. A bar code symbology provides the required flexibility for a particular inventory tracking system. A symbology may be for particular industries, such as food and beverage, automotive, railroad, or aircraft. Some of these industries have established their own bar code symbology because other symbologies did not meet their needs. Without going into great detail on the bar code structure, note that no two products use the same bar code. Each product gets a unique bar code. Industries that use a particular type of bar code symbology have formed regulating committees or are members of national institutes that issue and keep track of bar codes. This ensures that each organization that contributes to a particular industry conforms to its standard. Without some form of governing body, bar coding would not work. Note: “700 Color” pertains to 740, 741, 750, 751, 760, and 761 Computers unless otherwise noted. 700 Series Color Mobile Computer User’s Manual 393 Appendix B — Bar Code Symbologies Codabar Codabar was for retail price-labeling systems. Today it is widely accepted by libraries, medical industries, and photo finishing services. Codabar is a discrete, self-checking code with each character represented by a stand-alone group of four bars and three intervening spaces. Four different start or stop characters get defined and designated “a”, “b”, “c”, and “d”. These start and stop characters are constructed using one wide bar and two wide spaces. A complete Codabar symbol begins with one of the start or stop characters followed by some number of data characters and ending in one of the start or stop characters. Any of the start or stop characters may be used on either end of the symbol. It is possible to use the 16 unique start or stop combinations to identify label type or other information. Since Codabar is variable-length, discrete, and self-checking, it is a versatile symbology. The width of space between characters is not critical and may vary significantly within the same symbol. The character set consists of “0” through “9”, “-”, “$”, “:”, “/”, “.”, and “+”. The specific dimensions for bars and spaces in Codabar optimize performance of certain early printing and reading equipment. Codabar has 18 different dimensions for bar and space widths. So many different dimensions often result in labels printed out of specification and cause Codabar printing equipment to be more expensive. Code 11 Code 11 satisfies the requirements for a very high density, discrete numeric bar code. The name Code 11 derives from 11 different data characters that can be represented, in addition to a start or stop character. The character set includes the 10 digits and the dash symbol. Each character is represented by a stand-alone group of three bars and two intervening spaces. Although Code 11 is discrete, it is not self-checking. A single printing defect can transpose one character into another valid character. One or two check digits obtain data security. The specifications for Code 11 suggest that this code should have a narrow element width of 7.5 mils. This results in an information density of 15 characters per inch. Code 39 Code 39 (C39) is the most widely used symbology among the industrial bar codes. Most major companies, trade associations, and the federal government find this code to fit their needs. The main feature of this symbology is the ability to encode messages using the full alphanumeric character set, seven special characters, and ASCII characters. Programming for this symbology can be for any length that the application requires. The application program for the 700 Color Computer handles symbology at least one character but no more than 32 characters in length. 394 700 Series Color Mobile Computer User’s Manual Appendix B — Bar Code Symbologies When programming the computer for Code 39, it is important to set the symbology limit as close as possible (minimum and maximum bar code lengths being scanned). Doing so keeps the computer bar code processing time to a minimum and conserves battery power. Bar code readers can respond to Uniform Symbology Specification symbols in non-standard ways for particular applications. These methods are not for general applications, because of the extra programming required. Code 39 Full ASCII is one example of non-standard code. Note: See page 389 to scan several Code 39 bar code labels available to change settings on your 700 Color Computer. Encoded Code 39 (Concatenation) If the first data character of a symbol is a space, the reader may be programmed to append the information contained in the remainder of the symbol to a storage buffer. This operation continues for all successive symbols that contain a leading space, with messages being added to the end of previously stored ones. When a message is read which does not contain a leading space, the contents are appended to the buffer, the entire buffer is transmitted, and the buffer is cleared. Encoded Code 39 (Full ASCII) If the bar code reader is programmed for the task, the entire ASCII character set (128 characters) could be coded using two character sequences: a symbol (“$”,“.”,“%”,“/”) followed by a letter of the alphabet. Code 93 The introduction of Code 93 provided a higher density alphanumeric symbology designed to supplement Code 39. The set of data characters in Code 93 is identical with that offered with Code 39. Each character consists of nine modules arranged into three bars and three spaces. Code 93 uses 48 of the 56 possible combinations. One of these characters, represented by a square, is reserved for a start or stop character, four are used for control characters, and the remaining 43 data characters coincide with the Code 39 character set. An additional single module termination bar after the stop character concludes the final space. Code 93 is a variable length, continuous code that is not self-checking. Bar and spaces widths may be one, two, three, or four modules wide. Its structure uses edge-to-similar-edge decoding. This makes the bar code immune to uniform ink spread, which allows liberal bar width tolerances. Code 93 uses two check characters. Its supporters believes this makes it the highest density alphanumeric bar code. The dual check digit scheme provides for high data integrity. All substitution errors in a single character are detected for any message length. 700 Series Color Mobile Computer User’s Manual 395 Appendix B — Bar Code Symbologies Code 128 Code 128 (C128) is one of the newest symbologies used by the retail and manufacturing industries. It responds to the need for a compact alphanumeric bar code symbol that could encode complex product identification. The fundamental requirement called for a symbology capable of being printed by existing data processing printers (primarily dot-matrix printers) that produce daily, work-in-progress, job, and product traceability documents. The ability to print identification messages between 10 and 32 characters long, on existing forms and labels deemed an important requirement. Code 128 uniquely addresses this need as the most compact, complete, alphanumeric symbology available. Additionally, the Code 128 design with geometric features, improves scanner read performance, does self-checking, and provides data message management function codes. Code 128 encodes the complete set of 128 ASCII characters without adding extra symbol elements. Code 128 contains a variable-length symbology and the ability to link one message to another for composite message transmission. Code 128, being a double-density field, provides two numeric values in a single character. Code 128 follows the general bar code format of start zone, data, check digit, stop code, and quiet zone. An absolute minimum bar or space dimension of nine mils (0.010 inch minimum nominal ± 0.001 inch tolerance) must be maintained. Characters in Code 128 consist of three bars and three spaces so that the total character set includes three different start characters and a stop character. UCC/EAN-128 Shipping Container Labeling is a versatile tool that can ease movement of products and information. The Shipping Container Labeling bar code can take any form and usually has meaning only within the company or facility where applied. Because this random data can get mistaken later for an industry standard code format, the UCC and EAN chose a symbology uniquely identified from these other bar codes. This standard is for maximum flexibility, to handle the diversity of distribution in global markets by cost efficiency. The UCC/EAN-128 Container Labeling specification calls for a FUNC1 to immediately follow the bar code’s start character. FUNC1 also follows any variable-length application field. The specification also calls for the computer to send “]C1” for the first FUNC1. The specification requires that the computer send a “ ” (hex 1D) for subsequent FUNC1 codes in the bar code. Because “ ” is not compatible with computer emulation data streams, the Uniform Code Council has been asked to change the specification. This change is made to send the same three character sequence “]C1” to identify the embedded FUNC1 codes. 396 700 Series Color Mobile Computer User’s Manual Appendix B — Bar Code Symbologies This implementation should provide for clean application coding by identifying the same sequences for the same scanned codes. If the communication of Norand bar code types is enabled, the Shipping Container Label codes precede with a “J”. These strings will appear on the computer display. The application may have to allow for strings longer than 48 characters (maximum length indicated in the specification). Actual length variance depends on the number of variable-length data fields. Allowing for 60 characters should be sufficient. Within the Code 128 specification, the computer can link bar codes together. If this is to happen, allow for more characters (computer limit is 100 characters). The Application Identifier Standard, that is part of the UCC/EAN Shipping Label concept, complements, rather than replaces, other UCC/EAN standards. Most UCC/EAN standards primarily identify products. Several industries expressed the need to standardize more than product identification. The UCC/EAN Code 128 Application Identifier Standard supplies this tool. The standard adds versatility for inter-enterprise exchanges of perishability dating, lot and batch identification, units of use measure, location codes, and several other information attributes. For more detailed information on Code 128 UCC/EAN Shipping Label bar code and Application Identifier Standard, refer to the UCC/EAN-128 Application Identifier Standard specification. Data Matrix Data Matrix is a high density 2D matrix code that can store a large amount of information. It has excellent error correction abilities and is mostly used for marking and tracking parts. Data Matrix can store from 1 to about 2000 characters. The symbol is square and can range from 0.001 inch per side up to 14 inches per side. As an example of density, 500 numeric-only characters can encode in a 1-inch square using a 24-pin dot matrix printer. Data Matrix is used to encode product and serial number information on electrical rating plates; to mark of surgical instruments in Japan; to identify lenses, circuit boards, and other items during manufacturing. EAN (European Article Numbering) EAN symbology is similar to UPC symbology, except that it contains 13 characters and uses the first two to identify countries. The EAN symbology is used in the retail environment throughout most of Europe. Though similar to UPC symbology, these are not interchangeable. 700 Series Color Mobile Computer User’s Manual 397 Appendix B — Bar Code Symbologies I 2 of 5 (Interleaved) I 2 of 5 (Interleaved 2 of 5 Code) is an all-numeric symbology, widely used for warehouse and heavy industrial applications. Its use has been particularly prevalent in the automobile industry. The I 2 of 5 symbology can be placed on smaller labels than what the standard UPC symbology requires. I 2 of 5 also provides a little more flexibility on the type of material it can print on. Interleaved 2 of 5 Code has its name because of the way the bar code is configured. I 2 of 5 bars and spaces both carry information. The bars represent the odd number position digits, while spaces represent the even number position digits. The two characters are interleaved as one. Messages encoded with this symbology have to use an even number of characters since two numeric characters always get interleaved together. Matrix 2 of 5 Matrix 2 of 5 is a derivitive of Code 11 and is a linear bar code that is only read by linear imagers. It is limited to the ten digits and start/stop character. Discrete but not self-checking. Matrix 2 of 5 is used with a single Mmodulo 10 check digit. Compared with Code 11 (using two check digits) and the other industrial symbologies, Matrix 2 of 5 is somewhat more subject to substitution errors and offers no particular advantage. MaxiCode MaxiCode is a fixed-size code which holds up to 93 data characters. The symbol is composed of a central bulls-eye locator and offset rows of hexagonal elements; the overall dimensions of the symbol are approximately 1.11 x 1.054 inches. Each element measures 0.035 x 0.041 inches. Created by United Parcel Service, the MaxiCode symbol was designed for quick automated scanning of packages on high-speed conveyor lines (special cameras can read a MaxiCode on a carton travelling at up to 500 feet per minute). PDF417 The PDF417 symbology is a stacked 2D symbology that allows you to scan across rows of code. Each row consists of start/stop characters, row identifiers, and symbol characters, which consist of four bars and four spaces each and contain the actual data. This symbology uses error correction symbol characters appended at the end to recover loss of data. PDF417 can store up to about 1800 printable ASCII characters or 1100 binary characters per symbol. The symbol is rectangular; the shape of the symbol can be adjusted to some extent by setting the width and allowing the height to grow with the data. It is also possible to break large amounts 398 700 Series Color Mobile Computer User’s Manual Appendix B — Bar Code Symbologies of data into several PDF417 symbols which are logically linked. There is no theoretical limit on the amount of data that can store in a group of PDF417 symbols. The capacity of PDF417 can be helpful in applications where the data must travel with the labeled item, where a host database is not always available for quick look-up. PDF417 is used for hazardous materials labeling; storing technical specifications, and calibration data on electronic instruments; encoding fingerprints and photographs on the backs of drivers’ licenses. The maximum data density is determined by the smallest elements which can be reliably printed and scanned. Using the smallest recommended element size of 0.0075 inch wide and 0.010 inch high, the maximum data density in the binary mode is 686 bytes per square inch (106.2 bytes per square centimeter). In the printable ASCII mode the density is 1144 characters per square inch (177.2 characters per square centimeter). Micro PDF417 Micro PDF417 is derived from PDF417. The code has a limited set of symbol sizes and a fixed level of error correction for each symbol size. Module dimensions are user-specified so that the symbol may be printed with a variety of printers. The symbology allows up to 150 bytes, 250 alphanumeric characters, or 366 numeric digits to be stored. This is done by specifying one of three compaction modes: data, text or numeric. Text Compaction mode permits all printable ASCII characters to be encoded (values 32 to 126 inclusive) as well as selected control characters. Byte Compaction mode permits all 256 possible 8-bit byte values to be encoded. This includes all ASCII characters value 0 to 127 inclusive and provides for international character set support Micro PDF417 is designed for applications where the symbol must be smaller than PDF417 will allow. Plessey Plessey finds its origin in the pulse width modulated (PWM) code developed in England. It is widely used for shelf markings in grocery stores. Pulse width modulated codes represent each bit of information by a bar and space pair. A zero bit consists of a narrow bar followed by a wide space, while a one bit consists of a wide bar followed by a narrow space. It is mainly a numeric symbology (0-9) with six extra characters available for assigning any symbol or letter desired. Plessey codes employ a variety of check characters and a polynomial-based Cyclic Redundancy Check (CRC). For start and stop characters, Plessey employs a 1101 and previously used a 0101. This symbology is very limited about what information can be encoded. It is not considered for new applications. 700 Series Color Mobile Computer User’s Manual 399 Appendix B — Bar Code Symbologies MSI Code (Variant of Plessey) The MSI Plessey bar code is a variant of the Plessey bar code. It is a pulsewidth modulated non-self checking code, and is used primarily in store shelf labeling. Each character consists of eight elements, four bars and four spaces. The character set includes the digits 0 through 9. A Modulo 10 checksum is appended to the end of the code. For start and stop checks, MSI employs a single bit pair of 1 as a start symbol and a single bit pair of 0 as a stop symbol. MSI reverses the 1-2-4-8 BCD pattern for bit pair weighting to 8-6-2-1. QR Code (Quick Response Code) QR Code is a 2D matrix symbology containing dark and light square data modules. It has position detection patterns on three of its four corners and features direct encodation of the Japanese Kana-Kanji character set. A 2D imaging device such as a CCD camera is necessary to scan the symbology. QR Code is designed with selectable levels of error correction. It supports industry standard escape sequences to define international code pages and special encodation schemes. QR Code is used for small item marking applications using a wide variety of printing and marking technologies. This document includes descriptions of the character encodation, symbol structure, reference decode algorithm, and symbol quality measurements for QR Code. S 2 of 5 (Standard 2 of 5) The code S 2 of 5 (Standard 2 of 5 Code) is designed primarily for: S Warehouse inventory handling S Identification of photo finishing envelopes S Airline tickets S Baggage and cargo handling The code S 2 of 5 is simple and straightforward. All information is contained in the widths of the bars, with the spaces serving only to separate the individual bars. Bars can either be wide or narrow, and the wide bars are usually three times the widths of the narrow bars. Spaces may be any reasonable width but are typically equal to the narrow bars. Narrow bars are identified as zero bits and wide bars as one bits. Remember the code structure by associating the bar positions from left to right with weighting factors 1, 2, 4, 7, and parity. Exceptions to this rule are zero, start, and stop. This code is a discrete code, since the white spaces between the characters are not part of the code. Because the white spaces carry no information, their dimensions are not critical. The S 2 of 5 code is self-checking, meaning a scanner passing through a printing void would detect the proper ratio of wide bars to total bars. When the scanner spots an error, a non-read will occur. 400 700 Series Color Mobile Computer User’s Manual Appendix B — Bar Code Symbologies Telepen Telepen was devised by George Sims, Managing Director of SB Electronic Systems Limited, in early 1972, this is the only symbology to directly represent the full ASCII character set without shift characters.Telepen carries the double-density numeric-only mode and is very compact. The Telepen symbol is up to 8 ASCII characters or16 digit per inch, and is easy to print. It has a fixed 3:1 ratio, with a tolerance at least 0.4x. This symbology is extremely secure, with negligible risk of misreading. It is supported by most leading manufacturers. UPC (Universal Product Code) The UPC (Universal Product Code) is the symbology used throughout the grocery and retail industries. This bar code symbology contains two pieces of numerical information encoded on the bar code, producer identification, and product identification information. The UPC symbol is 12 characters long. The first character of the UPC symbol is a number system character, such as “0” for grocery items and “3” for drug- and health-related items. The UPC symbology is for retail environments such as grocery stores, convenience stores, and general merchandise stores. Some retail items are so small that a standard UPC bar code cannot fit on the packaging. When this occurs there is a permitted shorter version of the UPC symbology, referred to as UPC-E. UPC-E is six characters long (eight including number system and check digit), approximately half the size of a standard UPC bar code. 700 Series Color Mobile Computer User’s Manual 401 Appendix B — Bar Code Symbologies 402 700 Series Color Mobile Computer User’s Manual I Index The Classes and Functions Index covers classes and functions for the 700 Series Color Mobile Computer. The General Index covers all topics. Those in italics are figures, those in bold are tables. The Files Index is to assist you in locating descriptions for device drivers, applications, utilities, batch files, or other files within this publication. 700 Series Color Mobile Computer User’s Manual 403 Index Classes and Functions add_registry_section, [AddReg] flags, 224 registry_root_string, 224 value_name, 224 AddReg, [DefaultInstall], 220 [AddReg], add_registry_section flags, 224 registry_root_string, 224 value_name, 224 AddWep(), 270 ANT_DIVERSITY, GetDiversity(), 263 ANT_PRIMARY, GetDiversity(), 263 ANT_SECONDARY, GetDiversity(), 263 AppName, [CEStrings], 217 Asset management, DeviceURL parameter, 235 Basic connect/disconnect functions, 260 BlockSize, FTP Server, 235 BuildMax, [CEDevice], 218 BuildMin, [CEDevice], 218 [CEDevice] BuildMax, 218 BuildMin, 218 ProcessorType, 218 UnsupportedPlatforms, 218 VersionMax, 218 VersionMin, 218 CESelfRegister, [DefaultInstall], 220 CESetupDLL, [DefaultInstall], 220 CEShortcuts, [DefaultInstall], 220 [CEShortcuts], shortcut_list_section shortcut_filename, 225 shortcut_type_flag, 225 target_file/path, 225 target_file_path, 225 CESignature [SourceDiskNames], 220 [Version], 216 [CEStrings] AppName, 217 InstallDir, 217 ClassID field values VN_CLASS_ASIC, 244 VN_CLASS_BOOTSTRAP, 244 VN_CLASS_KBD, 244 CloseHandle() DTR printing, 196, 197 IrDA printing, 190 NPCP printing, 191, 192 404 Cold boot, IOCTL_HAL_COLDBOOT, 252 ConfigureProfile(), 275 Copyfiles, [DefaultInstall], 220 [CopyFiles], file_list_section destination_filename, 223 flags, 223 source_filename, 223 CreateEvent(), 286 CreateFile() DTR printing, 196, 197 IrDA printing, 190 NPCP printing, 191, 192 [DefaultInstall] AddReg, 220 CESelfRegister, 220 CESetupDLL, 220 CEShortcuts, 220 Copyfiles, 220 Deprecated functions, 280 DeregisterDevice(), 191 DTR printing, 196 [DestinationDirs], file_list_section, 222 DeviceIOControl(), 258 DTR printing, 196 NPCP printing, 191 DeviceIoControl(), NPCP printing, 192, 193 DeviceName, FTP Server, 235 DeviceURL, FTP Server, 235 disk_ordinal, [SourceDiskNames], 220 DllRegisterServer, 220 DllUnregisterServer, 220 EnableSuppLogging(), 279 EnableWep(), 270 EnableZeroConfig(), 276 EncryptionStatus(), 271 EncryptWepKeyForRegistry(Deprecated), 280 ERROR_INSUFFICIENT_BUFFER IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 ERROR_INVALID_PARAMETER IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 File Transfer Protocol. See FTP file_list_section [CopyFiles] destination_filename, 223 flags, 223 source_filename, 223 [DestinationDirs], 222 filename, [SourceDiskFiles], 221 700 Series Color Mobile Computer User’s Manual Index FTP client, 237 configurable parameters, 235 BlockSize, 235 DeviceName, 235 DeviceURL, 235 PauseAtStartup, 236 FTPDCMDS subdirectory, 239 RTC 959, 239 server, 237 server requests CDUP, 237 CWD, 237 DELE, 237 HELP, 237 LIST, 237 MKD, 237 MODE, 237 NLST, 237 NOOP, 237 PASS, 237 PWD, 237 QUIT, 237 RETR, 237 RMD, 237 RNFR, 237 RNTO, 237 SITE, 238 SITE ATTRIB, 238 SITE BOOT, 238 SITE COPY, 238 SITE EKEY, 239 SITE EVAL, 239 SITE EXIT, 238 SITE GVAL, 239 SITE HELP, 238 SITE KILL, 238 SITE LOG, 238 SITE PLIST, 238 SITE PVAL, 239 SITE RUN, 238 SITE STATUS, 239 SITE TIMEOUT, 239 STOR, 237 SYST, 237 TYPE, 237 USER, 237 XCUP, 237 XCWD, 237 XMKD, 237 XPWD, 237 XRMD, 237 stopping server from application, 240 support, 237 web browsers, 239 GetAssociationStatus(), 261 GetAuthenticationMode(), 262 GetBSSID(), 262 700 Series Color Mobile Computer User’s Manual GetCCXStatus(), 269 GetCurrentDriverName(), 279 GetDiversity(), 263 GetLinkSpeed(), 263 GetMac(), 264 GetMedia(Deprecated), 280 GetMedium(Deprecated), 280 GetNetworkMode(), 264 GetNetworkType(), 265 GetNicStats(Deprecated), 280 GetPowerMode(), 266 GetRadioIpAddress(), 269 GetRSSI(), 266 GetRTSThreshold(Deprecated), 280 GetSSID(), 265 GetTXPower(), 267 GetWepStatus(), 268 HAL, verion of Pocket PC IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_OAL_VERINFO, 250 Helper functions, 275 ID field values IOCTL_HAL_ITC_READ_PARM ITC_NVPARM_80211_INSTALLED, 245 ITC_NVPARM_80211_RADIOTYPE, 245 ITC_NVPARM_ANTENNA_DIVERSITY, 244 ITC_NVPARM_BLUETOOTH_INSTALLED, 246 ITC_NVPARM_CONTRAST, 244 ITC_NVPARM_DISPLAY_TYPE, 244 ITC_NVPARM_ECN, 244 ITC_NVPARM_EDBG_SUBNET, 244 ITC_NVPARM_EDG_IP, 244 ITC_NVPARM_ETHERNET_ID, 243 ITC_NVPARM_INTERMEC_DATACOLLECTION_HW, 245 ITC_NVPARM_INTERMEC_DATACOLLECTION_SW, 245 ITC_NVPARM_INTERMEC_SOFTWARE_CONTENT, 244 ITC_NVPARM_LAN9000_INSTALLED, 246 ITC_NVPARM_MANF_DATE, 243 ITC_NVPARM_MCODE, 244 ITC_NVPARM_RTC_RESTORE, 245 ITC_NVPARM_SERIAL_NUM, 243 ITC_NVPARM_SERIAL2_INSTALLED, 246 ITC_NVPARM_SERVICE_DATE, 243 ITC_NVPARM_SIM_PROTECT_HW_INSTALLED, 246 ITC_NVPARM_SIM_PROTECT_SW_INSTALLED, 246 ITC_NVPARM_VERSION_NUMBER, 244 ITC_NVPARM_VIBRATE_INSTALLED, 246 ITC_NVPARM_WAN_FREQUENCY, 245 ITC_NVPARM_WAN_INSTALLED, 245 ITC_NVPARM_WAN_RADIOTYPE, 245 405 Index ITC_NVPARM_WAN_RI, 244 IOCTL_HAL_ITC_WRITE_SYSPARM ITC_ DOCK_SWITCH, 248 ITC_ WAKEUP_MASK, 248 ITC_AMBIENT_FRONTLIGHT, 248 ITC_AMBIENT_KEYBOARD, 248 ITC_REGISTRY_SAVE_ENABLE, 248 IDNA DeviceName, 235 DeviceURL, 235 IDNATarget, FTP Server, 236 InstallDir, [CEStrings], 217 Intermec Device Network Announcement. See IDNA IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252, 283 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255, 283 IOCTL_HAL_WARMBOOT, 252, 283 IOCTL_LOAD_NDIS_MINIPORT, 258 IOCTL_PROCESSOR_INFORMATION, 256 IOCTL_UNLOAD_NDIS_MINIPORT, 258 isDHCPEnabled(), 278 isOrinoco(), 276 isSupplicantRunning(), 277 isZeroConfigEnabled(), 276 ITC_ DOCK_SWITCH, 248 ITC_ WAKEUP_MASK, 248 ITC_AMBIENT_FRONTLIGHT, 248 ITC_AMBIENT_KEYBOARD, 248 ITC_DEVID_80211RADIO_INTEL_2011B, 245 ITC_DEVID_80211RADIO_MAX values ITC_DEVID_80211RADIO_INTEL_2011B, 245 ITC_DEVID_80211RADIO_NONE, 245 ITC_DEVID_80211RADIO_NONE, 245 ITC_DEVID_INTERMEC_EVIO, 245 ITC_DEVID_INTERMEC2D_IMAGER, 245 ITC_DEVID_OEM2D_IMAGER, 245 ITC_DEVID_SCANHW_MAX values ITC_DEVID_INTERMEC_EVIO, 245 ITC_DEVID_INTERMEC2D_IMAGER, 245 ITC_DEVID_OEM2D_IMAGER, 245 ITC_DEVID_SCANHW_NONE, 245 ITC_DEVID_SE900_LASER, 245 ITC_DEVID_SE900HS_LASER, 245 ITC_DEVID_SCANHW_NONE, 245 ITC_DEVID_SE900_LASER, 245 ITC_DEVID_SE900HS_LASER, 245 ITC_DEVID_WANRADIO_NONE, 245 ITC_DEVID_WANRADIO_SIEMENS_MC45, 245 406 ITC_DEVID_WANRADIO_SIEMENS_MC46, 245 ITC_DEVID_WANRADIO_SIERRA_SB555, 245 ITC_DEVID_WANRADIO_XIRCOM_GEM3503, 245 ITC_IFTP_STOP, 240 ITC_NVPARM_80211_INSTALLED, 245 ITC_NVPARM_80211_RADIOTYPE, 245 ITC_NVPARM_ANTENNA_DIVERSITY, 244 ITC_NVPARM_BLUETOOTH_INSTALLED, 246 ITC_NVPARM_CONTRAST, 244 ITC_NVPARM_DISPLAY_TYPE, 244 ITC_NVPARM_ECN, 244 ITC_NVPARM_EDBG_SUBNET, 244 ITC_NVPARM_EDG_IP, 244 ITC_NVPARM_ETHERNET_ID, 243 ITC_NVPARM_INTERMEC_DATACOLLECTION_HW, 245 ITC_NVPARM_INTERMEC_DATACOLLECTION_SW, 245 ITC_NVPARM_INTERMEC_SOFTWARE_CONTENT, 244 ITC_NVPARM_LAN9000_INSTALLED, 246 ITC_NVPARM_MANF_DATE, 243 ITC_NVPARM_MCODE, 244 ITC_NVPARM_RTC_RESTORE, 245 ITC_NVPARM_SERIAL_NUM, 243 ITC_NVPARM_SERIAL2_INSTALLED, 246 ITC_NVPARM_SERVICE_DATE, 243 ITC_NVPARM_SIM_PROTECT_HW_INSTALLED, 246 ITC_NVPARM_SIM_PROTECT_SW_INSTALLED, 246 ITC_NVPARM_VERSION_NUMBER, 244 ITC_NVPARM_VIBRATE_INSTALLED, 246 ITC_NVPARM_WAN_FREQUENCY, 245 ITC_NVPARM_WAN_INSTALLED, 245 ITC_NVPARM_WAN_RADIOTYPE, 245 ITC_NVPARM_WAN_RI, 244 ITC_REGISTRY_SAVE_ENABLE, 248 KernelIoControl IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252, 283 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255, 283 IOCTL_HAL_WARMBOOT, 252, 283 IOCTL_PROCESSOR_INFORMATION, 256 KernelIoControl(), 242 700 Series Color Mobile Computer User’s Manual Index lpBytesReturned IOCTL_GET_CPU_ID, 257 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_PROCESSOR_INFORMATION, 256 lpInBuf IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 IOCTL_PROCESSOR_INFORMATION, 256 lpInBufSize IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 lpOutBuf IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 IOCTL_PROCESSOR_INFORMATION, 256 ManifestName, FTP Server, 236 nDeviceId, NLEDGetDeviceInfo, 282 700 Series Color Mobile Computer User’s Manual NDIS_ENCRYPTION_1_ENABLED EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_1_KEY_ABSENT EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_2_ENABLED EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_2_KEY_ABSENT EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_3_ENABLED EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_3_KEY_ABSENT EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_DISABLED EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_ENCRYPTION_NOT_SUPPORTED EncryptionStatus(), 271 GetWepStatus(), 268 NDIS_MIXED_CELL_OFF, SetMixedCellMode(), 274 NDIS_MIXED_CELL_ON, SetMixedCellMode(), 274 NDIS_NET_AUTO_UNKNOWN GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_MODE_ESS GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_MODE_IBSS GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_MODE_UNKNOWN GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_TYPE_DS, GetNetworkType(), 265 NDIS_NET_TYPE_FH, GetNetworkType(), 265 NDIS_NET_TYPE_OFDM_2_4G GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_TYPE_OFDM_5G GetNetworkMode(), 264 SetNetworkMode(), 273 NDIS_NET_TYPE_UNDEFINED, GetNetworkType(), 265 NDIS_NETWORK_EAP_MODE_OFF GetCCXStatus(), 269 SetCCXStatus(), 274 NDIS_NETWORK_EAP_MODE_ON GetCCXStatus(), 269 SetCCXStatus(), 274 NDIS_POWER_LEVEL_1, GetTXPower(), 267 NDIS_POWER_LEVEL_15, GetTXPower(), 267 NDIS_POWER_LEVEL_30, GetTXPower(), 267 NDIS_POWER_LEVEL_5, GetTXPower(), 267 NDIS_POWER_LEVEL_63, GetTXPower(), 267 407 Index NDIS_POWER_LEVEL_UNKNOWN, GetTXPower(), 267 NDIS_RADIO_ASSOCIATED, GetAssocationStatus(), 261 NDIS_RADIO_AUTH_MODE_AUTO GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_ERROR GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_OPEN GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_SHARED GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_WPA GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_WPA_NONE GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_AUTH_MODE_WPA_PSK GetAuthenticationMode(), 262 SetAuthenticationMode(), 272 NDIS_RADIO_POWER_AUTO GetPowerMode(), 266 SetPowerMode(), 273 NDIS_RADIO_POWER_MODE_CAM GetPowerMode(), 266 SetPowerMode(), 273 NDIS_RADIO_POWER_MODE_FAST_PSP GetPowerMode(), 266 SetPowerMode(), 273 NDIS_RADIO_POWER_MODE_PSP GetPowerMode(), 266 SetPowerMode(), 273 NDIS_RADIO_POWER_UNKNOWN GetPowerMode(), 266 SetPowerMode(), 273 NDIS_RADIO_SCANNING, GetAssociationStatus(), 261 nInBufSize IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_PROCESSOR_INFORMATION, 256 nInfoId, NLEDGetDeviceInfo, 282 NLED_COUNT_INFO, NLEDGetDeviceInfo, 282 NLED_SETTINGS_INFO_ID, NLEDGetDeviceInfo, 282 NLED_SUPPORTS_INFO_ID, NLEDGetDeviceInfo, 282 NLEDGetDeviceInfo, 282 NLEDSetDevice, 282 nOutBufSize IOCTL_GET_CPU_ID, 257 408 IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_DEVICE_INFO, 242 IOCTL_HAL_GET_DEVICEID, 249 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 IOCTL_PROCESSOR_INFORMATION, 256 Object store IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 Oldstyle device ID, 249 OSVERSIONINFO.dwBuildNumber, 218 OSVERSIONINFO.dwVersionMajor, 218 OSVERSIONINFO.dwVersionMinor, 218 PauseAtStartup, FTP Server, 236 pInput, NLEDSetDevice, 282 Pocket PC IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_OAL_VERINFO, 250 pOutput, NLEDGetDeviceInfo, 282 Processor information, IOCTL_PROCESSOR_INFORMATION, 256 ProcessorType, [CEDevice], 218 Provider, [Version], 216 Query Information functions, 261 RadioConnect(), 260 RadioDisassociate(), 261 RadioDisconnect(), 260 ReadFile(), NPCP printing, 191 Reboot methods IOCTL_HAL_COLDBOOT, 283 IOCTL_HAL_REBOOT, 283 IOCTL_HAL_WARMBOOT, 283 RegFlushKey(), 123, 233 RegisterDevice(), 191 DTR printing, 196 Registry FTP Server parameters, 235 save location, IOCTL_HAL_ITC_WRITE_SYSPARM, 247 700 Series Color Mobile Computer User’s Manual Index RegOpenKeyEx(), 285 RegQueryValueEx(), 285 RegSetValueEx(), 285 RemoveWep(), 275 RenewDHCP(), 278 ResetRadioToSystemSave(), 279 RFC 959, 239 Root, FTP Server, 236 Set information functions, 270 SetAuthenticationMode(), 272 SetCCXStatus(), 274 SetChannel(), 272 SetDiversity(Deprecated), 280 SetMixedCellMode(), 274 SetNetworkMode(), 273 SetPowerMode(), 273 SetRTSThreshold(Deprecated), 280 SetSSID(), 274 SetTXRate(Deprecated), 280 SHFullScreen(), 233 shortcut_list_section, [CEShortcuts] shortcut_filename, 225 shortcut_type_flag, 225 target_file/path, 225 target_file_path, 225 Signature, [Version], 216 SIM cards protection hardware, 246 protection software, 246 software installed, 246 [SourceDiskFiles], filename, 221 [SourceDiskNames] CESignature, 220 disk_ordinal, 220 SourceDisksNames.MIPS, 221 SourceDisksNames.SH3, 221 StartScanList(), 277 StartSupplicant(), 277 700 Series Color Mobile Computer User’s Manual StopSupplicant(), 278 string_key, [Strings], 217 [Strings], string_key, 217 SwitchPacketDriver(), 280 SYSTEMINFO.dwProcessorType, 218 UDP, FTPDCE, 237 UDP broadcasts, IDNATarget parameter, 236 UnsupportedPlatforms, [CEDevice], 218 UUID, 249 [Version] CESignature, 216 Provider, 216 Signature, 216 VersionMax, [CEDevice], 218 VersionMin, [CEDevice], 218 VN_CLASS_ASIC, 244 VN_CLASS_BOOTSTRAP, 244 VN_CLASS_KBD, 244 WAN radio IDs ITC_DEVID_WANRADIO_NONE, 245 ITC_DEVID_WANRADIO_SIEMENS_MC45, 245 ITC_DEVID_WANRADIO_SIEMENS_MC46, 245 ITC_DEVID_WANRADIO_SIERRA_SB555, 245 Warm boot IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 Wireless TCP/IP installations, BlockSize parameter, 235 WriteFile() DTR printing, 196, 197 IrDA printing, 190 NPCP printing, 191, 192 Xscale processor ID, IOCTL_GET_CPU_ID, 257 409 Index General Index Numbers 1470 Imager. See Imager 1551/1553 Tethered Scanner See also Tethered scanner configuring, 209 reset to factory defaults, 212 troubleshooting, 212 1D laser scanner, about, 199 1D OmniDir Decode Enable, configuration parameter, 334 2D Imager, about, 199 4820 printer, NPCP driver, 191 6804DM printer DTR driver, 196 IrDA driver, 190 6804T printer DTR driver, 196 IrDA driver, 190 6805A printer DTR driver, 196 IrDA driver, 190 6806 printer DTR driver, 196 IrDA driver, 190 6808 printer DTR driver, 196 IrDA driver, 190 printer support, 189 681T printer, DTR driver, 196 6820 printer IrDA driver, 190 NPCP driver, 191 printer support, 189 6920 Communications Server, ManifestName parameter, 236 740 Color Computer, 284 781 printers, DTR driver, 196 782T printer, printer support, 189 802.11 antenna color code, 127 API, 259 channel, 366 communications setup, 129, 365 configuration profiles, 259 CORE module, 133 LEAP network EAP, 383 WPA encryption, 382 network type, 366 PEAP network EAP, 372 WPA encryption, 371 profile label, 366 410 profile security information, WEP encryption, 368 profiles, 365 advanced settings, 384 basic information, 366 security information, 367 SSID (network name), 366 TTLS, WPA encryption, 378 WPA authentication, Zero Configuration, 109 WPA authentication with pre-shared key, Zero Configuration, 109 WPA encryption, 369 zero configuration, WEP encryption, 108 802.11 CF radio CORE module, 133 installing available modules, 132 loading a module, 133 Abstract Syntax Notation.1. See ASN.1 Accessory list, 22 Accounts, via Inbox, 75 Activation wizard Phone application, CDMA radios, 145 phone application, CDMA radios, 140 ActiveSync ActiveSync Help, 45 adding programs, 42 adding programs to Start menu, 43 Folder behavior connected to e-mail server, 74 installing applications, 119 Microsoft Reader, 90 Pocket Internet Explorer favorite links, 94 mobile favorites, 95 Mobile Favorites folder, 94 Start menu icon, 27 URL, 44 Windows Mobile, 44 ActiveX control tools, unit information control panel, CAB files, 357 AD command, with/without data, 337 Adding bookmarks, Microsoft Reader, 93 Adding drawings to text, Microsoft Reader, 93 Adding programs ActiveSync, 42 Pocket Internet Explorer, 42 to the Start menu, 43 via ActiveSync, 43 via File Explorer, 43 Windows Mobile, 41 Adjusting settings, Windows Mobile, 41 Adobe Acrobat Reader, URL, 177 AE command, with/without data, 339 Aimer LED Duration, configuration parameter, 330 All-Day events, Calendar, 48 creating, 52 Alpha plane on keypad, 285 700 Series Color Mobile Computer User’s Manual Index Alphanumeric keypad alpha (blue) key sequences, 15 [gold/white] key sequences, 13 registry settings alpha plane, 285 gold plane, 285 unshifted plane, 285 scan codes, 288 Ambient lighting, 2 Annotations index, Microsoft Reader, 93 Antenna, radio type, 127 APIs 802.11, 259 AT command interface, 177 IrSock, 190 App launch, control panel applet, 361 Application keys app launch control panel applet, 361 wakeup mask control panel applet, 360 Appointments Calendar adding a note, 54 assigning to a category, 56 changing, 51 creating, 51 deleting, 58 finding, 58 making recurring, 55 setting a reminder, 53 viewing, 49 via Calendar, 46 APS linear imager, about, 199 ASCII printing, 190 printing to a port, port print method, 190 raw text to printer, 190 ASN.1, 187 AT command interface, 177 testing, 178 Attaching notes to text, Microsoft Reader, 93 Audio, phone application, 155 Audio control panel applet, input mixing, 8 Audio files, Windows Media Player, 89 Audio system external headset jack, 4 microphone, 4 speaker, 3 AutoCab, command line syntax, 124 AutoFTP, 240 AutoIP, 186 Automatic Private IP. See AutoIP Automatic shutoff bar code configuration, 385, 390 configuration parameter, 385 Autostart FTP, 240 AvantGo channels, Pocket Internet Explorer, 96 700 Series Color Mobile Computer User’s Manual AXCommunication, 357 AXFileTransfer, 357 AXReaderCommand, 357 AXVWedge, 357 Backlight control panel applet ambient light sensor, 2 keypad, 11 Backlight timeout bar code configuration, 386, 390 configuration parameter, 386 Bar code configuration audio volume, 385 automatic shutoff, 385 backlight timeout, 386 key clicks, 386 Bar codes configuration audio volume, 389 automatic shutoff, 390 backlight timeout, 390 Code 39, 389 key clicks, 391 internal scanner supported symbologies, 203 scanning labels, 389 supported symbologies, 295 symbologies Codabar, 394 Code 11, 394 Code 128, 396 Code 39, 394 Code 39 concatenation, 395 Code 39 full ASCII, 395 Code 93, 395 Data Matrix, 397 EAN, 397 I 2 of 5, 398 Matrix 2 of 5, 398 MaxiCode, 398 Micro PDF417, 399 MSI code, 400 PDF417, 398 Plessey, 399 QR code, 400 S 2 of 5, 400 Telepen, 401 UPC, 401 tethered scanner supported symbologies, 213 Battery ambient lighting, 2 low battery conditions, 6 RAM maintenance, 6 status, 5 Battery status, unit information control panel applet, 355 411 Index Beeper configuration parameter frequency, 327 volume, 325, 326 disabling the volume, 326 selecting a volume, 9 silencing the volume, 10 supported functions, 324 volume, turning it on, 7 when not available beeper frequency, 327 good read beep duration, 329 good read beeps, 328 Bell Mobility activation process, 176 Block recognizer, Windows Mobile input panel, 32 Bluealps CORE module installing available modules, 132 loading a module, 133 Bluetooth accessing, 182 activating, 182 unit information control panel, main stack CAB file, 356 WPport, 183 Bluetooth compatibility, network support, 182 Books, Microsoft Reader adding bookmarks, 93 adding drawings, 93 annotations index, 93 attaching notes, 93 copying, 93 downloading, 90 highlighting, 93 reading, 92 removing, 93 searching, 93 Browsing the Internet, Pocket Internet Explorer, 97 Build information, software, 18 CAB files after the extraction, 228 creating, 216 INF files, 216 with CAB Wizard, 231 installation functions, SETUP.DLL, 228 placing files onto storage card, 122 unit information control panel applet, 356 Cabinet Wizard creating CAB files, 231 troubleshooting, 232 using the application, 216 Cabling, scanner, 207 Calendar all day events, 48 creating, 52 appointments adding a note, 54 assigning to a category, 56 412 changing, 51 creating, 51 deleting, 58 finding, 58 making recurring, 55 setting a reminder, 53 viewing, 49 categories, 47 meetings, sending a request, 57 options, changing, 59 Pocket Outlook, 46 recurrence pattern, 49 Start menu icon, 27 synchronizing, 47 Call Guard alert, enable while roaming, Phone application, CDMA radios, 147 Call history, Phone application CDMA radios, 144 GSM radios, 150 Capacitor, internal super, 6 Capturing thoughts and ideas, via Notes, 71 Card support CompactFlash cards, 19 MultiMediaCards, 19 radios, 21 Secure Digital cards, 19 Carrier, location of ESN, 160 Categories calendar, 47 contacts, assigning to, 65 CDMA/1xRTT, 135 activation with SB555 Watcher, 160 Bell Mobility, 176 Sprint, 167 Telus, 176 Verizon, 163 antenna color code, 127 AT command set, 177 copying files from web site, 157 via Microsoft ActiveSync, 158 via storage cards, 158 CORE module, 136 location of ESC, 160 phone activation, 140 phone application, 140 setting up, 157 terminology, 157 CEImager location of the executable file, 122 migrating AUTORUN.DAT files, 122 Channel, 802.11 radio module, 366 Clock restore real-time after cold-boot, 359 setting date and time, 388 Windows Mobile settings, 41 Closing drivers, NPCP, 192 Codabar, 394 configuration parameter, 298 user ID, 317 700 Series Color Mobile Computer User’s Manual Index Code 11, 394 configuration parameter, 312 user ID, 321 Code 128, 396 configuration parameter, 301 FNC1 character, 303 user ID, 317 Code 39, 394 configuration parameter, 296 user ID, 317 Code 93, 395 configuration parameter, 300 length, 300 user ID, 318 Code Division Multiple Access. See CDMA/1xRTT Codes 11, 394 128, 396 39, 394 39 concatenation, 395 39 full ASCII, 395 93, 395 Cold boot, performing, 17 COM A, modem position, 358 COM B, serial position, 358 COM port configuration, 205 wedge settings, 205 COM1, NPCP parameter, 191 COM1 port, 190 Comm port wedge disabling, 205 enabling, 204 error messages, 205 limitations, 207 settings, 205 unit information control panel, 356 Command line syntax, AutoCab, 124 Common Object Resource Environment. See CORE Communications DTR, 197 NPCP, 194 CompactFlash cards card support, 19 installing applications, 120 migrating applications, 122 packaging an application, 118 Computer shutdown, 6 Concatenation, 395 Configuration parameters 1D OmniDir decode enable, 334 aimer LED duration, 330 automatic shutoff, 385 backlight timeout, 386 beeper, 325 frequency, 327 volume, 326 codabar, 298 user ID, 317 700 Series Color Mobile Computer User’s Manual code 11, 312 user ID, 321 code 128, 301 FNC1 character, 303 user ID, 317 code 39, 296 user ID, 317 code 93, 300 length, 300 user ID, 318 datamatrix, 314 date/time, 386 EAN 13 user ID, 320 8 user ID, 320 good read beep duration, 329 beeps, 328 identification contact, 351 location, 353 name, 352 image dimension, 332 interleaved 2 of 5, 309 user ID, 318 key clicks, 386 lighting mode, 333 macro PDF, 306 matrix 2 of 5, 310 user ID, 320 maxicode, 315 micro PDF417, 308 MSI, 305 user ID, 318 PDF417, 306 user ID, 318 plessey, 304 user ID, 319 prefix, 322 QR code, 313 security encryption key, 348 read encryption, 346 read-only community string, 344 read/write community string, 345 write encryption, 347 SNMP, security subnet mask, 316 standard 2 of 5, 297 user ID, 319 sticky aimer duration, 331 suffix, 323 telepen, 311 user ID, 320 trap authentication, 349 threshold, 350 UPC A user ID, 319 E user ID, 319 413 Index UPC/EAN, 299 virtual wedge, 335 code page, 341 grid, 340 postamble, 338 preamble, 336 volume, 385 Configuring service settings, Phone application, GSM radios, 152 Connecting to an ISP, 98 e-mail server, 114 work, 102 Connecting to a mail server, via Inbox, 75 Connections See also Getting connected directly to e-mail server, 114 ending, 113 setting up an e-mail account, 114 to an ISP, 98 via modem, 98 to work, 102 via modem, 103 via VPN server, 111 via modem to an ISP, 98 to work, 103 via VPN server, to work, 111 via wireless network, 106 Conserving battery power, 2 Contacts adding a note, 64 adding a telephone number CDMA radios, 144 GSM radios, 150 adding to speed dial, 68 assigning to a category, 65 changing, 63 changing options, 68 copying, 65 creating, 61, 63 deleting, 67 finding, 67 MSN Messenger managing, 87 sending messages, 88 working with, 86 Pocket Outlook, 60 sending a message, 66 Start menu icon, 27 synchronizing, 61 viewing, 62 Control panel applets Audio, 8 414 backlight, 2, 11 clock, 388 data collection, 294 beeper volume, 9 beeper/LED, 324 imager, 330 symbologies, 295 symbology options, 316 vibrator, 20 virtual wedge, 335 intemec settings beeper volume, 10 vibrator, 21 intermec settings, 294, 342 phone settings CDMA radios, 146 GSM radios, 151 power battery status, 5 RAM maintenance, 6 SNMP, 343 identification, 351 security, 344 traps, 349 system, wireless network, 129, 365 unit information, 354 battery status, 5, 355 CAB files, 356 versions, 18, 354 utilities, 358 app launch, 361 dock switch, 358 registry save, 123, 359 wakeup mask, 360 wireless network, 363 Converting writing to text, 35 Copying, contacts, 65 Copying text, Microsoft Reader, 93 CORE, 132 802.11 CF module, 133 802.11 radio module details, 135 general, 134 accessing from Programs panel, 132 Today screen, 133 activating, 132 installing available modules, 132 loading a module, 133 module for 802.11 NIC, 259 WAN monitor, GSM/GPRS, 138 WAN radio module CDMA/1xRTT, 136 general, 138 700 Series Color Mobile Computer User’s Manual Index Creating a modem connection to an ISP, 98 to work, 103 a VPN server connection, to work, 111 a wireless network connection, 106 CAB files, 216 with CAB Wizard, 231 contacts via Contacts, 61 document via Pocket Word, 78 drawing via Notes, 37 INF files, 216 note via Notes, 71 task via Tasks, 70 workbook via Pocket Excel, 82 Data, Phone application, CDMA radios, 147 Data collection configuration parameters 1D OmniDir decode enable, 334 aimer LED duration, 330 beeper, 325 beeper frequency, 327 beeper volume, 326 codabar, 298 codabar user ID, 317 code 11, 312 code 11 user ID, 321 code 128, 301 code 128 FNC1 character, 303 code 128 user ID, 317 code 39, 296 code 39 user ID, 317 code 93, 300 code 93 length, 300 code 93 user ID, 318 datamatrix, 314 EAN-13 user ID, 320 EAN-8 user ID, 320 good read beep duration, 329 good read beeps, 328 image dimension, 332 interleaved 2 of 5, 309 interleaved 2 of 5 user ID, 318 lighting mode, 333 macro PDF, 306 matrix 2 of 5, 310 matrix 2 of 5 user ID, 320 maxicode, 315 micro PDF417, 308 MSI, 305 MSI user ID, 318 PDF417, 306 PDF417 user ID, 318 plessey, 304 plessey user ID, 319 prefix, 322 QR code, 313 standard 2 of 5, 297 700 Series Color Mobile Computer User’s Manual standard 2 of 5 user ID, 319 sticky aimer duration, 331 suffix, 323 telepen, 311 telepen user ID, 320 UPC-E user ID, 319 UPC-A user ID, 319 UPC/EAN, 299 virtual wedge, 335 virtual wedge code page, 341 virtual wedge grid, 340 virtual wedge postamble, 338 virtual wedge preamble, 336 vibrator, 20 Data Matrix, 397 configuration parameter, 314 Date, setting, 388 Date/Time, configuration parameter, 386 DHCP, 186 Display full screen, 233 Dock switch, control panel applet, 358 Docks, modem support, 16 DRAM low battery shutdown, 6 maintenance, 6 Drawing mode, Pocket Word, 81 Drawing on the screen See also Notes Pocket Word, 81 Drivers DTR communications, 197 installing, 196 opening, 197 removing, 196 writing to, 197 NPCP closing, 192 communications, 194 I/O controls, 193 installing, 191 opening, 192 reading from, 192 removing, 191 writing to, 192 O’Neil. See DTR printing DTR printing, 196 closing driver, 197 communications, 197 opening driver, 197 removing driver, 196 writing to driver, 197 E-mail account, setting up an account, 114 E-mail server, getting connected, 114 EAN, configuration parameter, 299 13 user ID, 320 8 user ID, 320 Editing a profile, 365 415 Index Edition information, 24 Emails, SMS messages via Phone application CDMA radios, 145 GSM radios, 151 Encoded Code 39 concatenation, 395 full ASCII, 395 Ending a connection, 113 Epson Escape Sequences, 190 Error messages comm port wedge, 205 tethered scanner, 205 ESN, location on computer, 160 Ethernet, communications setup, 128 ETSI GSM 07.05 interface specifications, 177 ETSI GSM 07.07 interface specifications, 177 European Article Numbering. See EAN European Article Numbering code. See EAN Favorite links, Pocket Internet Explorer, 94 File Explorer adding programs to Start menu, 43 removing programs, 43 Windows Mobile, 40 Find feature, Windows Mobile, 40 Flash File Store migrating applications, 122 packaging an application, 118 Flash file system, control panel applet, 359 Folder behavior connected to e-mail server ActiveSync, 74 IMAP4, 74 POP3, 74 SMS, 74 FRAME_NOT_ACKED, 193 FTP configurable parameters IDNATarget, 236 ManifestName, 236 Root, 236 heartbeat, 237 server, installing applications, 120 FTPDCMDS subdirectory, FTP support, 239 Full screen display, 233 GDI approach, 190 General Packet Radio Service. See GSM/GPRS Getting connected directly to an e-mail server, 114 ISP, 98 setting up an e-mail account, 114 to an ISP, 98 creating a modem connection, 98 to work, 102 creating a modem connection, 103 416 creating a VPN server connection, 111 creating a wireless network connection, 106 Windows Mobile, 98 Gold plane on keypad, 284 Good read, configuration parameter beep duration, 329 beeps, 328 Grid data, configuration parameter, 340 GSM/GPRS, 138 antenna color code, 127 AT command set MC45, 177 MC46, 177 CORE module, 138 phone application, 149, 154 Handset phone application, 154 volume, 156 Headset jack, external, 4 Hiding your location from everyone except 911, CDMA radios, 146 Highlighting text, Microsoft Reader, 93 I 2 of 5. See Interleaved 2 of 5 I/O controls, NPCP driver, 193 Identification, configuration parameter contact, 351 location, 353 name, 352 IDNA IDNATarget, 236 ManifestName, 236 Image dimension, configuration parameter, 332 Imager beeper functions not available beeper frequency, 327 good read beep duration, 329 good read beeps, 328 beeper/LED parameters, beeper, 325 control panel appet, data collection, 330 data collection parameters 1D OmniDir decode enable, 334 aimer LED duration, 330 datamatrix, 314 image dimension, 332 lighting mode, 333 maxicode, 315 QR code, 313 sticky aimer duration, 331 settings, 206 supported beeper functions, 324 functions, 330 symbologies, 295 700 Series Color Mobile Computer User’s Manual Index symbologies not available CIP 128 French Pharmaceutical, 302 Code 11, 312 Code 128 FNC1 character, 303 EAN 128 ]C1, 302 Macro PDF, 306 Matrix 2 of 5, 310 micro PDF417, 308 Telepen, 311 symbology user IDs not available Codabar, 317 Code 11, 321 Code 128, 317 Code 39, 317 Code 93, 318 EAN 13, 320 EAN 8, 320 Interleaved 2 of 5, 318 Matrix 2 of 5, 320 MSI, 318 PDF417, 318 Plessey, 319 Standard 2 of 5, 319 Telepen, 320 UPC A, 319 UPC E, 319 vibrator, enabling, 20 IMAP4, Folder behavior connected to e-mail server, 74 Inbox accounts, 75 composing/sending messages, 77 connecting to a mail server, 75 downloading messages from server, 76 getting connected, 98 managing e-mail messages and folders, 74 Pocket Outlook, 73 Start menu icon, 27 synchronizing e-mail messages, 73 using My Text, 39 INF files, creating, 216 Input Mixing, Audio control panel applet, 8 Input panel block recognizer, 32 keyboard, 31 letter recognizer, 33 Pocket Word, 79 selecting typed text, 33 transcriber, 33 Windows Mobile, 28 word suggestions, 31 Installation functions, SETUP.DLL, 228 Installing applications using a storage card, 120 using CompactFlash cards, 120 700 Series Color Mobile Computer User’s Manual using Secure Digital cards, 121 with ActiveSync, 119 with FTP Server, 120 Installing drivers DTR, 196 NPCP, 191 Instant messaging, 84 Integrated scanners. See Internal scanners Interface specifications, ETSI GSM 07.0x, 177 Interleaved 2 of 5, 398 configuration parameter, 309 user ID, 318 Intermec part numbers, 22 Intermec settings, 294, 342 beeper volume, 10 vibrator, 21 INTERMEC_PACKET_DRIVER, SwitchPacketDriver(), 280 Internal scanners configuring, 202 supported symbologies, 203 Internet explorer software build version, 18 Windows Mobile 2003 edition, 24 Internet Service Provider. See ISP IOCTL_NPCP_BIND, 193 IOCTL_NPCP_CANCEL, 193 IOCTL_NPCP_CLOSE, 193 IOCTL_NPCP_ERROR, 193 IOCTL_NPCP_FLUSH, 193 IrDA printing, 190 ISP connecting to via Windows Mobile, 98 creating, a modem connection, 98 Pocket Internet Explorer, 94 Windows Mobile, 98 ITC_KEYBOARD_CHANGE, CreateEvent(), 286 ITU-T interface specifications, 177 Keeping a to-do list, via Tasks, 69 Key clicks bar code configuration, 386, 391 configuration parameter, 386 Key sequences alpha (blue) keys alphanumeric, 15 numeric, 14 [gold] keys, numeric, 12 [gold/white] keys, alphanumeric, 13 Keyboard See also Keypad Windows Mobile input panel, 31 417 Index Keypad advanced remapping, 286 alphanumeric alpha (blue) key sequences, 15 [gold/white] key sequences, 13 scan codes, 288 backlight control panel applet, 11 change notification, 286 driver registry settings, 286 numeric alpha (blue) key sequences, 14 [gold] key sequences, 12 scan codes, 287 planes, 284 remapping, 284 sample registry keys, 290 Laser scanner configuration parameters, 292 data collection parameters beeper frequency, 327 beeper volume, 326 codabar, 298 codabar user ID, 317 code 11, 312 code 11 user ID, 321 code 128, 301 code 128 FNC1 character, 303 code 128 user ID, 317 code 39, 296 code 39 user ID, 317 code 93, 300 code 93 length, 300 code 93 user ID, 318 EAN-13 user ID, 320 EAN-8 user ID, 320 good read beep duration, 329 good read beeps, 328 interleaved 2 of 5, 309 interleaved 2 of 5 user ID, 318 macro PDF, 306 matrix 2 of 5, 310 matrix 2 of 5 user ID, 320 micro PDF417, 308 MSI, 305 MSI user ID, 318 PDF417, 306 PDF417 user ID, 318 plessey, 304 plessey user ID, 319 prefix, 322 standard 2 of 5, 297 standard 2 of 5 user ID, 319 suffix, 323 telepen, 311 telepen user ID, 320 UPC-E user ID, 319 UPC-A user ID, 319 UPC/EAN, 299 418 virtual wedge, 335 virtual wedge code page, 341 virtual wedge grid, 340 virtual wedge postamble, 338 virtual wedge preamble, 336 SNMP configuration parameters identification contact, 351 identification location, 353 identification name, 352 security encryption key, 348 security read encryption, 346 security read-only community string, 344 security read/write community string, 345 security subnet mask, 316 security write encryption, 347 trap authentication, 349 trap threshold, 350 supported beeper functions, 324 symbologies, 295 symbologies not available Datamatrix, 313 datamatrix, 314 maxicode, 315 LEAP 802.11 radio module network EAP, 383 WPA encryption, 382 profile security information, 381 WEP encryption, 381 Letter recognizer, Windows Mobile input panel, 33 Letting your location be visible, CDMA radios, 146 Library, Microsoft Reader, 91 Lighting Mode, configuration parameter, 333 Line printing, 190 Location, Phone application, CDMA radios, 146 LPT9 printer device, 191 Macro PDF, configuration parameter, 306 Managing e-mail messages and folders, via Inbox, 74 Matrix 2 of 5, 398 configuration parameter, 310 user ID, 320 MaxiCode, 398 configuration parameter, 315 Meetings Calendar, sending a request, 57 via Calendar, 46 Menus, Windows Mobile settings, 41 Messages sending to, contacts, 66 via Inbox composing/sending, 77 downloading from server, 76 MIBs ASN.1, 187 files, 187 object identifier, 188 OIDs, 188 700 Series Color Mobile Computer User’s Manual Index Micro PDF417, 399 configuration parameter, 308 Microphone, 4 phone application, 154 Microsoft Developer Network Library. See MSDN library Microsoft Exchange e-mail account, 84 Microsoft Passport account, 84 Microsoft Reader books downloading, 90 reading, 92 removing, 93 features, 93 adding bookmarks, 93 adding drawings, 93 annotations index, 93 attaching notes, 93 copying text, 93 highlighting text, 93 searching for text, 93 using the library, 91 Windows Mobile, 90 Microsoft’s Wireless Zero Config, 365 Migrating applications Flash File Store, 122 CompactFlash storage cards, 122 Secure Digital storage cards, 122 Migrating to a 700 Color Computer, 124 Mobile Favorites, Pocket Internet Explorer, 95 Mobile Favorites folder, Pocket Internet Explorer, 94 Modem position, COM A, 358 Modems, creating a connection to an ISP, 98 to work, 103 MP3 files, Windows Media Player, 89 MSDN library, 240 MSDN Windows CE documentation, 186 MSI, 400 configuration parameter, 305 user ID, 318 MSN Messenger about, 84 accounts Microsoft Exchange e-mail, 84 Microsoft Passport, 84 contacts managing, 87 sending messages, 88 working with, 86 setting up an account, 85 using My Text, 39 MultiMediaCards, card support, 19 NDIS_SUPP_LOGGING_OFF, EnableSuppLogging(), 279 NDIS_SUPP_LOGGING_ON, EnableSuppLogging(), 279 NDISUIO_PACKET_DRIVER, SwitchPacketDriver(), 280 700 Series Color Mobile Computer User’s Manual Network adapters antenna color code, 127 Ethernet communications, 128 no networking, 130 wireless 802.11, 129 wireless printing, 182 Network EAP LEAP security method, 383 PEAP security method, 372 Network settings, Phone application, GSM radios, 153 Network type, 802.11 radio module, 366 NLED driver, vibrator, 281 NLED_SETTINGS_INFO_ID, NLEDSetDevice, 282 Notes adding to appointments, 54 contacts, 64 creating a note, 71 drawing on the screen, 37 creating a drawing, 37 selecting a drawing, 37 Pocket Outlook, 71 recording a message, 38 Start menu icon, 27 synchronizing notes, 72 writing on the screen, 34 alternate writing, 35 converting writing to text, 35 selecting the writing, 34 tips for good recognition, 36 NPCP printing, 191 about, 191 closing driver, 192 COM1 parameters, 191 communications, 194 driver I/O controls, 193 installation, 191 LPT9, 191 opening driver, 192 reading from driver, 192 removal, 191 sample code, 194 unit information control panel, NPCPTEST CAB file, 356 writing to driver, 192 Numeric keypad alpha (blue) key sequences, 14 [gold] key sequences, 12 registry settings alpha plane, 285 gold plane, 285 unshifted plane, 285 scan codes, 287 O’Neil printing See also DTR printer installing driver, 196 Object Store, packaging an application, 118 419 Index Opening drivers DTR, 197 NPCP, 192 Owner information, Windows Mobile settings, 41 Packaging an application CompactFlash storage cards, 118 Flash File Store, 118 Object Store, 118 Persistent Storage Manager, 118 Secure Digital storage cards, 118 Page format printing, 190 Password Pocket Excel, 82 Windows Mobile settings, 41 PB20 printers, printer support, 189 PDF417, 398 about the laser scanner, 199 configuration parameter, 306 user ID, 318 PEAP 802.11 radio module network EAP, 372 WPA encryption, 371 profile security information, 370 WEP encryption, 370 Performing a cold boot, 17 Persistent Storage Manager. See PSM Phone application CDMA radios, 140 activation wizard, 140, 145 adding contact to speed dial, 68, 144 call history, 144 customizing phone settings, 146 enable Call Guard alert while roaming, 147 hiding your location except from 911, 146 letting your location be visible for everyone, 146 reset connection settings for PCS Vision, 147 sending SMS messages, 145 toggle between automatic or Sprint roaming, 147 update your PCS Vision profile, 147 view current phone settings, 148 voice mail, 145 GSM radios, 149 adding contact to speed dial, 150 call history, 150 customizing phone settings, 151 finding, setting, selecting networks, 153 sending SMS messages, 151 service settings, 152 Phone Info, Phone application, CDMA radios, 148 Phone jack position, control panel applet, 358 Phone settings control panel applet CDMA radios, 146 GSM radios, 151 customizing via Phone application CDMA radios, 146 GSM radios, 151 420 network settings, GSM radios, 153 view current settings via Phone application, CDMA radios, 148 PhoneUtility, 154 ring, 155 vibrate, 155 Planes, keypad, 284 Plessey, 399 configuration parameter, 304 user ID, 319 Pocket Excel about, 82 creating a workbook, 82 Pocket Internet Explorer about, 94 adding programs, 42 AvantGo channels, 96 browsing the Internet, 97 favorite links, 94 getting connected, 98 mobile favorites, 95 Mobile Favorites folder, 94 software build, 18 Start menu icon, 27 viewing mobile favorites and channels, 97 Pocket Outlook, 46 Calendar, 46 Pocket Word about, 78 creating a document, 78 drawing mode, 81 recording mode, 80 synchronizing, 81 tips, 83 typing mode, 79 writing mode, 80 POP3, Folder behavior connected to e-mail server, 74 Postamble configuration parameter, 338 with/without data, 339 Power control panel battery status, 5 RAM maintenance, 6 Windows Mobile settings, 41 Preamble configuration parameter, 336 with/without data, 337 Prefix, configuration parameter, user ID, 322 Printer support, 190 IrDA printer driver, 190 NPCP printer driver, 191 O’Neil printer driver, 196 Profile label, 802.11 radio module, 366 Profiles 802.11 radio module, 365 advanced settings, 384 basic information, 366 security information, 367 editing, 365 700 Series Color Mobile Computer User’s Manual Index Programs, adding or removing, Windows Mobile, 41 PSM determining build version, 16 packaging an application, 118 PSM build, 294 QR code, 400 configuration parameter, 313 Quick Response Code. See QR Code Radios See also Network adapters card support, 21 Reader commands, 387 configuration change, 387 date and time settings, 388 Reading from drivers, NPCP, 192 Real-Time Clock, restore after cold-boot, 359 Record button, recording a message, 38 Recording, via Notes, 38 Recording a message, Pocket Word, 80 Recording mode, Pocket Word, 80 Recovery CD AutoCab method, 124 AUTOUSER.DAT file, 123 RegFlushKey() API, 233 S9C upgrade, 357 updating the system software, 121 Recurrence pattern, Calendar, 49 RegFlush utility, 123 Registry keypad remapping, 286 sample view of key mapping, 290 writing to a storage card, 123 Registry Save, control panel applet, 359 Registry settings AutoCfg, 186 AutoFTP, 241 AutoInterval, 186 AutoIP/DHCP, 186 DhcpMaxRetry, 186 DhcpRetryDialogue, 186 EnableDHCP, 186 keypad driver, 286 keypad planes alpha, 285 gold, 285 unshifted, 285 Removing drivers DTR, 196 NPCP, 191 Removing programs, Windows Mobile, 41, 43 Reset button, 17 Reset connection settings for PCS Vision, Phone application, CDMA radios, 147 Roaming, toggle between automatic or Sprint, Phone application, CDMA radios, 147 RTC. See Real-Time Clock 700 Series Color Mobile Computer User’s Manual S 2 of 5. See Standard 2 of 5 S9C, unit information control panel, upgrade files, 357 Sabre 1551E or 1553 See also Tethered scanner cabling, 207 settings, 206 Sample code, NPCP printing, 194 SB555 Watcher activation, 160 Bell Mobility, 176 Sprint, 167 Telus, 176 Verizon, 163 copying files to computer, 157 via Microsoft ActiveSync, 158 via storage cards, 158 location of ESN, 160 Scan codes alphanumeric keypad, 288 numeric keypad, 287 SCAN Mute, Audio control panel applet, 8 Scanner beeper volume selecting, 9 turning it off, 10 turning it on, 7 mute feature, turning it off, 8 unit configuration parameters automatic shutoff, 385 backlight timeout, 386 date/time, 386 key clicks, 386 volume, 385 utilities configuration, button wakeup mask, 360 Scanner cabling, 207 Scheduling appointments and meetings, via Calendar, 46 SDK, unit information control panel, 357 SDMMC Disk, 122 Searching for text, Microsoft Reader, 93 Secure Digital cards card support, 19 installing applications, 120, 121 migrating applications, 122 packaging an application, 118 Security, configuration parameter encryption key, 348 read encryption, 346 read-only community string, 344 read/write community string, 345 subnet mask, 316 write encryption, 347 Selecting, drawing via Notes, 37 Sending and receiving messages, via Inbox, 73 Serial port, modem support, 16 Serial position, COM B, 358 Services, Phone application, GSM radios, 152 Setting date and time, 388 Setting up an e-mail account, 114 421 Index SETUP.DLL, installation functions, 228 SIM cards IMSI assigned CDMA/1xRTT, 137 GSM/GPRS, 139 installation status, GSM/GPRS, 139 phone number assigned, GSM/GPRS, 138 Simple Network Management Protocol. See SNMP SMS, Folder behavior connected to e-mail server, 74 SMS messages, Phone application CDMA radios, 145 GSM radios, 151 Snap-on modems, 16 SNMP, 187 configuration parameters identification contact, 351 identification location, 353 identification name, 352 security encryption key, 348 security read encryption, 346 security read-only community string, 344 security read/write community string, 345 security subnet mask, 316 security write encryption, 347 trap authentication, 349 trap threshold, 350 SNMP OIDs 1D OmniDir decode enable, 334 aimer LED duration, 330 automatic shutoff, 385 backlight timeout, 386 beeper, 325 frequency, 327 volume, 326 codabar, 298 user ID, 317 code 11, 312 user ID, 321 code 128, 301 FNC1 character, 303 user ID, 317 code 39, 296 user ID, 317 code 93, 300 length, 300 user ID, 318 datamatrix, 314 date/time, 386 EAN 13 user ID, 320 8 user ID, 320 good read beep duration, 329 beeps, 328 identification contact, 351 location, 353 name, 352 image dimension, 332 422 interleaved 2 of 5, 309 user ID, 318 key clicks, 386 lighting mode, 333 macro PDF, 306 matrix 2 of 5, 310 user ID, 320 maxicode, 315 micro PDF417, 308 MSI, 305 user ID, 318 PDF417, 306 user ID, 318 plessey, 304 user ID, 319 prefix, 322 QR code, 313 security encryption key, 348 read encryption, 346 read-only community string, 344 read/write community string, 345 write encryption, 347 security subnet mask, 316 standard 2 of 5, 297 user ID, 319 sticky aimer duration, 331 suffix, 323 telepen, 311 user ID, 320 trap authentication, 349 threshold, 350 UPC A user ID, 319 E user ID, 319 UPC/EAN, 299 virtual wedge, 335 code page, 341 grid, 340 postamble, 338 preamble, 336 volume, 385 Software Developer’s Kit. See SDK Software versions, 18, 354 700 Series Computer, 18 unit information control panel applet, 356 Speaker, 3 Speakerphone phone application, 154 volume, 156 Speed dial, Phone application CDMA radios, 144 GSM radios, 150 Sprint activation process, 167 SSID (network name), 802.11 radio module, 366 Standard 2 of 5, 400 configuration parameter, 297 user ID, 319 700 Series Color Mobile Computer User’s Manual Index Start Menu, adding programs, 43 via ActiveSync, 43 via File Explorer, 43 Status icons, Windows Mobile, 26 Sticky Aimer Duration, configuration parameter, 331 Storage media, 19 Stream device driver NPCPPORT.DLL, 191 ONEIL.DLL, 196 Suffix, configuration parameter, 323 Symbologies internal scanner supported symbologies, 203 scanning labels, 389 tethered scanner supported symbologies, 213 user IDs Codabar, 317 Code 11, 321 Code 128, 317 Code 39, 317 Code 93, 318 EAN 13, 320 EAN 8, 320 Interleaved 2 of 5, 318 Matrix 2 of 5, 320 MSI, 318 PDF417, 318 Plessey, 319 Standard 2 of 5, 319 Telepen, 320 UPC A, 319 UPC E, 319 when not available imager, 304, 305, 306, 308, 310, 311, 312 laser scanner, 313, 314, 315 Synchronizing AvantGo channels, 96 Calendar, 47 contacts, 61 e-mail messages, 73 favorite links, 94 mobile favorites, 95 notes, 72 Pocket Word, 81 Tasks, 70 System, Phone application, CDMA radios, 147 Tasks creating a task, 70 Pocket Outlook, 69 Start menu icon, 27 synchronizing, 70 TCP/IP client, DHCP server, 186 Telepen, 401 configuration parameter, 311 user ID, 320 700 Series Color Mobile Computer User’s Manual Telus activation process, 176 Testing AT commands, 178 Tethered scanner capabilities, 207 disabling, 205 enabling, 205 error messages, 205 limitations, 207 settings, 205 supported symbologies, 213 Text messages, Windows Mobile, 39 Time, setting, 388 Tips for working, Pocket Excel, 83 TLS 802.11 profile certificates, 380 WPA encryption, 375 profile security information WEP encryption, 374 WPA encryption, 375 Today, Windows Mobile settings, 41 Today screen, Windows Mobile, 26 Tools CD Bluetooth documentation, 182 CAB files, 120, 356 CE Imager, 122 Comm Port Wedge CAB file, 356 management tools installed on desktop, 119 MIB files, 187 sample NPCP code, 194 Wireless Printing Development Guide, 182 wireless printing sample, 357 wireless printing SDK, 182 Tracking people, via Contacts, 60 Transcriber, Windows Mobile input panel, 33 Trap configuration parameters authentication, 349 threshold, 350 Traps, control panel appet, SNMP, 349 Troubleshooting 1551/1553 Tethered Scanners, 212 CAB Wizard, 232 TTLS 802.11 radio module, WPA encryption, 378 profile security information, WEP encryption, 377 Typing mode, Pocket Word, 79 Typing on the screen, Pocket Word, 79 Unit, configuration parameters automatic shutoff, 385 backlight timeout, 386 date/time, 386 key clicks, 386 volume, 385 423 Index Unit information battery status, 355 CAB files, 356 ActiveX control tools, 357 Bluetooth stack, 356 Comm Port Wedge, 356 NPCP printer, 356 S9C Upgrade, 357 SDK, 357 Windows configuration, 357 wireless printing sample, 357 versions, 18, 354 Unit Manager, date/time, 386 Universal Product Code. See UPC Unshifted plane on keypad, regular keypad, 284 UPC, 401 configuration parameter, 299 A user ID, 319 E user ID, 319 Update your PCS Vision profile, Phone application, CDMA radios, 147 Updating, bootloader, 119 URLs ActiveSync, 44 Adobe Acrobat Reader, 177 AT command interface CDMA/1xRTT SB555, 177 GPRS/GSM MC45, 177 GPRS/GSM MC46, 177 full screen display, 233 MIBs, 187 Microsoft Exchange e-mail account, 84 Microsoft Passport account, 84 Microsoft support, 25 MSDN library, 240 MSDN Windows CE documentation, 186 Windows Mobile, 25 Windows Mobile support, 25 Utilities control panel applet app launch, 361 dock switch, 358 registry save, 359 wakeup mask, 360 Verizon activation process, 163 Vibrator enabling, 20 phone application, 155 programming, 281 Video files, Windows Media Player, 89 Viewing mobile favorites and channels, Pocket Internet Explorer, 97 Virtual wedge bar code configuration grid, 392 424 postamble, 392 preamble, 392 configuration parameter, 335 code page, 341 grid, 340 postamble, 338 preamble, 336 Voice mail, Phone application, CDMA radios, 145 Volume bar code configuration, 385, 389 configuration parameter, 385 phone application, 154, 156 VPN server, creating a connection, to work, 111 Wakeup mask, control panel applet, 360 WAN monitor CORE module CDMA/1xRTT, 135 GSM/GPRS, 138 installing available modules, 132 loading a module, 133 WAN rado CORE module installing available modules, 132 loading a module, 133 WAP pages, 94 connecting to an ISP, 98 Watcher applications activating, Sprint, 167 downloading, Sprint, 167 using Sprint, 170 Verizon, 163 Web browsers, FTP support, 239 Web pages, 94 connecting to an ISP, 98 Welch Allyn 1470 Imager cabling, 207 settings, 206 WEP encryption LEAP security method, 381 PEAP security method, 370 profile security information, 367, 368 TLS security method, 374 TTLS security method, 377 zero configuration, 108 Windows CE documentation (MSDN), 186 Windows configuration, unit information control panel, WinCfg CAB file, 357 Windows Media files, Windows Media Player, 89 Windows Media Player Start menu icon, 27 Windows Mobile, 89 700 Series Color Mobile Computer User’s Manual Index Windows Mobile ActiveSync, 44 basic skills, 26 Calendar, 46 command bar, 28 Contacts, 60 edition information, 24 getting connected, 98 Inbox, 73 MSN Messenger, 84 navigation bar, 28 Notes, 71 notifications, 29 Pocket Excel, 82 Pocket Word, 78 pop-up menus, 29 programs, 27 status icons, 26 support URLs, 25 Tasks, 69 Today screen, 26 where to find information, 25 Windows Media Player, 89 writing on the screen, 34 Wireless Network, creating a connection, 106 Wireless network, 129, 365 Wireless printing Bluetooth compatible module, 182 unit information control panel, WP_SAMPLE.CAB file, 357 700 Series Color Mobile Computer User’s Manual Wireless WAN AT command interface CDMA/1xRTT SB555, 177 GPRS/GSM MC45, 177 GPRS/GSM MC46, 177 CDMA/1xRTT, 135 GSM/GPRS, 138 testing AT commands, 178 Work creating a modem connection, 103 a VPN server connection, 111 getting connected, 102 WPA authentication 802.11 radio module, Zero Configuration, 109 with pre-shared key, Zero Configuration, 109 WPA encryption 802.11 radio module, 369 LEAP security method, 382 PEAP security method, 371 TLS security method, 375 TTLS security method, 378 WPport, 183 Writing mode, Pocket Word, 80 Writing on the screen See also Notes Pocket Word, 80 Writing to drivers DTR, 197 NPCP, 192 425 Index Files Index Numbers 80211API.DLL, 259 80211CONF.EXE, 259 80211SCAN.EXE, 259 802PM.DLL, 259 AUTOUSER.DAT, 120, 121 CABWIZ.DDF, 231 CABWIZ.EXE, 216, 231 CEIMAGER.EXE, 122 COREDLL.DLL, 281 CPL802.CPL, 259 DEVICEID.H, 249 EXITME.BIN, 239 FTPDCE.EXE, 237, 239 AutoFTP, 241 FTP Server, 234 FTPDCE.TXT, 239 INTERMEC.MIB, 187 ITCADC.MIB, 187 ITCSNMP.MIB, 187 ITCTERMINAL.MIB, 187 MAKECAB.EXE, 231 MOD80211.DLL, 259 NETWLAN.DLL, 259 NLED.H, 282 NLEDGetDeviceInfo, 282 426 NLEDSetDevice, 282 NPCPPORT.DLL, 191 NRINET.INI, 357 OEMIOCTL.H IOCTL_GET_CPU_ID, 257 IOCTL_HAL_COLDBOOT, 252 IOCTL_HAL_GET_BOOT_DEVICE, 254 IOCTL_HAL_GET_BOOTLOADER_VERINFO, 251 IOCTL_HAL_GET_OAL_VERINFO, 250 IOCTL_HAL_GET_RESET_INFO, 253 IOCTL_HAL_ITC_READ_PARM, 243 IOCTL_HAL_ITC_WRITE_SYSPARM, 247 IOCTL_HAL_REBOOT, 255 IOCTL_HAL_WARMBOOT, 252 ONEIL.DLL, 196 PKFUNCS.H IOCTL_HAL_GET_DEVICEID, 249 IOCTL_PROCESSOR_INFORMATION, 256 PRISMNDS.DLL, 259 REBOOTME.BIN, 239 __RESETMEPLEASE__.TXT, 228 RPM.EXE, 221 RPMCE212.INI, 221 SETUP.DLL, 220, 228 DllMain, 228 Sprint_Watcher_PPC_2002-03xxx.CAB, 168 TAHOMA.TTF, 221 URODDSVC.EXE, 259 WCESTART.INI, 221 700 Series Color Mobile Computer User’s Manual Corporate Headquarters 6001 36th Avenue West Everett, Washington 98203 U.S.A. tel 425.348.2600 fax 425.355.9551 www.intermec.com 700 Series Color Mobile Computer User's Manual - November 2004 *961-054-031G* P/N 961-054-031 REV G
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : No Page Count : 230 XMP Toolkit : XMP toolkit 2.9.1-13, framework 1.6 About : uuid:0769820f-020a-49f8-8841-098c6d1779fa Modify Date : 2004:12:13 10:04:17-06:00 Create Date : 2004:12:13 10:03:58-06:00 Metadata Date : 2004:12:13 10:04:17-06:00 Document ID : uuid:c018bb33-6a61-45a3-bbbf-682ffc6a930d Format : application/pdf Title : legal Creator : PScript5.dll Version 5.2 Author : ThingA Producer : Acrobat Distiller 6.0 (Windows)EXIF Metadata provided by EXIF.tools