JavaPOS Linux Classes		Ver. 1.14.3


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

1.14.2 2022.3.21
Fixed an error in claim

1.14.3 2022.3.29
Add claim timeout processing
Update serial communication library

---------------------------------------------
  Files:
---------------------------------------------
</> directory
	demo.sh                demo program files
	checkHealth.sh
	setupPOS.sh
	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
	nrjavaserial521.jar	COM ports Library
	javapos1142.jar         JavaPOS architecture classes, including all control classes
	xercesImpl.jar          XML parser and utility system.
	xml-apis.jar		Arabic decode 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. update CLASSPATH environment variable to include all newly installed java packages
   Please see demo.bat for reference.
3. connect the hardware
4. run setupPOS.sh modify jpos.xml and meet your system configuration
5. run demo.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 x 2 msec)
			t2     --> The pulse for OFF time is (t2 x 2 msec)

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

  UPOS_EX_PORTOPENFAILED	= 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
			