
             IBM(R) Point of Sale Subsystem for Linux(R) 
                          Version 1.2.0
                       Installation Readme


  Instructions for installing the IBM Point of Sale Subsystem (POSS) 
  for Linux can also be found in the publication, "IBM Point of Sale
  Subsystem: Installation, Keyboards, and Code Pages", which is 
  available on the IBM Web site.



  IBM POINT OF SALE SUBSYSTEM FOR LINUX PACKAGES
  ==============================================
  
  Once you have downloaded and unzip'd the IBM POSS for Linux 
  package, you will have four files:

        * This file (readme.1st)  
        * ibmposs-linux-patch-ps2filter-1.2.tgz
        * ibmposs-linux-1.2.0-<build>.i386.rpm
        * ibmposs-linux-1.2.0-<build>.i386.tgz
        
  where <build> is the two-digit build number of the package.
  
  The IBM POSS for Linux V1.2.0 has been tested with Red Hat(R) Linux 
  V7.3 (kernel 2.4.18-27.7) running on IBM 4694-1xx, 4694-2xx,  
  4694-3xx, and 4800-7x1 cash registers.


        
  INSTALLING ANPOS KEYBOARD SUPPORT
  =================================
  
  If you intend to use an ANPOS keyboard as the system keyboard
  (i.e. attched via the PS/2 port), you must apply a keyboard
  kernel patch *before* installing the subsystem.  
  
  a) Decide which tar file you will use for the ANPOS keyboard
     patch:
  
     If you intend to install POSS for Linux using RPM, you will
     use the following tar file:
  
         ibmposs-linux-patch-ps2filter-1.2.tgz
         
     If you are not planning on using RPM to install POSS for 
     Linux, you will use this tar file:
  
         ibmposs-linux-1.2.0-<build>.i386.tgz

  b) Decompress/extract files from the tar file:
  
         tar zxvf ibmposs-linux-patch-ps2filter-1.2.tgz
         
                          or
  
         tar zxvf ibmposs-linux-1.2.0-<build>.i386.tgz
  
  c) Follow the instructions in ps2_patch/POS_patch_instructions.txt
     to install the keyboard patch.           
  
            

  INSTALLING THE POINT OF SALE SUBSYSTEM FOR LINUX
  ================================================


  Installing POSS for Linux Using RPM
  -----------------------------------
     
  a) You will use the POSS for Linux RPM file:
   
         ibmposs-linux-1.2.0-<build>.i386.rpm
        
  b) To install POSS for Linux for the first time:
  
     i. Type the following:
 
            rpm -i ibmposs-linux-1.2.0-<build>.i386.rpm 
                
  c) To upgrade POSS for Linux:
  
     i. Type the following:
 
        rpm -U ibmposs-linux-1.2.0-<build>.i386.rpm --noscripts 
         
  d) To enable mouse emulation using an IBM 4820 Touch Screen (RS-485),
     edit the file, /etc/aipsys.conf, and remove the '!' from the
     "mouse=on" line.
     
  e) Reboot the system.
 


  Installing POSS for Linux Using the Installation Shell Script
  -------------------------------------------------------------

  a) You will use the POSS for Linux tar file:
 
         ibmposs-linux-1.2.0-<build>.i386.tgz

  b) Decompress/extract the POSS for Linux tar file:
 
         tar zxvf ibmposs-linux-1.2.0-<build>.i386.tgz

  c) Change directory into the top-level directory created:
  
         cd ibmposs-linux-1.2.0-<build>

  d) Run the following command:
 
         ./install_pos.sh --install 
        
     to install the POS subsystem files.  
    
  e) To enable mouse emulation using an IBM 4820 Touch Screen (RS-485),
     edit the file, /etc/aipsys.conf, and remove the '!' from the
     "mouse=on" line.
     
  f) Reboot the system.




  UNINSTALLING THE POINT OF SALE SUBSYSTEM FOR LINUX
  ==================================================
   
  Removing ANPOS Keyboard Support
  -------------------------------
  Follow the instructions in ps2_patch/POS_patch_instructions.txt to 
  remove/reverse the ANPOS keyboard patch.
     
          
  Uninstalling POSS for Linux Using RPM
  -------------------------------------
     
  To uninstall, type the following:
     
         rpm -e ibmposs-linux
            
   
  Uninstalling POSS for Linux Using the Installation Shell Script
  ---------------------------------------------------------------

  To uninstall POSS for Linux, if you have not touched the untarred 
  sources, change directory into the top-level directory of these 
  sources -- ibmposs-linux-<version>;  if you no longer have these 
  sources or have modified them, change directory to the location of 
  install_pos.sh.  Run the following command:
        
         ./install_pos.sh --uninstall



  MOUSE EMULATION FOR 4820 TOUCHSCREEN (RS-485)
  =============================================

  Enabling Mouse Emulation
  ------------------------
  
  If you have an RS-485 IBM 4820 Touch Screen and would like to enable
  mouse emulation, you will need to modify the POSS for Linux 
  configuration file, aipsys.conf, to contain the entry:
  
  mouse = on
  
  The aipsys.conf file that comes with POSS for Linux already contains
  this entry but it has been commented out -- remove the '!' from the 
  beginning of the line to uncomment it.
  

 
  Mouse Emulation Configurations for 4820 Touchsceen (RS-485)
  -----------------------------------------------------------
  
  By default, the installation provides PS/2 mouse and touch in console
  mode only (no X Window System).
  
  If it is desirable to use mouse emulation in both console mode and
  the X Window System, please note that current support only allows for 
  the following configurations:

      (1) Touch only in console mode
          PS/2 mouse and touch in the X Window System

      OR

      (2) PS/2 mouse and touch in console mode
          Touch only in the X Window System

  The directions below in "Using the 4820 Touchscreen (RS-485) in the 
  X Window System" will result in configuration (1).

  For configuration (2), follow the same directions but in the file,
  /etc/rc.d/init.d/aipstart, replace
  
      gpm -m /dev/psaux -t ps2 -M -m /dev/input/touch -t mtouch
      
  with
      
      gpm -m /dev/psaux -t ps2 -M -m /dev/input/touch -t mtouch -Rsumma
      
 
    
  Using the 4820 Touchscreen (RS-485) in console mode
  ---------------------------------------------------
  
  Mouse emulation for the 4820 Touchscreen requires the GPM (General 
  Purpose Mouse) package version 1.19.3-12 or later. Installing 
  POSS for Linux automatically sets up console mouse emulation for 
  the touchscreen.
  

  
  Using the 4820 Touchscreen (RS-485) in the X Window System
  ----------------------------------------------------------
  
  For cash registers capable of running the X Window System:

  (a) Download 'gpmsumma_drv.o' from this link:
  
      http://www.annet.pl/~anowak/mtouch/gpmsumma_drv.o

  (b) Copy the 'gpmsumma_drv.o' driver to /usr/X11R6/lib/modules/input

  (c) Edit /etc/X11/XF86Config-4, adding the following lines:

      Section "InputDevice"
          Identifier  "Touch"
          Driver      "gpmsumma"
          Option      "Type"    "finger"
          Option      "Device"  "/dev/gpmdata"
          Option      "Mode"    "Absolute"
          Option      "Cursor"  "Puck"
      EndSection

  (d) Also in /etc/X11/XF86Config-4, modify the ServerLayout section 
      as follows (...... denotes existing configuration):

      Section "ServerLayout"
          ......
          ......
          InputDevice    "Touch"    "SendCoreEvents"
      EndSection

  (e) Modify /etc/rc.d/init.d/aipstart as follows:

      Change
  
         gpm -m /dev/psaux -t ps2 -M -m /dev/input/touch -t mtouch
     
      to
  
         gpm -m /dev/input/touch -t mtouch -Rsumma

  (f) Reboot


  BEHAVIOR OF MOUSE EMULATION IN CONSOLE MODE AND THE X WINDOW SYSTEM
  ===================================================================
  
  The description on how the mouse emulation behaves can be found in 
  the document, README.microtouch. This document is located in the 
  source tree of gpm. The gpm source tree is available as part of 
  RedHat's Linux distribution. 
  
  A mouse click is emulated by first moving the cursor to the desired 
  position and then quickly tapping the touchscreen. To drag, double 
  tap the touchscreen but hold on the second tap.  
  
       
  Using the 4820 Touchscreen (RS-485) Calibration Utility (Console)
  -------------------------------------------------------------------
  The utility provides 2-point touch screen calibration, touch tone 
  configuration and restore touch default settings.

  To start the calibration utility program with menu, type:
  
      aiptutil
      
  From the menu, user can choose 2-point touch screen calibration, touch 
  tone configuration or restore touch default settings.

  To start the calibration utility to perform 2-point touch screen 
  calibration only, type:
  
      aiptutil -c

  To start the calibration utility to perform reset to default touch 
  settings only, type:
  
      aiptutil -r

  To start the calibration utility to enable touchdown click tone only,
  type:
  
      aiptutil -t:touchdown

  To start the calibration utility to enable liftoff click tone only,
  type: 
  
      aiptutil -t:liftoff

  To start the calibration utility to disable click tone only, type:
  
      aiptutil -t:disable

  To know more about the available options for this utility, type:
  
      aiptutil -h


 =====================================================================
*  IBM is a registered trademark of the International Business 
   Machines Corporation.
*  Linux is a registered trademark of Linus Torvalds.
*  Red Hat is a registered trademark of Red Hat, Incorporated.
