
                         Elo CashDrawer Driver
             for EloPOS Pack Connected to NCR Cash Drawers
         
                          SW603029 v4.4.1.1
                           
                         Elo Touch Solutions
                             Nov 10, 2023                            
                            
  ===================================================================

  -------------------------------------------------------------------
                      1. Supported Linux Distros
  -------------------------------------------------------------------

  The package is expected to work for Linux distros which support
  legacy sysfs interface with /sys/class/gpio/gpiochipXXX exposed.
  
  Due to large number of Linux distros, not all distros are tested.
  The user is encouraged to verify the package on targeted Linux
  distro before production-level usage. 
  
  -------------------------------------------------------------------
                      2. Before Installation
  -------------------------------------------------------------------
  
  Please make sure any previous Elo cash drawer drivers have been 
  removed.

  -------------------------------------------------------------------
                      3. Install the CashDrawer Driver
  -------------------------------------------------------------------

  (a) Unzip the pacakge and place the driver folder
      "elo_cash_drawer" to /usr/local/:
 
      /usr/local/elo_cash_drawer/


  (b) Make files accessible:

      Under "elo_cash_drawer" folder:

      sudo chmod 777 *

  (c) Run installation with root privilege:
       
      Under "elo_cash_drawer" folder:

      sudo ./install.sh

      User will be prompted for a reboot at end of setup.

  -------------------------------------------------------------------
                       4. Test the Cash Drawer
  -------------------------------------------------------------------

  (a) Test Elo JPOS driver using Java test utility "postest.jar" 

      jre7 or newer is required to run the java test utility.
      
      Under elo_cash_drawer/postest/ folder:
       
      java -cp '*:.' com.jpos.POStest.POStest
    
  (b) Test the cash drawer using Linux sysfs commands:

      Under elo_cash_drawer:

      To open drawerA: sudo ./cd_open1.sh
      To open drawerB: sudo ./cd_open2.sh
      
  -------------------------------------------------------------------
                5. Setting CLASSPATH for User's Java App
  -------------------------------------------------------------------
  
    For Java applications controlling cash drawer, the CLASSPATH 
    should include the jars below including path to the "jpos" 
    sub-folder: "elo_cash_drawer/jpos/":

      jpos-1.14.2.jar
      jna-4.0.0.jar
      jna-platform-4.0.0.jar
      xerces.jar
      sampleld.jar
      eloJPosService114.jar
      ./

  -------------------------------------------------------------------
                  6. Uninstall Elo Cash Drawer Driver
  -------------------------------------------------------------------

    Under elo_cash_drawe folder:
    sudo ./uninstall.sh

    Then user can delete the elo_cash_drawer folder if desired.
    
  --- END OF readme.txt ---
