IBM 4800-C41, 4694-207, 4694-247, 4694-307, 4694-347 Configuration Manual

PointOfSale



Linux Operating Systems Configuration
Guid e

G362-0570-00

PointOfSale



Linux Operating Systems Configuration
Guid e

G362-0570-00

Note

Before using this information and the product it supports, be sure to read the general information under Appendix A,
“Safety information,” on page 19 and Appendix B, “Notices,” on page 25.

July 2009

This edition applies to SUSE Linux Enterprise 11 and to all subsequent releases and modifications until otherwise
indicated in new editions. IBM support for SUSE Linux Enterprise Point of Sale 11 is provided under product
number 5799-HRL.

Current versions of Retail Store Solutions documentation are available on the IBM Retail Store Solutions Web site at
http://www.ibm.com/solutions/retail/store/support. Click Publications.

A form for reader’s comments is also provided at the back of this publication. If the form has been removed,
address your comments to:

IBM Corporation
Retail Store Solutions Information Development
Department ZBDA
PO Box 12195
Research Triangle Park, North Carolina 27709 USA

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute whatever information
you supply in any way it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 2009.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents

About this guide ...........v

Publications accessibility ..........v

Who should use this guide .........v

How this guide is organized .........v

Where to find more information ........v

Publications .............v

Downloads .............vi

Notice statements ............vi

Providing feedback ............vi

Chapter 1. Common configuration

procedures .............1

RS-232 serial port configuration ........1

SLED 11 and SLES 11 installation procedures . . 1

SLEPOS 11 installation procedures ......2

RS-485 touch screen configuration .......2

Serial touch screen calibration ........3

IBM 4820-2xx/4xx/5xx SurePoint Solution serial

touch screen coordinates .........4

Providing serial touch screen coordinates in

xorg.conf ..............5

Tone support for Elo touch screens ......5

FBdev driver configuration .........6

VIA display driver installation and configuration . . 6
MSR, Intermac scanner, and Omni scanner

configuration ..............7

JavaPOS packages installation ........8

RMA packages installation..........9

Chapter 2. SUSE Linux Enterprise

Desktop 11 procedures........11

IBM 4694-207/247/307/347 .........11

IBM AnyPlace Kiosk 4836/4838........11

IBM SurePOS 100 4613-1x8 .........11

IBM SurePOS 300 4810-32x/33x/34x ......12

IBM SurePOS 500 4840 ..........13

IBM SurePOS 500 4846-5xx .........13

IBM SurePOS 500 4851/4951-514 .......13

IBM SurePOS 700 4800-7x1 .........13

IBM SurePOS 700 4800-7x2 .........14

IBM SurePOS 700 4800-7x3 .........14

Chapter 3. SUSE Linux Enterprise Point

of Service 11 procedures .......15

Hardware requirements ..........15

SLEPOS Admin, Image, and Branch Servers . . 15

SLEPOS client terminals .........16

POSBranch Server configuration .......16

POS client image creation..........16

Video and serial touch screen configuration . . . 17
Additional package and application installation . . 17

Appendix A. Safety information ....19

Appendix B. Notices .........25

Appendix C. Trademarks .......27

Index ...............29

© Copyright IBM Corp. 2009 iii

iv Linux OS Configuration

About this guide

This guide provides necessary information to configure the Linux®operating system (OS) environments
on supported IBM®Point of Sale hardware devices. It includes procedures to configure these system units
and displays, along with associated input devices:

v IBM 4694-207/247/307/347

™

v IBM 4820-1xx/2xx/4xx/5xx SurePoint

TM

v IBM AnyPlace

v IBM SurePOS

v IBM SurePOS 300 4810-32x/33x/34x

v IBM SurePOS 500 4846-5xx, 4851/4951

v IBM SurePOS 700 4800-72x/74x/78x

Kiosk 4836 and 4838-x3x/3xx/5xx/7xx/9xx

™

100 4613-1x8

Publications accessibility

The softcopy version of this guide and other related publications are accessibility enabled.

Who should use this guide

This guide is intended for systems integrators or administrators who are responsible for installing and
configuring supported Linux operating systems on IBM Point of Sale hardware devices. It is not intended
to provide general or comprehensive configuration information for the OSs that are covered in this guide.

Solution

How this guide is organized

This guide contains these chapters:

v Chapter 1, “Common configuration procedures,” on page 1, which presents configuration procedures

that are common to all Linux environments, for supported IBM Point of Sale hardware devices. If
applicable, perform these procedures before proceeding to the OS-specific parts of this guide.

v Chapter 2, “SUSE Linux Enterprise Desktop 11 procedures,” on page 11, which presents configuration

procedures that are specific to the SUSE Linux Enterprise Desktop 11 (SLED 11) operating system, for
specific IBM Point of Sale hardware devices.

v Chapter 3, “SUSE Linux Enterprise Point of Service 11 procedures,” on page 15, which presents

configuration procedures that are specific to the SUSE Linux Enterprise Point of Service 11 (SLEPOS 11)
operating system, for supported IBM Point of Sale hardware devices.

In addition, there are Appendices that address safety, legal, and trademark information.

Where to find more information

Publications

Familiarity with these publications is assumed before you proceed with the configuration procedures in
this guide:

v IBM Remote Management Agent User’s Guide, GC30-4106

v IBM Point of Sale Subsystem UnifiedPOS User’s Guide, Keyboards, and Code Pages, GC30-4078

v Java for Retail POS Programming Guide

© Copyright IBM Corp. 2009 v

Downloads

The following drivers and utilities might be required for your configuration, depending upon your
hardware:

v posIBM_setseriel: http://www.ibm.com/support/docview.wss?uid=pos1R4000245

v Sensor driver: http://www.ibm.com/support/docview.wss?rs=219&uid=pos1R4000167

v Elotone support: http://www.ibm.com/support/docview.wss?uid=pos1R4000246

Notice statements

Notices in this guide are defined as follows:

Notes These notices provide important tips, guidance, or advice.

Important These notices provide information or advice that might help you avoid inconvenient or

problem situations.

Attention These notices indicate potential damage to programs, devices, or data. An attention notice

is placed just before the instruction or situation in which damage could occur.

Caution These statements indicate situations that can be potentially hazardous to you. A caution

statement is placed just before the description of a potentially hazardous procedure step
or situation.

Danger These statements indicate situations that can be potentially lethal or extremely hazardous

to you. A danger statement is placed just before the description of a potentially lethal or
extremely hazardous procedure step or situation.

Providing feedback

Your feedback is important in helping IBM provide accurate and high-quality information.

To provide feedback:

v Go to http://www.ibm.com/solutions/retail/store. Click Support, then click Publications. Click the

publication comments within the introductory text. Provide the requested information and your

comments. Be sure to include the name and form number of the document in the [Publication ID] field.

v You can mail your comments to:

IBM Corporation Retail Store Solutions
Information Development Department ZBDA
P.O. Box 12195 Research Triangle Park,
North Carolina 27709 USA

Be sure to include the name and form number of the document.

If applicable, include a reference to the specific location of the text (for example, the page or table
number) on which you are commenting.

Between major revisions of this document, there might be minor technical updates. The latest version of
this document is available on the Retail Store Solutions Web site at www.ibm.com/solutions/retail/store/
support/publications/.

vi Linux OS Configuration

Chapter 1. Common configuration procedures

This chapter presents configuration procedures that are common to all supported Linux operating
systems, for the indicated IBM Point of Sale hardware devices.

RS-232 serial port configuration

You can automatically configure the RS-232 ports on a system using the posIBM_setserial utility. On
supported systems, the configuration matches port (tty) assignments to the labeled alphabetical order.
You can download the utility at http://www.ibm.com/support/docview.wss?uid=pos1R4000245.

The posIBM_setserial utility only supports these IBM POS and AnyPlace Kiosk systems certified for SLES
11, SLED 11, and SLEPOS 11:

v IBM 4694-207/247/307/347

v IBM AnyPlace Kiosk 4836-132(12")/135(15")/13V(volume control)

v IBM AnyPlace Kiosk 4838-xxx/132 (12")/135 (15")/13V (volume control)/137/1Z7 (E37/EZ7

preload)/3yz (y=1 [depot] or 3 [onsite], z=0 [no preload] or E [preload])

v IBM SurePOS 100 4613-108(mono)/118 (color)

v IBM SurePOS 300 4810-32H/33H/340 (E40 preload)

v IBM SurePOS 300 4910-E4D/E4F/E4S/E4T

v IBM SurePOS 500 4840-563/573

v IBM SurePOS 500 4846-565/545 (E65/E45 preload)

v IBM SurePOS 500 4851-514

v IBM SurePOS 500 4951-514 (Express)

v IBM SurePOS 700 4800-721/722/723/741/742/743/781/782/783/C41/C42/C43

SLED 11 and SLES 11 installation procedures

The posIBM_setserial utility comes in an RPM Package Manager (RPM) package and follows the normal
RPM installation procedure:

1. Download the package from the IBM support site.

2. Copy the package to the system onto which you want to install it.

3. On the command line, enter the following command:

rpm –ivh posIBM_setserial.xxx.rpm

Where xxx is the release number of the RPM package.

4. Reboot the system. The package will run the posIBM_setserial service.

© Copyright IBM Corp. 2009 1

SLEPOS 11 installation procedures

To use the posIBM_setserial utility in SLEPOS, you can use the normal installation procedure for SLED or
SLES, but you can also include it in your image creation so that an image loaded through SLEPOS
Branch server to the terminal automatically runs the posIBM_setserial utility.

To integrate the package into the image:

1. Start and run the YaST2 Image Creator provided with SLEPOS. Refer to the SLEPOS 11 guide at

http://www.novell.com/documentation/slepos11/ for more information.

2. From the Image Creator Configuration Overview, edit the image in which you want to include the

rpm package:

a. From the Image Preparation, select Add and Local Directory.

b. In Path to Directory section, browse to the directory in which the RPM is located.

c. Click Add to return to the image configuration screen.

d. Click Change to make changes to the image.
e. Select Filter > Search and look for posIBM_setserial.

f. Check the box so that the package is included in the SLEPOS image.

3. Click Yes to save the image configuration and start building the image. Refer to the SLEPOS 11 guide

at http://www.novell.com/documentation/slepos11/ for information about image deployment.

RS-485 touch screen configuration

To configure an RS-485-attached touch screen:

1. Install the latest JavaPOS package.

2. Edit the /etc/aipsys.conf file to remove the ! under the # RS-485 Touch Emulation line:

# RS-485 Touch Emulation. To enable, remove the "!" and set to "on".
# Valid values are "on" and "off"
mouse=on

3. Reboot the system with the RS-485 touch screen attached. You should see these lines in the

/etc/X11/xorg.conf file:

[...]

Section "InputDevice"
Driver "evdev"
Identifier "Touchscreen"
Option "evBits" "+1 +3"
Option "keyBits" "-272-274 +330"
Option "absBits" "+0-1"
Option "Pass" "3"
EndSection

[...]

Section "ServerLayout"
[...]
InputDevice "Touchscreen" "SendCoreEvents"
[...]
EndSection

2 Linux OS Configuration

Serial touch screen calibration

This chapter provides the procedures for configuring the serial touch screen installed in these IBM Point
of Sale hardware devices:

v IBM 4694-207/247/307/247 with serial-attached IBM 4820-2xx/4xx/5xx SurePoint Solution

v IBM AnyPlace Kiosk 4836 and 4838-x3x/3xx/5xx/7xx/9xx

v IBM SurePOS 300 4810-32x/33x/34x with serial-attached IBM 4820-2xx/4xx/5xx SurePoint Solution

v IBM SurePOS 500 4840, 4851/4951 with serial-attached IBM 4820-2xx/4xx/5xx SurePoint Solution

v IBM SurePOS 500 4846-5xx

v IBM SurePOS 700 4800-72x/74x/78x with serial-attached IBM 4820-2xx/4xx/5xx SurePoint Solution

To calibrate a serial touch screen, you must provide the serial touch screen’s minimum and maximum X
and Y coordinates to X Window System.

The following variables are used in the procedure in this section, and they vary based on individual
system:

Table 1. Serial touch screen calibration variable values based on system

System
(screen size)

IBM
4694-207/247/
307/347

IBM AnyPlace
Kiosk
4836/4838-132
(12")

IBM AnyPlace
Kiosk
4836/4838-135
(15")

IBM AnyPlace
Kiosk
4836/4838-137
(17")

IBM AnyPlace
Kiosk 4838-3xx
(15")

IBM AnyPlace
Kiosk 4838-5xx
(15")

IBM AnyPlace
Kiosk 4838-7xx
(17")

IBM AnyPlace
Kiosk 4838-9xx
(19")

IBM SurePOS
300 4810-32x

IBM SurePOS
300
4810-33x/34x

/dev/ttySn

1

value

0 or 1 microtouch or

1 microtouch 3 3963 32 4077

1 microtouch 0 3977 96 4062

1 microtouch 9 3870 190 4090

4 elographics 18 3998 122 4045

4 elographics 5 4024 32 4039

4 elographics 17 3865 178 4037

4 elographics 12 3973 110 4057

0, 1, 4, 5, 6,or7microtouch or

0 or 1 microtouch or

2

driver

elographics

elographics

elographics

minimum_X maximum_X minimum_Y maximum_Y

See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch
screen coordinates” on page 4, if applicable to your installation.

See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch
screen coordinates” on page 4, if applicable to your installation.

See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch
screen coordinates” on page 4, if applicable to your installation.

Chapter 1. Common configuration procedures 3

Table 1. Serial touch screen calibration variable values based on system (continued)

System
(screen size)

IBM SurePOS
500 4840

IBM SurePOS
500 4846-545

IBM SurePOS
500 4846-565

IBM SurePOS
500 4851/4951

IBM SurePOS
700
4800-7x3/7x3/
7x3

/dev/ttySn

1

value

4 elographics See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch

4 elographics 71 4003 112 4079

4 elographics 6 4066 163 4023

5 elographics See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch

0, 1, 4,or5 microtouch or

2

driver

elographics

minimum_X maximum_X minimum_Y maximum_Y

screen coordinates,” if applicable to your installation.

screen coordinates,” if applicable to your installation.

See “IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch
screen coordinates,” if applicable to your installation.

Table notes:

1. If more than one value is listed, use the ttyS number for the RS-232 serial port to which the touch

screen is attached (which is a value one less than the physically enumerated port number, because
ttyS numbering starts with 0 not 1).

2. If more than one value is listed, use microtouch or elographics based on the type of serial touch

screen that is attached to the system:

Table 2. Touch screen drivers by 4820 model

4820 model Touch driver

IBM 4820-42T SurePoint Solution
IBM 4820-4FT SurePoint Solution
IBM 4820-FBT SurePoint Solution

IBM 4820-2WN SurePoint Solution
IBM 4820-2WB SurePoint Solution
IBM 4820-2GN SurePoint Solution
IBM 4820-2GB SurePoint Solution
IBM 4820-5WN SurePoint Solution
IBM 4820-5GN SurePoint Solution

microtouch

elographics

IBM 4820-2xx/4xx/5xx SurePoint Solution serial touch screen
coordinates

The following variables are used in the procedure in this section with the specified, serial-attached
SurePoint Solution:

Table 3. SurePoint Solution serial touch screen coordinate values

System minimum_X maximum_X minimum_Y maximum_Y

IBM 4820-2xx/4xx
SurePoint Solution

IBM 4820-5xx
SurePoint Solution

0 16350 16350 0

-46

Note: This value is
negative.

3922 46 4094

4 Linux OS Configuration

Providing serial touch screen coordinates in xorg.conf

To provide the X Window System with the specific minimum and maximum X and Y coordinates for the
serial touch screen:

1. Launch the terminal application from Init 3 text console mode.

2. Use a text editor to add the following section to the /etc/X11/xorg.conf file:

Section "InputDevice"

Driver "driver"
Identifier "Mouse[3]"
Option "ButtonNumber" "1"
Option "ButtonThreshold" "17"
Option "Device" "/dev/ttySn"
Option "InputFashion" "Touchpanel"
Option "MinX" "minimum_X"
Option "MaxX" "maximum_X"
Option "MinY" "minimum_Y"
Option "MaxY" "maximum_Y"
Option "Name" "unique_device_id"
Option "ReportingMode" "Scaled"
Option "SendCoreEvents" "on"

EndSection

See Table 1 on page 3 and Table 3 on page 4 (as applicable) for the variable values; unique_device_id is
any alphanumeric string by which you would like the device identified in the OS.

3. Add the following line to the ServerLayout section in the /etc/X11/xorg.conf file:

InputDevice "Mouse[3]" "SendCoreEvents"

For example:

Section "ServerLayout"

Identifier "Layout[all]"
InputDevice "Keyboard[0]" "CoreKeyboard"
InputDevice "Mouse[1]" "CorePointer"

InputDevice "Mouse[3]" "SendCoreEvents"

Option "Clone" "off"
Option "Xinerama" "off"
Screen "Screen[0]"

EndSection

Tone support for Elo touch screens

IBM provides a utility which turns on or off the audible feedback for external 4820 Elo USB and RS-232
Elo touch screens. You can download the IBM_elotone4sle-1.0.0-0.i586.rpm package from IBM support
web site at http://www.ibm.com/support/docview.wss?uid=pos1R4000246.

To install the package on SLED 11 or SLES 11, enter the following command on the command line:

rpm -ivh IBM_elotone4sle-1.0.0-0.i586.rpm

To install the package on SLEPOS 11, refer to the SLEPOS 11 documentation.

To activate the tone on an external 4820 Elo touch screen, enter the following on the command line:

./elotone4sle {--help} -s [DOWN | UP | BOTH | OFF] -d port -f frequency -t time

[DOWN | UP | BOTH | OFF]

Specifies whether the tone sounds when a touch is first recognized (DOWN), when a touch
is released (UP), at both times (BOTH), or not at all (OFF).

port Specifies either USB-attached (usb) or RS-232 serial-attached (/dev/ttySn).

frequency Specifies the frequency value in hertz for the tone.

time Specifies the duration in milliseconds that the tone sounds.

Chapter 1. Common configuration procedures 5