Logic Controls Customer Display JPOS Driver for Linux
======================================================
01/29/2010


Java version 1.5.x or later required

This package contains Logic Controls customer display JPOS drivers 
for Linux Kernel version 2.4.x.x. and 2.6.x.x.  Follow the following 
installation instructions carefully.

Models supported by our JPOS driver are:

	LD9900, LD9990, LD9900U, LD9900UP
	PD3900, PD3990, PD3900U, PD3900UP
	PD6900, PD6990,	PD6900U, LD1000

	LT9900, LT9990, LT9900U, LT9900UP
	TD3900, TD3990, TD3900U, TD3900UP

Make sure that the pole display being used is one of the above models.



1. If you have the USB interface JPOS pole display, install USB driver 
   first before installing the JPOS drivers.

2. The package contains drivers for both Linux kernel 2.4.x.x and 2.6.x.x.
   Copy the drivers for the correct kernerl into the a target folder.

3. Follow instructions below for the corresponding Kernel to install.




Installaton Instructions for Kernel 2.4.x.x
===========================================


1. Install JDK.
	(1) Download the jdk for linux from java.sun.com.
	(2) Install it.
	(3) Set the environment variables.
		Suppose JDK version is J2sdk1.4.2 and was installed at 
		"/usr/java/J2sdk1.4.2".If the JDK version is different,
		make sure change the JDK version number to match the 
		version number in your computer.
		a. open vi, and edit "/root/.bash_profile
		b. add following information.
	export JAVA_HOME=/usr/java/J2sdk1.4.2
	export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/jre/lib:$JAVA_HOME/lib/tools.jar
	export PATH=.:$PATH:$JAVA_HOME/bin:$JAVA_HOME/jre/bin


***** Note **********************************
For USB Pole Display, skip step 2,3,4 & 5, 
install the USB driver and then go to step 6
*********************************************

2. Installing Sun's comm.jar.
	(1)  This comm.jar is extracted from the x86 Solaris version of commapi.
	     This x86 Solaris version of commapi was obtained from
	     http://java.sun.com/products/javacomm/index.html
	(2)  Copy this comm.jar to "/usr/java/j2sdk1.4.2/jre/lib/ext/comm.jar"

3. Install Installing javax.comm.properties.
	(1)  Edit javax.comm.properties file.
		javax.comm.properties needs the following text in it:
		Driver=gnu.io.RXTXCommDriver
	(2)  Copy it to "/usr/java/j2sdk1.4.2/jre/lib".
	
4.Install RXTX.
	There are two method to install rxtx.
	(1). Using the source code to install.
		a. Extract the rxtx-2.0.5.tar.gz to /home/rxrx-2.0.5
		b. cd /home/rxtx-2.0.5
		c. ./configure
		d.make
		f. make install
	         Install rxtx is finished.
	(2) Copy all released file to proper path.
               	a. Copy librxtxSerial-2.0.5.so,librxtxSerial.la, librxtxParallel-2.0.5.so and 	librxtxParallel.la to
		"/usr/java/j2sdk1.4.2/jre/lib/$(ARCH)/"
		Note: $(ARCH) is your PC's architecture.e.g. i386
		b. Make new link file.
		    The command is following:
			cd /usr/java/j2sdk1.4.2/jre/lib/i386/			
			ln -s librxtxSerial-2.0.5.so librxtxSerial.so
			ln -s librxtxParallel-2.0.5.so librxtxParallel.so
		c. Copy jcl.jar to "/usr/java/j2sdk1.4.2/jre/lib/ext/"
		
5. The result after all settings.
	Files:
			/usr/java/j2sdk1.4.2/jre/lib/ext/jcl.jar
			/usr/java/j2sdk1.4.2/jre/lib/ext/comm.jar
			/usr/java/j2sdk1.4.2/jre/lib/$(ARCH)/librxtxSerial-2.0.5.so.
			/usr/java/j2sdk1.4.2/jre/lib/$(ARCH)/librxtxParallel-2.0.5.so.
			/usr/java/j2sdk1.4.2/jre/lib/$(ARCH)/librxtxSerial.la
			/usr/java/j2sdk1.4.2/jre/lib/$(ARCH)/librxtxParallel.la
			/usr/java/j2sdk1.4.2/jre/lib/javax.comm.properties	

6. Install LC Jpos, unzip zip file to a directory.
	(1) Copy all LC Jpos files to "/home/lcjpos".
	(2) Add all jar file to CLASSPATH.
		a. open vi , edit /root/.bash_profile
		b.Add following line to it.
	export LD_LIBRARY_PATH=/home/lcjpos:$LD_LIBRARY_PATH
	export LC_HOME=	/home/lcjpos
	export CLASSPATH=$LC_HOME/jcl.jar:$LC_HOME/jcl_editor.jar:$LC_HOME/jpos17.jar:$LC_HOME/LCJpos.jar:$LC_HOME/xerces.jar:$CLASSPATH

	Check the sample ".bash_profile" for how to set environment variables.
  
7. Reboot the computer.

8. Run lcjpos test program
	java com.logiccontrols.TestApp
	Select "/dev/ttyS0" for serial port, or "Linux USB LD9" for USB port.

9.For more detail about rxtx install, please see rxtx_install.txt file.

-------------------------------------------------------------------------------




Installaton Instructions for Linux Kernel 2.6.x.x
=================================================


This driver is for both serial port and USB interface pole 
displays. The following steps have been tested under Xubuntu8.10 
(Kernel:2.6.27-7-generic) by using USB PD.
 
1. If you are using USB displays, please install USB PD Driver for 
   Linux first. You may download the USB PD Driver from 
      http://www.logiccontrols.com/web/sd.htm
   After installation, test PD by "./testlcpd" to see whether driver 
   works properly.


2. Install JDK/JRE

   For example (If Internet is connected),
      #apt-get install sun.java6.jdk


3. Copy jcl.jar, jcl_editor.jar, jpos19.jar, LCJpos19.jar, jpos.xml 
   and xerces.jar to your created jpos folder (this can be any folder).

   For example (if user name is lc),

       mkdir /home/lc/jpos
       cp jcl.jar /home/lc/jpos
       ..................
       cp xerces.jar /home/lc/jpos


4. Edit enviroment variables.
   Add the following new variables to the end of file. 
   Following example assumes login as root.

	(1) JAVA_HOME
 		vi /etc/bash.bashrc
		export JAVA_HOME=<Your java path>

		e.g: export JAVA_HOME=/usr/lib/jvm/java-6-sun

	(2) LC_HOME
		vi /etc/bash.bashrc
		export LC_HOME=<your jpos folder>

		e.g: export LC_HOME=/home/lc/jpos

	(3) CLASSPATH
		vi /etc/bash.bashrc
		export CLASSPATH=$LC_HOME/jpos19.jar:$LC_HOME/LCJpos19.jar:$LC_HOME/jcl.jar:$LC_HOME/jcl_editor.jar:$LC_HOME/xerces.jar:$CLASSPATH


5. Install the *.so files

	Copy libJposHook.so, and libLCUSB.so to /usr/lib folder


6. Run setup program:

	java com.logiccontrols.TestApp


7. In jpos setup program window, if you're using USB PD, 
   select "Linux USB PD" from "Port name" drop-down listbox, 
   and then click "Save" button. Finally, you can click the 
   "Open", "Claim", "Enable Device" , "Display Text", ... 
   to test JPOS.

   Please note if you are using serial port displays, the 
   port name has to be selected according to actual port being
   used.  For example, if COM1 is connected to the PD, please 
   select "/dev/ttyS0" in "Port name" drop-down listbox.

---------------------------------------------------------------------------


		
Logic Controls, Inc.
355 Denton Avenue
New Hyde Park, NY 11040
Tel: (516)-248 0400
Fax: (516)-248 0443
email: lci@logiccontrols.com
web: www.logiccontrols.com



