8/6/2019 Configuracion de Barras Del Escaner
1/19
IBM Anyplace KioskOmni Scanner Configuration Guide
Version: 3.9July 24, 2006
TERMS & CONDITIONS:AS A PRECONDITION TO DOWNLOADING AND USE OF THE FOLLOWING DOCUMENTATION, PROGRAM CODE, SAMPLES,UPDATES, AND FIXES ("CODE"), YOU MUST AGREE THAT (1) THE CODE IS SUBJECT TO THE TERMS OF THE LICENSEAGREEMENT WHICH ACCOMPANIED, OR IS CONTAINED IN, THE PROGRAM FOR WHICH YOU ARE OBTAINING THE CODE AND (2)YOU READ AND ACCEPTED THOSE TERMS WHEN YOU OBTAINED THE PROGRAM. YOU ARE NOT AUTHORIZED TO INSTALL ORUSE THE CODE, EXCEPT AS PART OF A PROGRAM FOR WHICH YOU HAVE A VALID PROOF OF ENTITLEMENT. SUBJECT TO ANYSTATUTORY WARRANTIES THAT CANNOT BY LAW BE EXCLUDED, IBM MAKES NO WARRANTIES OR CONDITIONS EITHEREXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT, REGARDING THE CODE OR TECHNICAL SUPPORT PROVIDEDIN CONNECTION WITH THE CODE, IF ANY.
8/6/2019 Configuracion de Barras Del Escaner
2/19
Table of Contents
Section 1 Document Objectives..............................................................................................................................................3
Section 2 Scanner Introduction .............................................................................................................................................4Three Scan Pattern Options.....................................................................................................................................................5Installing the Scanner & MSR Drivers................................................................................................................................6Default Scanner Configuration Settings..................................................................................................................................7
Section 3 Using IBM UPOS Package ....................................................................................................................................9Scanner Initialization ..............................................................................................................................................................9Testing Basic Functionality ....................................................................................................................................................9UPOS Installation Procedure ................................................................................................................................................10Customizing the JPOS.XML.................................................................................................................................................12
Section 4 Using Direct Communication via COM Port .....................................................................................................14Scanner Initialization ............................................................................................................................................................14Testing Basic Functionality ..................................................................................................................................................14Available Programming References .....................................................................................................................................14
Section 5 Keyboard Wedge Mode .......................................................................................................................................15Scanner Initialization & Testing ...........................................................................................................................................15Enabling Serial Keys.............................................................................................................................................................15Disabling Serial Keys............................................................................................................................................................15
Section 6 Frequently Asked Questions................................................................................................................................16Does the scanner support 2D / PDF / RSS barcode formats? .............................................................................................................................16 The system and/or application are not recognizing the Omni scanner. ................................................................................................................16 How do I know that the hardware and drivers are working properly? .................................................................................................................16 How can the scanner send data to a web based application? ..............................................................................................................................16 What support is provided under Linux for this scanner?....................................................................................................................................16 Where can I find additional programming information and supported parameter barcodes for this scanner? ..........................................................16
Section 7 Troubleshooting & Support Options ..................................................................................................................17
Appendix A: Parameter Barcodes.........................................................................................................................................18
8/6/2019 Configuracion de Barras Del Escaner
3/19
Section 1 Document ObjectivesThis document describes how to configure the IBM Anyplace Kiosk (4836, 4838) integrated omni scanner through various
methods.
The following communication methods will be discussed:
IBM Unified Point Of Sale (UPOS) (v1.90 or higher required)
Direct serial communication Keyboard Wedge
8/6/2019 Configuracion de Barras Del Escaner
4/19
Section 2 Scanner IntroductionThe Omni Scanner is an RS232 device which uses a USB to Serial virtual COM port architecture. The scanner can be
accessed through a standard RS-232 COM port. The default COM port used for the scanner is COM4. This is accomplished
through a device installed on the scanner working in conjunction with the Scanner & MSR Drivers which must be installed
in order to communicate with the scanner using any of the method described in this document.
Since the scanner is on a standard RS-232 COM device in Windows, standard RS-232 communication functions can be usedto configure and read data from the scanner.
This scanner is optimized for aggressive reading on 1-D symbols, and also features a Smart Raster scan pattern for 2-D
symbols including PDF417.
For reference purposes only, the engine used in the Omni Scanner is the Symbol SE3223. Additional information is available
from Symbol (http://www.symbol.com). Symbol does not provide any support for, nor warrant in any way, the Omni
Scanner.
http://www.symbol.com/http://www.symbol.com/8/6/2019 Configuracion de Barras Del Escaner
5/19
Three Scan Pattern OptionsThe Integrated Omni Scanner has the capability of 3 different scan patterns 1-D linear, 2-D raster, and omni-
directional "Cyclone". This allows you to select the best scan pattern for your particular application.
Scan Pattern Definitions
Omnidirectional Scan Pattern
The scan pattern is a high speed rotatingomnidirectional scan pattern that provides very
aggressive performance on 1-D bar codes because
there are virtually no "holes" in the pattern. This
ensures fast throughput at the point of activity and
the ability to read 1-D symbols in 360 of rotation,
eliminating the need to orient the bar code in the
field of View.
Smart Raster Scan PatternCreates a single line which opens vertically to read
PDF417 symbols using the Smart raster feature.
This feature auto detects the type of bar code being
scanned and adjusts its pattern accordingly. This
provides optimal performance on 1-D, PDF417,RSS, and Composite codes.
Always Raster PatternCreates an adjustable raster pattern of a
programmed height. This pattern is best for PDF417
environments.
Typical Barcode Types
1DUPC-A
Omnidirectional Scan Pattern
1D
Code 39Omnidirectional Scan Pattern
2DPDF-417
Smart Raster Scan Pattern
or Always Raster Pattern
8/6/2019 Configuracion de Barras Del Escaner
6/19
Installing the Scanner & MSR DriversThe installation process will prompt you with a message regarding Digital Signatures, for each of these messages,
simply click YES. During the installation, the following messages should appear:
When the Scanner & MSR Drivers are properly installed, you should see the following items in Device Manager:
8/6/2019 Configuracion de Barras Del Escaner
7/19
Default Scanner Configuration SettingsListed below are the default settings for the scanner. These settings are the same on a new system, and after
scanning the Reset Factory Defaults parameter barcode.
ParameterParameter
NumberDefault
Operating ModesBeeper Volume 8Ch High Volume
Beeper Tone 91h High Frequency
Laser On Time 88h 5.0 sec
Trigger Mode 8Ah Level
Scanning Mode 8Dh Smart Raster
Aiming Mode F0h 7Eh Disabled
Beep After Good Decode 38h Enable
Transmit .No Read. Message 5Eh Disable
Parameter Scanning ECh Enable
Bi-directional Redundancy 43h Disable
Supported SymbologiesUPC-A 01h Enable
UPC-E 02h Enable
UPC-E1 0Ch Disable
EAN-8 04h EnableEAN-13 03h Enable
Bookland EAN 53h Disable
UPC/EAN Coupon Code 55h Disable
Decode UPC/EAN Supplementals 10h Ignore
Transmit UPC-A Check Digit 28h Enable
Transmit UPC-E Check Digit 29h Enable
Transmit UPC-E1 Check Digit 2Ah Enable
UPC-A Preamble 22h System Character
UPC-E Preamble 23h System Character
UPC-E1 Preamble 24h System Character
Convert UPC-E to A 25h Disable
Convert UPC-E1 to A 26h Disable
EAN-8 Zero Extend 27h Disable
Linear UPC/EAN Decode 44h Disable
Code 128 08h Enable
UCC/EAN-128 0Eh Enable
Code 39 00h Enable
Trioptic Code 39 0Dh Disable
Transmit Code 39 Check Digit 2Bh Disable
Code 93 09h Disable
Code 11 0Ah Disable
Interleaved 2 of 5 06h Disable
Discrete 2 of 5 05h Disable
Codabar 07h Disable
MSI Plessey 0Bh Disable
PDF417 0Fh Disable
MicroPDF417 E3h Disable
MicroPDF Performance F0h 65h Standard
Code 128 Emulation 7Bh Disable
RSS-14 F0h 52h Disable
RSS-Limited F0h 53h DisableRSS-Expanded F0h 54h Disable
8/6/2019 Configuracion de Barras Del Escaner
8/19
Communication Settings
Scan Data Transmission Format EBh Data as is
Baud Rate 9Ch 9600
Parity 9Eh None
Check Parity 97h Enable
Software Handshaking 9Fh ACK/NAK
Host RTS Line State 9Ah Low
Decode Data Packet Format EEh Unpacketed
Stop Bit Select 9Dh 1
Intercharacter Delay 6Eh 0
NOTE: Host RTS Line State must be changed to HIGH for certain applications, as directed in the steps below. Do not set RTS
Line State to HIGH unless directed to do so in this document. The parameter barcode to make this change is included in Appendix A.
8/6/2019 Configuracion de Barras Del Escaner
9/19
Section 3 Using IBM UPOS PackageThis section describes the steps necessary to properly configure the scanner, install the IBM Unified Point of Sale (UPOS)
driver package, and test for proper functionality. For more information on POS Driver standards visit the Monroe
Consulting Services website at http://www.monroecs.com/posstandards.htm.
NOTE: IBM UPOS v1.90 or higher is required to support the OMNI Scanner.
Scanner InitializationYou must first enable the scanner for serial based communications. To do so, scan all of the BASE barcodes and
the RTS Line State = LOW barcode provided in Appendix A.
Additional parameters will be configured as needed automatically by the UPOS installation package.
Any specific configuration changes which your application requires can be setup within the JPOS.XML file(see below).
Testing Basic FunctionalityBefore proceeding, we recommend that you first test the scanner to ensure that the hardware and drivers are working
properly. The simplest test for this is to use HyperTerminal to display the scanned data upon reading a barcode.
1. Ensure that the Scanner and MSR Drivers are properly installed. Refer to the Scanner Introduction
section above.2. Initialize the scanner using the steps above.3. Launch HyperTerminal and create a new connection using COM4. Configure this connection to use 9600,
8, N, 1, XON/XOFF.
4. When you scan a bar code the scanner should beep for a good decode and the data should appear in theterminal window. Note that unless you configure the scanner otherwise, with additional Parameter
Barcodes, the scanner will transmit all digits scanned including any prefixes and/or check digits. A full
listing of the parameter barcodes is available in the Integration Reference Guide.
http://www.monroecs.com/posstandards.htmhttp://www.monroecs.com/posstandards.htm8/6/2019 Configuracion de Barras Del Escaner
10/19
UPOS Installation ProcedureThe steps listed below are a brief overview of the procedures to setup basic OPOS and/or JavaPOS support. Please
refer to the UPOS Users Guide for detailed installation and usage instructions. The latest publications are available
on our IBM Retail Store Solutions Support site at:
http://www-1.ibm.com/support/search.wss?rs=219&q=PUBUPOS
Current Package LevelsAs of the date on this document, the current releases of the packages required for this installation are:
IBM UPOS Package v1.90 (or higher)
OPOS Common Controls v1.9.000 (or higher)
The current level of UPOS is based on the Point of Sale device standards available from the Monroe
Consulting Services (MCS) website (http://www.monroecs.com/unifiedpos.htm). Additional information
and downloads are available directly from this site.
1. If you already have the OPOS Common Controls version 1.9.000 or higher installed, continue tothe next step. Otherwise, remove any previous versions then download and install the latest OPOS
Common Controls (CCOs) from the MCS website
(http://www.monroecs.com/oposccos_current.htm). The CCOs are packaged in both ZIP and
WISE install versions. We recommend that you use the WISE install method.
2. Download and install the latest IBM UPOS Package from the IBM Support websitehttp://www.ibm.com/solutions/retail/store/support/html/driverss.html.
3. The IBM UPOS package supports communication with the Line Scanner, Omni Scanner, MSRand Presence Sensor. Install the UPOS package following the steps provided in the UPOS
documentation.
NOTE: It is critical that you select the proper options on the Custom Install panel (see
below).
You must first select either JavaPOS or OPOS support.
Then select Anyplace Kiosk 4836/4838.
Finally, you must install the Java JRE/JCOMM components. These components areincluded in the installation package, but will not be installed unless you check this
box. JavaPOS and OPOS will not function if a JRE/JCOMM has not been installed.
4. Installation of the IBM UPOS package also requires the Microsoft .NET Framework. TheMicrosoft .NET Framework installation source is not included with the UPOS distribution files.
This can be downloaded directly from the Microsoft website.
http://www-1.ibm.com/support/search.wss?rs=219&q=PUBUPOShttp://www.monroecs.com/unifiedpos.htmhttp://www.monroecs.com/oposccos_current.htmhttp://www.ibm.com/solutions/retail/store/support/html/driverss.htmlhttp://www.ibm.com/solutions/retail/store/support/html/driverss.htmlhttp://www.monroecs.com/oposccos_current.htmhttp://www.monroecs.com/unifiedpos.htmhttp://www-1.ibm.com/support/search.wss?rs=219&q=PUBUPOS8/6/2019 Configuracion de Barras Del Escaner
11/19
5. After installation of the Microsoft .NET Framework, the system will no longer be configured toautomatically logon. If you are using this feature, and would like to re-enable it, use the following
procedure:
Run the following command:CONTROL USERPASSWORDS2
Select the user you want to logon automatically
Uncheck Users must enter a Username and password.
Click OK
Enter the password (blank for none) Click OK
6. Run the OPOS Configuration Utility to configure the peripheral(s) you are using.7. Click on XML File Location Output Location.
8. Browse to and select c:\pos\ibmjpos\jpos.xml.
9. Click Save
10. Select the SurePOS 300/500/600, Kiosk tab11. Locate the device you wish to configure in the list. You may need to expand the Description
column to see the full description.
12. Each device to be used must be configured. Only use/configure those devices which indicate inthe description that they are specifically for the IBM Anyplace, 4836 or 4838 systems.
8/6/2019 Configuracion de Barras Del Escaner
12/19
13. The recommended device configurations are shown below:
NOTE: Device Name can be any value you select, however it MUST match exactly with the
Device Name used in your application. It is case sensitive as well.
14. Once the packages have been installed and the devices configured, you can test the installationsimply using our online OPOS Checkup. This is a set of online tests which use standard HTML,
VBScript and JavaScript to communicate with the devices, using UPOS calls. In addition to being
a very good test resource, the source code from these tests can assist you with understanding the
basic methods of using OPOS from web applications. The OPOS Checkup is available at
http://www.ibm.com/solutions/retail/store/support/html/oposcheckup.html
Customizing the JPOS.XMLAdditional scanner configuration settings can be made by manually editing the jpos.xml file and inserting the
required values.
"Scanner Parameter Barcodes Enabled"
This setting is recommended for diagnostic purposes only. When used on a deployed Kiosk, we
recommend that these values be set to "false".
With these set to "true", the Parameter barcodes (i.e. "Set all Defaults") will be permitted tomodify the operating of the scanner directly.
With these set to "false", the scanner will ignore any Parameter barcodes. If configuration
changes are required, they can be made using the JPOS.XML.
For example:
For more information on these and other properties available under UPOS refer to the UPOS publications on our
support site.
http://www.ibm.com/solutions/retail/store/support/html/oposcheckup.htmlhttp://www.ibm.com/solutions/retail/store/support/html/oposcheckup.html8/6/2019 Configuracion de Barras Del Escaner
13/19
Below is an example JPOS.XML file, based on default provided with the UPOS installation.
8/6/2019 Configuracion de Barras Del Escaner
14/19
Section 4 Using Direct Communication via COM PortThis section describes the steps necessary to properly configure the scanner for direct communication via the COM Port
(COM4), and test for proper functionality.
Scanner InitializationTo communicate with the scanner directly via the COM port, you must first enable the scanner for this method. To
do so, scan all of the BASE barcodes, and the RTS Line State = High barcode provided in Appendix A.
Testing Basic FunctionalityBefore proceeding to coding your application, we recommend that you first test the scanner to ensure that the
hardware and drivers are working properly. The simplest test for this is to use HyperTerminal to display the
scanned data upon reading a barcode.
1. Ensure that the Scanner and MSR Drivers are properly installed. Refer to the Scanner Introduction
section above.
2. Initialize the scanner using the steps above.
3. Launch HyperTerminal and create a new connection using COM4. Configure this connection to use 9600,
8, N, 1, XON/XOFF.
4. When you scan a bar code the scanner should beep for a good decode and the data should appear in theterminal window. Note that unless you configure the scanner otherwise, with additional Parameter
Barcodes, the scanner will transmit all digits scanned including any prefixes and/or check digits. A full
listing of the parameter barcodes are available in the Integration Reference Guide
Available Programming ReferencesThe Symbol Simple Serial Interface (SSI) protocol is used for communication with the Scanner. The SSI interface
uses nonstandard handshaking that requires that RTS be inactive before the scanner will send data. The SSI
Software Development Kit (SDK) for this protocol can be downloaded from the Symbol web site
(www.symbol.com). The development kit is owned, licensed and supported by Symbol Technologies.
http://www.symbol.com/http://www.symbol.com/8/6/2019 Configuracion de Barras Del Escaner
15/19
Section 5 Keyboard Wedge ModeThe IBM Anyplace Kiosk scanner(s) are not designed to operate as a keyboard wedge device. However, there are some third
party applications which allow you to configure serial devices to send data through the keyboard buffer.
Microsoft Windows XP has a built in feature called Serial Keys which is one such application.
Microsoft Windows Embedded for Point of Service (WEPOS) does not include this feature.
Use of third party applications, including Serial Keys is not supported by IBM Retail Store Solutions. The information
below is provided for reference only.
Scanner Initialization & TestingConfigure and test the scanner for Direct I/O use following the steps provided in Section 4 above.
Enabling Serial KeysThe Serial Keys feature is configurable through Accessibility Options in Control Panel.
Ensure that the Use Serial Keys checkbox is checked and that the correct COM port is selected by clicking the
Settings button. To save the settings between reboots, check both checkboxes under Administrative Options.
Disabling Serial KeysWhen disabling the Serial Keys functionality, removing the check for Use Serial Keys under Accessibility
Options is not sufficient. Even when this check is removed, the Serial Keys service (SKEYS.EXE) will still be
running and will interfere with other applications ability to access the COM port configured in Serial KeysSettings.
If not using the Serial Keys feature, we recommend that you set the Serial Keys service to Disabled under
Windows Services. This service will not be listed under Windows Services until it has been configured and enabled
the first time. One enabled, the Service is persistent.
NOTE: The Serial Keys feature will only monitor a single COM port. If multiple COM ports are required, there
are many third party solutions available (not supported).
8/6/2019 Configuracion de Barras Del Escaner
16/19
Section 6 Frequently Asked QuestionsThe list below includes some of the most frequently asked questions regarding the use of the scanner. Additional
information is available on our IBM Retail Store Solutions Knowledge Base, online at
(http://www.ibm.com/solutions/retail/store/support).
Does the scanner support 2D / PDF / RSS barcode formats?
This scanner is optimized for aggressive reading on 1-D symbols, and also features a Smart Raster scanpattern for 2-D symbols including PDF417.
The system and/or application are not recognizing the Omni scanner.
The Anyplace Kiosk must be using the latest level of Scanner & MSR Drivers. Please ensure you are
using v1.2.11.04 or higher to support either the Linear or Omni scanners.
Ensure that the scanner is connected securely. The scanner should automatically power on when the
system is turned on.
How do I know that the hardware and drivers are working properly?
Please refer to the Scanner Introduction section in this document.
How can the scanner send data to a web based application?
This depends primarily on the application. Any of the communication methods discussed in this documentcould be used to send data to a web application.
What support is provided under Linux for this scanner?
The Anyplace Kiosk supports the IBM Retail Environment for SuSE Linux (IRES). Support for theIntegrated Omni Scanner under IRES will be available at a later date.
Where can I find additional programming information and supported parameter barcodes for this scanner?
The Omni scanner is uses the Symbol SE-3223 OEM scan engine. Additional information for this scannercan be found on the Symbol website. Parameter barcodes can be found in the Integration Reference Guide
for the MiniScan MS-XX04. (The MS-XX04 uses the same SE-3223 scan engine)
http://www.ibm.com/solutions/retail/store/supporthttp://www.symbol.com/assets/files/6713402a.pdfhttp://www.symbol.com/assets/files/6713402a.pdfhttp://www.ibm.com/solutions/retail/store/support8/6/2019 Configuracion de Barras Del Escaner
17/19
Section 7 Troubleshooting & Support OptionsIn addition to the information provided in this documentation, we also have drivers, utilities, etc available on our support site.
If you would like to contact us for assistance, or need additional information, please refer to our online support page at:
http://www.ibm.com/solutions/retail/store/support
http://www.ibm.com/solutions/retail/store/supporthttp://www.ibm.com/solutions/retail/store/support8/6/2019 Configuracion de Barras Del Escaner
18/19
Appendix A: Parameter BarcodesBelow are the most commonly used parameter barcodes (BASE Barcodes) as well as those barcodes (RTS Line State
Barcodes) required for special communication methods as described earlier in this document.
BASE Barcodes
8/6/2019 Configuracion de Barras Del Escaner
19/19
RTS Line State Barcodes