7 Programming The following programming information pertains to the 700 Series Color Mobile Computer: S Creating CAB Files (page 208) S Customization and Lockdown (page 225) S FTP Server (page 227) S Kernel I/O Control Functions (page 239) S Network Selection APIs (page 255) S Notifications (page 301) S Reboot Functions (page 303) S Remapping the Keypad (page 304) 700 Series Color Mobile Computer User’s Manual 207
Chapter 7 — Programming Creating CAB Files The Windows CE operating system uses a .CAB file to install an application on a Windows CE-based device. A .CAB file is composed of multiple files that are compressed into one file. Compressing multiple files into one file provides the following benefits: S All application files are present. S A partial installation is prevented. S The application can be installed from several sources, such as a desktop computer or a Web site.
Chapter 7 — Programming [CEStrings] This specifies string substitutions for the application name and the default installation directory. Required? Yes S AppName: app_name Name of the application. Other instances of %AppName% in the .INF file are replaced with this string value, such as RP32. S InstallDir: default_install_dir Default installation directory on the device. Other instances of %InstallDir% in the .INF file are replaced with this string value. Example: \SDMMC_Disk\%AppName% Example [CEStrings]
Chapter 7 — Programming [CEDevice] Describes the platform for the targeted application. All keys in this section are optional. If a key is nonexistent or has no data, Windows CE does not perform any checking with the exception being UnsupportedPlatforms. If the UnsupportedPlatforms key exists but no data, the previous value is not overridden. Required? Yes S ProcessorType : processor_type The value that is returned by SYSTEMINFO.dwProcessorType.
Chapter 7 — Programming Example The following code example shows three [CEDevice] sections: one that gives basic information for any CPU and two that are specific to the SH3 and the MIPS microprocessors. [CEDevice] UnsupportedPlatforms = pltfrm1 ; A “template” for all platforms ; Does not support pltfrm1 ; The following specifies version 1.0 devices only. VersionMin = 1.0 VersionMax = 1.0 [CEDevice.ARM] ; Inherits all [CEDevice] settings ; This will create a .CAB file specific to ARM devices.
Chapter 7 — Programming [DefaultInstall] This describes the default installation of your application. Note that under this section, you will list items expanded upon later in this description. Required? Yes S Copyfiles: copyfile_list_section Maps to files defined later in the .INF file, such as Files.App, Files.Font, and Files.Bitmaps. S AddReg: add_registry_section Example: RegSettings.
Chapter 7 — Programming [SourceDiskFiles] This describes the name and path of the files in which your application resides. Required? Yes S filename: disk_number[,subdir] RPM.EXE = 1,c:\appsoft\... WCESTART.INI = 1 RPMCE212.INI = 1 TAHOMA.TTF = 2 Note: [,subdir] is relative to the location of the INF file. Example [SourceDisksFiles] ; Required section begin.wav = 1 end.wav = 1 sample.hlp = 1 [SourceDisksFiles.SH3] sample.exe = 2 ; Uses the SourceDisksNames.SH3 identification of 2. [SourceDisksFiles.
Chapter 7 — Programming [DestinationDirs] This describes the names and paths of the destination directories for the application on the target device. Note Windows CE does not support directory identifiers. Required? Yes S file_list_section: 0,subdir String that identifies the destination directory. The following list shows the string substitutions supported by Windows CE. Use these only for the beginning of the path. \ %CE1% \Program Files %CE2% \Windows %CE3% \My Documents %CE4% \Windows\Startup %CE5% \My
Chapter 7 — Programming [CopyFiles] This section, under the [DefaultInstall] section, describes the default files to copy to the target device. Within the [DefaultInstall] section, files were listed that must be defined elsewhere in the INF file. This section identifies that mapping and may contain flags. Required? Yes S copyfile_list_section: destination_filename,[source_filename] The source_filename parameter is optional if it is the same as destination_filename.
Chapter 7 — Programming [AddReg] This section, under the [DefaultInstall] section, is optional and describes the keys and values that the .CAB file adds to the device registry. Within the [DefaultInstall] section, a reference may have been made to this section, such as “AddReg=RegSettings.All”. This section defines the options for that setting. Required? No S add_registry_section: registry_root_string String that specifies the registry root location.
Chapter 7 — Programming [CEShortCuts] This section, a Windows CE-specific section under the [DefaultInstall] section, is optional and describes the shortcuts that the installation application creates on the device. Within the [DefaultInstall] section, a reference may have been made to this section, such as “ShortCuts.All”. This section defines the options for that setting. Required? No S shortcut_list_section: shortcut_filename String that identifies the shortcut name. It does not require the .
Chapter 7 — Programming rpmce212.ini = 1 intermec.bmp = 1 rpmlogo.bmp = 1 rpmname.bmp = 1 import.bmp = 1 export.bmp = 1 clock.bmp = 1 printer.bmp = 1 filecopy.bmp = 1 readme.txt = 1 lang_eng.bin = 1 rpmdata.dbd = 1,database\wce1 tahoma.ttf = 2 mfcce212.dll = 3 olece212.dll = 3 olece211.dll = 1,c:\windows ce tools\wce400\NMSD61102.11\mfc\lib\x86 rdm45wce.dll = 1,c:\rptools\rdm45wce\4_50\lib\wce400\wcex86rel picfmt.dll = 1,c:\rptools\picfmt\1_00\wce400\wcex86rel6110 fmtctrl.dll = 1,c:\rptools\fmtctrl\1_00\wc
Chapter 7 — Programming fmtctrl.dll,,,0 ugrid.dll,,,0 simple.dll,,,0 psink.dll,,,0 pslpwce.dll,,,0 npcpport.dll,,,0 ;dexcom.dll,,,0 [Files.DataBase] rpmdata.dbd,,,0 [Files.Fonts] tahoma.ttf,,,0 [Files.BitMaps] intermec.bmp,,,0 rpmlogo.bmp,,,0 rpmname.bmp,,,0 import.bmp,,,0 export.bmp,,,0 clock.bmp,,,0 printer.bmp,,,0 filecopy.bmp,,,0 [Files.Intl] lang_eng.bin,,,0 [Files.TelecomNcsCE] ncsce.exe,,,0 nrinet.dll,,,0 [Files.Windows] readme.txt,,,0 [Files.Import] readme.txt,,,0 [Files.Export] readme.
Chapter 7 — Programming Using Installation Functions in SETUP.DLL SETUP.DLL is an optional file that enables you to perform custom operations during installation and removal of your application. The following list shows the functions that are exported by SETUP.DLL. S Install_Init Called before installation begins. Use this function to check the application version when reinstalling an application and to determine if a dependent application is present. S Install_Exit Called after installation is complete.
Chapter 7 — Programming // FALSE - process is not running.
Chapter 7 — Programming 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__.
Chapter 7 — Programming 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.
Chapter 7 — Programming S cpu_type Creates a .CAB file for each specified microprocessor tag, which is a label used in the Win32 SETUP.INF file to differentiate between different microprocessor types. The /cpu parameter, followed by multiple cpu_type values, must be the last qualifier in the command line. Example This example creates .CAB files for the ARM and MIPS microprocessors, assuming the Win32 SETUP.INF file contains the ARM and MIPS tags: cabwiz.exe “c:\myfile.inf” /err myfile.
Chapter 7 — Programming Customization and Lockdown Pocket PC (Windows Mobile) is a hardware specification created by Microsoft Corporation. Devices that wish to carry the Pocket PC logo must meet the minimum hardware requirements set in the Pocket PC specification. Manufacturers are free to add extra hardware functionality. Pocket PC devices also use a specialized version of the CE operating system. This OS is built from Windows CE 3.
Chapter 7 — Programming Should you want your 700 Series Computer to display a full screen, keep in mind that your computer is Pocket-PC certified by Microsoft Corporation. Check out resources on programming for the Pocket PC, using the following links. These instructions give full instructions on how to display full screen. S Instructions on how to create a full screen application for eVC++ applications using an SHFullScreen() API: http://support.microsoft.com/support/kb/articles/Q266/2/44.
Chapter 7 — Programming FTP Server FTP support is provided through the FTP Server application FTPDCE.EXE (MS Windows CE Versions) which is provided as part the base system. FTPDCE is the Internet File Transfer Protocol (FTP) server process. The server can be invoked from an application or command line. Besides servicing FTP client requests the FTP Server also send a “network announcement” to notify prospective clients of server availability.
Chapter 7 — Programming 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. Default port is 21.
Chapter 7 — Programming DeviceName This parameter configures the Intermec FTP Server to include the specified device name in the Intermec Device Network Announcement (IDNA). Adjusting this value may be useful in assigning a symbolic name to this device for asset tracking. Key HKLM\Software\Intermec\IFTP Value Type REG_SZ Valid Range None. Default None. DeviceURL This parameter configures the Intermec FTP Server to transmit the specified URL in the IDNA.
Chapter 7 — Programming IDNATarget This parameter configures the Intermec FTP Server to transmit the IDNA to a specific destination instead of a general UDP broadcast. This parameter is useful on networks that do not allow UDP broadcasts to be routed between subnets. The use of this parameter 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.
Chapter 7 — Programming PauseAtStartup This parameter configures the Intermec FTP Server to sleep for the specified number of seconds before making the FTP service available on the device. Key HKLM\Software\Intermec\IFTP Value Type REG_DWORD - stored in seconds. Valid Range None. Default 0 Root This parameter configures the Intermec FTP Server to set the root of the FTP mount point to the specified value.
Chapter 7 — Programming Transferring Files Over TCP/IP Networks The File Transfer Protocol (FTP) server transfers files over TCP/IP networks. The FTPDCE.EXE program is a version that does not display a window, but can run in the background. FTPDCE is the Internet File Transfer Protocol (FTP) server process. The server can be invoked from an application or command line.
Chapter 7 — Programming S RNTO Specifies rename-to file name. S STOR Stores a file. S SYST Shows the operating system type of server system. S TYPE (Binary transfers only.) Specifies the data transfer type with the Type parameter. S USER Specifies user name. S XCUP (Not Normally Used) Changes the parent directory of the current working directory. S XCWD (Not Normally Used) Changes the current directory. S XMKD (Not Normally Used) Creates a directory.
Chapter 7 — Programming S BOOT Reboots the server OS. This will cause the system on which the server is executing to reboot. The FTP Server will shut down cleanly before reboot. All client connections will be terminated. Cold boot is default except for the PocketPC build in which the default is warm boot. (SITE BOOT) Usage: QUOTE SITE BOOT [WARM | COLD] S COPY Copies a file from one location to another. (SITE COPY) Usage: QUOTE SITE COPY [source] [destination] Example QUOTE SITE COPY ‘\Storage Card\one
Chapter 7 — Programming S STATUS Returns the current settings of the FTP Server. MAC, serial number, model, IP address, network announcement information as well as OS memory usage are returned. (SITE STATUS) Usage: QUOTE SITE STATUS S TIMEOUT Toggles idle timeout between 120 to 1200 seconds (2 to 20 minutes). If this timer expires with no activity between the client and the server, the client connection will be disconnected.
Chapter 7 — Programming S Use the GET command on these files to have the FTP Server execute these commands. S Security: A customer configurable access control list may be installed on the 700 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.
Chapter 7 — Programming 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 unload 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.
Chapter 7 — Programming To do an AutoFTP Installation Check: 1 Ensure the FTP Server is running “out-of-the-box” the first time. 2 Tap Start > Today to access the Today screen, then tap the antenna icon in the System Tray to bring up the NDISTRAY pop-up menu. Select AutoFTP Off to disable AutoFTP. Do a warm boot and confirm the FTP Server is not running. 3 Tap Start > Today to access the Today screen, then tap the antenna icon in the System Tray to bring up the NDISTRAY pop-up menu.
Chapter 7 — Programming Kernel I/O Controls This describes the KernelIoControl() functions available to application programmers. Most C++ applications will need to prototype the function as the following to avoid link and compile errors. extern “C” BOOL KernelIoControl(DWORD dwIoControlCode, LPVOID lpInBuf, DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned); IOCTL_HAL_GET_DEVICE_INFO This IOCTL returns either the platform type or the OEMPLATFORM name based on an input value.
Chapter 7 — Programming IOCTL_HAL_ITC_READ_PARM Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_ITC_READ_PARM,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Points to this structure. See “ID Field Values” below. struct PARMS { BYTE id; BYTE ClassId; }; nInBufSize Must be set to the size of the PARMS structure. lpOutBuf Must point to a buffer large enough to hold the return data of the function.
Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_DISPLAY_TYPE This IOCTL returns the device’s display type. One byte is returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_EDG_IP This IOCTL returns the device Ethernet debug IP address. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter. ITC_NVPARM_EDBG_SUBNET This IOCTL returns the device Ethernet debug subnet mask. Four bytes are returned in the buffer pointed to by the lpOutBuffer parameter.
Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_RTC_RESTORE This IOCTL reads the state of the real-time clock restore flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the RTC is restored upon a cold boot. FALSE indicates that the RTC is not restored. ITC_NVPARM_INTERMEC_DATACOLLECTION_SW This IOCTL reads the state of the data collection software enabled flag.
Chapter 7 — Programming ID Field Values (continued) ITC_NVPARM_BLUETOOTH_INSTALLED This IOCTL reads the state of the Bluetooth radio installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer. TRUE indicates that the Bluetooth radio is installed. FALSE indicates that no Bluetooth radio is installed. ITC_NVPARM_SERIAL2_INSTALLED This IOCTL reads the state of the serial 2 (COM2) device installed flag. A BOOLEAN DWORD is returned in the buffer pointed to by lpOutBuffer.
Chapter 7 — Programming IOCTL_HAL_ITC_WRITE_SYSPARM Describes and enables the registry save location. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_ITC_WRITE_SYSPARM,LPVOID lpInBuf,DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned ); Parameters lpInBuf A single byte that may be one of the id values. See “ID Field Values” on the next page. nInBufSize Must be set to the size of the lpInBuf in bytes.
Chapter 7 — Programming ID Field Values The id field of lpInBuf may be one of the following values: ID Field Values ITC_REGISTRY_SAVE_ENABLE This function enables or disables the save registry to non-volatile media feature of the RegFlushKey() function. lpOutBuf must be set to zero (FALSE) if the feature is to be disabled or one (TRUE) if the feature is to be enabled. ITC_ DOCK_SWITCH This IOCTL sets a position of the dock switch. The dock switch may be set to either “modem” or “serial” positions.
Chapter 7 — Programming IOCTL_HAL_GET_DEVICEID This IOCTL returns the device ID. There are two types of device IDs supported, which are differentiated based on the size of the output buffer. The UUID is returned if the buffer size is set to sizeof(UNIQUE_DEVICEID), otherwise the oldstyle device ID is returned. Usage #include “pkfuncs.h” #include “deviceid.
Chapter 7 — Programming IOCTL_HAL_GET_OAL_VERINFO Returns the HAL version information of the Pocket PC image. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_OAL_VERINFO,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a VERSIONINFO structure as defined by OEMIOCTL.H.
Chapter 7 — Programming IOCTL_HAL_GET_BOOTLOADER_VERINFO Returns the HAL version information of the Pocket PC image. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_OAL_VERINFO,LPVOID lpInBuf, DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. nInBufSize Should be set to zero. lpOutBuf Must point to a VERSIONINFO structure as defined by OEMIOCTL.H.
Chapter 7 — Programming IOCTL_HAL_WARMBOOT Causes the system to perform a warm-boot. The object store is retained. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_WARMBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Should be NULL. nOutBufSize Should be zero. Return Values None. IOCTL_HAL_COLDBOOT Causes the system to perform a cold-boot.
Chapter 7 — Programming IOCTL_HAL_GET_RESET_INFO This IOCTL code allows software to check the type of the most recent reset. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_RESET_INFO,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a HAL_RESET_INFO structure. See sample below. nOutBufSize The size of HAL_RESET_INFO in bytes.
Chapter 7 — Programming IOCTL_HAL_GET_BOOT_DEVICE This IOCTL code allows software to check which device CE booted from. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_GET_BOOT_DEVICE,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Must point to a buffer large enough to hold a DWORD (4 bytes) that contains the boot device.
Chapter 7 — Programming IOCTL_HAL_REBOOT Causes the system to perform a warm-boot. The object store is retained. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_HAL_REBOOT,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. lpInBufSize Should be set to zero. lpOutBuf Should be NULL. nOutBufSize Should be zero. Return Values None.
Chapter 7 — Programming IOCTL_PROCESSOR_INFORMATION Returns processor information. Usage #include “pkfuncs.h” Syntax BOOL KernelIoControl( IOCTL_PROCESSOR_INFORMATION,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should be set to NULL. nInBufSize Should be set to zero. lpOutBuf Should be a pointer to the PROCESSOR_INFO structure. The PROCESSOR_INFO structure stores information that describes the CPU more descriptively.
Chapter 7 — Programming IOCTL_GET_CPU_ID Returns Xscale processor ID. Usage #include “oemioctl.h” Syntax BOOL KernelIoControl( IOCTL_GET_CPU_ID,LPVOID lpInBuf, DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned ); Parameters lpInBuf Should point to a CPUIdInfo structure defined in OEMIOCTL.H. lpInBufSize Should be sizeof(CPUIdInfo). lpOutBuf Should be NULL. nOutBufSize Should be set to 0.
Chapter 7 — Programming Network Selection APIs The Network Selection APIs change the network adapter configuration programmatically. Both drivers support the same IOCTL function numbers for loading and unloading the drivers. Loading and unloading of the 802.11b driver is performed by the FWL1: device in the system by performing DeviceIOControl() calls to the driver.
Chapter 7 — Programming The API provided by Intermec Technologies exposes a limited set of routines that allows a programmer to access and affect the 802.11b 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming Query Information Functions GetAssociationStatus() Call this function to obtain the radio’s current association status with a service set.
Chapter 7 — Programming GetAuthenticationMode() Call this function to obtain the radio’s current authentication mode. Syntax UINT GetAuthenticationMode( ULONG & ); Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11b Open Authentication. Indicates that the radio is using an open system. NDIS_RADIO_AUTH_MODE_SHARED 802.11b Shared Authentication. Indicates that the radio is using a shared key. NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates automatic detection is used when available.
Chapter 7 — Programming GetBSSID() Call this function to get the current MAC address (BSSID) of the service set. In ESS mode, this is the MAC address of the access point the radio is associated with. In IBSS mode, this is a randomly generated MAC address, and serves as the ID for the IBSS. Syntax UINT GetBSSID( TCHAR * ); Parameters Pointer to a character array, which is populated with the current BSSID after a successful call.
Chapter 7 — Programming GetDiversity() Call this function to get the current diversity setting of your 802.11b radio. 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.
Chapter 7 — Programming 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 example: 1, 2, 5, 11, etc. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed.
Chapter 7 — Programming 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 after a successful call.
Chapter 7 — Programming 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. Use of this option is not supported or recommended. NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps NDIS_NET_TYPE_OFDM_2_4G 802.11g 2.
Chapter 7 — Programming GetNetworkType() Call this function to get the current network type of the radio. Do not confuse this with GetNetworkMode(). Syntax UINT GetNetworkType( ULONG & ); Parameters NDIS_NET_TYPE_FH Indicates that this is a frequency hopping radio. NDIS_NET_TYPE_DS Indicates that this is a direct sequence radio. NDIS_NET_TYPE_UNDEFINED Indicates that this radio type is unknown or undefined.
Chapter 7 — Programming 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.
Chapter 7 — Programming GetPowerMode() Call this function to get the current power savings mode of the radio. Syntax UINT GetPowerMode( ULONG & ); Parameters NDIS_RADIO_POWER_MODE_CAM Continuous Access Mode (ie: always on). NDIS_RADIO_POWER_MODE_PSP Power Saving Mode. NDIS_RADIO_POWER_UNKNOWN Unknown power mode. NDIS_RADIO_POWER_AUTO Auto.
Chapter 7 — Programming GetRSSI() Call this function to get the current RSSI (Radio Signal Strength Indicator), in Dbm. Syntax UINT GetRSSI( ULONG & ); Parameters References a ULONG that is populated with the current RSSI after a successful call. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks If ERROR_SUCCESS is returned, your ULONG reference contains the RSSI.
Chapter 7 — Programming GetTXPower() Call this function to get the current transmit power of the radio. Syntax UINT GetTXPower( ULONG & ); Parameters NDIS_POWER_LEVEL_63 63 mW NDIS_POWER_LEVEL_30 30 mW NDIS_POWER_LEVEL_15 15 mW NDIS_POWER_LEVEL_5 5 mW NDIS_POWER_LEVEL_1 1 mW NDIS_POWER_LEVEL_UNKNOWN Unknown Value or Error. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed.
Chapter 7 — Programming GetWepStatus() Call this function to get the current state of the radio’s WEP and encryption levels. Syntax UINT GetWepStatus( ULONG & ); Parameters NDIS_ENCRYPTION_1_ENABLED WEP is enabled; TKIP and AES are not enabled, and a transmit key may or may not be available. (same as NDIS_RADIO_WEP_ENABLED) NDIS_ENCRYPTION_DISABLED Indicates that AES, TKIP, and WEP are disabled, and a transmit key is available.
Chapter 7 — Programming GetRadioIpAddress() Call this function to obtain a formatted string indicating whether DHCP is enabled, and what is the current adapters IP address. Syntax UINT GetRadioIpAddress( TCHAR * ); Parameters Pointer to a character array that contains the formatted string of the IP address and static/DHCP information. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed.
Chapter 7 — Programming 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.
Chapter 7 — Programming Set Information Functions AddWep() Call this function to add a WEP key to the radio. Call this function multiple times when adding more than one WEP key. Save the “default” key for last. For example, when adding four keys, and the second key is the default transmit key, add keys 1, 3 and 4 before you add key 2. Note: Add the default transmit key last. Syntax UINT AddWep( ULONG, BOOL, TCHAR * ); Parameters ULONG Specifies the key index to be set. Valid values are 0–3.
Chapter 7 — Programming EnableWep() Enables or disables WEP encryption on the radio (TRUE/FALSE). Syntax UINT EnableWep( BOOL ); Parameters Set BOOL to TRUE to enable WEP encryption, or FALSE to disable WEP encryption. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks Call this function with TRUE as the parameter to enable WEP encryption.
Chapter 7 — Programming EncryptionStatus() Call this function to set the desired encryption status. Syntax UINT EncryptionStatus( UINT mode ); Parameters NDIS_ENCRYPTION_1_ENABLED WEP is enabled; TKIP and AES are not enabled, and a transmit key may or may not be available. (same as NDIS_RADIO_WEP_ENABLED) NDIS_ENCRYPTION_DISABLED Indicates that AES, TKIP, and WEP are disabled, and a transmit key is available.
Chapter 7 — Programming SetAuthenticationMode() Call this function to set the desired authentication mode. Syntax UINT SetAuthenticationMode( ULONG ); Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11b Open Authentication. Indicates that the radio is using an open system. NDIS_RADIO_AUTH_MODE_SHARED 802.11b Shared Authentication. Indicates that the radio is using a shared key. NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates automatic detection is used when available.
Chapter 7 — Programming SetChannel() This function is currently not implemented. Ad-hoc networks automatically select a channel or use the already existing channel. Syntax UINT SetChannel( USHORT ); Parameters USHORT value that should populate with the desired channel (1–14). Return Values None. Remarks None.
Chapter 7 — Programming SetNetworkMode() Call this function to set the desired Network Mode. Syntax UINT SetNetworkMode( ULONG ); Parameters NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode. NDIS_NET_MODE_ESS 802.11 Infrastructure Mode. NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supported or recommended. NDIS_NET_TYPE_OFDM_5G 5 Gigahertz 54 Mbps NDIS_NET_TYPE_OFDM_2_4G 802.11g 2.
Chapter 7 — Programming SetPowerMode() Call this function to set the desired power mode. Syntax UINT SetPowerMode( ULONG mode ); Parameters NDIS_RADIO_POWER_MODE_CAM Continuous Access Mode (ie: always on). NDIS_RADIO_POWER_MODE_PSP Power Saving Mode. NDIS_RADIO_POWER_UNKNOWN Unknown power mode. NDIS_RADIO_POWER_AUTO Auto.
Chapter 7 — Programming SetSSID() Call this function with a pointer to a null-terminated TCHAR array containing the desired SSID to set the desired SSID of the adapter. Syntax UINT SetSSID( TCHAR * ); Parameters Pointer to a character array that contains the desired SSID. This should be null-terminated. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed.
Chapter 7 — Programming 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming RemoveWep() Call this function with a key index of 0–3 to remove the WEP key at that index. Syntax UINT RemoveWep( ULONG ); Parameters ULONG value that specifies the key index to set. Valid values are 0–3. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed. Remarks On disassociation with all BSSIDs of the current service set, the WEP key is removed by the adapter.
Chapter 7 — Programming Helper Functions ConfigureProfile() If using the Intermec 802.11b Profile Management system, you can program the API to configure the radio to a specific profile by passing the profile name. Syntax UINT ConfigureProfile( TCHAR * ); Parameters Pointer to a character array that contains the profile name. This should be null-terminated. Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or ERR_CONNECT_FAILED if a connection with the radio failed.
Chapter 7 — Programming EnableZeroConfig() This enables or disables the Wireless Zero Configuration Wizard from Microsoft. After calling this function, a warm-boot is required for the change to take effect. Note: Enabling this function effectively disables all the SET commands in this API.
Chapter 7 — Programming 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming isSupplicantRunning() Call this function to determine whether the security supplicant is running. Syntax UINT isSupplicantRunning( ); Parameters None. Return Values TRUE if the security supplicant is running, FALSE if it is not running. Remarks None.
Chapter 7 — Programming StartScanList() If a scan list is configured on the system, this causes the API to begin the process of scanning for an available network. This call can take quite a while to process (depending upon the length of the scan list and how long it takes to find a valid network), you may wish to call it from a separate thread. Syntax UINT StartScanList( ); Parameters None. Return Values ERROR_SUCCESS when successful.
Chapter 7 — Programming StartSupplicant() Call this function to start the supplicant service if it is installed on the system. Syntax UINT StartSupplicant( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None.
Chapter 7 — Programming StopSupplicant() Call this function to stop the supplicant service. Syntax UINT StopSupplicant( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None.
Chapter 7 — Programming 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.
Chapter 7 — Programming RenewDHCP() Call this function to force a DHCP renewal on the current network adapter. Syntax UINT RenewDHCP( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks You should not have to call this function on Microsoft PocketPC 2003 or Microsoft Windows CE 4.2 .NET and later devices.
Chapter 7 — Programming GetCurrentDriverName() Call this function to populate the TCHAR array with the driver name. Syntax UINT GetCurrentDriverName( TCHAR * ); Parameters Pointer to a TCHAR array which contains the name of the driver when successful. Return Values ERROR_SUCCESS when successful. Remarks This function is called with a pointer to a TCHAR array that is large enough to hold the name of the driver PLUS the null terminator.
Chapter 7 — Programming ResetRadioToSystemSave() Call this function to force the radio to reset to the last desired active profile. Syntax UINT ResetRadioToSystemSave( ); Parameters None. Return Values ERROR_SUCCESS when successful. Remarks None.
Chapter 7 — Programming 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.
Chapter 7 — Programming SwitchPacketDriver() Call this function to switch between available packet drivers on the system. Syntax UINT SwitchPacketDriver( USHORT ); Parameters INTERMEC_PACKET_DRIVER Intermec Packet Driver (ZNICZIO) NDISUIO_PACKET_DRIVER Microsoft Packet Driver (NDISUIO) Return Values ERROR_SUCCESS when successful. Remarks After switching to a new packet driver, perform a warm boot for changes to take effect.
Chapter 7 — Programming Deprecated Functions The following functions are deprecated. While these are not removed from the API, these are no longer supported.
Chapter 7 — Programming Notifications Use the following information to programmatically control the vibrator, to write an application to turn on the vibrator when a message is received via the WLAN radio link, and turn it off when the user hits a key. Vibrator support is implemented in the NLED driver as a false LED. The vibrator is LED 5 and is identified with an CycleAdjust of –1. The vibrate option is only available in the notifications panel when the vibrator is present in the system.
Chapter 7 — Programming NLEDGetDeviceInfo Usage #include “nled.h” Syntax BOOL NLEDGetDeviceInfo ( UINT nInfoId, void *pOutput ); Parameters S nInfoId Integer specifying the information to return. These values are defined: NLED_COUNT_INFO Indicates the pOutput buffer specifies the number of LEDs on the device. NLED_SUPPORTS_INFO_ID Indicates the pOutput buffer specifies information about the capabilities supported by the LED.
Chapter 7 — Programming Reboot Functions There are several methods, via Kernel I/O Control functions, that an application program can use to force the 700 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.
Chapter 7 — Programming 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.
Chapter 7 — Programming Alpha (Blue) Plane The alpha plane contains values from the keypad when the keypad has been placed in alpha mode by pressing the blue alpha key, such as the following: Press the Keys Numeric Keypad Alphanumeric Keypad To Enter This [Alpha] F 1 [Alpha] F g Caps [Alpha] F 5 [Alpha] F J j [Alpha] F 9 [Alpha] F W w Key Values Key values for each plane are stored in the registry. All units ship with a default key mapping already loaded in the registry.
Chapter 7 — Programming How Key Values Are Stored in Registry To know which fields to update in the registry, you must know what Scan Codes are assigned to each physical key (see the “Keypad Scan Codes and Meanings” table on the next page). The Scan Code is used at the lowest level of the system to let the keypad driver know which physical key has been pressed.
Chapter 7 — Programming Scan Codes At the lowest driver level, the 700 Color Numeric Keypad and the 700 Color Alphanumeric Keypad identifies keys as scan codes. These scan codes are sent via the keypad microcontroller, and cannot be changed without modifying the keypad firmware.
Chapter 7 — Programming Numeric Keypad Scan Codes and Meanings (continued) Press this Key Meaning ScanCode e Enter/@ (at symbol) 0x1D 6 6/MNO/A4 0x1E None 0x1F–0x40 B Charge Detect 0x41 C LCD frontlight 0x42 b Ambient light 0x42 Threshold crossed 0x42 Headset detected 0x43 Keypad Backlight 0x44 Ambient Light 0x44 Threshold Crossed 0x44 b Alphanumeric Keypad The following scan codes pertain to the 700 Color Alphanumeric keypad: Alphanumeric Keypad Scan Codes and Meanings Press
Chapter 7 — Programming Alphanumeric Keypad Scan Codes and Meanings (continued) Press this Key Meaning ScanCode J J/PgUp 0x13 K K/@ (as symbol) 0x14 L L/– (minus sign) 0x15 M M/1 0x16 N N/2 0x17 I I/backlight 0x18 P P/PgDn 0x19 Q Q/, (comma) 0x1A R R/+ (plus sign) 0x1B S S/4 0x1C T T/5 0x1D O O/3 0x1E g Caps/Lock 0x1F h BkSp 0x20 V V/.
Chapter 7 — Programming Sample View of Registry Keys The following is a sample view of the current default key mapping for the 700 Color Numeric Keypad. See the registry on your device for the latest key mappings. [HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\KEYBD] ”ResumeMask”=dword:7 ”Vkey”=hex: 00,00,0B,05,02,03,C1,07,04,03,BE,00,34,00,00,00,\ 25,00,00,00,08,00,03,02,00,00,1B,00,28,00,31,00,\ 37,00,01,02,00,00,26,00,27,00,32,00,38,00,30,00,\ 35,00,00,00,01,03,33,00,39,00,0D,00,36,00,00,00,\ 00,00,00,00,00,00,
A Configurable Settings This appendix contains information about the Data Collection, Intermec Settings, SNMP, Unit Information, Utilities, and Wireless Network control panel applets that may be on the 700 Series Color Mobile Computer. 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.
Appendix A — Configurable Settings 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: S Change Data Collection and SNMP parameters via control panel applets later in this appendix. S Send parameters from an SNMP management station.
Appendix A — Configurable Settings S Tap Refresh to discard changes and start again. Tap Yes when you are prompted to verify this action. About Configuration Parameters You can find this information about each configuration parameter: S Name and Purpose: Describes the parameter and its function. S Action: Describes what to do with a parameter once that parameter is selected. S SNMP OID: Lists the SNMP OID for the parameter.
Appendix A — Configurable Settings Data Collection Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM Build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the Data Collection applet.
Appendix A — Configurable Settings 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.
Appendix A — Configurable Settings Code 39 Code 39 is a discrete, self-checking, variable length symbology. The character set is uppercase A–Z, 0–9, dollar sign ($), period (.), slash (/), percent (%), space ( ), plus (+), and minus (-). Action Tap (+) to expand the Code 39 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.3.
Appendix A — Configurable Settings Standard 2 of 5 Standard 2 of 5 is a discrete and self-checking symbology that uses the bars to encode information and the spaces to separate the individual bars. Action Tap (+) to expand the Standard 2 of 5 parameter, select the setting to be changed, then tap an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.4.
Appendix A — Configurable Settings Codabar Codabar is a self-checking, discrete symbology. Action Tap (+) to expand the Codabar parameter, select a setting to be changed, then select an option from the drop-down list to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.5.
Appendix A — Configurable Settings UPC/EAN UPC/EAN are fixed-length, numeric, continuous symbologies that use four element widths. Action Tap (+) to expand the UPC/EAN parameter, select the setting to be changed, then select an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.6.
Appendix A — Configurable Settings Code 93 Code 93 is a variable length, continuous symbology that uses four element widths. Action Tap the Code 93 parameter, then select an option to change this parameter setting. Tap (+) to access the Code 93 Lengths parameter. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.7.1 Options 0 1 Not active (default) Active Code 93 Length Sets the Code 93 bar code length. Action Tap (+) to expand the Code 93 parameter, then tap (+) to expand the Code 93 Lengths parameter.
Appendix A — Configurable Settings Code 128 Code 128 is a variable-length, continuous, high-density, alphanumeric symbology that uses multiple element widths and supports the extended ASCII character set. Action Tap the Code 128 parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.9.1 Options 0 1 Not active (default) Active This illustration is from a 700 Series Computer using a laser scanner.
Appendix A — Configurable Settings Code 128 Options Set the following for the Code 128 parameter. Note that the EAN 128 ]C1 and CIP 128 French Pharmaceutical options are not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Code 128 FNC1 Character The Code 128 FNC1 character (EAN 128 norms) can be any ASCII character and is used as a separator when multiple identifiers and their fields are concatenated. Note that this is not available when you use an imager with your 700 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 enter
Appendix A — Configurable Settings Plessey Plessey is a pulse-width modulated symbology like most other bar codes. It includes a start character, data characters, an eight-bit cyclic check digit, and a termination bar. The code is continuous and not self-checking. You need to configure two parameters for Plessey code: Start Code and Check Digit. Note that this is not available when you use an imager with your 700 Series Computer.
Appendix A — Configurable Settings 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 Computer. Action Tap (+) to expand the MSI parameter, select the setting to be changed, then select an option to change this setting or select an option from the drop-down list. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.15.
Appendix A — Configurable Settings PDF417 PDF417 is a stacked two-dimensional symbology that provides the ability to scan across rows of code. Each row consists of start/stop characters, row identifiers, and symbol characters, which consist of four bars and four spaces each and contain the actual data. This symbology uses error correction symbol characters appended at the end to recover loss of data.
Appendix A — Configurable Settings S Select Unbuffered for multi-label PDF417 messages that are too long for the Sabre buffer (memory overflow). Each part of the PDF417 label is transmitted separately, and the host application must then assemble the message using the macro PDF control header transmitted with each label. Control Header is only present in macro PDF codes and is always transmitted with unbuffered option.
Appendix A — Configurable Settings 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, together with a fixed level of error correction for each symbology size. Note that this is not available when you use an imager with your 700 Series Computer.
Appendix A — Configurable Settings Interleaved 2 of 5 Interleaved 2 of 5 (I 2 of 5) is a high-density, self-checking, continuous, numeric symbology used mainly in inventory distribution and the automobile industry. Note: An Interleaved 2 of 5 bar code label must be at least three characters long for the 700 Series Computer to scan and decode correctly.
Appendix A — Configurable Settings Matrix 2 of 5 Matrix 2 of 5 is a numerical symbology. Note that this is not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Telepen Telepen is an alphanumeric, case-sensitive, full ASCII symbology. Note that this is not available when you use an imager with your 700 Series Computer. Action Tap (+) to expand the Telepen parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.25.
Appendix A — Configurable Settings Code 11 Code 11 is a high density, discrete numeric symbology that is extensively used in labeling telecommunications components and equipment. Note that this is not available when you use an imager with your 700 Series Computer. Action Tap (+) to expand the Code 11 parameter, select the setting to be changed, then tap an option to change this setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.1.1.26.
Appendix A — Configurable Settings QR Code QR Code (Quick Response Code) is a two-dimensional matrix symbology containing dark and light square data modules. It has position detection patterns on three of its four corners and features direct encodation of the Japanese Kana-Kanji character set. It can encode up to 2509 numeric or 1520 alphanumeric characters and offers three levels of error detection.
Appendix A — Configurable Settings Data Matrix A two-dimensional matrix symbology, which is made of square modules arranged within a perimeter finder pattern. The symbology utilizes Error Checking and Correcting (ECC) algorithm with selectable levels for data error recovery and Cyclic Redundancy Check algorithm to validate the data. The character set includes either 128 characters conforming to ISO 646 (ANSI X3.4 - 1986) or 256 extended character set.
Appendix A — Configurable Settings MaxiCode MaxiCode is a fixed-size 2-D matrix symbology which is made up of offset rows of hexagonal elements arranged around a unique circular finder pattern. ASCII data is encoded in six-bit symbol characters. The symbol contains 33 rows which are alternately 30 and 29 elements wide. There are five different code sets. A single MaxiCode symbol can encode up to 93 characters of data.
Appendix A — Configurable Settings Symbology Options To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > the Data Collection icon to access its control panel applet. Use the right and left arrows to scroll to the Symbology Options tab, then tap this tab to access its parameters. The following are parameters for bar code symbology options. Note that these are listed in the order of their appearance within the Symbology Options tab.
Appendix A — Configurable Settings Code 39 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 39 bar code data. Note that this is not available when you use an imager with your 700 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: x where x is a single ASCII character.
Appendix A — Configurable Settings Code 93 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 93 bar code data. Note that this is not available when you use an imager with your 700 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: x where x is a single ASCII character.
Appendix A — Configurable Settings Plessey User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Plessey bar code data. Note that this is not available when you use an imager with your 700 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: x where x is a single ASCII character.
Appendix A — Configurable Settings EAN 8 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify EAN-8 bar code data. Note that this is not available when you use an imager with your 700 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: x where x is a single ASCII character. Default is \x
Appendix A — Configurable Settings Code 11 User ID If “1” was selected in the Symbology ID parameter, you can set your own ASCII character to identify Code 11 bar code data. Note that this is not available when you use an imager with your 700 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: x where x is a single ASCII character.
Appendix A — Configurable Settings Prefix Prepends a string of up to 20 ASCII characters to all scanned data. Action Tap the Prefix parameter, then enter a prefix value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.4.1.29.1 Options Acceptable values are up to 20 ASCII characters. Embedded null () characters are not allowed. Default is no characters (disabled).
Appendix A — Configurable Settings Suffix Appends a string of up to 20 ASCII characters to all scanned data. Action Tap the Suffix parameter, then enter a suffix value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.3.4.1.30.1 Options Acceptable values are up to 20 ASCII characters. Embedded null () characters are not allowed. Default is no characters (disabled).
Appendix A — Configurable Settings Beeper/LED To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > the Data Collection icon to access its control panel applet. Use the right and left arrows to scroll to the Beeper/LED tab, then tap this tab to access its parameters. Most of these functions are not available when using an imager. The following table shows which functions are supported either by an imager or by a laser scanner.
Appendix A — Configurable Settings Beeper Sets the volume for the good read beep. Note that this is not available when you use a laser scanner with your 700 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.
Appendix A — Configurable Settings Beeper Volume Sets the volume for the good read beep. Note that this is not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Beeper Frequency Sets the frequency for the good read beep. Note that this is not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Good Read Beeps Sets the number of good read beeps. Note that this is not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Good Read Beep Duration Sets the duration of the good read beep. Note that this is not available when you use an imager with your 700 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.
Appendix A — Configurable Settings Imager Note: These instructions do not apply to the 730 Computer. To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > Data Collection to access its control panel applet. Use the right and left arrows to scroll to the Imager tab, then tap this tab to access its parameters. The following are parameters for the imager. Note that these are listed in the order of their appearance within the Imager tab.
Appendix A — Configurable Settings Sticky Aimer Duration The Sticky Aimer Duration controls the time the Aimer LED stays on after the a bar code read completes or after the trigger button is released. Note that this is not available when you use a laser scanner with your 700 Series 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.
Appendix A — Configurable Settings Image Dimension The image dimensions control the vertical size of the image for decoding. This can restrict the image to one bar code when otherwise, there might be more than one bar code in the image to be decoded. Note that this is not available when you use a laser scanner with your 700 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.
Appendix A — Configurable Settings Lighting Mode The Lighting Mode sets the lighting mode of the imager. When set to “LED Priority,” the imager depends more on ambient lighting to illuminate the bar code for reading. When set to “Aperture Priority,” the imager uses its built-in LED to illuminate the bar code for reading. Note that this is not available when you use a laser scanner with your 700 Series Computer. Action Tap the Lighting Mode parameter, then select an option to change this parameter setting.
Appendix A — Configurable Settings 1D OmniDir Decode Enable The 1D OmniDir Decode Enable affects the scanning abilities of the IT4000 Imager. With 1D omni directional enabled, the imager is able to decode images and bar code labels regardless of the orientation of the label. With 1D omni directional disabled, the imager only decodes labels in the direction of the aimer LED. Note that this is not available when you use a laser scanner with your 700 Series Computer.
Appendix A — Configurable Settings Virtual Wedge To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > Data Collection to access its control panel applet. Use the right and left arrows to scroll to the Virtual Wedge tab, then tap this tab to access its parameters. The following are parameters for the virtual wedge scanner. Note that these are listed in the order of their appearance within the Virtual Wedge tab.
Appendix A — Configurable Settings Preamble Sets the preamble that precedes any data you scan with the 700 Series Computer. Common preambles include a data location number or an operator number. Action Tap the Preamble parameter, then enter a preamble value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.3.1 Syntax ADdata where data is any acceptable values up to 31 ASCII characters. Embedded null () characters are not allowed.
Appendix A — Configurable Settings Note: When you enter the AD command without data, the preamble is disabled. If you want to use quotation marks or the following combinations of characters as part of the appended data, separate those characters from the AD command with quotes.
Appendix A — Configurable Settings Postamble Sets the postamble that is appended to any data you scan with the 700 Series Computer. Common postambles include cursor controls, such as tabs or carriage return line feeds. Action Tap the Postamble parameter, then enter a postamble value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.4.1 Syntax AEdata where data is any acceptable values up to 31 ASCII characters. Embedded null () characters are not allowed.
Appendix A — Configurable Settings Note: When you enter the AE command without data, the postamble is disabled. If you want to use quotation marks or the following combinations of characters as part of the appended data, separate those characters from the AE command with quotes. If you do not use quotes as described here, the 700 Series Computer will interpret the characters as another configuration command.
Appendix A — Configurable Settings 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.
Appendix A — Configurable Settings Code Page Sets the virtual wedge code page. The code page controls the translation from the character set of the raw collected data to Unicode, which is the character set expected by Windows CE applications. The default code page is 1252, which is the Windows Latin 1 (ANSI) character set. Action Tap the Code Page parameter, then select an option to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.15.3.2.1.1.6.
Appendix A — Configurable Settings Intermec Settings Control Panel Applet You may have the Intermec Settings control panel applet. Information about the settings you can configure with this applet is described in the Intermec Computer Command Reference Manual. The online manual is available from the Intermec web site at www.intermec.com.
Appendix A — Configurable Settings SNMP Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the SNMP applet.
Appendix A — Configurable Settings Security To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > SNMP > the Security tab to access its parameters. The following are parameters that affect encryption and community strings. Note that these are listed in the order of their appearance within the Security tab. Read Only Community Sets the read-only community string for this 700 Series Computer, which is required for processing of SNMP get and get next requests.
Appendix A — Configurable Settings Read/Write Community Sets the read/write community string, which is required for processing of SNMP set requests by this 700 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.
Appendix A — Configurable Settings Read Encryption Sets the packet-level mode of security for SNMP read-only requests. If you enable read encryption, all received SNMP get and get next packets have to be encrypted or the packet will not be authorized. If encryption is enabled, you can only use software provided by Intermec Technologies. Note: To enable security encryption, you also need to set the Security Encryption Key (page 368).
Appendix A — Configurable Settings Write Encryption Sets the packet-level mode of security for SNMP read/write requests. If you enable write encryption, all SNMP packets that are received with the read/write community string have to be encrypted or the packet will not be authorized. You need to use software from Intermec Technologies that supports encryption. Note: To enable security encryption, you also need to set the Security Encryption Key (page 368).
Appendix A — Configurable Settings Encryption Key Identifies the key that this 700 Series Computer uses to encrypt or decipher SNMP packets. Encryption is used only by software provided by Intermec Technologies. If encryption is enabled, SNMP management platforms will not be able to communicate with the 700 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.
Appendix A — Configurable Settings Traps To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > SNMP > the Traps tab to access its parameters. The following are authentication and threshold parameters for traps. Note that these are listed in the order of their appearance within the Traps tab. Authentication Determines whether to send authentication traps.
Appendix A — Configurable Settings Threshold Determines the maximum number of traps per second that the master agent generates. If the threshold is reached, the trap will not be sent. Action Tap the Threshold parameter, then enter a threshold value to change this parameter setting. SNMP OID 1.3.6.1.4.1.1963.10.5.2.3.0 Options Any positive integer value. Default is 10.
Appendix A — Configurable Settings Identification To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > SNMP > the Identification tab to access its parameters. The following are parameters for contact, location, and name information for support purposes. Note that these are listed in the order of their appearance within the Identification tab. Contact Sets the contact information for the person responsible for this 700 Series Computer.
Appendix A — Configurable Settings Name Sets the assigned name for this 700 Series Computer. Action Tap the Name parameter, then enter the name of your 700 Series Computer to change this parameter setting. SNMP OID 1.3.6.1.2.1.1.5.0 Options The identification name may be up to 255 ASCII characters. Default is no characters or blank.
Appendix A — Configurable Settings 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.
Appendix A — Configurable Settings Unit Information Control Panel Applet Note: This applet is not available in units with PSM Build 3.00 or newer. To determine your PSM build version, tap Start > Programs > File Explorer > the PSMinfo text file. If your unit has PSM Build 3.00 or newer, then you may have the Intermec Settings control panel applet in place of the Unit Information applet.
Appendix A — Configurable Settings 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 > the System tab > Unit Information > the Versions tab to view the latest software build version. Tap ok to exit this information.
Appendix A — Configurable Settings 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 > the System tab > Unit Information > the Battery Status tab to view the current status. Tap ok to exit this information.
Appendix A — Configurable Settings CAB Files You can view the latest developer or released version of each CAB file from Intermec Technologies Corporation that are installed in your 700 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.
Appendix A — Configurable Settings S S9C Upgrade: Installs the files needed to upgrade the S9C scanner firmware. See the 700 Color Management Tools portion of the Intermec Developer’s Library CD for more information about upgrading the firmware. S SDK: Installs the Intermec Software Developer’s Kit (SDK). See the SDK User’s Manual for more information. S WinCfg: Configures the NRINET.INI file, launches the NRINet client, and loads and unloads the LAN and WLAN device drivers.
Appendix A — Configurable Settings Utilities Control Panel Applet The Utilities control panel applet examines and modifies settings and operational modes of specific hardware and software on the 700 Color Computer, including the dock switch, registry storage, wakeup mask, and application launch keys. To access the settings from the 700 Series Computer, tap Start > Settings > the System tab > Utilities to access its control panel applet.
Appendix A — Configurable Settings Dock Switch From the 700 Series Computer, tap Start > Settings > the System tab > Utilities > the Dock Switch tab to access the Dock Switch control panel applet. Use this applet to control the position of the dock switch. This can be set either to a COM A (phone jack for a modem) position or to a COM B (serial) position.
Appendix A — Configurable Settings Registry Save From the 700 Series Computer, tap Start > Settings > the System tab > Utilities > the Registry Save tab to access the Registry Save control panel applet. For Windows Mobile 2003, the only medium available for saving the registry is the Flash File System (PSM). Registry data is stored in the “\Flash_File_Store\Registry” path. Check Enable Registry Storage to enable this function.
Appendix A — Configurable Settings Wakeup Mask From the 700 Series Computer, tap Start > Settings > the System tab > Utilities > the Wakeup Mask tab to access the Wakeup Mask control panel applet. This applet programs three scanner buttons and the A1 and A2 application keys to be “wakeup” or resume keys. That is, to prompt the 700 Series Computer to “wake up” or resume activity after going to “sleep” as a result of being inactive after a length of time.
Appendix A — Configurable Settings App Launch From the 700 Series Computer, tap Start > Settings > the System tab > Utilities , then scroll to the right to tap the App Launch tab to access the Application Launch control panel applet. This applet programs or maps two scanner buttons and four application keys to start up to six applications.
Appendix A — Configurable Settings S To disable or unmap a currently mapped application from a corresponding button, select “unassigned” from the applicable drop-down list. S To restore these buttons to their defaults, tap Defaults in the lower right corner. 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.
Appendix A — Configurable Settings 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 networks of two types: access point networks and peer-to-peer networks. S Access point networks get you onto your corporate network and the internet.
Appendix A — Configurable Settings S TKIP (Temporal Key Integrity Protocol) This protocol is part of the IEEE 802.11i encryption standard for wireless LANs., which provides per-packet key mixing, a message integrity check and a re-keying mechanism, thus fixing the flaws of WEP. This protocol provides stronger encryption than WEP, by dynamically updating the encryption keys every 10,000 packets.
Appendix A — Configurable Settings Configuring Your Wireless Network To start 802.11b communications on the 700 Series Computer, tap Start > Settings > the System 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.
Appendix A — Configurable Settings Basic Use the Basic page to set the network type, name, and manage battery power for this profile. Tap ok or OK to return to the Profiles page. S Profile Label: Enter a unique name for your profile. S Network type: Tap the drop-down list to select either “Infrastructure” if your network uses access points to provide connectivity to the corporate network or internet; or “Ad-Hoc” to set up a private network with one or more participants.
Appendix A — Configurable Settings Security The following are available from the 8021x Security drop-down list. Note that the last four methods are available if you have purchased the security package. Contact your Intermec representative for information.
Appendix A — Configurable Settings None Use “None” to disable 802.1x Security and enable either WEP or WPAPSK encryption. To Disable 802.1x Security 1 Set 8021x Security as “None.” 2 Set Association to “Open.” 3 Set Encryption to “None.
Appendix A — Configurable Settings To Enable WEP Encryption 1 Set 8021x Security as “None.” 2 Set Association to either “Open” if WEP keys are not required; or “Shared” when WEP keys are required for association. 3 Set Encryption to “WEP.” See page 386 for information about WEP encryption.
Appendix A — Configurable Settings To Enable WPA Encryption Using a Preshared Key 1 Set 8021x Security as “None.” 2 Set Association to “WPA.” See page 386 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 386 for more information about TKIP. 4 Enter the temporal key as ASCII (12345) in the Pre-Shared Key field.
Appendix A — Configurable Settings PEAP (Protected EAP) This protocol is suitable for performing secure authentication against Windows domains and directory services. It is comparable to EAP-TTLS (see page 401), both in its method of operation and its security, though not as flexible. This does not support the range of inside-the-tunnel authentication methods supported by EAP-TTLS. Microsoft and Cisco both support this protocol.
Appendix A — Configurable Settings To Enable PEAP with WPA Encryption 1 Set 8021x Security as “PEAP.” 2 Set Association to “WPA.” See page 386 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 386 for more information about TKIP. 4 Enter your unique user name and password to use this protocol.
Appendix A — Configurable Settings To Enable PEAP with Network EAP 1 Set 8021x Security as “PEAP.” 2 Set Association to “Network EAP.” See page 385 for information about EAP. 3 Set Encryption to either “WEP” or “CKIP.” See page 385 for information about CKIP and page 386 for information about WEP encryption. 4 Enter your unique user name and password to use this protocol.
Appendix A — Configurable Settings Additional Settings 1 Select an authentication method from the Inner PEAP Authentication drop-down list. EAP/MS-CHAP-V2 Authenticates against a Windows Domain Controller and other non-Windows user databases. This is Microsoft’s implementation of PEAP. EAP/Token Card Use with token cards. The password value entered is never cached. This is Cisco’s implementation of PEAP. EAP/MD5-Challenge Message Digest 5. A secure hashing authentication algorithm.
Appendix A — Configurable Settings TLS (EAP-TLS) EAP-TLS is a protocol that is based on the TLS (Transport Layer Security) protocol widely used to secure web sites. This requires both the user and authentication server have certificates for mutual authentication. While cryptically strong, this requires corporations that deploy this to maintain a certificate infrastructure for all their users.
Appendix A — Configurable Settings To Enable TLS with WPA Encryption 1 Set 8021x Security as “TLS.” 2 Set Association to “WPA.” See page 386 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.”See page 386 for more information about TKIP. 4 Enter your unique Subject Name and User Name as credentials for this profile. 5 Tap Get Certificates to obtain or import server certificates. See page 399 for more information.
Appendix A — Configurable Settings To Get Certificates Certificates are pieces of cryptographic data that guarantee a public key is associated with a private key. They contain a public key and the entity name that owns the key. Each certificate is issued by a certificate authority. Use this page to configure certificates assigned to the 802.1x TLS security method. 1 Tap the <<< button next to the Certificate Path field to browse for the applicable certificate file.
Appendix A — Configurable Settings Additional Settings 1 Check Validate Server Certificate to verify the identity of the authentication server based on its certificate when using TTLS, PEAP, and TLS. 2 Enter the Common Names of trusted servers. Note that if these fields are left blank, the server certificate trust validation is not performed or required. 3 Click ok to return to the Security page.
Appendix A — Configurable Settings 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 other credentials that are transported in a securely encrypted “tunnel” established using server certificates.
Appendix A — Configurable Settings To Enable TTLS with WPA Encryption 1 Set 8021x Security as “TTLS.” 2 Set Association to “WPA.” See page 386 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 386 for more information about TKIP. 4 Enter your unique user name and password to use this protocol.
Appendix A — Configurable Settings Additional Settings 1 Select an authentication protocol from the Inner TTLS Authentication drop-down list: PAP Password Authentication Protocol. A simple authentication protocol that sends security information in the clear. CHAP Challenge Handshake Authentication Protocol. Use of Radius to authenticate a terminal without sending security data in the clear. Authenticates against non-Windows user databases.
Appendix A — Configurable Settings LEAP (Cisco Lightweight EAP) LEAP is the Cisco Lightweight version of EAP. See page 385 for information about EAP. Use “LEAP” to configure the use of LEAP as an authentication protocol, select “Open,” “WPA,” or “Network EAP” as an association mode, or assign Network EAP. Note that this defaults to the Network EAP. To Enable LEAP with an Open Association 1 Set 8021x Security as “LEAP.” 2 Set Association to “Open.” 3 Skip Encryption as it is automatically set to “WEP.
Appendix A — Configurable Settings To Enable LEAP with WPA Encryption 1 Set 8021x Security as “LEAP.” 2 Set Association to “WPA.” See page 386 for information about WPA encryption. 3 Skip Encryption as it is automatically set to “TKIP.” See page 386 for more information about TKIP. 4 Enter your unique User Name to use this protocol.
Appendix A — Configurable Settings To Enable LEAP with Network EAP 1 Set 8021x Security as “LEAP.” 2 Set Association to “Network EAP,” an EAP protocol for the network. See page 385 for information about EAP. 3 Set Encryption to either “WEP” or “CKIP.” See page 385 for information about CKIP and page 386 for information about WEP encryption. 4 Enter your unique User Name to use this protocol.
Appendix A — Configurable Settings Advanced Use this page to configure additional settings for this profile. Tap ok or OK to return to the Profiles page. S Enable mixed cell: Mixed cell is a profile-dependent setting. If enabled, you can connect to mixed cell without using WEP, then you can query the cell to determine whether you can use encryption. S Enable Logging: Check this to log what activity incurs for this profile.
Appendix A — Configurable Settings Other Configurable Parameters The following parameters can be configured by sending reader commands through the network or from an application. See “Using Reader Commands” on page 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.
Appendix A — Configurable Settings Backlight Timeout Sets the length of time that the display backlight remains on. If you set a longer timeout value, you use the battery power at a faster rate. SNMP OID 1.3.6.1.4.1.1963.15.13.1.0 Options (Syntax Data for Reader Commands) 10 30 60 120 180 240 300 10 seconds 30 seconds 1 minute (default) 2 minutes 3 minutes 4 minutes 5 minutes Date/Time Sets the current date and time. SNMP OID Date: Time: 1.3.6.1.4.1.1963.15.501.2.1.0 1.3.6.1.4.1.1963.15.501.2.2.
Appendix A — Configurable Settings 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 perform a task, such as changing the time and date. Some reader commands temporarily override the configuration settings and some change the configuration settings. Change Configuration The Change Configuration command must precede any configuration command.
Appendix A — Configurable Settings 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.
Appendix A — Configurable Settings Configuration Bar Codes You can change some settings on your 700 Series Computer by scanning the following Code 39 bar code labels. S You can use the Data Collection control panel to set the three Virtual Wedge parameters (starting on page 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 automatically. Asterisks are included here for translation purposes.
Appendix A — Configurable Settings 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.
Appendix A — Configurable Settings Backlight Timeout 2 minutes *$+DF120* *$+DF120* Backlight Timeout 3 minutes *$+DF180* *$+DF180* Backlight Timeout 4 minutes *$+DF240* *$+DF240* Backlight Timeout 5 minutes *$+DF300* *$+DF300* Key Clicks Note: The Key Clicks parameter information is on page 409.
Appendix A — Configurable Settings Virtual Wedge Grid, Preamble, Postamble The following parameters are user-configurable strings. Refer to a full ASCII chart for more information. Grid For Virtual Wedge Grid, the first part of the bar code would be the following, which can include a string of up to 240 characters. Parameter information starts on page 360.
Appendix A — Configurable Settings 416 700 Series Color Mobile Computer User’s Manual
B Bar Code Symbologies This appendix contains a brief explanation of some of the bar code symbologies that the 700 Series Color Mobile Computer decodes and explains some of the general characteristics and uses of these bar code types. The 700 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 flexibility for a particular inventory tracking system.
Appendix B — Bar Code Symbologies Codabar Codabar was for retail price-labeling systems. Today it is widely accepted by libraries, medical industries, and photo finishing services. Codabar is a discrete, self-checking code with each character represented by a stand-alone group of four bars and three intervening spaces. Four different start or stop characters get defined and designated “a”, “b”, “c”, and “d”. These start and stop characters are constructed using one wide bar and two wide spaces.
Appendix B — Bar Code Symbologies When programming the computer for Code 39, it is important to set the symbology limit as close as possible (minimum and maximum bar code lengths being scanned). Doing so keeps the computer bar code processing time to a minimum and conserves battery power. Bar code readers can respond to Uniform Symbology Specification symbols in non-standard ways for particular applications. These methods are not for general applications, because of the extra programming required.
Appendix B — Bar Code Symbologies Code 128 Code 128 (C128) is one of the newest symbologies used by the retail and manufacturing industries. It responds to the need for a compact alphanumeric bar code symbol that could encode complex product identification. The fundamental requirement called for a symbology capable of being printed by existing data processing printers (primarily dot-matrix printers) that produce daily, work-in-progress, job, and product traceability documents.
Appendix B — Bar Code Symbologies This implementation should provide for clean application coding by identifying the same sequences for the same scanned codes. If the communication of Norand bar code types is enabled, the Shipping Container Label codes precede with a “J”. These strings will appear on the computer display. The application may have to allow for strings longer than 48 characters (maximum length indicated in the specification).
Appendix B — Bar Code Symbologies I 2 of 5 (Interleaved) I 2 of 5 (Interleaved 2 of 5 Code) is an all-numeric symbology, widely used for warehouse and heavy industrial applications. Its use has been particularly prevalent in the automobile industry. The I 2 of 5 symbology can be placed on smaller labels than what the standard UPC symbology requires. I 2 of 5 also provides a little more flexibility on the type of material it can print on.
Appendix B — Bar Code Symbologies of data into several PDF417 symbols which are logically linked. There is no theoretical limit on the amount of data that can store in a group of PDF417 symbols. The capacity of PDF417 can be helpful in applications where the data must travel with the labeled item, where a host database is not always available for quick look-up.
Appendix B — Bar Code Symbologies MSI Code (Variant of Plessey) The MSI Plessey bar code is a variant of the Plessey bar code. It is a pulsewidth modulated non-self checking code, and is used primarily in store shelf labeling. Each character consists of eight elements, four bars and four spaces. The character set includes the digits 0 through 9. A Modulo 10 checksum is appended to the end of the code.
Appendix B — Bar Code Symbologies Telepen Telepen was devised by George Sims, Managing Director of SB Electronic Systems Limited, in early 1972, this is the only symbology to directly represent the full ASCII character set without shift characters.Telepen carries the double-density numeric-only mode and is very compact. The Telepen symbol is up to 8 ASCII characters or16 digit per inch, and is easy to print. It has a fixed 3:1 ratio, with a tolerance at least 0.4x.
Appendix B — Bar Code Symbologies 426 700 Series Color Mobile Computer User’s Manual
I Index The Classes and Functions Index covers classes and functions for the 700 Series Color Mobile Computer. The General Index covers all topics. Those in italics are figures, those in bold are tables. The Files Index is to assist you in locating descriptions for device drivers, applications, utilities, batch files, or other files within this publication.
Index 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
Index 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.
Index General Index Numbers 1470 Imager.
Index Antenna, radio type, 127 APIs 802.
Index 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 informat
Index 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.
Index 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 opti
Index 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 ima
Index 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.
Index 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 I 2 of 5.
Index 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 fol
Index 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_ED
Index 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 o
Index 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 M
Index 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 SetNetworkMo
Index 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_DEV
Index 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 configurati
Index 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 bac
Index 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,
Index TLS 802.
Index 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,
Index 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.
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.
