Intermec Technologies BTS080 8520-00080 radio in 700C User Manual legal
Intermec Technologies Corporation 8520-00080 radio in 700C legal
Contents
User Manual 2 of 2
207700 Series Color Mobile Computer User’s Manual
Programming
7
The following programming information pertains to the 700 Series Color
Mobile Computer:
SCreating CAB Files (page 208)
SCustomization and Lockdown (page 225)
SFTP Server (page 227)
SKernel I/O Control Functions (page 239)
SNetwork Selection APIs (page 255)
SNotifications (page 301)
SReboot Functions (page 303)
SRemapping the Keypad (page 304)
ProgrammingChapter —7
208 700 Series Color Mobile Computer User’s Manual
Creating CAB Files
The Windows CE operating system uses a .CAB file to install an applica-
tion 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:
SAll application files are present.
SA partial installation is prevented.
SThe 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:
1Create an .INF file with Windows CE-specific modifications (page
208).
2Optional Create a SETUP.DLL file to provide custom control of the
installation process (page 220).
3Use 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 223).
Creating an .INF File
An .INF file specifies information about an application for the CAB Wi-
zard. Below are the sections of an .INF file:
[Version]
This specifies the creator of the file, version, and other relevant informa-
tion.
Required? Yes
SSignature:“signature_name”
“$Windows NT$”
SProvider:“INF_creator”
The company name of the application, such as “Microsoft.”
SCESignature
“$Windows CE$”
Example
[Version]
Signature = “$Windows NT$”
Provider = “Intermec”
CESignature = “$Windows CE$”
Programming—Chapter 7
209700 Series Color Mobile Computer User’s Manual
[CEStrings]
This specifies string substitutions for the application name and the default
installation directory.
Required? Yes
SAppName:app_name
Name of the application. Other instances of %AppName% in the .INF
file are replaced with this string value, such as RP32.
SInstallDir:default_install_dir
Default installation directory on the device. Other instances of %Install-
Dir% 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
Sstring_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
ProgrammingChapter —7
210 700 Series Color Mobile Computer User’s Manual
[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
SProcessorType :processor_type
The value that is returned by SYSTEMINFO.dwProcessorType.For
example, the value for the ARM CPU is 2577
SUnsupportedPlatforms: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
SVersionMin: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.
SVersionMax: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.
SBuildMin: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.
SBuildMax: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.
Programming—Chapter 7
211700 Series Color Mobile Computer User’s Manual
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] ; A “template” for all platforms
UnsupportedPlatforms = pltfrm1 ; 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.
ProgrammingChapter —7
212 700 Series Color Mobile Computer User’s Manual
[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
SCopyfiles:copyfile_list_section
Maps to files defined later in the .INF file, such as Files.App, Files.Font,
and Files.Bitmaps.
SAddReg:add_registry_section
Example: RegSettings.All
SCEShortcuts:shortcut_list_section
String that identifies one more section that defines shortcuts to a file, as
defined in the [CEShortcuts] section.
SCESetupDLL:setup_DLL
Optimal string that specifies a SETUP.DLL file. It is written by the In-
dependent 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.
SCESelfRegister:self_reg_DLL_filename
String that identifies files that self-register by exporting the DllRegister-
Server 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 ap-
plication resides.
Required? Yes
Sdisk_ordinal:disk_label,,path
1=,“App files” , C:\Appsoft\RP32\...
2=,“Font files”,,C:\RpTools\...
3=,“CE Tools” ,,C:\windows ce tools...
SCESignature: “$Windows CE$”
Example
[SourceDisksNames] ; Required section
1 = ,“Common files”,,C:\app\common ; Using an absolute path
[SourceDisksNames.SH3]
2 = ,“SH3 files”,,sh3 ; Using a relative path
[SourceDisksNames.MIPS]
2 = ,“MIPS files”,,mips ; Using a relative path
Programming—Chapter 7
213700 Series Color Mobile Computer User’s Manual
[SourceDiskFiles]
This describes the name and path of the files in which your application
resides.
Required? Yes
Sfilename: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.
ProgrammingChapter —7
214 700 Series Color Mobile Computer User’s Manual
[DestinationDirs]
This describes the names and paths of the destination directories for the
application on the target device. Note Windows CE does not support directo-
ry identifiers.
Required? Yes
Sfile_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 ; \Program Files\My Subdir
Files.Shared = 0,%CE2% ; \Windows
Programming—Chapter 7
215700 Series Color Mobile Computer User’s Manual
[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 identi-
fies that mapping and may contain flags.
Required? Yes
Scopyfile_list_section:destination_filename,[source_filename]
The source_filename parameter is optional if it is the same as destina-
tion_filename.
Scopyfile_list_section:flags
The numeric value that specifies an action to be done while copying fi-
les. 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
ProgrammingChapter —7
216 700 Series Color Mobile Computer User’s Manual
[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
Sadd_registry_section:registry_root_string
String that specifies the registry root location. The following list shows
the values supported by Windows CE.
SHKCR Same as HKEY_CLASSES_ROOT
SHKCU Same as HKEY_CURRENT_USER
SHKLM Same as HKEY_LOCAL_MACHINE
Sadd_registry_section:value_name
Registry value name. If empty, the “default” registry value name is used.
Sadd_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 ; <default> = “alpha”
HKLM,%reg_path%,test,0x00010001,3 ; Test = 3
HKLM,%reg_path%\new,another,0x00010001,6 ; New\another = 6
Programming—Chapter 7
217700 Series Color Mobile Computer User’s Manual
[CEShortCuts]
This section, a Windows CE-specific section under the [DefaultInstall]
section, is optional and describes the shortcuts that the installation applica-
tion 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
Sshortcut_list_section:shortcut_filename
String that identifies the shortcut name. It does not require the .LNK
extension.
Sshortcut_list_section:shortcut_type_flag
Numeric value. Zero or empty represents a shortcut to a file; any non-
zero numeric value represents a shortcut to a folder.
Sshortcut_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 [Destination-
Dirs] section, such as DefaultDestDir,orthe%InstallDir% string.
Sshortcut_list_section:standard_destination_path
Optional string value. A standard %CEx% path or %InstallDir%.Ifno
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 ; Uses the path in DestinationDirs. Sample
App,0,sample.exe,%InstallDir% ; 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
ProgrammingChapter —7
218 700 Series Color Mobile Computer User’s Manual
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 ; Uses the path in DestinationDirs.
;Sample App,0,sample.exe,%InstallDir% ; 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
Programming—Chapter 7
219700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
220 700 Series Color Mobile Computer User’s Manual
Using Installation Functions in SETUP.DLL
SETUP.DLL is an optional file that enables you to perform custom opera-
tions during installation and removal of your application. The following
list shows the functions that are exported by SETUP.DLL.
SInstall_Init
Called before installation begins. Use this function to check the applica-
tion version when reinstalling an application and to determine if a de-
pendent application is present.
SInstall_Exit
Called after installation is complete. Use this function to handle errors
that occur during application installation.
SUninstall_Init
Called before the removal process begins. Use this function to close the
application, if the application is running.
SUninstall_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 212) 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 <windows.h>
#include <Tlhelp32.h>
#include <winioctl.h>
#include <ce_setup.h> // 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.
Programming—Chapter 7
221700 Series Color Mobile Computer User’s Manual
// FALSE - process is not running.
// $DOCEND$
//************************************************************************
BOOL IsProcessRunning( TCHAR * pname )
{
HANDLE hProcList;
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;
}
ProgrammingChapter —7
222 700 Series Color Mobile Computer User’s Manual
codeINSTALL_EXIT Install_Exit (
HWND hwndParent,
LPCTSTR pszInstallDir,
WORD cFailedDirs,
WORD cFailedFiles,
WORD cFailedRegKeys,
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;
}
Programming—Chapter 7
223700 Series Color Mobile Computer User’s Manual
codeUNINSTALL_INIT
Uninstall_Init(
HWND hwndParent,
LPCTSTR pszInstallDir ) {
// 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 <program> directory, with the following com-
mands, works well:
cabwiz.exe c:\appsoft\<program>\<inf_file_name>
cd \appsoft\<program>
S“inf_file”
The SETUP.INF file path.
Sdest_directory
The destination directory for the .CAB files. If no directory is specified,
the .CAB files are created in the “inf_file” directory.
Serror_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 speci-
fied, 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 au-
tomated builds.
ProgrammingChapter —7
224 700 Series Color Mobile Computer User’s Manual
Scpu_type
Creates a .CAB file for each specified microprocessor tag, which is a la-
bel used in the Win32 SETUP.INF file to differentiate between differ-
ent 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.
Troubleshooting the CAB Wizard
To identify and avoid problems that might occur when using the CAB
Wizard, follow these guidelines:
SUse %% 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.
SDo not use .INF or .CAB files created for Windows CE to install ap-
plications on Windows-based desktop platforms.
SEnsure the MAKECAB.EXE and CABWIZ.DDF files, included with
Windows CE, are in the same directory as CABWIZ.EXE.
SUse the full path to call CABWIZ.EXE.
SDo 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.
SDo not set the read-only attribute for .CAB files.
Programming—Chapter 7
225700 Series Color Mobile Computer User’s Manual
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 spe-
cification. Manufacturers are free to add extra hardware functionality.
Pocket PC devices also use a specialized version of the CE operating sys-
tem. This OS is built from Windows CE 3.0 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 require-
ments. The test lab then reports the findings back to Microsoft Corpora-
tion and Intermec Technologies. If the 700 Series 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,
thedevicewouldfailITLtestingandwewouldnotbeabletoshipdevices
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 featu-
res. Intermec cannot customize the operating system in any way but a cus-
tom application can:
SDelete 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 ap-
plication will need to be run on every cold boot.
SUse 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 situa-
tion.
SUse 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.
SRemap keys and disable keys on the keypad.
SCreate a custom SIP.
SMake changes to the registry to configure the device.
ProgrammingChapter —7
226 700 Series Color Mobile Computer User’s Manual
Should you want your 700 Series Computer to display a full screen, keep
in mind that your computer is Pocket-PC certified by Microsoft Corpora-
tion. Check out resources on programming for the Pocket PC, using the
following links. These instructions give full instructions on how to display
full screen.
SInstructions on how to create a full screen application for eVC++ ap-
plications using an SHFullScreen() API:
http://support.microsoft.com/support/kb/articles/Q266/2/44.ASP
SInstructions on how to create a full screen application for eVB applica-
tions also using the SHFullScreen() API:
http://support.microsoft.com/support/kb/articles/Q265/4/51.ASP
Programming—Chapter 7
227700 Series Color Mobile Computer User’s Manual
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 ser-
vicing FTP client requests the FTP Server also send a “network announce-
ment” 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:
Shttp://www.ietf.org/rfc/rfc959.txt for the text version, or
Shttp://www.w3.org/Protocols/rfc959/ for an html version
Do the following to send commands:
1Start an FTP client and connect to the device FTP server.
2Log in with “intermec” as the user name and “cr52401” for the pass-
word.
3From the FTP client, send the command.
4Wait for a response.
Synopsis
ftpdce [options ]
Options
S–Aaddr (where addr is in the form of a.b.c.d)
Sets the single target address to which to send the network announce-
ment. Default is broadcast.
S–Bbyte
Sets the FTP data block size. Smaller sizes may be useful over slower
links. Default is 65536.
S–Cname
Sets the device name. Used by Intermec management software.
S–Fvalue
Disables the default Intermec account. A value of “0” disables the ac-
count. Default is “1”.
Note: Disabling the default account without providing a working access
controllistontheserverwillresultinadevicethatwillnotacceptany
FTP connections.
S–Hsec
Sets the interval between network announcements in seconds.A value of
“0” turns the network announcement off. Default is 30 seconds.
ProgrammingChapter —7
228 700 Series Color Mobile Computer User’s Manual
S–Iaddr (where addr is in the form of a.b.c.d)
Sets the preferred 6920 Communications Server (optional).
S–Llog (where log is either “0” or “1”)
Sets the state of logging. Default is 0 (disabled).
S–Nsec
Specifies the number of seconds to wait before initially starting FTP
server services.
S–Pport
Sets the UDP port on which the network announcement will be sent.
Default port is 52401.
S–Qport
Sets the port on which the FTP Server will listen for connections.
Defaultportis21.
S–Rdir
Sets the FTP mount point to this directory. Default is the root folder of
the object store.
S–Tscript
Sets the script name for the 6920 Communications Server to process.
S–Uurl
Sets the default URL for this device.
S–Z“parms”
Sets extended parameters to be included in the network announcement.
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. Adjust-
ing 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
Programming—Chapter 7
229700 Series Color Mobile Computer User’s Manual
DeviceName
This parameter configures the Intermec FTP Server to include the speci-
fied 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 speci-
fied URL in the IDNA. This can be used by Intermec management soft-
ware for asset management.
Key
HKLM\Software\Intermec\IFTP
Value Type
REG_SZ
Valid Range
None.
Default
None.
ProgrammingChapter —7
230 700 Series Color Mobile Computer User’s Manual
IDNATarget
This parameter configures the Intermec FTP Server to transmit the IDNA
to a specific destination instead of a general UDP broadcast. This parame-
ter is useful on networks that do not allow UDP broadcasts to be routed
between subnets. The use of this parameter will restrict 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 speci-
fied 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 pa-
rameter.
Key
HKLM\Software\Intermec\IFTP
Value Type
REG_SZ
Valid Range
None.
Default
iftp.ini
Programming—Chapter 7
231700 Series Color Mobile Computer User’s Manual
PauseAtStartup
This parameter configures the Intermec FTP Server to sleep for the speci-
fied 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
0
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 ex-
isting directory or you will not be able to log into the FTP Server.
Key
HKLM\Software\Intermec\IFTP
Value Type
REG_SZ
Valid Range
None.
Default
\
ProgrammingChapter —7
232 700 Series Color Mobile Computer User’s Manual
Transferring Files Over TCP/IP Networks
The File Transfer Protocol (FTP) server transfers files over TCP/IP net-
works. 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 ser-
vicing FTP client requests, the FTP Server also sends a “network an-
nouncement” to notify prospective clients of server availability.
Remarks
The FTP Server currently supports the following FTP requests:
SCDUP
Changes to the parent directory of the current working directory.
SCWD
Changes working directory.
SDELE
Deletes a file.
SHELP
Gives help information.
SLIST (This FTP request is the same as the ls -lgA command).
Gives list files in a directory.
SMKD
Makes a directory.
SMODE (AlwaysUsesBinary).
Specifies data transfer mode.
SNLST (Not supported)
Gives a name list of files in directory (this FTP request is the same as
the ls command).
SNOOP
Does nothing.
SPASS
Specifies a password.
SPWD
Prints the current working directory.
SQUIT
Terminates session.
SRETR
Retrieves a file.
SRMD
Removes a directory.
SRNFR
Specifies rename-from file name.
Programming—Chapter 7
233700 Series Color Mobile Computer User’s Manual
SRNTO
Specifies rename-to file name.
SSTOR
Stores a file.
SSYST
Shows the operating system type of server system.
STYPE (Binary transfers only.)
Specifies the data transfer type with the Type parameter.
SUSER
Specifies user name.
SXCUP (Not Normally Used)
Changes the parent directory of the current working directory.
SXCWD (Not Normally Used)
Changes the current directory.
SXMKD (Not Normally Used)
Creates a directory.
SXPWD (Not Normally Used)
Prints the current working directory.
SXRMD (Not Normally Used)
Removes a directory.
SSITE
The following extended OEM commands are supported by the SITE
request. For Microsoft FTP clients, you can send site commands by pre-
ceding the command with “quote” such as “quote site status.”
SATTRIB
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.
RRead-only file attribute.
AArchive file attribute.
SSystem file attribute.
HHidden 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:
CCompressed file attribute.
EEncrypted file attribute.
IINROM file attribute.
XXIPfileattribute(executeinROM,notshadowedinRAM).
ProgrammingChapter —7
234 700 Series Color Mobile Computer User’s Manual
SBOOT
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:QUOTE SITE BOOT [WARM |COLD]
SCOPY
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’
SEXIT
Exits the FTP Server. This command will shut down the FTP Server
thus terminating all client connections. (SITE EXIT)
Usage:QUOTE SITE EXIT
SHELP
Gives site command help information. (SITE HELP)
Usage:QUOTE SITE HELP [command]
SKILL
Terminates a running program. (SITE KILL)
Usage:QUOTE SITE KILL [program |pid]
SLOG
Opens or closes the program log. (SITE LOG)
Usage:QUOTE SITE LOG [open [filename]| close]
SPLIST
Lists the running processes (SITE PLIST)
Usage:QUOTE SITE PLIST
SRUN
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’
Programming—Chapter 7
235700 Series Color Mobile Computer User’s Manual
SSTATUS
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:QUOTE SITE STATUS
STIMEOUT
Toggles idle timeout between 120 to 1200 seconds (2 to 20 minutes).
If this timer expires with no activity between the client and the serv-
er, 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:QUOTE SITE TIMEOUT [seconds]
SEKEY
Gives site command electronic key information. (SITE HELP)
Usage:QUOTE SITE EKEY [command]
SEVAL
Gives site command electronic value information. (SITE HELP)
Usage:QUOTE SITE EVAL [command]
SGVAL
Gives site command general value information. (SITE HELP)
Usage:QUOTE SITE GVAL [command]
SPVAL
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 num-
ber and OS 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 environ-
ment.
The FTPDCMDS subdirectory contains commands that can be used from
the web browser.
SClick EXITME.BIN to execute a SITE EXIT command.
SClick REBOOTME.BIN to execute SITE BOOT command.
ProgrammingChapter —7
236 700 Series Color Mobile Computer User’s Manual
SUse the GET command on these files to have the FTP Server execute
these commands.
SSecurity:
A customer configurable access control list may be installed on the
700 Series Computer. This list will allow customers to restrict access
via the FTP Server to the users they wish. This is in addition to the
default Intermec account which can be 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 Series Computer as the FTPDCE.EXE
server. The FTP Server will encrypt 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 Series Computer
after the FTP Server starts will require a restart of the FTP Server to
take effect.
The format of the FTPDCE.TXT is as follows:
FTPDCE:user1!passwd1<cr><lf>user2!passwd2<cr><lf>user3!pas
swd3<cr><lf>...
Note: The user accounts and passwords are case sensitive.
Once the access control list is encrypted on the 700 Series Computer, the
FTP Server hides this file from users. Once an access control list is
installed on the 700 Series 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 Series 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 Net-
work 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.
Programming—Chapter 7
237700 Series Color Mobile Computer User’s Manual
Autostart FTP
This automatically starts the FTP Server (FTPDCE.EXE) when the 700
Series 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 un-
load the network drivers. Tap the antenna icon in the System Tray of the
Today screen (a sample antenna icon is circled below) to get this pop-up
menu.
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” en-
ables 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 Series 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 RESE-
TIFTP to implement the restart on resume feature.
ProgrammingChapter —7
238 700 Series Color Mobile Computer User’s Manual
To do an AutoFTP Installation Check:
1Ensure the FTP Server is running “out-of-the-box” the first time.
2Tap 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.
3Tap 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.
4Unload the network driver when the FTP Server is running and con-
firm that it is not running any more.
5Load 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.
Programming—Chapter 7
239700 Series Color Mobile Computer User’s Manual
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
namebasedonaninputvalue.
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_GETPLAT-
FORMTYPE 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_GE-
TOEMINFO is specified in lpInBuf, then the “Intermec 700\0”
Unicode string is returned.
nOutBufSize ThesizeoflpOutBuf 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.
ProgrammingChapter —7
240 700 Series Color Mobile Computer User’s Manual
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 ThesizeoflpOutBuf 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.11 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.
Programming—Chapter 7
241700 Series Color Mobile Computer User’s Manual
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:
SVN_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.
SVN_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.
SVN_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
indicatesthatitisnotinstalled.
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.
ProgrammingChapter —7
242 700 Series Color Mobile Computer User’s Manual
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.
SITC_DEVID_SCANHW_NONE No scanner hardware is installed.
SITC_DEVID_OEM2D_IMAGER OEM 2D imager is installed.
SITC_DEVID_INTERMEC2D_IMAGER Intermec 2D imager is installed.
SITC_DEVID_SE900_LASER SE900 laser is installed.
SITC_DEVID_SE900HS_LASER SE900HS laser is installed.
SITC_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 whichindicatesthetypeofWANradiohardwareinstalled.Themaximumpossiblevaluereturnedis
ITC_DEVID_WANRADIO_MAX. The current definitions are:
SITC_DEVID_WANRADIO_NONE No WAN radio installed.
SITC_DEVID_WANRADIO_SIERRA_SB555 CDMA Sierra Wireless radio.
SITC_DEVID_WANRADIO_XIRCOM_GEM3503 GSM/GPRS Intel (Xircom) radio.
SITC_DEVID_WANRADIO_SIEMENS_MC45 GSM/GPRS Siemens radio.
ITC_NVPARM_80211_INSTALLED
This IOCTL reads the state of the 802.11b radio installed flag. A BOOLEAN DWORD is returned in the buffer
pointed to by lpOutBuffer. TRUE indicates that the 802.11b radio is installed. FALSE indicates that no 802.11b
radio is installed.
ITC_NVPARM_80211_RADIOTYPE
This IOCTL reads the 802.11b radio ID installed by manufacturing. A BYTE is returned in the buffer pointer to by
lpOutBuffer that indicates the type of 802.11b radio hardware installed. The maximum possible value returned is
ITC_DEVID_80211RADIO_MAX. The current definitions are:
SITC_DEVID_80211RADIO_NONE No 802.11b radio installed.
SITC_DEVID_80211RADIO_INTEL_2011B Intel 2011B radio installed.
Programming—Chapter 7
243700 Series Color Mobile Computer User’s Manual
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.
ProgrammingChapter —7
244 700 Series Color Mobile Computer User’s Manual
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 Asinglebytethatmaybeoneoftheid 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 ThesizeoflpOutBuf 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.
Programming—Chapter 7
245700 Series Color Mobile Computer User’s Manual
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
definedinOEMIOCTL.H.Onlythefollowingkeysareprogrammableaswakeupevents.
#define SCANNER_TRIGGER 1
#define SCANNER_LEFT 2
#define SCANNER_RIGHT 4
#define GOLD_A1 8
#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.
ProgrammingChapter —7
246 700 Series Color Mobile Computer User’s Manual
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 re-
turned.
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 re-
turned if the size in bytes is greater than or equal to sizeof(DE-
VICE_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.
Programming—Chapter 7
247700 Series Color Mobile Computer User’s Manual
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:
Scboemverinfo sizeof (tagOemVerInfo);
Sverinfover 1
Ssig; “ITC\0”
Sid; ‘N’
Stgtcustomer “”
Stgtplat SeaRay
Stgtplatversion Current build version number
Stgtcputype[8]; “Intel\0”
Stgtcpu “PXA255\0”;
Stgtcoreversion “”
Sdate Build time
Stime Build date
nOutBufSize ThesizeofVERSIONINFOinbytes.
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.
ProgrammingChapter —7
248 700 Series Color Mobile Computer User’s Manual
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:
Scboemverinfo Sizeof (tagOemVerInfo);
Sverinfover 1
Ssig; “ITC\0”
Sid; ‘B’
Stgtcustomer “”
Stgtplat SeaRay
Stgtplatversion Current build version number of the
bootstrap loader
Stgtcputype[8]; “Intel\0”;
Stgtcpu “PXA255\0”
Stgtcoreversion “”
Sdate Build time
Stime Build date
nOutBufSize ThesizeofVERSIONINFOinbytes.
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.
Programming—Chapter 7
249700 Series Color Mobile Computer User’s Manual
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.
ProgrammingChapter —7
250 700 Series Color Mobile Computer User’s Manual
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; // most recent reset type
DWORD ObjectStoreState; // state of object store
} HAL_RESET_INFO, * PHAL_RESET_INFO;
// Reset reason types
#define HAL_RESET_TYPE_UNKNOWN 0
#define HAL_RESET_REASON_HARDWARE 1 // cold
#define HAL_RESET_REASON_SOFTWARE 2 // suspend
#define HAL_RESET_REASON_WATCHDOG 4
#define HAL_RESET_BATT_FAULT 8 // power fail
#define HAL_RESET_VDD_FAULT 16 // warm boot
// Object store state flags
#define HAL_OBJECT_STORE_STATE_UNKNOWN 0
#define HAL_OBJECT_STORE_STATE_CLEAR 1
Programming—Chapter 7
251700 Series Color Mobile Computer User’s Manual
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 sup-
ported:
#define HAL_BOOT_DEVICE_UNKNOWN 0
#define HAL_BOOT_DEVICE_ROM_XIP 1
#define HAL_BOOT_DEVICE_ROM 2
#define HAL_BOOT_DEVICE_PCMCIA_ATA 3
#define HAL_BOOT_DEVICE_PCMCIA_LINEAR 4
#define HAL_BOOT_DEVICE_IDE_ATA 5
#define HAL_BOOT_DEVICE_IDE_ATAPI 6
nOutBufSize ThesizeoflpOutBuf 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.
ProgrammingChapter —7
252 700 Series Color Mobile Computer User’s Manual
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.
Programming—Chapter 7
253700 Series Color Mobile Computer User’s Manual
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; // Set to value 1
WCHAR szProcessorCore[40]; // “ARM\0”
WORD wCoreRevision; // 4
WCHAR szProcessorName[40]; // “PXA255\0”
WORD wProcessorRevision; // 0
WCAHR szCatalogNumber[100]; // 0
WCHAR szVendor[100]; // “Intel Corporation\0”
DWORD dwInstructionSet; // 0
DWORD dwClockSpeed; // 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.
ProgrammingChapter —7
254 700 Series Color Mobile Computer User’s Manual
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 ShouldpointtoaCPUIdInfostructuredefinedinOEMIOCTL.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.
Programming—Chapter 7
255700 Series Color Mobile Computer User’s Manual
Network Selection APIs
The Network Selection APIs change the network adapter configuration
programmatically. Both drivers support the same IOCTL function num-
bers for loading and unloading the drivers.
Loading and unloading of the 802.11b 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.
SFor loading an NDIS driver associated with an adapter, the IOCTL is
IOCTL_LOAD_NDIS_MINIPORT.
SFor unloading NDIS drivers associated with an adapter the IOCTL is
IOCTL_UNLOAD_NDIS_MINIPORT.
Example
#include <winioctl.h>
#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);
}
}
}
ProgrammingChapter —7
256 700 Series Color Mobile Computer User’s Manual
The API provided by Intermec Technologies exposes a limited set of rou-
tines that allows a programmer to access and affect the 802.11b network
interface card from within their application. The routines provided also
reads/writes values to the CE registry that pertain to the 802.11b radio
driver. By using the provided functions, a programmer can alter the
802.11b 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 pres-
ent in any load with the 802.11b networking installed.
NETWLAN.DLL
PRISMNDS.DLL
This file is the 802.11b driver. It is present in all 700 CE loads
that use the 802.11b network interface card.
80211API.DLL This file is an Intermec authored file that provides the program-
mer with a set of API calls to configure or monitor status of the
802.11b network.
MOD80211.DLL The CORE module for the 802.11b NIC. It provides the
802.11b status information displayed when the CORE applica-
tion is running.
80211CONF.EXE This is the “Control Panel” for configuring the 802.11b 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 applica-
tion 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 profiles and switch between them using the 802.11 API.
See the ConfigureProfile() function on page 286 for more information.
Programming—Chapter 7
257700 Series Color Mobile Computer User’s Manual
Basic Connect/Disconnect Functions
Below are functions available for the 700 Series Color Computer when
enabled with the 802.11b 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 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 radio available on the sys-
tem. Check extended error codes if it returns anything else for informa-
tion.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_RadioConnect)();
#else
UINT RadioConnect();
#endif
ProgrammingChapter —7
258 700 Series Color Mobile Computer User’s Manual
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.
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
Programming—Chapter 7
259700 Series Color Mobile Computer User’s Manual
RadioDisassociate()
Call this function to have the 802.11b 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
ProgrammingChapter —7
260 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
261700 Series Color Mobile Computer User’s Manual
GetAuthenticationMode()
Call this function to obtain the radio’s current authentication mode.
Syntax
UINT GetAuthenticationMode( ULONG &);
Parameters
NDIS_RADIO_AUTH_MODE_OPEN 802.11b Open Authentication. In-
dicates that the radio is using an
open system.
NDIS_RADIO_AUTH_MODE_SHARED 802.11b Shared Authentication. In-
dicates 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 deter-
mined 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
ProgrammingChapter —7
262 700 Series Color Mobile Computer User’s Manual
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,
andservesastheIDfortheIBSS.
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
Programming—Chapter 7
263700 Series Color Mobile Computer User’s Manual
GetDiversity()
Call this function to get the current diversity setting of your 802.11b ra-
dio. This function uses an optional NDIS5.1 OID to query the radio,
which a large number of 802.11b devices do not support. This function
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
ProgrammingChapter —7
264 700 Series Color Mobile Computer User’s Manual
GetLinkSpeed()
Call this function to get the current link speed of the 802.11b 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 ex-
ample: 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
Programming—Chapter 7
265700 Series Color Mobile Computer User’s Manual
GetMac()
Call this function to get the MAC address of the 802.11b radio.
Syntax
UINT GetMac( TCHAR * );
Parameters
Pointer to a character array, which is populated with the MAC address af-
ter 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: Call RadioConnect() before calling this function for this function to
work properly.
ProgrammingChapter —7
266 700 Series Color Mobile Computer User’s Manual
GetNetworkMode()
Call this function to get the current Network Mode (SSID) for the
802.11b 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. Useofthisoptionisnot
supported or recommended.
NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps
NDIS_NET_TYPE_OFDM_2_4G 802.11g 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
Programming—Chapter 7
267700 Series Color Mobile Computer User’s Manual
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 Indicatesthatthisisafrequencyhoppingradio.
NDIS_NET_TYPE_DS Indicatesthatthisisadirectsequenceradio.
NDIS_NET_TYPE_UNDEFINED Indicates that 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
ProgrammingChapter —7
268 700 Series Color Mobile Computer User’s Manual
GetSSID()
Call this function to get the desired SSID of the 802.11b 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.
Programming—Chapter 7
269700 Series Color Mobile Computer User’s Manual
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: al-
ways 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.
ProgrammingChapter —7
270 700 Series Color Mobile Computer User’s Manual
GetRSSI()
Call this function to get the current RSSI (Radio Signal Strength Indica-
tor), in Dbm.
Syntax
UINT GetRSSI( ULONG & );
Parameters
References a ULONG that is populated with the current RSSI after a suc-
cessful 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
Programming—Chapter 7
271700 Series Color Mobile Computer User’s Manual
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 5mW
NDIS_POWER_LEVEL_1 1mW
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
ProgrammingChapter —7
272 700 Series Color Mobile Computer User’s Manual
GetWepStatus()
Call this function to get the current state of the radio’s WEP and encryp-
tion 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 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,orWEP,andAES,TKIP,andWEPareenabled.
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
Programming—Chapter 7
273700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
274 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
275700 Series Color Mobile Computer User’s Manual
Set Information Functions
AddWep()
Call this function to add a WEP key to the radio. Call this function multi-
ple 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
ProgrammingChapter —7
276 700 Series Color Mobile Computer User’s Manual
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 encryp-
tion. Call this function with the FALSE parameter to disable WEP encryp-
tion. 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
Programming—Chapter 7
277700 Series Color Mobile Computer User’s Manual
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,orWEP,andAES,TKIP,andWEPareenabled.
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
ProgrammingChapter —7
278 700 Series Color Mobile Computer User’s Manual
SetAuthenticationMode()
Call this function to set the desired authentication mode.
Syntax
UINT SetAuthenticationMode( ULONG );
Parameters
NDIS_RADIO_AUTH_MODE_OPEN 802.11b Open Authentication. In-
dicates that the radio is using an
open system.
NDIS_RADIO_AUTH_MODE_SHARED 802.11b Shared Authentication. In-
dicates 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 deter-
mined 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
Programming—Chapter 7
279700 Series Color Mobile Computer User’s Manual
SetChannel()
This function is currently not implemented. Ad-hoc networks automatical-
ly 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
ProgrammingChapter —7
280 700 Series Color Mobile Computer User’s Manual
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. Useofthisoptionisnot
supported or recommended.
NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps
NDIS_NET_TYPE_OFDM_2_4G 802.11g 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
Programming—Chapter 7
281700 Series Color Mobile Computer User’s Manual
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: al-
ways 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
None.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_SetPowerMode)(ULONG mode);
#else
UINT SetPowerMode(ULONG mode);
#endif
ProgrammingChapter —7
282 700 Series Color Mobile Computer User’s Manual
SetSSID()
Call this function with a pointer to a null-terminated TCHAR array con-
taining 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
Programming—Chapter 7
283700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
284 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
285700 Series Color Mobile Computer User’s Manual
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, the WEP key
is removed by the adapter.
Definitions
#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_RemoveWEP)(ULONG);
#else
UINT RemoveWEP(ULONG);
#endif
ProgrammingChapter —7
286 700 Series Color Mobile Computer User’s Manual
Helper Functions
ConfigureProfile()
If using the Intermec 802.11b Profile Management system, you can pro-
gram the API to configure the radio to a specific profile by passing the
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
Programming—Chapter 7
287700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
288 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
289700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
290 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
291700 Series Color Mobile Computer User’s Manual
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),youmaywishtocallitfromaseparate
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
ProgrammingChapter —7
292 700 Series Color Mobile Computer User’s Manual
StartSupplicant()
Call this function to start the supplicant service if it is installed on the sys-
tem.
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
Programming—Chapter 7
293700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
294 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
295700 Series Color Mobile Computer User’s Manual
RenewDHCP()
Call this function to force a DHCP renewal on the current network adap-
ter.
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
ProgrammingChapter —7
296 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
297700 Series Color Mobile Computer User’s Manual
ResetRadioToSystemSave()
Call this function to force the radio to reset to the last desired active pro-
file.
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
ProgrammingChapter —7
298 700 Series Color Mobile Computer User’s Manual
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
Programming—Chapter 7
299700 Series Color Mobile Computer User’s Manual
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
ProgrammingChapter —7
300 700 Series Color Mobile Computer User’s Manual
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) UINT SetDiversity( USHORT );
Programming—Chapter 7
301700 Series Color Mobile Computer User’s Manual
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 pres-
ent in the system.
Regarding an applications interface to NLED.DLL, LEDs must be avail-
able for use by applications. This is possible via two functions exported by
the COREDLL.DLL file. To use the LED functions, declare these as ex-
tern ”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:
SNotification LED 0
SRadio On LED 1 (does not apply to the 730 Computer)
SAlpha Lock LED 2
SScanner LED 3
SLow Battery 4
SVibrator 5 (does not apply to the 730 Computer)
ProgrammingChapter —7
302 700 Series Color Mobile Computer User’s Manual
NLEDGetDeviceInfo
Usage
#include “nled.h”
Syntax
BOOL NLEDGetDeviceInfo ( UINT nInfoId, void *pOutput );
Parameters
SnInfoId
Integer specifying the information to return. These values are defined:
NLED_COUNT_INFO Indicates the pOutput buffer specifies the num-
ber of LEDs on the device.
NLED_SUPPORTS_INFO_ID Indicates the pOutput buffer specifies informa-
tion about the capabilities supported by the
LED.
NLED_SETTINGS_INFO_ID Indicates the pOutput buffer contains informa-
tion about the LED current settings.
SpOutput
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
SnDeviceId
Integer specifying the device identification. The following is defined:
NLED_SETTINGS_INFO_ID Contains information about the desired LED
settings.
SpInput
Pointertothebufferthatcontains the NLED_SETTINGS_INFO
structure.
Programming—Chapter 7
303700 Series Color Mobile Computer User’s Manual
Reboot Functions
There are several methods, via Kernel I/O Control functions, that an ap-
plication program can use to force the 700 Series Computer to reboot.
IOCTL_HAL_REBOOT
IOCTL_HAL_REBOOT performs a warm-boot. See page 252.
IOCTL_HAL_COLDBOOT
Invoking the KernelIOControl function with
IOCTL_HAL_COLDBOOT forces a cold reboot. This resets the 700
Series Computer and reloads Windows CE as if a power-up had been
performed. The contents of the Windows CE RAM-based object store are
discarded. See page 249.
IOCTL_HAL_WARMBOOT
This function is supported on the 700 Series Computers. It performs a
warm boot of the system, preserving the object store. See page 249.
ProgrammingChapter —7
304 700 Series Color Mobile Computer User’s Manual
Remapping the Keypad
Note; Use caution when remapping the keypad. Improper remapping may
render the keypad unusable. Data within the 700 Series 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 boot-
ing 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
1M1
5T5
9Y9
Gold Plane
The gold plane contains values from the keypad when a key is simulta-
neously pressed with the [Gold] bkey on the numeric keypad or the
[Gold/White] ckey on the alphanumeric keypad, such as the following:
Press the Keys
Numeric Keypad Alphanumeric Keypad To Enter This
[Gold] b1[Gold/White] ce Send
[Gold] b5[Gold/White] cC A3
[Gold] b9[Gold/White] cP PgDn
Programming—Chapter 7
305700 Series Color Mobile Computer User’s Manual
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 fol-
lowing:
Press the Keys
Numeric Keypad Alphanumeric Keypad To Enter This
[Alpha] F1[Alpha] FgCaps
[Alpha] F5[Alpha] FJj
[Alpha] F9[Alpha] FWw
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(), RegQuery-
ValueEx(), and RegSetValueEx().
Numeric Keypad
For the 700 Color Numeric Keypad, the following registry keys contain
the plane mappings:
SThe unshifted plane mapping can be found in the registry at:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\Vkey
SThe gold plane mapping can be found in the registry at:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\VkeyGold
SThe 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 con-
tain the plane mappings:
SThe unshifted plane mapping can be found in the registry at:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\Vkey
SThe gold plane mapping can be found in the registry at:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\VkeyGold
SThe alpha plane mapping can be found in the registry at:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD\ALPHA\VkeyAlpha
ProgrammingChapter —7
306 700 Series Color Mobile Computer User’s Manual
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 this 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. Look-
ing 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 repre-
sentation 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. Remap-
ping these scan codes could render your 700 Series 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 situa-
tion 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.
Programming—Chapter 7
307700 Series Color Mobile Computer User’s Manual
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
PressthisKey Meaning ScanCode
Reserved 0x00
II/O button 0x01
Scanner Handle Trigger 0x02
Scanner Left 0x03
Scanner Right 0x04
44/GHI/A2 0x06
None 0x07
LLeft arrow/Back Tab 0x08
None 0x09
KBkSp// (forward slash) 0x0A
b[Gold] key 0x0B
None 0x0C
EEsc/– (minus sign) 0x0D
DDown arrow/Volume decrease 0x0E
11/Caps/Send 0x0F
77/PQRS/PgUp 0x10
F[Alpha] key 0x11
None 0x12
UUp arrow/Volume increase 0x13
RRight arrow/Tab 0x14
22/ABC/End 0x15
88/TUV/* (asterisk) 0x16
00/Win 0x17
55/JKL/A3 0x18
None 0x19
AAction/+ (plus symbol) 0x1A
33/DEF/backlight 0x1B
99/WXYZ/PgDn 0x1C
ProgrammingChapter —7
308 700 Series Color Mobile Computer User’s Manual
Numeric Keypad Scan Codes and Meanings (continued)
ScanCodeMeaningPressthisKey
eEnter/@ (at symbol) 0x1D
66/MNO/A4 0x1E
None 0x1F–0x40
BCharge Detect 0x41
CLCD frontlight 0x42
bAmbient light 0x42
Threshold crossed 0x42
Headset detected 0x43
Keypad Backlight 0x44
bAmbient Light 0x44
Threshold Crossed 0x44
Alphanumeric Keypad
The following scan codes pertain to the 700 Color Alphanumeric keypad:
Alphanumeric Keypad Scan Codes and Meanings
PressthisKey Meaning ScanCode
Reserved 0x00
iI/O button 0x01
Scanner Handle Trigger 0x02
Scanner Left 0x03
Scanner Right 0x04
AA/A1 key 0x05
BB/A2 key 0x06
eEscape/Send 0x07
jLeft arrow/Back Tab 0x08
kUp arrow/Volume increase 0x09
mDown arrow/Volume decrease 0x0A
lRight arrow/Tab 0x0B
aAction/End 0x0C
EE/Win 0x0D
FF/= (equal sign) 0x0E
GG/* (asterisk) 0x0F
CC/A3 0x10
HH// (forward slash) 0x11
DD/A4 0x12
Programming—Chapter 7
309700 Series Color Mobile Computer User’s Manual
Alphanumeric Keypad Scan Codes and Meanings (continued)
ScanCodeMeaningPressthisKey
JJ/PgUp 0x13
KK/@ (as symbol) 0x14
LL/– (minus sign) 0x15
MM/1 0x16
NN/2 0x17
II/backlight 0x18
PP/PgDn 0x19
QQ/, (comma) 0x1A
RR/+ (plus sign) 0x1B
SS/4 0x1C
TT/5 0x1D
OO/3 0x1E
gCaps/Lock 0x1F
hBkSp 0x20
VV/. (period) 0x21
WW/7 0x22
XX/8 0x23
UU/6 0x24
cGold/White 0x25
NumLock 0x26
bSpace 0x27
ZZ/0 0x28
fEnter 0x29
YY/9 0x2A
None 0x2B–0x40
BCharge Detect 0x41
CLCD frontlight 0x42
bAmbient light 0x42
Threshold crossed 0x42
Headset detected 0x43
Keypad Backlight 0x44
bAmbient Light 0x44
Threshold Crossed 0x44
ProgrammingChapter —7
310 700 Series Color Mobile Computer User’s Manual
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
311700 Series Color Mobile Computer User’s Manual
Configurable Settings
A
This appendix contains information about the Data Collection, Intermec
Settings, SNMP, Unit Information, Utilities, and Wireless Network con-
trol panel applets that may be on the 700 Series Color Mobile Computer.
SNMP, Intermec Settings, and Data Collection settings that can appear
under Settings are dependent on what hardware configuration is done for
each 700 Series Computer at the time of shipment. These settings will cur-
rently only appear if a scanner or an imager option is present.
Likewise, other control panel applets that are specifically related to the
802.11b radio module will appear when a 802.11b radio module is
installed in a 700 Series 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 Series Computer. See Chapter 4, “Network Support,” for more infor-
mation 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 Com-
mand Reference Manual (P/N: 073529). The online manual is available
from the Intermec web site at www.intermec.com.
Configurable SettingsAppendix —A
312 700 Series Color Mobile Computer User’s Manual
Configuration Parameters
A configuration parameter changes the way the 700 Series Color Mobile
Computer operates, such as configuring a parameter to have the 700 Series
Computer emit a very loud beep in a noisy environment. Use any of the
following methods to execute configuration parameters:
SChange Data Collection and SNMP parameters via control panel ap-
plets later in this appendix.
SSend parameters from an SNMP management station. See “SNMP Con-
figuration on the 700 Series Computer” starting on page 178.
SScan EasySet bar codes. You can use the EasySet bar code creation soft-
ware from Intermec Technologies Corporation to print configuration
labels. Scan the labels to change the scanner configuration and data
transfer settings.
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 set-
tings. Tap a parameter to select, or expand a parameter (+) to view its sub-
parameters.
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.
STyping a new value in an entry field.
SChoosing a new value from the drop-down list.
SSelecting a different option. The selected option contains a bullet.
STap Defaults,thenApply to restore factory-default settings. Tap Yes
when you are prompted to verify this action.
Configurable SettingsAppendix —A
313700 Series Color Mobile Computer User’s Manual
STap 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:
SName and Purpose:
Describes the parameter and its function.
SAction:
Describes what to do with a parameter once that parameter is selected.
SSNMP OID:
Lists the SNMP OID for the parameter.
SSyntax 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 para-
meter.
Configurable SettingsAppendix —A
314 700 Series Color Mobile Computer User’s Manual
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 >thePSMinfo 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”intheIntermec 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 Series Computer, tap Start >Settings
>theSystem 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 rep-
resent the following groups of settings or parameters:
SSymbologies (starting on page 315)
SSymbology Options (starting on page 336)
SBeeper/LED (starting on page 344)
SImager (starting on page 350)
SVirtual Wedge (starting on page 355)
Configurable SettingsAppendix —A
315700 Series Color Mobile Computer User’s Manual
Symbologies
You can change bar code symbology parameter settings in your 700 Series
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 326),Micro
PDF417 (page 328),Matrix2of5(page 330), Telepen (page 331),and
Code 11 (page 332) symbologies are not supported. Likewise, when using
a laser scanner, the QR Code (page 333), Data Matrix (page 334),and
MaxiCode (page 335) symbologies are not supported.
Note: The 730 Computer uses the EV10 APS linear imager which sup-
ports 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 Laser Scanner
EV10 APS
Linear Imager
Code 39 XXX
Interleaved 2 of 5 XXX
Standard 2 of 5 XXX
Matrix 2 of 5 X X
Code 128 XXX
Code 93 XXX
Codabar XXX
MSI X X
Plessey XX
UPC XXX
EAN/EAN 128 XXX
Code 11 X X
PDF417 XXX
Micro PDF417 X X
Telepen XX
Data Matrix X
QR Code X
MaxiCode X
Configurable SettingsAppendix —A
316 700 Series Color Mobile Computer User’s Manual
Code 39
Code 39 is a discrete, self-checking, variable length symbology. The char-
acter set is uppercase A–Z, 0–9, dollar sign ($), period (.), slash (/), per-
cent (%), 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 0
1
Not active
Active (default)
Format 0
1
Standard 43 characters (default)
Full ASCII
Start/Stop 0
1
Not transmitted (default)
Transmitted
Start/Stop characters
(Not supported when us-
inganimager)
0
1
2
$ (dollar sign) only
* (asterisk) only (default)
$ and * (dollar sign and asterisk)
Check digit 0
1
2
3
4
5
6
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 0
1
Any length (default)
Minimum length
Minimum length 001–254 Minimum length 1–254 (default is 6)
Note:IfBarcodelength=“1”thenMinimum length is entered.
Configurable SettingsAppendix —A
317700 Series Color Mobile Computer User’s Manual
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 0
1
Not active (default)
Active
Format 0
1
Identicon, 6 start/stop bars (default)
Computer Identics, 4 start/stop bars
Check digit 0
1
2
Not used (default)
Mod 10 transmitted
Mod 10 not transmitted
Bar code length 0
1
2
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:IfBarcodelength=“1”thenMinimum length is entered. If Bar
code length =“2”thenFixed length 1,Fixed length 2,orFixed length 3
is entered.
Configurable SettingsAppendix —A
318 700 Series Color Mobile Computer User’s Manual
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 0
1
Not active (default)
Active
Start/Stop 0
1
2
3
4
Not transmitted (default)
abcd transmitted
ABCD transmitted
abcd/tn*e transmitted
DC1–DC4 transmitted
CLSI library system
(Not supported when us-
inganimager)
0
1
Not active (default)
Active
Check digit 0
1
2
Not used (default)
Transmitted
Not transmitted
Bar code length 0
1
2
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:IfBarcodelength=“1”thenMinimum length is entered. If Bar
code length =“2”thenFixed length 1,Fixed length 2,orFixed length 3
is entered.
Configurable SettingsAppendix —A
319700 Series Color Mobile Computer User’s Manual
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 0
1
Not Active
Active (default)
UPC E 0
1
Not Active
Active (default)
EAN 8 0
1
Not Active
Active (default)
EAN 13 0
1
Not Active
Active (default)
Add-on digits 0
1
Not required (default)
Required
Add-on 2 digits 0
1
Not active (default)
Active
Add-on 5 digits
(Not supported when us-
inganimager)
0
1
Not active (default)
Active
UPC A check digit 0
1
Not transmitted
Transmitted (default)
UPC E check digit 0
1
Not transmitted
Transmitted (default)
EAN 8 check digit 0
1
Not transmitted
Transmitted (default)
EAN 13 check digit 0
1
Not transmitted
Transmitted (default)
UPC A number system 0
1
Not transmitted
Transmitted (default)
UPC E number system 0
1
Not transmitted
Transmitted (default)
UPC A re-encoding 0
1
UPC A transmitted as UPC A
UPC A transmitted as EAN 13 (default)
UPC E re-encoding 0
1
UPC E transmitted as UPC E (default)
UPC E transmitted as UPC A
EAN 8 re-encoding 0
1
EAN 8 transmitted as EAN 8 (default)
EAN 8 transmitted as EAN 13
Configurable SettingsAppendix —A
320 700 Series Color Mobile Computer User’s Manual
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 parame-
ter 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
0 Not active (default)
1 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 0
1
Any length
Minimum length (default)
Minimum length 001–254 Minimum length 1–254 (default is 6)
Note:IfBarcodelength=“1”thenMinimum length is entered.
Configurable SettingsAppendix —A
321700 Series Color Mobile Computer User’s Manual
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 parame-
ter setting.
SNMP OID
1.3.6.1.4.1.1963.15.3.3.1.1.9.1
Options
0 Not active (default)
1 Active
This illustration is from a 700 Series Computer using a laser scanner.
Configurable SettingsAppendix —A
322 700 Series Color Mobile Computer User’s Manual
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 Series 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)
0
1
Remove (default)
Include
CIP 128 French Pharmaceutical
(Not supported when using an
imager)
0
1
Not active (default)
Active
Bar code length 0
1
Any length (default)
Minimum length
Minimum length 001–254 Minimum length 1–254 (default is 6)
This illustration is from a 700 Series Computer using a laser scanner.
Configurable SettingsAppendix —A
323700 Series Color Mobile Computer User’s Manual
Code 128 FNC1 Character
The Code 128 FNC1 character (EAN 128 norms) can be any ASCII char-
acter 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 Series 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:
SBEL \a
SBS \b
SFF \f
SLF \n
SCR \r
SHT \t
SVT \v
Action
Tap (+) to expand the Code 128 parameter, then type the ASCII charac-
ters 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)
Configurable SettingsAppendix —A
324 700 Series Color Mobile Computer User’s Manual
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
Series 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 0
1
Not active (default)
Active
Check digit 0
1
Not transmitted (default)
Transmitted
Bar code length 0
1
Any length
Minimum length (default)
Minimum length 001–254 Minimum length 1–254 (default is 6)
Note:IfBarcodelength=“1”thenMinimum length is entered.
Configurable SettingsAppendix —A
325700 Series Color Mobile Computer User’s Manual
MSI
MSI is a symbology similar to Plessey code (page 324) 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 Series Com-
puter.
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 0
1
Not active (default)
Active
Check digit 0
1
2
3
Mod 10 transmitted (default)
Mod 10 not transmitted
Double Mod 10 transmitted
Double Mod 10 not transmitted
Bar code length 0
1
Any length
Minimum length (default)
Minimum length 001–254 Minimum length 1–254 (default is 6)
Note:IfBarcodelength=“1”thenMinimum length is entered.
Configurable SettingsAppendix —A
326 700 Series Color Mobile Computer User’s Manual
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 correc-
tion 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 key-
pad buffer.
Action
Tap the PDF417 parameter, then select an option to change this parame-
ter 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
0Notactive
1 Active (default)
This illustration is from a 700 Series 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
Series Computer.
SSelect Buffered to store a multi-label PDF417 message in the Sabre
buffer, thus transmitting the entire message when all labels are read.
Configurable SettingsAppendix —A
327700 Series Color Mobile Computer User’s Manual
SSelect 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 0
1
Unbuffered
Buffered (default)
Control header 0
1
Not transmitted (default)
Transmitted
File name 0
1
Not transmitted (default)
Transmitted
Segment count 0
1
Not transmitted (default)
Transmitted
Time stamp 0
1
Not transmitted (default)
Transmitted
Sender 0
1
Not transmitted (default)
Transmitted
Addressee 0
1
Not transmitted (default)
Transmitted
File size 0
1
Not transmitted (default)
Transmitted
Checksum 0
1
Not transmitted (default)
Transmitted
Configurable SettingsAppendix —A
328 700 Series Color Mobile Computer User’s Manual
Micro PDF417
Micro PDF417 is a multi-row symbology derived from and closely based
on PDF417 (page 326). A limited set of symbology sizes is available, to-
gether 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 Series Com-
puter.
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
Decoding 0
1
Not active (default)
Active
Code 128 Emulation 0
1
Not active (default)
Active
Configurable SettingsAppendix —A
329700 Series Color Mobile Computer User’s Manual
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 automo-
bile industry.
Note: An Interleaved 2 of 5 bar code label must be at least three characters
long for the 700 Series 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 0
1
Not active (default)
Active
Check digit 0
1
2
3
4
Not used (default)
Mod 10 transmitted
Mod 10 not transmitted
French CIP transmitted
French CIP not transmitted
Bar code length 0
1
2
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:IfBarcodelength=“1”thenMinimum length is entered. If Bar
code length =“2” then Fixed length 1,Fixed length 2,orFixed length 3 is
entered.
Configurable SettingsAppendix —A
330 700 Series Color Mobile Computer User’s Manual
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 Series 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 0
1
Not active (default)
Active
Bar code length 0
1
Any length
Minimum length (default)
Minimum length 001–254 Minimum length 1–254 (default is 6)
Note:IfBarcodelength=“1”thenMinimum length is entered.
Configurable SettingsAppendix —A
331700 Series Color Mobile Computer User’s Manual
Telepen
Telepen is an alphanumeric, case-sensitive, full ASCII symbology. Note
that this is not available when you use an imager with your 700 Series Com-
puter.
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 0
1
Not active (default)
Active
Format 0
1
ASCII (default)
Numeric
Configurable SettingsAppendix —A
332 700 Series Color Mobile Computer User’s Manual
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 Series Com-
puter.
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
Decoding 0
1
Not active (default)
Active
Check digit verification 1
2
1 digit (default)
2 digits
Check digit transmit 0
1
Disable
Enable (default)
Configurable SettingsAppendix —A
333700 Series Color Mobile Computer User’s Manual
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 Se-
ries 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 0
1
Not active
Active (default)
Configurable SettingsAppendix —A
334 700 Series Color Mobile Computer User’s Manual
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 capac-
ity of a symbol is 2335 alphanumeric characters, 1556 8-bit byte charac-
ters or 3116 numeric digits. Note that this is not available when you use a
laser scanner with your 700 Series Computer or if you are using a 730 Com-
puter.
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 0
1
Not active
Active (default)
Configurable SettingsAppendix —A
335700 Series Color Mobile Computer User’s Manual
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 pat-
tern. ASCII data is encoded in six-bit symbol characters. The symbol con-
tains 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 Series 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 0
1
Not active
Active (default)
Configurable SettingsAppendix —A
336 700 Series Color Mobile Computer User’s Manual
Symbology Options
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab>theData 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:
SUser-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 Series
Computer.
SAIM 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 set-
ting. 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
0 Disable (default)
1 User defined (disabled when using an imager)
2 ISO/IEC Standard
Configurable SettingsAppendix —A
337700 Series Color Mobile Computer User’s Manual
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 Series 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: xwhere xis 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 Series 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: xwhere xis 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 Series 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: xwhere xis a single ASCII character. Default is D.
Configurable SettingsAppendix —A
338 700 Series Color Mobile Computer User’s Manual
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 Series 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: xwhere xis 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 Series 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 parame-
ter setting.
SNMP OID: 1.3.6.1.4.1.1963.15.3.3.4.1.10.1
Options: xwhere xis 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 Series 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: xwhere xis 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 avail-
able when you use an imager with your 700 Series 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: xwhere xis a single ASCII character. Default is D.
Configurable SettingsAppendix —A
339700 Series Color Mobile Computer User’s Manual
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 Series 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: xwhere xis 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 Series Computer.
Action: Tap (+) to expand the Symbology ID parameter, select the Standard 2 of
5userIDparameter, 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: xwhere xis 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
Series 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: xwhere xis 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 Series 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: xwhere xis a single ASCII character. Default is E.
Configurable SettingsAppendix —A
340 700 Series Color Mobile Computer User’s Manual
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 Series 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: xwhere xis 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 Series 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: xwhere xis 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 Series 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: xwhere xis 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 Series 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: xwhere xis a single ASCII character. Default is an asterisk (*).
Configurable SettingsAppendix —A
341700 Series Color Mobile Computer User’s Manual
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 Series 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: xwhere xis a single ASCII character. Default is asterisk (*).
Configurable SettingsAppendix —A
342 700 Series Color Mobile Computer User’s Manual
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 parame-
ter 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
(<NUL >) characters are not allowed. Default is no characters (disabled).
Configurable SettingsAppendix —A
343700 Series Color Mobile Computer User’s Manual
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 parame-
ter 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
(<NUL >) characters are not allowed. Default is no characters (disabled).
Configurable SettingsAppendix —A
344 700 Series Color Mobile Computer User’s Manual
Beeper/LED
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab>theData 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 Laser Scanner
Beeper X
Beeper Volume X
Beeper Frequency X
Good Read Beeps X
Good Read Beep Duration X
The following are parameters for features on the 700 Series Computer.
Note that these are listed in the order of their appearance.
Configurable SettingsAppendix —A
345700 Series Color Mobile Computer User’s Manual
Beeper
Sets the volume for the good read beep. Note that this is not available when
you use a laser scanner with your 700 Series 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
1 Beeper (default)
4Vibrate(not supported on 730 Computers)
700 Color with Imager Screen 730 Screen
Configurable SettingsAppendix —A
346 700 Series Color Mobile Computer User’s Manual
Beeper Volume
Sets the volume for the good read beep. Note that this is not available when
you use an imager with your 700 Series 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
0Low
1 High (default)
2Medium
3Off
4Vibrate
Disabling the Volume
To disable the beeper, tap Start >Settings >thePersonal tab > Sounds &
Notifications >theVolume 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.
Configurable SettingsAppendix —A
347700 Series Color Mobile Computer User’s Manual
Beeper Frequency
Sets the frequency for the good read beep. Note that this is not available
when you use an imager with your 700 Series 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)
Configurable SettingsAppendix —A
348 700 Series Color Mobile Computer User’s Manual
Good Read Beeps
Sets the number of good read beeps. Note that this is not available when you
use an imager with your 700 Series 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
0 No beeps
1 One beep (default)
2 Two beeps
Configurable SettingsAppendix —A
349700 Series Color Mobile Computer User’s Manual
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 Series 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)
Configurable SettingsAppendix —A
350 700 Series Color Mobile Computer User’s Manual
Imager
Note: These instructions do not apply to the 730 Computer.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem 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 sym-
bol before attempting to decode the bar code. Note that this is not available
when you use a laser scanner with your 700 Series 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)
Configurable SettingsAppendix —A
351700 Series Color Mobile Computer User’s Manual
Sticky Aimer Duration
The Sticky Aimer Duration controls the time the Aimer LED stays on af-
ter 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 Se-
ries 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)
Configurable SettingsAppendix —A
352 700 Series Color Mobile Computer User’s Manual
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 Series 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
Left position 0Not supported
Right position 0Not supported
Top position 0–478 Position in pixels (Default is 0)
Bottom position 0–479 Position in pixels (Default is 479)
Configurable SettingsAppendix —A
353700 Series Color Mobile Computer User’s Manual
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 illumi-
nate 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 Series 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
0 LED Priority (default)
1 Aperture Priority
Configurable SettingsAppendix —A
354 700 Series Color Mobile Computer User’s Manual
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 Series 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
0Disabled
1 Enabled (default)
Configurable SettingsAppendix —A
355700 Series Color Mobile Computer User’s Manual
Virtual Wedge
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem 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 Series 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 pa-
rameter setting.
SNMP OID
1.3.6.1.4.1.1963.15.3.2.1.1.2.1
Options
0Disable
1 Enable (default)
Configurable SettingsAppendix —A
356 700 Series Color Mobile Computer User’s Manual
Preamble
Sets the preamble that precedes any data you scan with the 700 Series
Computer. Common preambles include a data location number or an op-
erator 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 (<NUL >) characters are not allowed. Below are the non-printing
characters you can use for Virtual Wedge Preambles. Default is blank.
\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.
Configurable SettingsAppendix —A
357700 Series Color Mobile Computer User’s Manual
Note: When you enter the AD command without data, the preamble is
disabled. If you want to use quotation marks or the following combina-
tions 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 Series Computer will interpret the characters as another con-
figuration 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”
Configurable SettingsAppendix —A
358 700 Series Color Mobile Computer User’s Manual
Postamble
Sets the postamble that is appended to any data you scan with the 700 Se-
ries 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 (<NUL >) characters are not allowed. Below are the non-printing
characters you can use for Virtual Wedge Postambles:
\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.
Configurable SettingsAppendix —A
359700 Series Color Mobile Computer User’s Manual
Note: When you enter the AE command without data, the postamble is
disabled. If you want to use quotation marks or the following combina-
tions 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 Series Computer will interpret the characters as another con-
figuration 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”
Configurable SettingsAppendix —A
360 700 Series Color Mobile Computer User’s Manual
Grid
Sets the virtual wedge grid, which filters the data coming from this 700
Series 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<symID> filter-expression= > editing-expression
where:
S<symID>
The AIM symbology ID (optional).
Sfilter-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.
Sediting-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.
Configurable SettingsAppendix —A
361700 Series Color Mobile Computer User’s Manual
Code Page
Setsthevirtualwedgecodepage.Thecodepagecontrolsthetranslation
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 param-
eter 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.
Configurable SettingsAppendix —A
362 700 Series Color Mobile Computer User’s Manual
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”intheIntermec 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 Series Computer, tap Start >Settings
>theSystem tab > Intermec Settings to access its control panel applet.
Configurable SettingsAppendix —A
363700 Series Color Mobile Computer User’s Manual
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 >thePSMinfo 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 iden-
tification information, security encryption, security community strings,
and traps.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > SNMP to access its control panel applet.
Tap a tab to access its menus. These tabs represent three groups of settings
or parameters:
SSecurity (starting on the next page)
STraps (starting on page 369)
SIdentification (starting on page 371)
Configurable SettingsAppendix —A
364 700 Series Color Mobile Computer User’s Manual
Security
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > SNMP >theSecurity 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 Series 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. De-
fault is Public.
Configurable SettingsAppendix —A
365700 Series Color Mobile Computer User’s Manual
Read/Write Community
Sets the read/write community string, which is required for processing of
SNMP set requests by this 700 Series 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. De-
fault is Private.
Configurable SettingsAppendix —A
366 700 Series Color Mobile Computer User’s Manual
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 en-
abled, you can only use software provided by Intermec Technologies.
Note: To enable security encryption, you also need to set the Security En-
cryption Key (page 368).
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
1On SNMPgetandgetnextpacketsmustbeencrypted
2Off SNMP packets do not have to be encrypted (default)
Configurable SettingsAppendix —A
367700 Series Color Mobile Computer User’s Manual
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 En-
cryption Key (page 368).
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
1On SNMP packets must be encrypted
2Off SNMP packets do not have to be encrypted (default)
Configurable SettingsAppendix —A
368 700 Series Color Mobile Computer User’s Manual
Encryption Key
Identifies the key that this 700 Series Computer uses to encrypt or deci-
pher SNMP packets. Encryption is used only by software provided by In-
termec Technologies. If encryption is enabled, SNMP management plat-
forms will not be able to communicate with the 700 Series 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 366) or Write
Encryption (page 367) 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.
Configurable SettingsAppendix —A
369700 Series Color Mobile Computer User’s Manual
Traps
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > SNMP >theTraps 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 authentica-
tion is enabled, an authentication trap is sent if an SNMP packet is re-
ceived 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
1 On (default)
2Off
Configurable SettingsAppendix —A
370 700 Series Color Mobile Computer User’s Manual
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.
Configurable SettingsAppendix —A
371700 Series Color Mobile Computer User’s Manual
Identification
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > SNMP >theIdentification 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 appear-
ance within the Identification tab.
Contact
Sets the contact information for the person responsible for this 700 Series
Computer.
Action
Tap the Contact parameter, then enter the name of your contact represen-
tative 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.
Configurable SettingsAppendix —A
372 700 Series Color Mobile Computer User’s Manual
Name
Sets the assigned name for this 700 Series Computer.
Action
Tap the Name parameter, then enter the name of your 700 Series Com-
puter 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.
Configurable SettingsAppendix —A
373700 Series Color Mobile Computer User’s Manual
Location
Sets the identification location for this 700 Series Computer, such as
“Shipping.”
Action
Tap the Location parameter, then enter the location of where your 700
Series 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.
Configurable SettingsAppendix —A
374 700 Series Color Mobile Computer User’s Manual
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 >thePSMinfo 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 infor-
mation about your 700 Series Computer, such as software version builds,
available CAB files, and the internal battery status.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > Unit Information to access its control panel applet.
700 Color Screen 730 Screen
Tap a tab to access its menus. These tabs represent three groups of settings
or parameters:
SVersions (starting on the next page)
SBattery Status (starting on page 376)
SCAB Files (starting on page 377)
Configurable SettingsAppendix —A
375700 Series Color Mobile Computer User’s Manual
Versions
You can view the latest software build version on your 700 Series
Computer by accessing the Unit Information control panel applet.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > Unit Information >theVersions tab to view the latest
software build version. Tap ok to exit this information.
700 Color Screen 730 Screen
Below are some of the software applications you may find on this screen:
S700 Platform Build:
Shows the latest development or released version of the software build
for the 700 Series Computer.
SS9C:
Provides the name and version of the scanner file built into this 700 Se-
ries Computer, along with the current CPU version.
SDataCollection Build:
Shows the latest development or released version of the software build
for the Data Collection control panel applet.
Configurable SettingsAppendix —A
376 700 Series Color Mobile Computer User’s Manual
Battery Status
You can view the battery status for your 700 Series Computer by accessing
the Unit Information control panel applet.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem tab > Unit Information >theBattery Status tabtoviewthe
current status. Tap ok to exit this information.
Configurable SettingsAppendix —A
377700 Series Color Mobile Computer User’s Manual
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 Series
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 Series Computer, tap Start >
Settings >theSystem tab > Unit Information >theCAB 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 Series Computer with their latest developer or released ver-
sion of the software build. Should you need to add any of these to your
700 Series Computer, contact an Intermec representative.
SBtMainStack:
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.
SComm 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.
SNPCPTest:
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.
Configurable SettingsAppendix —A
378 700 Series Color Mobile Computer User’s Manual
SS9C 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.
SSDK:
Installs the Intermec Software Developer’s Kit (SDK). See the SDK
User’s Manual for more information.
SWinCfg:
Configures the NRINET.INI file, launches the NRINet client, and
loadsandunloadstheLANandWLANdevicedrivers.
SWireless 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 Print-
ing SDK on the Intermec Developer’s Library CD.See the SDK User’s
Manual for more information.
SActiveX 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 infor-
mation.
SAXCommunication:
Communication controls that transmit or receive messages from in-
put connections.
SAXFileTransfer:
File transfer controls that transmit and receive files using the Trivial
File Transfer Protocol (TFTP).
SAXReaderCommand:
Reader command functions that modify and retrieve configuration
information from your 700 Series Computer.
SAXVWedge:
The virtual wedge control that retrieves scanned ADC data and sends
it to the keyboard driver to interpret data as keyboard input.
Configurable SettingsAppendix —A
379700 Series Color Mobile Computer User’s Manual
Utilities Control Panel Applet
The Utilities control panel applet examines and modifies settings and op-
erational modes of specific hardware and software on the 700 Color Com-
puter, including the dock switch, registry storage, wakeup mask, and ap-
plication launch keys.
To access the settings from the 700 Series Computer, tap Start >Settings
>theSystem 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 rep-
resent the following groups of settings or parameters:
SDock Switch (next page)
SRegistry Save (page 381)
SWakeup Mask (page 382)
SApp Launch (page 383)
Configurable SettingsAppendix —A
380 700 Series Color Mobile Computer User’s Manual
Dock Switch
From the 700 Series Computer, tap Start >Settings >theSystem tab >
Utilities >theDock 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 will have the following
behavior:
SIf the 700 Series Computer is on charge, the dock switch will remain
switched to COM B.
SIf the 700 Series Computer is off charge, the dock switch will switch to
COM A and remain in this position until the 700 Series Computer re-
sumes charge.
Configurable SettingsAppendix —A
381700 Series Color Mobile Computer User’s Manual
Registry Save
From the 700 Series Computer, tap Start >Settings >theSystem tab >
Utilities >theRegistry Save tab to access the Registry Save control panel
applet.
For Windows Mobile 2003, the only medium available for saving the reg-
istry is the Flash File System (PSM). Registry data is stored in the
“\Flash_File_Store\Registry” path. Check Enable Registry Storage to en-
able this function.
To ensure that the 700 Series 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 730 Screen
Configurable SettingsAppendix —A
382 700 Series Color Mobile Computer User’s Manual
Wakeup Mask
From the 700 Series Computer, tap Start >Settings >theSystem tab >
Utilities >theWakeup Mask tab to access the Wakeup Mask control pan-
el 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 Series
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 be-
tween 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 Series Com-
puter.
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(Application1) Press [Gold] ba Press [Gold/White] cA
GOLD+A2(Application2) Press [Gold] b4 Press [Gold/White] cB
Configurable SettingsAppendix —A
383700 Series Color Mobile Computer User’s Manual
App Launch
From the 700 Series Computer, tap Start >Settings >theSystem 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.
For 700 Series Computers with either a laser scanner or an imager,
applications are as follows and default mappings are shown in the follow-
ing illustration:
SLeft Scanner Trigger
SRight Scanner Trigger
SRecord (see Note)
SCalendar (see Note)
SContacts (see Note)
STasks (see Note)
For700SeriesComputerswithouteitheralaserscanneroranimager,
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.
STo assign an application to a button, select an application from the ap-
plicable drop-down list box.
STo 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.
Configurable SettingsAppendix —A
384 700 Series Color Mobile Computer User’s Manual
STo disable or unmap a currently mapped application from a correspon-
ding button, select “unassigned” from the applicable drop-down list.
STo restore these buttons to their defaults, tap Defaults in the lower
right corner.
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 “unas-
signed” and map the application to the second button.
Note: All changes are activated immediately upon selection.
Configurable SettingsAppendix —A
385700 Series Color Mobile Computer User’s Manual
Wireless Network Control Panel Applet
Note: See Chapter 4, “Network Support,” for information about the
802.11b radio module.
About the Wireless Network
Your wireless adapter (network interface card) connects to wireless net-
works of two types: access point networks and peer-to-peer networks.
SAccess point networks get you onto your corporate network and the in-
ternet. Your 700 Series 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.1x infra-
structure mode.
SPeer-to-peer networks are private networks shared between two or more
people, 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 infringe-
ment.
With multiple networks within range of each other, security is a necessity,
to avoid outside eavesdropping. To make a network safe, the following are
required:
SAuthentication by both the network and the user
SAuthentication is cryptographically protected
SWireless connection is encrypted
There are two basic mechanisms for providing secure encryption over a
wireless network: preconfigured secrets called WEP keys and authentica-
tion using the 802.1x protocol.
Terminology
Below are terms you may encounter as you configure your wireless net-
work:
SCKIP (Cisco Key Integrity Protocol)
This is a light version of the TKIP protocol developed by Cisco.
SEAP (Extensible Authentication Protocol)
802.1x uses this protocol to perform authentication. This is not neces-
sarily 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.
Configurable SettingsAppendix —A
386 700 Series Color Mobile Computer User’s Manual
STKIP (Temporal Key Integrity Protocol)
This protocol is part of the IEEE 802.11i encryption standard for wire-
less LANs., which provides per-packet key mixing, a message integrity
check and a re-keying mechanism, thus fixing the flaws of WEP.
This protocol provides stronger encryption than WEP, by dynamically
updating the encryption keys every 10,000 packets. It eliminates attacks
on WEP, which is based on a cryptographic algorithm called RC4, leav-
ing WLANs open to various security attacks.
TKIP is an interim addition to WEP that addresses some security con-
cerns. It provides per-packet key mixing, a MIC (Message Integrity
Check), and a rekeying mechanism designed to fix WEP flaws.
SWEP (Wired Equivalent Privacy) encryption
With preconfigured WEP, both the client 700 Series Computer and
access point are assigned the same key, which can encrypt all data be-
tween the two devices. WEP keys also authenticate the 700 Series Com-
puter to the access point — unless the 700 Series 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).
SWPA (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.1x au-
thentication with EAP.
Configurable SettingsAppendix —A
387700 Series Color Mobile Computer User’s Manual
Configuring Your Wireless Network
To start 802.11b communications on the 700 Series Computer, tap Start
>Settings >theSystem tab > Wireless Network to access the Profile
Wizard for the 802.11b 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 envi-
ronments assigned to this 802.11b radio.
SProfile:
Tap the drop-down list to choose between four different profiles as-
signed to this unit, then tap Edit Select Profile, make the changes need-
ed for this profile (starting on the next page),thentapOK to return to
the Profiles page.
SEnable 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, in-
cluding configuration via the CORE application and the Wireless Net-
work control panel applet.
Configurable SettingsAppendix —A
388 700 Series Color Mobile Computer User’s Manual
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.
SProfile Label:
Enter a unique name for your profile.
SNetwork 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 par-
ticipants.
SChannel:
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.
SSSID (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.
SEnable Power Management:
Check this box to conserve battery power (default), or clear this box to
disable this feature.
Configurable SettingsAppendix —A
389700 Series Color Mobile Computer User’s Manual
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 pack-
age. Contact your Intermec representative for information.
SNone (next page)
SPEAP (page 393)
STLS (page 397)
STTLS (page 401)
SLEAP (page 404)
Configurable SettingsAppendix —A
390 700 Series Color Mobile Computer User’s Manual
None
Use “None” to disable 802.1x Security and enable either WEP or WPA-
PSK encryption.
To Disable 802.1x Security
1Set 8021x Security as “None.”
2Set Association to “Open.”
3Set Encryption to “None.”
Configurable SettingsAppendix —A
391700 Series Color Mobile Computer User’s Manual
To Enable WEP Encryption
1Set 8021x Security as “None.”
2Set Association to either “Open” if WEP keys are not required; or
“Shared” when WEP keys are required for association.
3Set Encryption to “WEP.” See page 386 for information about WEP
encryption.
4If 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.
Configurable SettingsAppendix —A
392 700 Series Color Mobile Computer User’s Manual
To Enable WPA Encryption Using a Preshared Key
1Set 8021x Security as “None.”
2Set Association to “WPA.” See page 386 for information about WPA
encryption.
3Skip Encryption as it is automatically set to “TKIP.” See page 386 for
more information about TKIP.
4Enter the temporal key as ASCII (12345) in the Pre-Shared Key field.
Configurable SettingsAppendix —A
393700 Series Color Mobile Computer User’s Manual
PEAP (Protected EAP)
This protocol is suitable for performing secure authentication against Win-
dows domains and directory services. It is comparable to EAP-TTLS (see
page 401), both in its method of operation and its security, though not as
flexible. This does not support the range of inside-the-tunnel authentica-
tion 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
1Set 8021x Security as “PEAP.”
2Set Association to “Open.”.
3Skip Encryption as it is automatically set to “WEP.” See page 386 for
information about WEP encryption.
4Enter 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 auto-
matically use the protocol without entering a password.
5Tap Additional Settings to assign an inner PEAP authentication and set
options for server certificate validation and trust. See page 396 for more
information.
Configurable SettingsAppendix —A
394 700 Series Color Mobile Computer User’s Manual
To Enable PEAP with WPA Encryption
1Set 8021x Security as “PEAP.”
2Set Association to “WPA.” See page 386 for information about WPA
encryption.
3Skip Encryption as it is automatically set to “TKIP.” See page 386 for
more information about TKIP.
4Enter 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 auto-
matically use the protocol without entering a password.
5Tap Additional Settings to assign an inner PEAP authentication and set
options for server certificate validation and trust. See page 396 for more
information.
Configurable SettingsAppendix —A
395700 Series Color Mobile Computer User’s Manual
To Enable PEAP with Network EAP
1Set 8021x Security as “PEAP.”
2Set Association to “Network EAP.” See page 385 for information about
EAP.
3Set Encryption to either “WEP” or “CKIP.” See page 385 for informa-
tion about CKIP and page 386 for information about WEP encryption.
4Enter 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 auto-
matically use the protocol without entering a password.
5Tap Additional Settings to assign an inner PEAP authentication and set
options for server certificate validation and trust. See page 396 for more
information.
Configurable SettingsAppendix —A
396 700 Series Color Mobile Computer User’s Manual
Additional Settings
1Select 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 algo-
rithm.
2Check Validate Server Certificate to verify the identity of the authenti-
cation server based on its certificate when using TTLS, PEAP, and TLS.
3Enter the Common Names of trusted servers. Note that if these fields are
left blank, the server certificate trust validation is not performed or required.
4Click ok to return to the Security page.
Configurable SettingsAppendix —A
397700 Series Color Mobile Computer User’s Manual
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.
ToEnableTLSwithanOpenAssociation
1Set 8021x Security as “TLS.”
2Set Association to “Open.”
3Skip Encryption as it is automatically set to “WEP.” See page 386 for
information about WEP encryption.
4EnteryouruniqueSubject Name and User Name to use this protocol.
5Tap Get Certificates to obtain or import server certificates. See page
399 for more information.
6Tap Additional Settings to set options for server certificate validation
and trust. See page 400 for more information.
Configurable SettingsAppendix —A
398 700 Series Color Mobile Computer User’s Manual
To Enable TLS with WPA Encryption
1Set 8021x Security as “TLS.”
2Set Association to “WPA.” See page 386 for information about WPA
encryption.
3Skip Encryption as it is automatically set to “TKIP.”See page 386 for
more information about TKIP.
4EnteryouruniqueSubject Name and User Name as credentials for this
profile.
5Tap Get Certificates to obtain or import server certificates. See page
399 for more information.
6Tap Additional Settings to set options for server certificate validation
and trust. See page 400 for more information.
Configurable SettingsAppendix —A
399700 Series Color Mobile Computer User’s Manual
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 configure certificates assigned to the 802.1x TLS security
method.
1Tap the <<< button next to the Certificate Path field to browse for the
applicable certificate file.
2Tap the <<< button next to the Key Path field to browse for the appli-
cable private key file.
3Tap Import Root Cert to install a DER-encoded .CER file located in
the root folder of your device.
4Tap Import User Cert to install the certificate identified in the
Certificate Path field and the private key file name. Note that the private
key should be a base64-encoded .TXT file.
Tap Web Enrollment to obtain a user certificate over the network from an
IAS Server. Tap ok to return to the Security page.
Configurable SettingsAppendix —A
400 700 Series Color Mobile Computer User’s Manual
Additional Settings
1Check Validate Server Certificate to verify the identity of the authenti-
cation server based on its certificate when using TTLS, PEAP, and TLS.
2Enter the Common Names of trusted servers. Note that if these fields are
left blank, the server certificate trust validation is not performed or required.
3Click ok to return to the Security page.
Configurable SettingsAppendix —A
401700 Series Color Mobile Computer User’s Manual
TTLS (EAP-Tunneled TLS)
This protocol provides authentication like EAP-TLS (see page 397) but
does not require certificates for every user. Instead, authentication servers
are issued certificates. User authentication is done using a password or oth-
er credentials that are transported in a securely encrypted “tunnel” estab-
lished 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 pro-
tocol, and select either “Open” or “WPA” as an association mode.
ToEnableTTLSwithanOpenAssociation
1Set 8021x Security as “TTLS.”
2Set Association to “Open.”
3Skip Encryption as it is automatically set to “WEP.” See page 386 for
information about WEP encryption.
4Enter 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 auto-
matically use the protocol without entering a password.
5Tap Additional Settings to assign an inner TTLS authentication and an
inner EAP, and set options for server certificate validation and trust. See
page 403 for more information.
Configurable SettingsAppendix —A
402 700 Series Color Mobile Computer User’s Manual
To Enable TTLS with WPA Encryption
1Set 8021x Security as “TTLS.”
2Set Association to “WPA.” See page 386 for information about WPA
encryption.
3Skip Encryption as it is automatically set to “TKIP.” See page 386 for
more information about TKIP.
4Enter 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 auto-
matically use the protocol without entering a password.
5Tap Additional Settings to assign an inner TTLS authentication and an
inner EAP, and set options for server certificate validation and trust. See
page 403 for more information.
Configurable SettingsAppendix —A
403700 Series Color Mobile Computer User’s Manual
Additional Settings
1Select 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 385 for informa-
tion about EAP.
2If you select “EAP” for the inner authentication protocol, then an inner
EAP protocol from the Inner EAP drop-down list.
3Enter the Common Names of trusted servers. Note that if these fields are
left blank, the server certificate trust validation is not performed or required.
4Check Validate Server Certificate to verify the identity of the authenti-
cation server based on its certificate when using TTLS, PEAP, and TLS.
5Enter the Anonymous EAP-TTLS Name as assigned for public usage.
Use of this outer identity protects your login name or identity.
6Click ok to return to the Security page.
Configurable SettingsAppendix —A
404 700 Series Color Mobile Computer User’s Manual
LEAP (Cisco Lightweight EAP)
LEAP is the Cisco Lightweight version of EAP. See page 385 for informa-
tion 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 as-
sign Network EAP. Note that this defaults to the Network EAP.
To Enable LEAP with an Open Association
1Set 8021x Security as “LEAP.”
2Set Association to “Open.”
3Skip Encryption as it is automatically set to “WEP.” See page 386 for
information about WEP encryption.
4EnteryouruniqueUser Name to use this protocol.
5Select 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.
Configurable SettingsAppendix —A
405700 Series Color Mobile Computer User’s Manual
To Enable LEAP with WPA Encryption
1Set 8021x Security as “LEAP.”
2Set Association to “WPA.” See page 386 for information about WPA
encryption.
3Skip Encryption as it is automatically set to “TKIP.” See page 386 for
more information about TKIP.
4EnteryouruniqueUser Name to use this protocol.
5Select 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.
Configurable SettingsAppendix —A
406 700 Series Color Mobile Computer User’s Manual
To Enable LEAP with Network EAP
1Set 8021x Security as “LEAP.”
2Set Association to “Network EAP,” an EAP protocol for the network.
See page 385 for information about EAP.
3Set Encryption to either “WEP” or “CKIP.” See page 385 for informa-
tion about CKIP and page 386 for information about WEP encryption.
4EnteryouruniqueUser Name to use this protocol.
5Select 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.
Configurable SettingsAppendix —A
407700 Series Color Mobile Computer User’s Manual
Advanced
Use this page to configure additional settings for this profile. Tap ok or
OK to return to the Profiles page.
SEnable 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 deter-
mine whether you can use encryption.
SEnable Logging:
Check this to log what activity incurs for this profile.
Configurable SettingsAppendix —A
408 700 Series Color Mobile Computer User’s Manual
Other Configurable Parameters
The following parameters can be configured by sending reader commands
through the network or from an application. See “Using Reader Com-
mands” on page 410 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)
0Off
1 Very quiet
2Quiet
3 Normal (default)
4Loud
5 Very loud
Automatic Shutoff
Sets the length of time the 700 Series Computer remains on when there is
no activity. When you turn on the 700 Computer, it either resumes exact-
ly where it was when you turned it off or boots and restarts your applica-
tion.
SNMP OID
1.3.6.1.4.1.1963.15.11.3.0
Options (Syntax Data for Reader Commands)
1 1 minute
2 2 minutes
3 3 minutes (default)
4 4 minutes
5 5 minutes
Configurable SettingsAppendix —A
409700 Series Color Mobile Computer User’s Manual
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 10 seconds
30 30 seconds
60 1 minute (default)
120 2 minutes
180 3 minutes
240 4 minutes
300 5 minutes
Date/Time
Sets the current date and time.
SNMP OID
Date: 1.3.6.1.4.1.1963.15.501.2.1.0
Time: 1.3.6.1.4.1.1963.15.501.2.2.0
Options (Syntax Data for Reader Commands)
Date Year 0000–9999 (1999)
Month 1–12 (6)
Day 1–31 (1)
Time Hour 0–23 (0)
Minute 0–59 (00)
Second 0–59 (00)
Key Clicks
Enables or disables the keypad clicks. The 700 Series 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)
0 Disable clicks
1 Enable soft key clicks
2 Enable loud key clicks (default)
Configurable SettingsAppendix —A
410 700 Series Color Mobile Computer User’s Manual
Using Reader Commands
After the 700 Series Computer is connected to your network, you can send
the 700 Series Computer a reader command from an application to per-
form a task, such as changing the time and date. Some reader commands
temporarily override the configuration settings and some change the con-
figuration settings.
Change Configuration
The Change Configuration command must precede any configuration
command. If you enter a valid string, the 700 Series Computer configura-
tion 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 configu-
ration 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 356 and 358 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
Series Computer through the network: $+BV0
where:
$+ Indicates Change Configuration.
BV Specifies the Audio Volume parameter.
0Specifies 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.
Configurable SettingsAppendix —A
411700 Series Color Mobile Computer User’s Manual
Set Time and Date
This command sets the date and time on the 700 Series Computer. The
default date and time is June 1, 1999 at 12:00 AM.
From the network, send the following:
/+ yyyymmddhhmmss
whereacceptablevaluesforthedateare:
yyyy 0000–9999 Year
mm 01–12 Month of the year
dd 01–31 Day of the month
hh 00–23 Hour
mm 00–59 Minutes
ss 00–59 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>theClock icon to access its control panel applet.
Configurable SettingsAppendix —A
412 700 Series Color Mobile Computer User’s Manual
Configuration Bar Codes
You can change some settings on your 700 Series Computer by scanning
the following Code 39 bar code labels.
SYou can use the Data Collection control panel to set the three Virtual
Wedge parameters (starting on page 355).
Note: When you use a bar code creation utility to make a scannable bar
code label, the utility probably adds opening and closing asterisks automat-
ically. Asterisks are included here for translation purposes.
Audio Volume
Note: The Audio Volume parameter information is on page 408.
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*
Configurable SettingsAppendix —A
413700 Series Color Mobile Computer User’s Manual
Automatic Shutoff
Note: The Automatic Shutoff parameter information is on page 408.
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 409.
Backlight Timeout 10 seconds
*$+DF10*
*$+DF10*
Backlight Timeout 30 seconds
*$+DF30*
*$+DF30*
Backlight Timeout 1 minute (default)
*$+DF60*
*$+DF60*
Configurable SettingsAppendix —A
414 700 Series Color Mobile Computer User’s Manual
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 409.
Disable key clicks
*$+KC0*
*$+KC0*
Enable soft key clicks
*$+KC1*
*$+KC1*
Enable loud key clicks (default)
*$+KC2*
*$+KC2*
Configurable SettingsAppendix —A
415700 Series Color Mobile Computer User’s Manual
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 fol-
lowing, which can include a string of up to 240 characters. Parameter in-
formation starts on page 360.
*$+AF
*$+AF
Preamble
For Virtual Wedge Preamble, the first part of the bar code would be be-
low, followed by a string of up to 31 characters (no <NUL>) and an aster-
isk. Default is no characters. Parameter information is on page 356.
*$+AD
*$+AD
Postamble
For Virtual Wedge Postamble, the first part of the bar code would be be-
low, followed by a string of up to 31 characters (no <NUL>) and an aster-
isk. Default is no characters. Parameter information is on page 358.
*$+AE
*$+AE
Configurable SettingsAppendix —A
416 700 Series Color Mobile Computer User’s Manual
417700 Series Color Mobile Computer User’s Manual
Bar Code Symbologies
B
This appendix contains a brief explanation of some of the bar code
symbologies that the 700 Series Color Mobile Computer decodes and ex-
plains some of the general characteristics and uses of these bar code types.
The 700 Series 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 flexibil-
ity 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 contrib-
utes to a particular industry conforms to its standard. Without some form
of governing body, bar coding would not work.
Bar Code SymbologiesAppendix —B
418 700 Series Color Mobile Computer User’s Manual
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 char-
acters 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 sym-
bol. It is possible to use the 16 unique start or stop combinations to identi-
fy label type or other information.
Since Codabar is variable-length, discrete, and self-checking, it is a versa-
tile 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 perfor-
mance of certain early printing and reading equipment. Codabar has 18
different dimensions for bar and space widths. So many different dimen-
sions 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 numer-
ic 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 charac-
ter 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 print-
ing 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 gov-
ernment find this code to fit their needs. The main feature of this symbol-
ogy 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 751G Computer handles
symbology at least one character but no more than 32 characters in length.
Bar Code SymbologiesAppendix —B
419700 Series Color Mobile Computer User’s Manual
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 sym-
bols 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 412 to scan several Code 39 bar code labels available to
change settings on your 751G Computer.
Encoded Code 39 (Concatenation)
If the first data character of a symbol is a space, the reader may be pro-
grammed to append the information contained in the remainder of the
symbol to a storage buffer. This operation continues for all successive sym-
bols 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 charac-
ter 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 con-
sists 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 struc-
ture 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 pro-
vides for high data integrity. All substitution errors in a single character are
detected for any message length.
Bar Code SymbologiesAppendix —B
420 700 Series Color Mobile Computer User’s Manual
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 alphanu-
meric 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 docu-
ments. The ability to print identification messages between 10 and 32
characters long, on existing forms and labels deemed an important require-
ment.
Code 128 uniquely addresses this need as the most compact, complete,
alphanumeric symbology available.
Additionally, the Code 128 design with geometric features, improves scan-
ner read performance, does self-checking, and provides data message man-
agement function codes.
Code 128 encodes the complete set of 128 ASCII characters without ad-
ding extra symbol elements. Code 128 contains a variable-length symbolo-
gy and the ability to link one message to another for composite message
transmission. Code 128, being a double-density field, provides two numer-
ic 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 di-
mension of nine mils (0.010 inch minimum nominal ±0.001 inch toler-
ance) 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 char-
acter.
UCC/EAN-128 Shipping Container Labeling is a versatile tool that can
ease movement of products and information. The Shipping Container La-
beling 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 “<GS>” (hex 1D) for subsequent FUNC1 codes
in the bar code.
Because “<GS>” 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.
Bar Code SymbologiesAppendix —B
421700 Series Color Mobile Computer User’s Manual
This implementation should provide for clean application coding by iden-
tifying the same sequences for the same scanned codes. If the communica-
tion of Norand bar code types is enabled, the Shipping Container Label
codes precede with a “J”. These strings will appear on the computer dis-
play. The application may have to allow for strings longer than 48 charac-
ters (maximum length indicated in the specification). Actual length vari-
ance 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 Ship-
ping 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 ex-
changes 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.
Bar Code SymbologiesAppendix —B
422 700 Series Color Mobile Computer User’s Manual
I2of5(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 par-
ticularly prevalent in the automobile industry. The I 2 of 5 symbology can
be placed on smaller labels than what the standard UPC symbology re-
quires.
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 posi-
tion 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 charac-
ter. 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 dig-
its) 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 hexag-
onal 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 (spe-
cial 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 correc-
tion 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
Bar Code SymbologiesAppendix —B
423700 Series Color Mobile Computer User’s Manual
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 avail-
able for quick look-up. PDF417 is used for hazardous materials labeling;
storing technical specifications, and calibration data on electronic instru-
ments; encoding fingerprints and photographs on the backs of drivers’ li-
censes.
The maximum data density is determined by the smallest elements which
can be reliably printed and scanned. Using the smallest recommended ele-
ment 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 char-
acters 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 al-
phanumeric 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 en-
coded. This includes all ASCII characters value 0 to 127 inclusive and pro-
vides 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 devel-
oped 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.
Bar Code SymbologiesAppendix —B
424 700 Series Color Mobile Computer User’s Manual
MSI Code (Variant of Plessey)
The MSI Plessey bar code is a variant of the Plessey bar code. It is a pulse-
width 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 for 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 ap-
plications using a wide variety of printing and marking technologies. This
document includes descriptions of the character encodation, symbol struc-
ture, reference decode algorithm, and symbol quality measurements for
QR Code.
S2of5(Standard 2 of 5)
The code S 2 of 5 (Standard 2 of 5 Code) is designed primarily for:
SWarehouse inventory handling
SIdentification of photo finishing envelopes
SAirline tickets
SBaggage and cargo handling
The code S 2 of 5 is simple and straightforward. All information is con-
tained 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
rightwithweightingfactors1,2,4,7,andparity.Exceptionstothisrule
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.
Bar Code SymbologiesAppendix —B
425700 Series Color Mobile Computer User’s Manual
Telepen
Telepen was devised by George Sims, Managing Director of SB Electronic
Systems Limited, in early 1972, this is the only symbology to directly rep-
resent 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 symbolo-
gy 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 identifica-
tion, 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, con-
venience 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.
Bar Code SymbologiesAppendix —B
426 700 Series Color Mobile Computer User’s Manual
427700 Series Color Mobile Computer User’s Manual
Index
I
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, applica-
tions, utilities, batch files, or other files within this publication.
Index
428 700 Series Color Mobile Computer User’s Manual
Classes and Functions
A
add_registry_section, [AddReg]
flags, 216
registry_root_string, 216
value_name, 216
AddReg, [DefaultInstall], 212
[AddReg], add_registry_section
flags, 216
registry_root_string, 216
value_name, 216
AddWep(), 275
AppName, [CEStrings], 209
B
BuildMax, [CEDevice], 210
BuildMin, [CEDevice], 210
C
[CEDevice]
BuildMax, 210
BuildMin, 210
ProcessorType, 210
UnsupportedPlatforms, 210
VersionMax, 210
VersionMin, 210
CESelfRegister, [DefaultInstall], 212
CESetupDLL, [DefaultInstall], 212
CEShortcuts, [DefaultInstall], 212
[CEShortcuts], shortcut_list_section
shortcut_filename, 217
shortcut_type_flag, 217
target_file/path, 217
target_file_path, 217
CESignature
[SourceDiskNames], 212
[Version], 208
[CEStrings]
AppName, 209
InstallDir, 209
CloseHandle()
DTR printing, 188, 189
IrDA printing, 182
NPCP printing, 183, 184
ConfigureProfile(), 286
Copyfiles, [DefaultInstall], 212
[CopyFiles], file_list_section
destination_filename, 215
flags, 215
source_filename, 215
CreateEvent(), 306
CreateFile()
DTR printing, 188, 189
IrDA printing, 182
NPCP printing, 183, 184
D
[DefaultInstall]
AddReg, 212
CESelfRegister, 212
CESetupDLL, 212
CEShortcuts, 212
Copyfiles, 212
DeregisterDevice(), 183
DTR printing, 188
[DestinationDirs], file_list_section, 214
DeviceIOControl(), 255
DTR printing, 188
NPCP printing, 183
DeviceIoControl(), NPCP printing, 184, 185
disk_ordinal, [SourceDiskNames], 212
DllRegisterServer, 212
DllUnregisterServer, 212
E
EnableSuppLogging(), 298
EnableWep(), 276
EnableZeroConfig(), 287
EncryptionStatus(), 277
EncryptWepKeyForRegistry(Deprecated), 300
F
file_list_section
[CopyFiles]
destination_filename, 215
flags, 215
source_filename, 215
[DestinationDirs], 214
filename, [SourceDiskFiles], 213
G
GetAssociationStatus(), 260
GetAuthenticationMode(), 261
GetBSSID(), 262
GetCCXStatus(), 274
GetCurrentDriverName(), 296
GetDiversity(), 263
GetLinkSpeed(), 264
GetMac(), 265
GetMedia(Deprecated), 300
GetMedium(Deprecated), 300
GetNetworkMode(), 266
GetNetworkType(), 267
GetNicStats(Deprecated), 300
GetPowerMode(), 269
GetRadioIpAddress(), 273
GetRSSI(), 270
GetRTSThreshold(Deprecated), 300
GetSSID(), 268
GetTXPower(), 271
GetWepStatus(), 272
Index
429700 Series Color Mobile Computer User’s Manual
I
InstallDir, [CEStrings], 209
isDHCPEnabled(), 294
isOrinoco(), 289
isSupplicantRunning(), 290
isZeroConfigEnabled(), 288
K
KernelIoControl(), 239
N
NLEDGetDeviceInfo, 302
NLEDSetDevice, 302
O
OSVERSIONINFO.dwBuildNumber, 210
OSVERSIONINFO.dwVersionMajor, 210
OSVERSIONINFO.dwVersionMinor, 210
P
ProcessorType, [CEDevice], 210
Provider, [Version], 208
R
RadioConnect(), 257
RadioDisassociate(), 259
RadioDisconnect(), 258
ReadFile(), NPCP printing, 183
RegFlushKey(), 123, 225
RegisterDevice(), 183
DTR printing, 188
RegOpenKeyEx(), 305
RegQueryValueEx(), 305
RegSetValueEx(), 305
RemoveWep(), 285
RenewDHCP(), 295
ResetRadioToSystemSave(), 297
S
SetAuthenticationMode(), 278
SetCCXStatus(), 283
SetChannel(), 279
SetDiversity(Deprecated), 300
SetMixedCellMode(), 284
SetNetworkMode(), 280
SetPowerMode(), 281
SetRTSThreshold(Deprecated), 300
SetSSID(), 282
SetTXRate(Deprecated), 300
SHFullScreen(), 225, 226
shortcut_list_section, [CEShortcuts]
shortcut_filename, 217
shortcut_type_flag, 217
target_file/path, 217
target_file_path, 217
Signature, [Version], 208
[SourceDiskFiles], filename, 213
[SourceDiskNames]
CESignature, 212
disk_ordinal, 212
SourceDisksNames.MIPS, 213
SourceDisksNames.SH3, 213
StartScanList(), 291
StartSupplicant(), 292
StopSupplicant(), 293
string_key, [Strings], 209
[Strings], string_key, 209
SwitchPacketDriver(), 299
SYSTEMINFO.dwProcessorType, 210
U
UnsupportedPlatforms, [CEDevice], 210
V
[Version]
CESignature, 208
Provider, 208
Signature, 208
VersionMax, [CEDevice], 210
VersionMin, [CEDevice], 210
W
WriteFile()
DTR printing, 188, 189
IrDA printing, 182
NPCP printing, 183, 184
Index
430 700 Series Color Mobile Computer User’s Manual
General Index
Numbers
1470 Imager. See Imager
1551/1553 Tethered Scanner
See also Tethered scanner
configuring, 201
reset to factory defaults, 204
troubleshooting, 204
1D laser scanner, about, 191
1D OmniDir Decode Enable, configuration parameter,
354
2D Imager, about, 191
4820 printer, NPCP driver, 183
6804DM printer
DTR driver, 188
IrDA driver, 182
6804T printer
DTR driver, 188
IrDA driver, 182
6805A printer
DTR driver, 188
IrDA driver, 182
6806 printer
DTR driver, 188
IrDA driver, 182
6808 printer
DTR driver, 188
IrDA driver, 182
printer support, 181
681T printer, DTR driver, 188
6820 printer
IrDA driver, 182
NPCP driver, 183
printer support, 181
6920 Communications Server, ManifestName parameter,
230
700 Platform Build, version number, 375
740 Color Computer, 304
781 printers, DTR driver, 188
782T printer, printer support, 181
802.11 CR radio CORE module, 129
installing available modules, 126
loading a module, 126
802.11b
antenna color code, 127
API, 256
channel, 388
communications setup, 129, 387
configuration profiles, 256
CORE module, 129
LEAP
network EAP, 406
WPA encryption, 405
network type, 388
PEAP
network EAP, 395
WPA encryption, 394
profile label, 388
profile security information, WEP encryption, 391
profiles, 387
advanced settings, 407
basic information, 388
security information, 389
SSID (network name), 388
TTLS, WPA encryption, 402
WPA encryption, 392
A
Abstract Syntax Notation.1. See ASN.1
Accessory list, 21
Accounts, via Inbox, 75
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, 378
AD command, with/without data, 357
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, 168
AE command, with/without data, 359
Aimer LED Duration, configuration parameter, 350
All-Day events, Calendar, 48
creating, 52
Alpha plane on keypad, 305
Alphanumeric keypad
alpha (blue) key sequences, 15
[gold/white] key sequences, 13
registry settings
alpha plane, 305
gold plane, 305
unshifted plane, 305
scan codes, 308
Ambient lighting, 2
Annotations index, Microsoft Reader, 93
ANT_DIVERSITY, GetDiversity(), 263
ANT_PRIMARY, GetDiversity(), 263
ANT_SECONDARY, GetDiversity(), 263
Index
431700 Series Color Mobile Computer User’s Manual
Antenna, radio type, 127
APIs
802.11b, 256
AT command interface, 168
IrSock, 182
App launch, control panel applet, 383
Application keys
app launch control panel applet, 383
wakeup mask control panel applet, 382
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, 191
ASCII
printing, 182
printing to a port, port print method, 182
raw text to printer, 182
ASN.1, 178
Asset management, DeviceURL parameter, 229
AT command interface, 168
testing, 169
Attaching notes to text, Microsoft Reader, 93
Audio, phone application, 166
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, 237
AutoIP, 177
Automatic Private IP. See AutoIP
Automatic shutoff
bar code configuration, 408, 413
configuration parameter, 408
Autostart FTP, 237
AvantGo channels, Pocket Internet Explorer, 96
AXCommunication, 378
AXFileTransfer, 378
AXReaderCommand, 378
AXVWedge, 378
B
Backlight control panel applet
ambient light sensor, 2
keypad, 11
Backlight timeout
bar code configuration, 409, 413
configuration parameter, 409
Bar code configuration
audio volume, 408
automatic shutoff, 408
backlight timeout, 409
key clicks, 409
Bar codes
configuration
audio volume, 412
automatic shutoff, 413
backlight timeout, 413
Code 39, 412
key clicks, 414
internal scanner supported symbologies, 195
scanning labels, 412
supported symbologies, 315
symbologies
Codabar, 418
Code 11, 418
Code 128, 420
Code 39, 418
Code 39 concatenation, 419
Code 39 full ASCII, 419
Code 93, 419
Data Matrix, 421
EAN, 421
I 2 of 5, 422
Matrix 2 of 5, 422
MaxiCode, 422
Micro PDF417, 423
MSI code, 424
PDF417, 422
Plessey, 423
QR Code, 424
S 2 of 5, 424
Telepen, 425
UPC, 425
tethered scanner supported symbologies, 205
Basic connect/disconnect functions, 257
Battery
ambient lighting, 2
low battery conditions, 6
RAM maintenance, 6
status, 5
Battery status, unit information control panel applet, 376
Beeper
configuration parameter
frequency, 347
volume, 345, 346
disabling the volume, 346
selecting a volume, 9
silencing the volume, 10
supported functions, 344
volume, turning it on, 7
when not available
beeper frequency, 347
good read beep duration, 349
good read beeps, 348
Bell Mobility activation process, 156
Block recognizer, Windows Mobile input panel, 32
Index
432 700 Series Color Mobile Computer User’s Manual
BlockSize, FTP Server, 228
Bluealps CORE module
installing available modules, 126
loading a module, 126
Bluetooth
accessing, 173
activating, 173
unit information control panel, main stack CAB file,
377
Bluetooth compatibility, network support, 173
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, 17
C
CAB files
after the extraction, 220
creating, 208
INF files, 208
with CAB Wizard, 223
installation functions, SETUP.DLL, 220
placing files onto storage card, 122
unit information control panel applet, 377
Cabinet Wizard
creating CAB files, 223
troubleshooting, 224
using the application, 208
Cabling, scanner, 199
Calendar
all day events, 48
creating, 52
appointments
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
categories, 47
meetings, sending a request, 57
options, changing, 59
Pocket Outlook, 46
recurrence pattern, 49
Start menu icon, 27
synchronizing, 47
Capacitor, internal super, 6
Capturing thoughts and ideas, via Notes, 71
Card support
CompactFlash cards, 18
MultiMediaCards, 18
radios, 20
Secure Digital cards, 18
Carrier, location of ESN, 140
Categories
calendar, 47
contacts, assigning to, 65
CDMA/1xRTT, 134
activation with SB555 Watcher, 140
Bell Mobility, 156
Sprint, 147
Telus, 156
Verizon, 143
WWANInit demo program, 156
antenna color code, 127
AT command set, 168
copying files from web site, 137
via Microsoft ActiveSync, 138
via storage cards, 138
CORE module, 134
location of ESC, 140
setting up, 137
terminology, 137
CEImager
location of the executable file, 122
migrating AUTORUN.DAT files, 122
Channel, 802.11 radio module, 388
ClassID field values
VN_CLASS_ASIC, 241
VN_CLASS_BOOTSTRAP, 241
VN_CLASS_KBD, 241
Clock
restore real-time after cold-boot, 381
setting date and time, 411
Windows Mobile settings, 41
Closing drivers, NPCP, 184
Codabar, 418
configuration parameter, 318
user ID, 337
Code 11, 418
configuration parameter, 332
user ID, 341
Code 128, 420
configuration parameter, 321
FNC1 character, 323
user ID, 337
Code 39, 418
configuration parameter, 316
user ID, 337
Code 93, 419
configuration parameter, 320
length, 320
user ID, 338
Code Division Multiple Access. See CDMA/1xRTT
Index
433700 Series Color Mobile Computer User’s Manual
Codes
11, 418
128, 420
39, 418
39 concatenation, 419
39 full ASCII, 419
93, 419
Cold boot, IOCTL_HAL_COLDBOOT, 249
COM A, modem position, 380
COM B, serial position, 380
COM port
configuration, 197
wedge settings, 197
COM1, NPCP parameter, 183
COM1 port, 182
Comm port wedge
disabling, 197
enabling, 196
error messages, 197
limitations, 199
settings, 197
unit information control panel, 377
Command line syntax, AutoCab, 124
Common Object Resource Environment. See CORE
Communications
DTR, 189
NPCP, 186
Communications options, 125
CompactFlash cards
card support, 18
installing applications, 120
migrating applications, 122
packaging an application, 118
Computer shutdown, 6
Concatenation, 419
Configuration parameters
1D OmniDir decode enable, 354
aimer LED duration, 350
automatic shutoff, 408
backlight timeout, 409
beeper, 345
frequency, 347
volume, 346
codabar, 318
user ID, 337
code 11, 332
user ID, 341
code 128, 321
FNC1 character, 323
user ID, 337
code 39, 316
user ID, 337
code 93, 320
length, 320
user ID, 338
datamatrix, 334
date/time, 409
EAN
13 user ID, 340
8 user ID, 340
good read
beep duration, 349
beeps, 348
identification
contact, 371
location, 373
name, 372
image dimension, 352
interleaved 2 of 5, 329
user ID, 338
key clicks, 409
lighting mode, 353
macro PDF, 326
matrix 2 of 5, 330
user ID, 340
maxicode, 335
micro PDF417, 328
MSI, 325
user ID, 338
PDF417, 326
user ID, 338
plessey, 324
user ID, 339
prefix, 342
QR code, 333
security
encryption key, 368
read encryption, 366
read-only community string, 364
read/write community string, 365
write encryption, 367
SNMP, security subnet mask, 336
standard 2 of 5, 317
user ID, 339
sticky aimer duration, 351
suffix, 343
telepen, 331
user ID, 340
trap
authentication, 369
threshold, 370
UPC
A user ID, 339
E user ID, 339
UPC/EAN, 319
virtual wedge, 355
code page, 361
grid, 360
postamble, 358
preamble, 356
volume, 408
Connecting to
an ISP, 98
e-mail server, 114
work, 104
Connecting to a mail server, via Inbox, 75
Index
434 700 Series Color Mobile Computer User’s Manual
Connections
See also Getting connected
directly to e-mail server, 114
ending, 114
setting up an e-mail account, 114
to an ISP, 98
via Ethernet, 103
via modem, 98
to work, 104
via Ethernet, 113
via modem, 106
via VPN server, 111
via wireless network, 108
via Ethernet
to an ISP, 103
to work, 113
via modem
to an ISP, 98
to work, 106
via VPN server, to work, 111
via wireless network, to work, 108
Conserving battery power, 2
Contacts
adding a note, 64
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
backlight, 2, 11
clock, 411
data collection, 314
beeper volume, 9
beeper/LED, 344
imager, 350
symbologies, 315
symbology options, 336
vibrator, 19
virtual wedge, 355
intemec settings
beeper volume, 10
vibrator, 20
intermec settings, 314, 362
power
battery status, 5
RAM maintenance, 6
SNMP, 363
identification, 371
security, 364
traps, 369
system, wireless network, 129, 387
unit information, 374
battery status, 5, 376
CAB files, 377
versions, 17, 375
utilities, 379
app launch, 383
dock switch, 380
registry save, 123, 381
wakeup mask, 382
wireless network, 385
Converting writing to text, 35
Copying, contacts, 65
Copying text, Microsoft Reader, 93
CORE, 126
802.11b radio module, 129
details, 131
general, 130
accessing from
Programs panel, 126
Today screen, 127
activating, 126
installing available modules, 126
loading a module, 126
module for 802.11b NIC, 256
WAN monitor, GSM/GPRS, 163
WAN radio module
CDMA/1xRTT, 134
general, 163
Creating
a modem connection
to an ISP, 98
to work, 106
a VPN server connection, to work, 111
a wireless network connection, to work, 108
an Ethernet connection
to an ISP, 103
to work, 113
CAB files, 208
with CAB Wizard, 223
contacts via Contacts, 61
document via Pocket Word, 78
drawing via Notes, 37
INF files, 208
note via Notes, 71
task via Tasks, 70
workbook via Pocket Excel, 82
Index
435700 Series Color Mobile Computer User’s Manual
D
Data collection
build version number, 375
configuration parameters
1D OmniDir decode enable, 354
aimer LED duration, 350
beeper, 345
beeper frequency, 347
beeper volume, 346
codabar, 318
codabar user ID, 337
code 11, 332
code 11 user ID, 341
code 128, 321
code 128 FNC1 character, 323
code 128 user ID, 337
code 39, 316
code 39 user ID, 337
code 93, 320
code 93 length, 320
code 93 user ID, 338
datamatrix, 334
EAN-13 user ID, 340
EAN-8 user ID, 340
good read beep duration, 349
good read beeps, 348
image dimension, 352
interleaved 2 of 5, 329
interleaved 2 of 5 user ID, 338
lighting mode, 353
macro PDF, 326
matrix 2 of 5, 330
matrix 2 of 5 user ID, 340
maxicode, 335
micro PDF417, 328
MSI, 325
MSI user ID, 338
PDF417, 326
PDF417 user ID, 338
plessey, 324
plessey user ID, 339
prefix, 342
QR code, 333
standard 2 of 5, 317
standard 2 of 5 user ID, 339
sticky aimer duration, 351
suffix, 343
telepen, 331
telepen user ID, 340
UPC-E user ID, 339
UPC-A user ID, 339
UPC/EAN, 319
virtual wedge, 355
virtual wedge code page, 361
virtual wedge grid, 360
virtual wedge postamble, 358
virtual wedge preamble, 356
vibrator, 19
Data Matrix, 421
configuration parameter, 334
Date, setting, 411
Date/Time, configuration parameter, 409
Deprecated functions, 300
DeviceName,FTPServer,229
DeviceURL, FTP Server, 229
DHCP, 177
Display full screen, 226
Dock switch, control panel applet, 380
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, 189
installing, 188
opening, 189
removing, 188
writing to, 189
NPCP
closing, 184
communications, 186
I/O controls, 185
installing, 183
opening, 184
reading from, 184
removing, 183
writing to, 184
O’Neil. See DTR printing
DTR printing, 188
closing driver, 189
communications, 189
opening driver, 189
removing driver, 188
writing to driver, 189
E
E-mail account, setting up an account, 114
E-mail server, getting connected, 114
EAN, configuration parameter, 319
13 user ID, 340
8 user ID, 340
Editing a profile, 387
Edition information, 24
Encoded Code 39
concatenation, 419
full ASCII, 419
Ending a connection, 114
Epson Escape Sequences, 182
Error messages
comm port wedge, 197
tethered scanner, 197
Index
436 700 Series Color Mobile Computer User’s Manual
ERROR_INSUFFICIENT_BUFFER
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
ERROR_INVALID_PARAMETER
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
ESN, location on computer, 140
Ethernet
communications setup, 128
creating a connection
to an ISP, 103
to work, 113
ETSI GSM 07.05 interface specifications, 168
ETSI GSM 07.07 interface specifications, 168
European Article Numbering. See EAN
European Article Numbering code. See EAN
F
Favorite links, Pocket Internet Explorer, 94
File Explorer
adding programs to Start menu, 43
removing programs, 43
Windows Mobile, 40
File Transfer Protocol. See FTP
Find feature, Windows Mobile, 40
FlashFileStore
migrating applications, 122
packaging an application, 118
Flash file system, control panel applet, 381
Folder behavior connected to e-mail server
ActiveSync, 74
IMAP4, 74
POP3, 74
SMS, 74
FRAME_NOT_ACKED, 185
FTP
client, 232
configurable parameters, 228
BlockSize, 228
DeviceName, 229
DeviceURL, 229
IDNATarget, 230
ManifestName, 230
PauseAtStartup, 231
Root, 231
FTPDCMDS subdirectory, 235
heartbeat, 232
RTC 959, 235
server, 232
installing applications, 120
server requests
CDUP, 232
CWD, 232
DELE, 232
HELP, 232
LIST, 232
MKD, 232
MODE, 232
NLST, 232
NOOP, 232
PASS, 232
PWD, 232
QUIT, 232
RETR, 232
RMD, 232
RNFR, 232
RNTO, 233
SITE, 233
SITE ATTRIB, 233
SITE BOOT, 234
SITE COPY, 234
SITE EKEY, 235
SITE EVAL, 235
SITE EXIT, 234
SITE GVAL, 235
SITE HELP, 234
SITE KILL, 234
SITE LOG, 234
SITE PLIST, 234
SITE PVAL, 235
SITE RUN, 234
SITE STATUS, 235
SITE TIMEOUT, 235
STOR, 233
SYST, 233
TYPE, 233
USER, 233
XCUP, 233
XCWD, 233
XMKD, 233
XPWD, 233
XRMD, 233
stopping server from application, 236
support, 232
web browsers, 235
FTPDCMDS subdirectory, FTP support, 235
Full screen display, 226
G
GDI approach, 182
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
creating an Ethernet connection, 103
to work, 104
creating a modem connection, 106
creating a VPN server connection, 111
creating a wireless network connection, 108
creating an Ethernet connection, 113
Windows Mobile, 98
Gold plane on keypad, 304
Good read, configuration parameter
beep duration, 349
beeps, 348
Grid data, configuration parameter, 360
Index
437700 Series Color Mobile Computer User’s Manual
GSM/GPRS, 163
antenna color code, 127
AT command set, MC45, 168
CORE module, 163
phone application, 165
H
HAL, verion of Pocket PC
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_OAL_VERINFO, 247
Handset
phone application, 165
volume, 167
Headset jack, external, 4
Helper functions, 286
Highlighting text, Microsoft Reader, 93
I
I2of5.See Interleaved 2 of 5
I/O controls, NPCP driver, 185
ID field values
IOCTL_HAL_ITC_READ_PARM
ITC_NVPARM_80211_INSTALLED, 242
ITC_NVPARM_80211_RADIOTYPE, 242
ITC_NVPARM_ANTENNA_DIVERSITY, 241
ITC_NVPARM_BLUETOOTH_INSTALLED,
243
ITC_NVPARM_CONTRAST, 241
ITC_NVPARM_DISPLAY_TYPE, 241
ITC_NVPARM_ECN, 241
ITC_NVPARM_EDBG_SUBNET, 241
ITC_NVPARM_EDG_IP, 241
ITC_NVPARM_ETHERNET_ID, 240
ITC_NVPARM_INTERMEC_DATACOLLEC-
TION_HW, 242
ITC_NVPARM_INTERMEC_DATACOLLEC-
TION_SW, 242
ITC_NVPARM_INTERMEC_SOFT-
WARE_CONTENT, 241
ITC_NVPARM_LAN9000_INSTALLED, 243
ITC_NVPARM_MANF_DATE, 240
ITC_NVPARM_MCODE, 241
ITC_NVPARM_RTC_RESTORE, 242
ITC_NVPARM_SERIAL_NUM, 240
ITC_NVPARM_SERIAL2_INSTALLED, 243
ITC_NVPARM_SERVICE_DATE, 240
ITC_NVPARM_SIM_PRO-
TECT_HW_INSTALLED, 243
ITC_NVPARM_SIM_PRO-
TECT_SW_INSTALLED, 243
ITC_NVPARM_VERSION_NUMBER, 241
ITC_NVPARM_VIBRATE_INSTALLED, 243
ITC_NVPARM_WAN_FREQUENCY, 242
ITC_NVPARM_WAN_INSTALLED, 242
ITC_NVPARM_WAN_RADIOTYPE, 242
ITC_NVPARM_WAN_RI, 241
IOCTL_HAL_ITC_WRITE_SYSPARM
ITC_ DOCK_SWITCH, 245
ITC_ WAKEUP_MASK, 245
ITC_AMBIENT_FRONTLIGHT, 245
ITC_AMBIENT_KEYBOARD, 245
ITC_REGISTRY_SAVE_ENABLE, 245
Identification, configuration parameter
contact, 371
location, 373
name, 372
IDNA
DeviceName, 229
DeviceURL, 229
IDNATarget, 230
ManifestName, 230
IDNATarget, FTP Server, 230
Image dimension, configuration parameter, 352
Imager
beeper functions not available
beeper frequency, 347
good read beep duration, 349
good read beeps, 348
beeper/LED parameters, beeper, 345
control panel appet, data collection, 350
data collection parameters
1D OmniDir decode enable, 354
aimer LED duration, 350
datamatrix, 334
image dimension, 352
lighting mode, 353
maxicode, 335
QR code, 333
sticky aimer duration, 351
settings, 198
supported
beeper functions, 344
functions, 350
symbologies, 315
symbologies not available
CIP 128 French Pharmaceutical, 322
Code 11, 332
Code 128 FNC1 character, 323
EAN 128 ]C1, 322
Macro PDF, 326
Matrix 2 of 5, 330
micro PDF417, 328
Telepen, 331
Index
438 700 Series Color Mobile Computer User’s Manual
symbology user IDs not available
Codabar, 337
Code 11, 341
Code 128, 337
Code 39, 337
Code 93, 338
EAN 13, 340
EAN 8, 340
Interleaved 2 of 5, 338
Matrix 2 of 5, 340
MSI, 338
PDF417, 338
Plessey, 339
Standard 2 of 5, 339
Telepen, 340
UPC A, 339
UPC E, 339
vibrator, enabling, 19
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, 208
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, 220
Installing applications
using a storage card, 120
using CompactFlash cards, 120
using Secure Digital cards, 121
with ActiveSync, 119
with FTP Server, 120
Installing drivers
DTR, 188
NPCP, 183
Instant messaging, 84
Integrated scanners. See Internal scanners
Interface specifications, ETSI GSM 07.0x, 168
Interleaved 2 of 5, 422
configuration parameter, 329
user ID, 338
Intermec Device Network Announcement. See IDNA
Intermec part numbers, 21
Intermec settings, 314, 362
beeper volume, 10
vibrator, 20
INTERMEC_PACKET_DRIVER, SwitchPacketDriver(),
299
Internal scanners
configuring, 194
supported symbologies, 195
Internet explorer
software build version, 17
Windows Mobile 2003 edition, 24
Internet Service Provider. See ISP
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249, 303
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO, 248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252, 303
IOCTL_HAL_WARMBOOT, 249, 303
IOCTL_LOAD_NDIS_MINIPORT, 255
IOCTL_NPCP_BIND, 185
IOCTL_NPCP_CANCEL, 185
IOCTL_NPCP_CLOSE, 185
IOCTL_NPCP_ERROR, 185
IOCTL_NPCP_FLUSH, 185
IOCTL_PROCESSOR_INFORMATION, 253
IOCTL_UNLOAD_NDIS_MINIPORT, 255
IrDA printing, 182
ISP
connecting to via Windows Mobile, 98
creating
a modem connection, 98
an Ethernet connection, 103
Pocket Internet Explorer, 94
Windows Mobile, 98
ITC_ DOCK_SWITCH, 245
ITC_ WAKEUP_MASK, 245
ITC_AMBIENT_FRONTLIGHT, 245
ITC_AMBIENT_KEYBOARD, 245
ITC_DEVID_80211RADIO_INTEL_2011B, 242
ITC_DEVID_80211RADIO_MAX values
ITC_DEVID_80211RADIO_INTEL_2011B, 242
ITC_DEVID_80211RADIO_NONE, 242
ITC_DEVID_80211RADIO_NONE, 242
ITC_DEVID_INTERMEC_EVIO, 242
ITC_DEVID_INTERMEC2D_IMAGER, 242
ITC_DEVID_OEM2D_IMAGER, 242
ITC_DEVID_SCANHW_MAX values
ITC_DEVID_INTERMEC_EVIO, 242
ITC_DEVID_INTERMEC2D_IMAGER, 242
ITC_DEVID_OEM2D_IMAGER, 242
ITC_DEVID_SCANHW_NONE, 242
ITC_DEVID_SE900_LASER, 242
ITC_DEVID_SE900HS_LASER, 242
Index
439700 Series Color Mobile Computer User’s Manual
ITC_DEVID_SCANHW_NONE, 242
ITC_DEVID_SE900_LASER, 242
ITC_DEVID_SE900HS_LASER, 242
ITC_DEVID_WANRADIO_NONE, 242
ITC_DEVID_WANRADIO_SIEMENS_MC45, 242
ITC_DEVID_WANRADIO_SIERRA_SB555, 242
ITC_DEVID_WANRADIO_XIRCOM_GEM3503, 242
ITC_IFTP_STOP, 236
ITC_KEYBOARD_CHANGE, CreateEvent(), 306
ITC_NVPARM_80211_INSTALLED, 242
ITC_NVPARM_80211_RADIOTYPE, 242
ITC_NVPARM_ANTENNA_DIVERSITY, 241
ITC_NVPARM_BLUETOOTH_INSTALLED, 243
ITC_NVPARM_CONTRAST, 241
ITC_NVPARM_DISPLAY_TYPE, 241
ITC_NVPARM_ECN, 241
ITC_NVPARM_EDBG_SUBNET, 241
ITC_NVPARM_EDG_IP, 241
ITC_NVPARM_ETHERNET_ID, 240
ITC_NVPARM_INTERMEC_DATACOLLEC-
TION_HW, 242
ITC_NVPARM_INTERMEC_DATACOLLEC-
TION_SW, 242
ITC_NVPARM_INTERMEC_SOFTWARE_CON-
TENT, 241
ITC_NVPARM_LAN9000_INSTALLED, 243
ITC_NVPARM_MANF_DATE, 240
ITC_NVPARM_MCODE, 241
ITC_NVPARM_RTC_RESTORE, 242
ITC_NVPARM_SERIAL_NUM, 240
ITC_NVPARM_SERIAL2_INSTALLED, 243
ITC_NVPARM_SERVICE_DATE, 240
ITC_NVPARM_SIM_PROTECT_HW_INSTALLED,
243
ITC_NVPARM_SIM_PROTECT_SW_INSTALLED,
243
ITC_NVPARM_VERSION_NUMBER, 241
ITC_NVPARM_VIBRATE_INSTALLED, 243
ITC_NVPARM_WAN_FREQUENCY, 242
ITC_NVPARM_WAN_INSTALLED, 242
ITC_NVPARM_WAN_RADIOTYPE, 242
ITC_NVPARM_WAN_RI, 241
ITC_REGISTRY_SAVE_ENABLE, 245
ITU-T interface specifications, 168
K
Keeping a to-do list, via Tasks, 69
KernelIoControl
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249, 303
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252, 303
IOCTL_HAL_WARMBOOT, 249, 303
IOCTL_PROCESSOR_INFORMATION, 253
Key clicks
bar code configuration, 409, 414
configuration parameter, 409
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
Keypad
advanced remapping, 306
alphanumeric
alpha (blue) key sequences, 15
[gold/white] key sequences, 13
scan codes, 308
backlight control panel applet, 11
change notification, 306
driver registry settings, 306
numeric
alpha (blue) key sequences, 14
[gold] key sequences, 12
scan codes, 307
planes, 304
remapping, 304
sample registry keys, 310
Index
440 700 Series Color Mobile Computer User’s Manual
L
Laser scanner
configuration parameters, 312
data collection parameters
beeper frequency, 347
beeper volume, 346
codabar, 318
codabar user ID, 337
code 11, 332
code 11 user ID, 341
code 128, 321
code 128 FNC1 character, 323
code 128 user ID, 337
code 39, 316
code 39 user ID, 337
code 93, 320
code 93 length, 320
code 93 user ID, 338
EAN-13 user ID, 340
EAN-8 user ID, 340
good read beep duration, 349
good read beeps, 348
interleaved 2 of 5, 329
interleaved 2 of 5 user ID, 338
macro PDF, 326
matrix 2 of 5, 330
matrix 2 of 5 user ID, 340
micro PDF417, 328
MSI, 325
MSI user ID, 338
PDF417, 326
PDF417 user ID, 338
plessey, 324
plessey user ID, 339
prefix, 342
standard 2 of 5, 317
standard 2 of 5 user ID, 339
suffix, 343
telepen, 331
telepen user ID, 340
UPC-E user ID, 339
UPC-A user ID, 339
UPC/EAN, 319
virtual wedge, 355
virtual wedge code page, 361
virtual wedge grid, 360
virtual wedge postamble, 358
virtual wedge preamble, 356
SNMP configuration parameters
identification contact, 371
identification location, 373
identification name, 372
security encryption key, 368
security read encryption, 366
security read-only community string, 364
security read/write community string, 365
security subnet mask, 336
security write encryption, 367
trap authentication, 369
trap threshold, 370
supported
beeper functions, 344
symbologies, 315
symbologies not available
Datamatrix, 333
datamatrix, 334
maxicode, 335
LEAP
802.11 radio module
network EAP, 406
WPA encryption, 405
profile security information, 404
WEP encryption, 404
Letter recognizer, Windows Mobile input panel, 33
Library, Microsoft Reader, 91
Lighting Mode, configuration parameter, 353
Line printing, 182
lpBytesReturned
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_PROCESSOR_INFORMATION, 253
lpInBuf
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
IOCTL_PROCESSOR_INFORMATION, 253
lpInBufSize
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
Index
441700 Series Color Mobile Computer User’s Manual
lpOutBuf
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
IOCTL_PROCESSOR_INFORMATION, 253
LPT9 printer device, 183
M
Macro PDF, configuration parameter, 326
Managing e-mail messages and folders, via Inbox, 74
ManifestName,FTPServer,230
Matrix 2 of 5, 422
configuration parameter, 330
user ID, 340
MaxiCode, 422
configuration parameter, 335
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, 178
files, 178
object identifier, 179
OIDs, 179
Micro PDF417, 423
configuration parameter, 328
Microphone, 4
phone application, 165
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, 387
Migrating applications
FlashFileStore,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, 380
Modems, creating a connection
to an ISP, 98
to work, 106
MP3 files, Windows Media Player, 89
MSDN library, 236
MSDN Windows CE documentation, 177
MSI, 424
configuration parameter, 325
user ID, 338
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, 18
N
nDeviceId, NLEDGetDeviceInfo, 302
NDIS_ENCRYPTION_1_ENABLED
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_1_KEY_ABSENT
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_2_ENABLED
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_2_KEY_ABSENT
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_3_ENABLED
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_3_KEY_ABSENT
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_DISABLED
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_ENCRYPTION_NOT_SUPPORTED
EncryptionStatus(), 277
GetWepStatus(), 272
NDIS_MIXED_CELL_OFF, SetMixedCellMode(), 284
Index
442 700 Series Color Mobile Computer User’s Manual
NDIS_MIXED_CELL_ON, SetMixedCellMode(), 284
NDIS_NET_AUTO_UNKNOWN
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_MODE_ESS
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_MODE_IBSS
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_MODE_UNKNOWN
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_TYPE_DS, GetNetworkType(), 267
NDIS_NET_TYPE_FH, GetNetworkType(), 267
NDIS_NET_TYPE_OFDM_2_4G
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_TYPE_OFDM_5G
GetNetworkMode(), 266
SetNetworkMode(), 280
NDIS_NET_TYPE_UNDEFINED, GetNetworkType(),
267
NDIS_NETWORK_EAP_MODE_OFF
GetCCXStatus(), 274
SetCCXStatus(), 283
NDIS_NETWORK_EAP_MODE_ON
GetCCXStatus(), 274
SetCCXStatus(), 283
NDIS_POWER_LEVEL_1, GetTXPower(), 271
NDIS_POWER_LEVEL_15, GetTXPower(), 271
NDIS_POWER_LEVEL_30, GetTXPower(), 271
NDIS_POWER_LEVEL_5, GetTXPower(), 271
NDIS_POWER_LEVEL_63, GetTXPower(), 271
NDIS_POWER_LEVEL_UNKNOWN, GetTXPower(),
271
NDIS_RADIO_ASSOCIATED, GetAssocationStatus(),
260
NDIS_RADIO_AUTH_MODE_AUTO
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_ERROR
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_OPEN
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_SHARED
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_WPA
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_WPA_NONE
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_AUTH_MODE_WPA_PSK
GetAuthenticationMode(), 261
SetAuthenticationMode(), 278
NDIS_RADIO_POWER_AUTO
GetPowerMode(), 269
SetPowerMode(), 281
NDIS_RADIO_POWER_MODE_CAM
GetPowerMode(), 269
SetPowerMode(), 281
NDIS_RADIO_POWER_MODE_FAST_PSP
GetPowerMode(), 269
SetPowerMode(), 281
NDIS_RADIO_POWER_MODE_PSP
GetPowerMode(), 269
SetPowerMode(), 281
NDIS_RADIO_POWER_UNKNOWN
GetPowerMode(), 269
SetPowerMode(), 281
NDIS_RADIO_SCANNING, GetAssociationStatus(), 260
NDIS_SUPP_LOGGING_OFF, EnableSuppLogging(),
298
NDIS_SUPP_LOGGING_ON, EnableSuppLogging(),
298
NDISUIO_PACKET_DRIVER, SwitchPacketDriver(),
299
Network adapters
802.11b, 129
antenna color code, 127
Ethernet communications, 128
no networking, 132
wireless printing, 173
WWAN radio options, 134
Network EAP
LEAP security method, 406
PEAP security method, 395
Network type, 802.11 radio module, 388
nInBufSize
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_PROCESSOR_INFORMATION, 253
nInfoId, NLEDGetDeviceInfo, 302
NLED driver, vibrator, 301
NLED_COUNT_INFO, NLEDGetDeviceInfo, 302
NLED_SETTINGS_INFO_ID
NLEDGetDeviceInfo, 302
NLEDSetDevice, 302
NLED_SUPPORTS_INFO_ID, NLEDGetDeviceInfo,
302
Index
443700 Series Color Mobile Computer User’s Manual
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
nOutBufSize
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_DEVICE_INFO, 239
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
IOCTL_PROCESSOR_INFORMATION, 253
NPCP printing, 183
about, 183
closing driver, 184
COM1 parameters, 183
communications, 186
driver I/O controls, 185
installation, 183
LPT9, 183
opening driver, 184
reading from driver, 184
removal, 183
sample code, 186
unit information control panel, NPCPTEST CAB file,
377
writing to driver, 184
Numeric keypad
alpha (blue) key sequences, 14
[gold] key sequences, 12
registry settings
alpha plane, 305
gold plane, 305
unshifted plane, 305
scan codes, 307
O
O’Neil printing
See also DTR printer
installing driver, 188
Object Store, packaging an application, 118
Object store
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
Oldstyle device ID, 246
Opening drivers
DTR, 189
NPCP, 184
Owner information, Windows Mobile settings, 41
P
Packaging an application
CompactFlash storage cards, 118
FlashFileStore,118
Object Store, 118
Persistent Storage Manager, 118
Secure Digital storage cards, 118
Page format printing, 182
Password
Pocket Excel, 82
Windows Mobile settings, 41
PauseAtStartup, FTP Server, 231
PB20 printers, printer support, 181
PDF417, 422
about the laser scanner, 191
configuration parameter, 326
user ID, 338
PEAP
802.11 radio module
network EAP, 395
WPA encryption, 394
profile security information, 393
WEP encryption, 393
Persistent Storage Manager. See PSM
Phone jack position, control panel applet, 380
PhoneUtility, 165
ring, 166
vibrate, 166
pInput, NLEDSetDevice, 302
Planes, keypad, 304
Plessey, 423
configuration parameter, 324
user ID, 339
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, 17
Start menu icon, 27
viewing mobile favorites and channels, 97
Index
444 700 Series Color Mobile Computer User’s Manual
Pocket Outlook, 46
Calendar, 46
Pocket PC
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_OAL_VERINFO, 247
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, 358
with/without data, 359
pOutput, NLEDGetDeviceInfo, 302
Power
control panel
battery status, 5
RAM maintenance, 6
Windows Mobile settings, 41
Preamble
configuration parameter, 356
with/without data, 357
Prefix, configuration parameter, user ID, 342
Printer support, 182
IrDA printer driver, 182
NPCP printer driver, 183
O’Neil printer driver, 188
Processor information, IOCTL_PROCESSOR_IN-
FORMATION, 253
Profile label, 802.11 radio module, 388
Profiles
802.11 radio module, 387
advanced settings, 407
basic information, 388
security information, 389
editing, 387
Programs,addingorremoving,WindowsMobile,41
PSM
determining build version, 16
packaging an application, 118
PSM build, 314
Q
QR Code, 424
QR code, configuration parameter, 333
Query Information functions, 260
Quick Response Code. See QR Code
Quick Response code. See QR code
R
Radios
See also Network adapters
card support, 20
Reader commands, 410
configuration change, 410
date and time settings, 411
Reading from drivers, NPCP, 184
Real-Time Clock, restore after cold-boot, 381
Reboot methods
IOCTL_HAL_COLDBOOT, 303
IOCTL_HAL_REBOOT, 303
IOCTL_HAL_WARMBOOT, 303
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, 225
S9C upgrade, 378
updating the system software, 121
Recurrence pattern, Calendar, 49
RegFlush utility, 123
Registry
FTP Server parameters, 228
keypad remapping, 306
sample view of key mapping, 310
save location, IOCTL_HAL_ITC_WRITE_SYSPARM,
244
writing to a storage card, 123
Registry Save, control panel applet, 381
Registry settings
AutoCfg, 177
AutoFTP, 237
AutoInterval, 177
AutoIP/DHCP, 177
DhcpMaxRetry, 177
DhcpRetryDialogue, 177
EnableDHCP, 177
keypad driver, 306
keypad planes
alpha, 305
gold, 305
unshifted, 305
Removing drivers
DTR, 188
NPCP, 183
Removing programs, Windows Mobile, 41, 43
RFC 959, 235
Root, FTP Server, 231
RTC. See Real-Time Clock
S
S2of5.See Standard 2 of 5
S9C
unit information control panel, upgrade files, 378
version number, 375
Sabre 1551E or 1553
See also Tethered scanner
cabling, 199
settings, 198
Index
445700 Series Color Mobile Computer User’s Manual
Sample code, NPCP printing, 186
SB555 Watcher
activation, 140
Bell Mobility, 156
Sprint, 147
Telus, 156
Verizon, 143
WWANInit demo program, 156
copying files to computer, 137
via Microsoft ActiveSync, 138
via storage cards, 138
location of ESN, 140
Scan codes
alphanumeric keypad, 308
numeric keypad, 307
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, 408
backlight timeout, 409
date/time, 409
key clicks, 409
volume, 408
utilities configuration, button wakeup mask, 382
Scanner cabling, 199
Scheduling appointments and meetings, via Calendar, 46
SDK, unit information control panel, 378
SDMMC Disk, 122
Searching for text, Microsoft Reader, 93
Secure Digital cards
card support, 18
installing applications, 120, 121
migrating applications, 122
packaging an application, 118
Security, configuration parameter
encryption key, 368
read encryption, 366
read-only community string, 364
read/write community string, 365
subnet mask, 336
write encryption, 367
Selecting, drawing via Notes, 37
Sending and receiving messages, via Inbox, 73
Serial port, modem support, 16
Serial position, COM B, 380
Set information functions, 275
Setting date and time, 411
Setting up an e-mail account, 114
SETUP.DLL, installation functions, 220
SIM cards
IMSI assigned
CDMA/1xRTT, 136
GSM/GPRS, 164
installation status, GSM/GPRS, 164
phone number assigned, GSM/GPRS, 163
protection hardware, 243
protection software, 243
software installed, 243
Simple Network Management Protocol. See SNMP
SMS, Folder behavior connected to e-mail server, 74
Snap-on modems, 16
SNMP, 178
configuration parameters
identification contact, 371
identification location, 373
identification name, 372
security encryption key, 368
security read encryption, 366
security read-only community string, 364
security read/write community string, 365
security subnet mask, 336
security write encryption, 367
trap authentication, 369
trap threshold, 370
SNMP OIDs
1D OmniDir decode enable, 354
aimer LED duration, 350
automatic shutoff, 408
backlight timeout, 409
beeper, 345
frequency, 347
volume, 346
codabar, 318
user ID, 337
code 11, 332
user ID, 341
code 128, 321
FNC1 character, 323
user ID, 337
code 39, 316
user ID, 337
code 93, 320
length, 320
user ID, 338
datamatrix, 334
date/time, 409
EAN
13 user ID, 340
8 user ID, 340
good read
beep duration, 349
beeps, 348
identification
contact, 371
location, 373
name, 372
image dimension, 352
interleaved 2 of 5, 329
user ID, 338
key clicks, 409
lighting mode, 353
macro PDF, 326
matrix 2 of 5, 330
user ID, 340
maxicode, 335
Index
446 700 Series Color Mobile Computer User’s Manual
micro PDF417, 328
MSI, 325
user ID, 338
PDF417, 326
user ID, 338
plessey, 324
user ID, 339
prefix, 342
QR code, 333
security
encryption key, 368
read encryption, 366
read-only community string, 364
read/write community string, 365
write encryption, 367
security subnet mask, 336
standard 2 of 5, 317
user ID, 339
sticky aimer duration, 351
suffix, 343
telepen, 331
user ID, 340
trap
authentication, 369
threshold, 370
UPC
A user ID, 339
E user ID, 339
UPC/EAN, 319
virtual wedge, 355
code page, 361
grid, 360
postamble, 358
preamble, 356
volume, 408
Software Developer’s Kit. See SDK
Software versions, 17, 375
700 Series Computer, 17
unit information control panel applet, 375, 377
Speaker, 3
Speakerphone
phone application, 165
volume, 167
Sprint activation process, 147
SSID (network name), 802.11 radio module, 388
Standard 2 of 5, 424
configuration parameter, 317
user ID, 339
Start Menu, adding programs, 43
via ActiveSync, 43
via File Explorer, 43
Status icons, Windows Mobile, 26
Sticky Aimer Duration, configuration parameter, 351
Storage media, 18
Stream device driver
NPCPPORT.DLL, 183
ONEIL.DLL, 188
Suffix, configuration parameter, 343
Symbologies
internal scanner supported symbologies, 195
scanning labels, 412
tethered scanner supported symbologies, 205
user IDs
Codabar, 337
Code 11, 341
Code 128, 337
Code 39, 337
Code 93, 338
EAN 13, 340
EAN 8, 340
Interleaved 2 of 5, 338
Matrix 2 of 5, 340
MSI, 338
PDF417, 338
Plessey, 339
Standard 2 of 5, 339
Telepen, 340
UPC A, 339
UPC E, 339
when not available
imager, 324, 325, 326, 328, 330, 331, 332
laser scanner, 333, 334, 335
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
T
Tasks
creating a task, 70
Pocket Outlook, 69
Start menu icon, 27
synchronizing, 70
TCP/IP client, DHCP server, 177
Telepen, 425
configuration parameter, 331
user ID, 340
Telus activation process, 156
Testing AT commands, 169
Tethered scanner
capabilities, 199
disabling, 197
enabling, 197
error messages, 197
limitations, 199
settings, 197
supported symbologies, 205
Text messages, Windows Mobile, 39
Time, setting, 411
Tips for working, Pocket Excel, 83
Index
447700 Series Color Mobile Computer User’s Manual
TLS
802.1x profile
certificates, 399
WPA encryption, 398
profile security information
WEP encryption, 397
WPA encryption, 398
Today, Windows Mobile settings, 41
Today screen, Windows Mobile, 26
Tools CD
Bluetooth documentation, 173
CAB files, 120, 377
CE Imager, 122
Comm Port Wedge CAB file, 377
management tools installed on desktop, 119
MIB files, 178
sample NPCP code, 186
Wireless Printing Development Guide, 173
wireless printing sample, 378
wireless printing SDK, 173
Tracking people, via Contacts, 60
Transcriber, Windows Mobile input panel, 33
Trap configuration parameters
authentication, 369
threshold, 370
Traps, control panel appet, SNMP, 369
Troubleshooting
1551/1553 Tethered Scanners, 204
CAB Wizard, 224
TTLS
802.11 radio module, WPA encryption, 402
profile security information, WEP encryption, 401
Typing mode, Pocket Word, 79
Typing on the screen, Pocket Word, 79
U
UDP, FTPDCE, 232
UDP broadcasts, IDNATarget parameter, 230
Unit, configuration parameters
automatic shutoff, 408
backlight timeout, 409
date/time, 409
key clicks, 409
volume, 408
Unit information
battery status, 376
CAB files, 377
ActiveX control tools, 378
Bluetooth stack, 377
Comm Port Wedge, 377
NPCP printer, 377
S9C Upgrade, 378
SDK, 378
Windows configuration, 378
wireless printing sample, 378
versions, 17, 375
700 Platform Build, 375
DataCollection Build, 375
S9C, 375
Unit Manager, date/time, 409
Universal Product Code. See UPC
Unshifted plane on keypad, regular keypad, 304
UPC, 425
configuration parameter, 319
A user ID, 339
E user ID, 339
Updating, bootloader, 119
URLs
ActiveSync, 44
Adobe Acrobat Reader, 168
AT command interface
CDMA/1xRTT SB555, 168
GPRS/GSM MC45, 168
full screen display, 226
MIBs, 178
Microsoft Exchange e-mail account, 84
Microsoft Passport account, 84
Microsoft support, 25
MSDN library, 236
MSDN Windows CE documentation, 177
Windows Mobile, 25
Windows Mobile support, 25
Utilities control panel applet
app launch, 383
dock switch, 380
registry save, 381
wakeup mask, 382
UUID, 246
V
Verizon activation process, 143
Vibrator
enabling, 19
phone application, 166
programming, 301
Video files, Windows Media Player, 89
Viewing mobile favorites and channels, Pocket Internet
Explorer, 97
Virtual wedge
bar code configuration
grid, 415
postamble, 415
preamble, 415
configuration parameter, 355
code page, 361
grid, 360
postamble, 358
preamble, 356
VN_CLASS_ASIC, 241
VN_CLASS_BOOTSTRAP, 241
VN_CLASS_KBD, 241
Volume
bar code configuration, 408, 412
configuration parameter, 408
phone application, 165, 167
VPN server, creating a connection, to work, 111
Index
448 700 Series Color Mobile Computer User’s Manual
W
Wakeup mask, control panel applet, 382
WAN monitor CORE module
CDMA/1xRTT, 134
GSM/GPRS, 163
installing available modules, 126
loading a module, 126
WAN radio IDs
ITC_DEVID_WANRADIO_NONE, 242
ITC_DEVID_WANRADIO_SIEMENS_MC45, 242
ITC_DEVID_WANRADIO_SIERRA_SB555, 242
WAN rado CORE module
installing available modules, 126
loading a module, 126
WAP pages, 94
connecting to an ISP, 98
Warm boot
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
Watcher applications
activating, Sprint, 147
downloading, Sprint, 147
using
Sprint, 150
Verizon, 143
Web browsers, FTP support, 235
Web pages, 94
connecting to an ISP, 98
Welch Allyn 1470 Imager
cabling, 199
settings, 198
WEP encryption
LEAP security method, 404
PEAP security method, 393
profile security information, 390, 391
TLS security method, 397
TTLS security method, 401
Windows CE documentation (MSDN), 177
Windows configuration, unit information control panel,
WinCfg CAB file, 378
Windows Media files, Windows Media Player, 89
Windows Media Player
Start menu icon, 27
Windows Mobile, 89
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, to work, 108
Wireless network, 129, 387
Wireless printing
Bluetooth compatible module, 173
unit information control panel, WP_SAMPLE.CAB file,
378
Wireless TCP/IP installations, BlockSize parameter, 228
Wireless WAN
AT command interface
CDMA/1xRTT SB555, 168
GPRS/GSM MC45, 168
CDMA/1xRTT, 134
GSM/GPRS, 163
testing AT commands, 169
Work
creating
a modem connection, 106
a VPN server connection, 111
a wireless network connection, 108
an Ethernet connection, 113
getting connected, 104
WPA encryption
802.11 radio module, 392
LEAP security method, 405
PEAP security method, 394
TLS security method, 398
TTLS security method, 402
Writing mode, Pocket Word, 80
Writing on the screen
See also Notes
Pocket Word, 80
Writing to drivers
DTR, 189
NPCP, 184
WWAN. See Wireless WAN
WWANInit demo program, 156
creating a new connection, 158
setting up, 157
using the program, 160
X
Xscale processor ID, IOCTL_GET_CPU_ID, 254
Index
449700 Series Color Mobile Computer User’s Manual
Files Index
Numbers
80211API.DLL, 256
80211CONF.EXE, 256
80211SCAN.EXE, 256
802PM.DLL, 256
A
AUTOUSER.DAT, 120, 121
C
CABWIZ.DDF, 224
CABWIZ.EXE, 208, 224
CEIMAGER.EXE, 122
COREDLL.DLL, 301
CPL802.CPL, 256
D
DEVICEID.H, 246
E
EXITME.BIN, 235
F
FTPDCE.EXE, 232, 236
AutoFTP, 238
FTP Server, 227
FTPDCE.TXT, 236
I
INTERMEC.MIB, 178
ITCADC.MIB, 178
ITCSNMP.MIB, 178
ITCTERMINAL.MIB, 178
M
MAKECAB.EXE, 224
MOD80211.DLL, 256
N
NETWLAN.DLL, 256
NLED.H, 302
NLEDGetDeviceInfo, 302
NLEDSetDevice, 302
NPCPPORT.DLL, 183
NRINET.INI, 378
O
OEMIOCTL.H
IOCTL_GET_CPU_ID, 254
IOCTL_HAL_COLDBOOT, 249
IOCTL_HAL_GET_BOOT_DEVICE, 251
IOCTL_HAL_GET_BOOTLOADER_VERINFO,
248
IOCTL_HAL_GET_OAL_VERINFO, 247
IOCTL_HAL_GET_RESET_INFO, 250
IOCTL_HAL_ITC_READ_PARM, 240
IOCTL_HAL_ITC_WRITE_SYSPARM, 244
IOCTL_HAL_REBOOT, 252
IOCTL_HAL_WARMBOOT, 249
ONEIL.DLL, 188
P
PKFUNCS.H
IOCTL_HAL_GET_DEVICEID, 246
IOCTL_PROCESSOR_INFORMATION, 253
PRISMNDS.DLL, 256
R
REBOOTME.BIN, 235
__RESETMEPLEASE__.TXT, 220
RPM.EXE, 213
RPMCE212.INI, 213
S
SETUP.DLL, 212, 220
DllMain, 220
T
TAHOMA.TTF, 213
U
URODDSVC.EXE, 256
W
WCESTART.INI, 213
Index
450 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 - April 2004
*961-054-031F*
P/N 961-054-031 REV F