JavaPOS Linux32 Classes		Ver. 1.14.2

---------------------------------------------
  Version Description:
---------------------------------------------
1.14.1 2022.1.7 
Initial version

1.14.2 2022.3.21
Fixed an error in claim

---------------------------------------------
  Files:
---------------------------------------------
</> directory
	Demo.bat                demo program files
	POSTest.bat		Java Pos Device tester v1.10.0
	CheckHealth.bat
	SetupPOS.bat
	jpos.xml		setup configuration file of demo
	readme_linux.txt        this file

<./lib> directory
	pos.jar            	JavaPOS classes
	SetupPOS.jar          	Manipulating the jpos.xml registry via JCL
	jposRES.jar
	POSTest.jar
	javapos1142.jar         JavaPOS architecture classes, including all control classes
	RXTXcomm.jar		COM ports Library
	xercesImpl.jar          XML parser and utility system.
	xml-apis.jar		Arabic decode library

<./bin> directory
	jposCHJNL.so		Linux32 Device Check Native Library
	rxtxSerial.so		Linux32 COM ports Native Library

<./demo> directory
	<classes> 		all separate classes of demo
	<src>			all java source code of demo


---------------------------------------------
  Installation and testing:
---------------------------------------------
1. copy above files to a directory
2. run run-install.sh copy ./bin/*.so to $JAVA_HOME/jre/lib
3. update CLASSPATH environment variable to include all newly installed java packages
   Please see demo.bat for reference.
4. connect the hardware
5. run SetupPOS.sh modify jpos.xml and meet your system configuration
6. run demo.sh or
   run POStest.sh or
   run CheckHealth.sh


---------------------------------------------
  Configuration of jpos.xml
---------------------------------------------
. Please refer to jpos.xml for test POStest program. 

. Please refer to below for default logical name of POStest program.
  1. Line Display
     default logicalName: defaultLineDisplay

  2. Cash Drawer
     default logicalName: defaultCashDrawer

. Please refer to jpos.xml for test demo program. 

. Please refer to below for default logical name of demo program.
  1. Line Display 
     default logicalName: LineDisplay

  2. Cash Drawer
     default logicalName: CashDrawer


. Please refer to below for the detail of vendor options.
  1. Line Display
     
	PortName:
			"/dev/ttyS0"	--> The com port name, example /dev/ttyS0,/dev/ttyS1... etc.
			"/dev/ttyUSB0"	--> The USB port name, example /dev/ttyUSB0,/dev/ttyUSB1...etc.
	Country:
			"U.S.A" --> Select international character set, examle  "France", "Russia" ... etc.

  2. Cash Drawer
     
	PortName:
			"/dev/ttyS0"	--> The com port name, example /dev/ttyS0,/dev/ttyS1... etc.
			"/dev/ttyUSB0"	--> The USB port name, example /dev/ttyUSB0,/dev/ttyUSB1...etc.

	OpenPIN:	
			"PIN2" --> Drawer kick-out connector pin 2
			"PIN5" --> Drawer kick-out connector pin 5

	OpenState:	
			"Low"  --> Drawer kick-out connector pin 3 is LOW
			"High" --> Drawer kick-out connector pin 3 is HIGH

	PulseOnTime:  
			t1     --> The pulse for ON time is (t1  2 msec)
			t2     --> The pulse for OFF time is (t2  2 msec)

---------------------------------------------
  Extended Error Code
---------------------------------------------

  UPOS_EX_BADPORT 		= 1001
  UPOS_EX_PORTUSED 		= 1002
  UPOS_EX_NOTSUPPORTED 		= 1003
  UPOS_EX_INVALID_VALUE 	= 1004
  UPOS_EX_UNKNOWN_DEVICE 	= 1005
  UPOS_EX_DEVBUSY 		= 1006
  UPOS_EX_TIMEOUT 		= 1007
			