Home

OPERATION MANUAL

1. iButton A 5 Display of result Check Health Program v 001 003 PBS gea Device Entry Ke lock s A Information y gt Z ysr _ T Internal External Interactive Result iButton SUCCESS Lp eer CheckHealthText A value is displayed in the Result box and the CheckHealthText Text box Either of the following two value combinations will be displayed in these boxes e When exited with the OK button in Step A 4 Result SUCCESS CheckHealthText Interactive Hcheck Successful e When exited with the NG button in Step A 4 Result SUCCESS CheckHealthText Interactive Hcheck Error 37 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL B 1 Keylock panel display JPOS Check Health Application f soy Keylock D iButton meres x Me g 74 Scanner 4 o y POS Printer Config Category LogiclaName Vender Product Name MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay __ LIUST 53 TOSHIBA TEC Corporation TECLineDisplay CashDrawer _ TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer TRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay __ LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWST50Ex TOSHIBA TEC
2. TOSHIBA TEC Corporation TECKeylock LT DRWST50Ex CashDrawer _ DRWST50 TOSHIBA TEC Corporation TECCashDrawer pRwsrTso Keylock PKBST5x TOSHIBA TEC Corporation TECKeylock HS530RS TOSHIBA TEC Corporation TECScanner KB Scanner o eee Keylock MSR MSRPKBST 5x TOSHIBA TEC Corporation ITECMSR ae Scanner HSS530RSEx TOSHIBA TEC Corporation TECScannerEx mi a vi Scanner y POS Printer Click on a node under the CashDrawer node CashDrawer has the following eight kinds e DRWSTS50 e DRWSTSOEx CashDrawer e EPSON Drawer TRSTA1xSDRW and TRSTA1xPDRW and TRSTA1xUDRW QM or CN and TRSTA1xLDRW and TRSTAOOUDRW C 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program vy 001 003 POS Device Entry Drawer g RA Information o External p Cash Drawer El MSR Internal pe om Line Display C TRSTAIS_CashDraw Result TRSTA1U_CashDraw C DRWST50Ex gt ayy Keylack orweTso CheckHealthText R POS Printer mi amp isf Scanner Click on the Interactive button at the right 40 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A CashDrawer C 3 Open the drawer CashDrawer Interactive CheckHealth Click on the Drawer Open button C 4 Ge
3. Cash Drawer Ty Hs530RS L HS530RSEx o 4 POS Printer Scanner Config Category LogiclaName Vender Product Name MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay LIUST 53 TOSHIBA TEC Corporation ITECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer TRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWST50Ex TOSHIBA TEC Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer DRWST50 TOSHIBA TEC Corporation TECCashDrawer Keylock PKBST5x TOSHIBA TEC Corporation TECKeylock Scanner HS530RS TOSHIBA TEC Corporation TECScanner MSR MSRPKBST 5x TOSHIBA TEC Corporation TECMSR Scanner HSS530RSEx TOSHIBA TEC Corporation TECScannerEx Click on the HS530RS node under the Scanner node F 2 Call to the Interactive Check Health method JPOS Check Health Application i ag Information e MSR Scanner HS530R8 C HS530RSEx POS Printer Scanner Internal Interactive Result SUCCESS CheckHealthText Interactive HCheck Successful
4. The example below explains the method to get YYY property in XXX object and set ZZZ value to the property Get a XXX getYYY Set XXX setYYY ZZZ 65 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 4 Disable a device drawer setDeviceEnabled flase drawer release drawer close e Set the DeviceEnabled property to FALSE e Release the exclusive processing e Close the device 4 For the devices which do not perform an exclusive processing the release processing is not required 2 When the device is closed an operation speed increases Please close the device when exiting from the application as much as possible To suspend the device set the DeviceEnabled property to FALSE Supplemental Explanation 1 Method to set an exception A process which uses JavaPOS Device Control drawer open LOGICALNAME drawer claim 100 drawer setDeviceEnabled true catch JposException e Describe an exception here Perform an exception for all cases where the JavaPOS Device Control is used for example device open claim call to device specific method property handling In detail describe a code which uses JavaPOS Device Control in braces and a handling when an exception occurs in braces of catch JposException JposException is an exception which is thrown when an exception occurs with the JavaPOS Device Control 66
5. applies both to Windows and Linux 2 Execution of Device Health Check program CheckHealth JCL Editor Click on the CheckHealth button at the top i Note the subsequent OPERATION differs for Keylock Drawer MSR LineDisplay and Scanner The functions of the JCL Editor are not used this time 34 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A 1 Keylock panel display JPOS Check Health Application Check Health Program vy 001 003 g Erz Information gt a MER mm Line Display F Cash Drawer o o L PKBST5x MN o 74 Scanner 4 o y POS Printer Config Category LogiclaName Vender Product Name MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay LIUST 53 TOSHIBA TEC Corporation TECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer TRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWST50Ex TOSHIBA TEC Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer DRWST50 TOSHIBA TEC Corporation TECCashDrawer Keylock PKBST5x TOSHIBA TEC Corporation TECKeylock Scanner HS530RS TOSH
6. file Change directory to Driver gt Keyboard Driver gt Windows folder and click the USB_XP_WEPOS Vista_SETUP bat file After finishing above steps please follow Windows 2000 XP and WEPOS steps 3 Reboot When the installation succeeds please reboot the computer 28 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved lt Linux USB SLED10SP1 and SLED11 gt Before this installation execute Installation of TECUSB procedure Execute the following commands in order to install the USB POS keyboard driver This procedure is necessary to operate MCR and Keylock attached to PKBST 52 Supported Product PKBST 52 Note Restarting the operating system clears this setting The procedure must be performed whenever the operating system is restarted Note In case of the simultaneous use with USB POS Printer install usbposkbd ko before installing tecusbd ko Select Driver gt Keyboard Driver gt Linux gt Driver gt SLED10SP1 or SLED11 Please select OS used gt USB folder Copy the usbposkbd ko module to any desired location usbposkbd ko is a USB Keyborad driver which runs on Linux 1 Installation of module 4 This setup is cleared whenever the operating system is rebooted This command must be executed every time the operating system is rebooted insmod home tec tecdrv usbposkbd ko Execute the above commands to instal
7. following commands in order from the top cd usr src linux Movement to a directory with the source file of a kernel make oldconfig Obtains configuration information of the kernel in operation make clean Deletes all interim files make Complies the kernel and driver modules make install Installs the kernel make modules _install Installs the drivers When the touch panel driver provided by Elo TouchSystems has been installed dependency information among the touch panel modules will disappear Execute the following commands and register the dependency information again cd etc opt elo ser setup or etc opt elo install sh Finally restart the operating system 14 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved lt Linux SLED11 gt The source file of a keyboard driver is rewritten using tec_kbd 2 6 27 patch file e usr src linux drivers input keyboard atkbd c e usr src linux drivers input serio i8042 c e usr src linux drivers char keyboard 1 Copy the following files to home tec tecdrv from Driver gt Linux Keyboard patch gt SLED11 folder in this Kit e tec_kbd 2 6 27 patch Execute the following command Then a patch is applied and a source file can be rewritten cp p home tec tecdrv tec_kbd 2 6 27 patch usr src linux cd usr src linux patch p0 lt tec_kbd 2 6 27 patch 2 Patch application to w1 driver
8. it is installation completion Click on the Finish button Device Manager File Action View Help e 4283 Computer See Disk drives iy Human Interface Devices H E IDE ATA ATAPI controllers H 5 gt Keyboards m7 Mice and other pointing devices Other devices oY Ports COM amp LPT Re Processors Sound video and game controllers PA System devices l TEC Bulk amp Interrupt USB Device J amp Toshiba TEC TRST A1x USB POS Printer amp Universal Serial Bus controllers Finally start device manager And confirm that it is installed as above 24 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved lt Linux SLED10SP1 and SLED11 gt 1 Copy of driver module Select Driver gt TECUSB Driver gt Linux gt Driver gt SLED10SP1 or SLED11 Please select OS used Copy the tecusbd ko driver module to any desired location tecusbd ko is a TECUSB driver which runs on Linux Select Driver gt TECUSB Driver gt Linux gt Driver Copy the libtecusbd so 0 0 module to any desired location 2 Installation of driver 4 This setup is cleared whenever the operating system is rebooted This command must be executed every time the operating system is rebooted insmod home tec tecdrv tecusbd ko Execute the above commands to install the driver The above is an example when tecusbd ko has bee
9. libtecusb so 0 0 7 TECUSBUNI dll 6 libTECUSBJNI so 0 0 7 TECUSBPM exe 3 Required only for Windows Required only for Linux Required only for using CashDrawer Device Service under Windows Required only for using CashDrawer Device Service under Linux Required only for using iButton Device Service under Linux Required only for using POSPrinter USB Device Service under Windows Required only for using POSPrinter USB Device Service under Linux 55 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Description of Files A destination to save a file may differ depending on the development environment The following explanation is based on the development using the NetBeans5 5 Jpos111 jar Destination to save Any location Description JavaPOS Device Control To be imported when creating an application Available from JavaPOS 1 11 0 Dist zip on the web site http www javapos com samplecode html or http www javapos com index html 56 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved jpos xml Destination to save Root directory of project Description A device setup file required to operate each Device Service The following focuses on the major setup items descried in the file This file is required for operating each Device Service 1 Creation of jpos xml file An xml file is provided for each device in the JavaPOS folder W
10. of Linux Kernel for TTEC iButton driver The source file of a w1 driver is rewritten using tec_w1 2 6 27 patch file e usr src linux drivers w1 masters ds2490 c Copy the following files to home tec tecdrv from Driver gt Linux iButton Driver gt patch folder in this Kit e w1 patch install sh e ds2490 h e tec_w1 2 6 27 patch Execute the following procedure when using the iButton driver developed by TTEC home tec tecdrv w1 patch install sh Rebuild a kernel after these two procedures are completed Cautions Rebuild a kernel takes several hours 15 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved 3 Rebuild the kernel Execute the following commands in order from the top cd usr src linux Movement to a directory with the source file of a kernel make oldconfig Obtains configuration information of the kernel in operation make clean Deletes all interim files make Complies the kernel and driver modules make install Installs the kernel make modules_install Installs the drivers When the touch panel driver provided by Elo TouchSystems has been installed dependency information among the touch panel modules will disappear Execute the following commands and register the dependency information again J cd_ etc opt elo ser setup or etc opt elo install sh Finally restart the operating system Installation of the Linux Keyboard
11. 0 TOSHIBA TEC CORPORATION All Rights Reserved Default value Default value of major parameters is as follows To change the default value please refer to the chapter 3 How to Use the JavaPOS Device Service in the GUIDE or the setup method in the Application User Manual of each device service Category LogicalName deviceBus PortName Keylock iButton USB Keylock PKBST52 USB MSR MSRPKBST 52 USB MSR MCRST A10 RS232 COM5 LineDisplay LIUST A10 RS232 COM4 LineDisplay LIUST 53 RS232 COM4 LineDisplay WD 111 RS232 COM4 Scanner HS530RS RS232 COM3 Scanner HS530RSEx RS232 COM3 CashDrawer DRWST50 DRW1 CashDrawer DRWST50Ex DRW2 CashDrawer TRSTA1S_CashDrawer RS232 COM1 CashDrawer TRSTA1P_CashDrawer Parallel LPT1 CashDrawer TRSTA1L_CashDrawer LAN POSPrinter TRSTA1S RS232 COM1 POSPrinter TRSTA1P Parallel LPT1 POSPrinter TRSTA1L x LAN x 1 or 2 0r3 Category LogicalName deviceBus_ vendorlD productID CashDrawer TRSTA1U_CashDrawer USB 4 2 POSPrinter TRSTA1U USB 4 2 4 TRST A1x U QM 61 TRST A1x U CN 70 TRST AO0 U 82 2 TRST AO0 U 2 Other 1or2 33 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL OPERATION lt Windows gt lt Linux gt CheackHealth sh txSerial so libTECCash Linux_jpos xml log4j dtd i The subsequent OPERATION
12. A00 UF QM R TRST A00 DF QM R TRST A00 UC QM R TRST A00 DC QM R VV VV V Installation of Java Runtime Environment Download the file from the following web site and implement the Java Runtime Environment http Java sun com products archive j2se 1 4 2_16 6 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved Installation of Drawer Driver lt Windows gt 1 Startup of driver setup batch file we eA CashOvawerDriver N mrm DRYDRW sys i ORW INF ST AlOdrw reg ST AZ0_SETUP BAT ST A10 Select CashDrawer Driver gt Windows then double click on the ST A10SETUP BAT file to execute ST A20 Select CashDrawer Driver gt Windows then double click on the ST A2Z0SETUP BAT file to execute 4 Under Windows Vista right click on the icon of the SETUP BAT file and select Run As Administrator to execute 2 DRVDRW sys is a CashDrawer driver which runs on Windows TECCashDrawerJni dll is a library file which is used to access the Windows CashDrawer driver from Java 2 Start of installation ci C WINDOWS system32 cmd exe llation of a drawer driver s any key to continue Press any key to start the installation 7 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 3 Permission to add registry Registry Editor 2 re you sure you wark to add the formation in ORW RES tothe regstry A confirmation w
13. B Driver gt Linux gt JNI 62 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL E libTECPKBFilterJNI so 0 0 Destination to save Root directory of project Description An application programming interface API to be used to access the Linux Make a link file called libTECPKBFilterJNI so and use it Ex In s libTECUSBJNI so 0 0 libTECUSBJNI so Available from This Kit Click on Driver gt Keyboard Driver gt Linux gt JNP 63 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Example of Creating An Application Using the JavaPOS Device Service This chapter describes the method to create an application using the JavaPOS Device Service For this purpose the demo program enclosed in the Kit is used Coding Process There are the following processes to create an application using the JavaPOS Device Service Create a device class object Enable a device Call to a device specific method and get a property Disable a device SQN The subsequent sections explain each process 1 Create a device class object import javax swing DefaultListModel import jpos import jpos events import java util public class DrawerPanel extends javax swing JPanel implements StatusUpdateListener DirectIOListener private CashDrawer drawer Creates new form Dr
14. Cash Drawer ce Keylock gt oF Scanner ee POS Printer LineDisplay Config Category LogiclaName Vender Product Name MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay LIUST 53 TOSHIBA TEC Corporation TECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer ITRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWST50Ex TOSHIBA TEC Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer DRWST50 TOSHIBA TEC Corporation TECCashDrawer Keylock PKBST5x TOSHIBA TEC Corporation TECKeylock Scanner HS530RS TOSHIBA TEC Corporation TECScanner MSR MSRPKBST 5x TOSHIBA TEC Corporation TECMSR Scanner HSS530RSEx TOSHIBA TEC Corporation TECScannerEx Click on the LIUST A10 node under the LineDisplay node D 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program vy 001 003 Eg POS Device Entry a _ g A Information amp ae usr A Line Display N Gusts LIUST A10 gt EA Cash Drawer o Keylock POS Printer o iS Scanner Line
15. Click on the Interactive button at the right 50 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A Scanner F 3 Read of bar code Scanner Interactive CheckHealth Master OK Read the bar code The bar code read first time will be used as master data of the bar code For subsequent bar code reading it is judged OK if the bar code read is the same as that registered as master data And it is judged NG if the bar code read is different from the master data lt Same as master data gt lt Different from master data gt Scanner Interactive CheckHealth Scanner Interactive CheckHealth Master F3068320016771 OK 1 F3068320016771 F4901301231420 To exit click on the End button 51 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A Scanner F 4 Display of result JPOS Check Health Application Check Health Program v 001 003 BES Device Entry Scanner g ZF information gt MSR Internal External Interactive S mm Line Display a i P Cash Drawer gt BB konoek Result Kf Scanner SUCCESS C Assa0Rs CheckHealthText C HS530RSEx o 51 POS Printer Interactive HCheck Successful Values displayed in the Result and CheckHealth Text boxes differ depending on the reading result
16. Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Supplemental Explanation 2 Receipt of events public void statusUpdateOccurred StatusUpdateEvent e Describe a handling here public void directlIOOccurred DirectIOEvent e Describe a handling here e Implement an event interface in a main class Please refer to 1 Create a device class object e Implement functions which should be called when an event occurs e Add an appropriate description in the shaded areas 4 Event types differ for each device For details please refer to the Application User Manual of each device 67 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Creation of Window The figure below shows an example of window created when an application is created following the above mentioned processes POS TEST for Java POS eS POS Device Entry Drawer DSVersion Description gt 27 information a J MSR o M Line Dispiay Jannnnnnnnnnnn E p DrawerOpe 5 Status T Be Cash Drawer Huonona Device Name DRWST50Ex C TRSTA1S_CashDrawer TRSTA1U_CashDrawey C DRWSTS0Ex C DRWwSTS0 see Keylock Scanner ClearList POS Printer 1 Device Name Logical Name text box A text box which is used to set a logical device name of a device to open the
17. Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer _ DRWST50 TOSHIBA TEC Corporation TECCashDrawer Keylock PKBST5x TOSHIBA TEC Corporation TECKeylock Scanner HS530RS TOSHIBA TEC Corporation TECScanner MSR MSRPKBST 5x TOSHIBA TEC Corporation TECMSR Scanner HS530RSEx TOSHIBA TEC Corporation TECScannerEx Click on the PKBST 52 node under the Keylock node B 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program v 001 003 E 3 Bas POS D El TESI i evice Entry be e Faf Information o re a mm Line Display z P Cash Drawer D iButton Q Eest POS Printer li sp Scanner o gt Keylock Internal External Result CheckHealthText Click on the Interactive button at the right Keylock 38 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL B 3 Installation of keylock Keylock Interactive CheckHealth KeyPosition Information Position Number 8 Position Count 8 When the above window appears change key position To exit click on the OK or NG button B 4 Display of result JPOS Check Health Application Check Health Program v 001 003 TESI POS Device Entry Keylock a Ez Informat
18. Display Internal External Result CheckHealthText Click on the Interactive button at the right 43 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A LineDisplay D o Display of LineDisplay Line Display Interactive CheckHealth There are the following two CheckHealth functions for LineDisplay Indicates ANK Code Click on the Indicates ANK Code button at the upper left and the same content displayed in the two boxes on the right side of the button is also displayed on the line display device Indicates Descriptors Click on the Indicates Descriptors button at the centre left and a descriptor is displayed in the line display device at a location indicated by the value in the box on the right side of the button 44 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A LineDisplay D4 Display of result JPOS Check Health Application Check Health Program v 001 003 TEEI POS Device Entry a ws amp EA information o SS usp mm Line Display e3 O kusta C iust a10 A a p Cash Drawer gt Gay Kevlock mm 7 Scanner La y POS Printer LineDisplay Internal External Interactive Result SUCCESS CheckHealthText Interactive HCheck Successful A value is displayed i
19. ED10SP1 folder in this Kit e load_usbibutton e usbibutton ko Source file modification of the kernel attached driver Modify two places of the dscore c file as follows Execute this procedure when using the iButton driver developed by TTEC Target source file e usr src linux drivers w1 dscore c Contents of modification 1 the 556th line from the top Before Modification if 0 int ds_search struct ds_device dev u64 init u64 buf u8 id_number int conditional_ search snip int ds_match_access struct ds_device dev u64 init 17 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved After Modification if O int ds_search struct ds_device dev u64 init u64 buf u8 id_number int conditional_ search snip if 0 int ds_match_access struct ds_device dev u64 init 2 the 789th line from the top Before Modification if 0 EXPORT_SYMBOL ds_ start_pulse EXPORT_SYMBOL ds_set_speed EXPORT_SYMBOL ds_ detect EXPORT_SYMBOL ds_stop_pulse EXPORT_SYMBOL ds_ search endif After Modification if O EXPORT_SYMBOL ds_ start_pulse EXPORT_SYMBOL ds_set_speed EXPORT_SYMBOL ds_ detect EXPORT_SYMBOL ds_stop_pulse endif EXPORT_SYMBOL ds_ search H endif 18 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved Rebuild a kernel after these two procedures are completed Cautions Rebuild a kernel takes se
20. IBA TEC Corporation TECScanner MSR MSRPKBST 5x TOSHIBA TEC Corporation TECMSR Scanner HS530RSEx TOSHIBA TEC Corporation TECScannerEx Click on the iButton node under the Keylock node A 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program v 001 003 BESI POS Device Entry pes a KA Information ic o a MSR E mm Line Display z E Cash Drawer Keylock D iButton DB pkestsx eR POS Printer i f Scanner Keylock Internal External Interactive Result CheckHealthText Click on the Interactive button at the right iButton 35 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL i A 3 iButton A 3 Installation of iButton Keylock Interactive CheckHealth Electronic Key Value Family Code Serial Number CRC Code When the above window appears make the iButton touch to the button contacts A 4 Display of iButton data Keylock Interactive CheckHealth Electronic Key Value Family Code 01 Serial Number 000000532649 CRC Code FA The text boxes in the window show data stored in the iButton To exit click on the OK or NG button 36 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL
21. J a v a P OSD r i v e r OPERATION MANUAL This JavaPOS Driver Kit OPERATION MANUAL hereinafter referred to as the GUIDE describes the procedures and precautions for using the JavaPOS Driver Kit hereinafter referred to as the Kit The GUIDE assumes that the reader is familiar with the following e General characteristics of POS peripheral devices e Java terminology and architecture e Java for Retail POS JavaPOS for short Programmer s Guide Notes e It is prohibited to use or duplicate a part or whole of the GUIDE without the permission of Toshiba TEC Corporation e The GUIDE is subject to change without prior notice Windows and Windows XP are registered trademarks of Microsoft Corporation in the United States and or other countries The official name of Windows is the Microsoft Windows Operating System Java and JavaPOS are trademarks of Sun Microsystems in the United States and or other countries 2 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved DOVER OCUULEC EN OU us sesso esis senor ececeeneooca canine tees ese ape ees 4 Overview or the MANUAL vi sisina niinen e iwc vaweu eae teat in E G 4 1 How to Build An Operating Environment ccsssssssssssssssseseceessersrenseeeseneeseaees 5 SUppOrted PrOduCh s r ei iso e oes eae ee eek ee ade ee S 5 Operating ENVIFONIMENE ovissa saaa aa ed etree EEEa E aaa aE AES 5 S pported DEVICES areren erre eve dervesvanclodredeare
22. PERATION MANUAL 3 Permission to add registry Registry Editor 2 4re you sure you want to add the information in key reg to the registry A confirmation window appears Click on the Yes button 4 Result of registry addition Registry Editor e 1 Information in key reg has been successfully entered into the registry When the registry has been successfully added the window shown above appears Click on the OK button 5 Confirmation of installation Mice and other pointing devices M E Network adapters Ei 4 Other devices 19 Ports COM amp LPT Processors Sound video and game controllers See Storage volumes System devices TEC Bulk amp Interrupt USB Device amp Toshiba TEC USB POSKeyboard IDCR Keylock amp Universal Serial Bus controllers Start the Device Manager and check that the Keyboard Filter driver has been successfully installed Then open the system32 folder C WINDOWS system32 and make sure that TECPKBFilterJNI dll has been copied 27 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Windows Vista When you install this driver on Windows Vista you have to execute exceptional steps Please follow the below 1 Run Command Prompt as Administrator Right Click cmd file in the Windows gt system32 folder and select Run as Administrator 2 Run BAT
23. SBJNLdll Destination to save Description Available from libTECUSBJNI so 0 0 Destination to save Description Available from C Windows system32 or C WINNT system32 Library of TECUSB driver for Windows This Kit Click on Driver gt TECUSB Driver gt Windows C Windows system32 or C WINNT system32 Library of TECUSB driver for Windows This Kit Click on Driver gt TECUSB Driver gt Windows Root directory of project Library of TECUSB driver for Linux Make a link file called libtecusb so and use it Ex J In s libtecusb so 0 0 __libtecusb so This Kit Click on Driver gt TECUSB Driver gt Linux gt Driver C Windows system32 or C WINNT system32 In case of Vista root directory of project An USB power management process for Windows It is nesessary to use TRST A1x U on Windows This Kit Click on Driver gt TECUSB Driver gt Windows C Windows system32 or C WINNT system32 An application programming interface API to be used to access the Windows TECUSB driver from Java This Kit Click on Driver gt TECUSB Driver gt Windows Root directory of project An application programming interface API to be used to access the Linux Make a link file called libTECUSBJNI so and use it Ex In s libTECUSBJNI so 0 0 libTECUSBJNI so This Kit Click on Driver gt TECUS
24. Serial so file is necessary to use this library This Kit Click on TEC RXTX Parallel Library Source It is bundled with rxtxParallel zip C Windows system32 or C WINNT system32 An application programming interface API to be used to access the Windows CashDrawer driver from Java This Kit Click on Driver gt Cash Drawer Driver gt Windows lib TECCashDrawerJni so 0 0 Destination to save Description Available from libTECiButtonJni so Destination to save Description Available from Root directory of project An application programming interface API to be used to access the Linux Make a link file called libTECCashDrawerJni so and use it Ex In s libTECCashDrawerJni so 0 0 libTECCashDrawerJni so This Kit Click on Driver gt Cash Drawer Driver gt Linux gt JNI Root directory of project An application programming interface API to be used to access the Linux iButton driver from Java This Kit Click on Driver gt Linux iButton Driver gt JNI 61 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved TECUSB dIl Destination to save Description Available from LogMngr dll Destination to save Description Available from libtecusb so 0 0 Destination to save Description Available from TECUSBPM exe Destination to save Description Available from TECU
25. TECKeylock Scanner HS530RS TOSHIBA TEC Corporation TECScanner MSR MSRPKBST 5x TOSHIBA TEC Corporation TECMSR Scanner HS530RSEx TOSHIBA TEC Corporation TECScannerEx Click on the MCRST A10 node under the MSR node E 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program v 001 003 Eg POS Device Entry ie g A Information MSR MCRST A10 MSRTFTST 76 MSRPKBST 5x Line Display Cash Drawer ges Kevlock ig Scanner POS Printer MSR Internal External Result CheckHealthText Click on the Interactive button at the right MSR 46 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A MSR E 3 Startup of card data read mode MSR Interactive CheckHealth Can t Read Data now Can t Read Data now Can t Read Data now Track4 Can t Read Data now Ln Click on the Start button E 4 Read of card data MSR Interactive CheckHealth Result Please swipe Card Tracki Waiting Track2 Waiting Track3 Waiting Track4 Waiting Len A message Waiting is displayed in the text boxes Swipe a card 47 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL lt Reading succeeded gt MSR Intera
26. There are the following two value combinations e When a reading operation in Step F 3 did not fail even once Result SUCCESS CheckHealthText Interactive Hcheck Successful e When a reading operation in Step F 3 failed at least once Result SUCCESS CheckHealthText Interactive Hcheck Error 52 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL G 1 PosPrinter panel display JPOS Check Health Application Check Health Program v 001 003 Brg POS Device Entry a Information o eae SR gt WM Display a pe E Cash Drawer o any Keylock Config Vender Product Name Category LogiclaName MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay _ LIUST 53 TOSHIBA TEC Corporation ITECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer TRSTA1 U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay _ LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWSTSOEx TOSHIBA TEC Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer DRWST50 TOSHIBA TEC Corporation TECCashDrawer TOSHIBA TEC Corporation TECKeylock TOSHIBA TEC Corporation TECScanner POSPrinter T Keylock PKBST5x Scanne
27. ader Available fromforge net downloads S A Any location A library file to access an image file To be imported when creating an application jimi1_0 zip on the web site http java sun com products jimi Root directory of project A library file to access a serial port under Windows rxtx 2 1 7 bins r2 zip on the web site http rxtx qbang org pub rxtx or http users frii com jarvi rxtx download htm Root directory of project A library file used to access a serial port under Linux rxtx 2 1 7 bins r2 zip on the web site http rxtx qbang org pub rxtx or http users frii com jarvi rxtx download html 60 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved rxtxParallel dll Destination to save Description Available from librxtxParallel so Destination to save Description Available from TECCashDrawerJni dll Destination to save Description Available from Root directory of project A library file used to access a parallel port under Windows This is a RXTX parallel library customized by TTEC It is based on rxtx 2 1 7 LGPL rxtxSerial dll file is necessary to use this library This Kit Click on TEC RXTX Parallel Library Source It is bundled with rxtxParallel zip Root directory of project A library file used to access a parallel port under Linux This is a RXTX parallel library customized by TTEC It is based on rxtx 2 1 7 LGPL librxtx
28. ake sure that TECCashDrawerJni dll has been copied When you install this driver on Windows Vista you have to execute exceptional steps Please follow the below 1 Copy files Copy the following file to particular place DRVDRW sys C OPOS TEC SYS DRW INF C OPOS TEC SYS install exe C OPOS TEC SYS TECCashDrawerJni dll C Windows system32 2 Add Hardware Select Add Hardware icon in Control Pane lanel Home ew alas alia nstalls legacy non PI 9 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Click Next button Welcome to the Add Hardware Wizard This wizard helps you install driver software to support older devices that do not support Plug and Play and which are not automatically recognized by Windows You should only use this wizard if you are an advanced user or you have been directed here by technical support amp if your hardware came with an installation CD it is recommended that you click Cancel to close this wizard and use the manufacturer s CD to install this hardware To continue click Next The wizard can help you install other hardware The wizard can search for other hardware and automatically install it for you Or f you know exactly which hardware model you want to install you can select it from a list What do you want the wizard to do Search for and
29. art installing your new hardware click Next 3 Registry addition Execute ST A10drw reg or ST A20drw reg to add registry 11 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL lt Linux SLED10SP1 and SLED11 gt 1 Copy of driver module Select Driver gt CashDrawer Driver gt Linux gt Driver gt SLED10SP1 or SLED11 Please select OS used Copy the drw ko driver module to any desired location drw ko is a CashDrawer driver which runs on Linux libTECCashDrawerJni so 0 0 in JNI folder is a library file which is used to access LinuxCashDrawerDriver from Java 2 Installation of CashDrawer driver ST A10 insmod home tec tecdrv drw ko mknod dev drw c 242 0 Execute the above commands to install the driver The above is an example when drw ko has been copied to home tec tecdrv ST A20 insmod home tec tecdrv drw ko port 0x48C mknod dev drw c 242 0 Execute the above commands to install the driver The above is an example when drw ko has been copied to home tec tecdrv The shaded value is the ST A20 drawer port address As the port address differs for each model please check it with the specifications of each model The 1st line installs the module and the 2nd line creates a device file 2 This setup is cleared whenever the operating system is re
30. avaPOS Device Service to be used to develop an application for key lock Keylock cash drawer Drawer magnetic stripe reader MSR line display LineDisplay scanner Scanner and POS printer POSPrinter Overview of the MANUAL The GUIDE consists of the following three steps and explains the demo program enclosed in the Kit Please follow the steps below Step 1 How to Build An Operating Environment This step describes the method to build an environment for using the JavaPOS Device Service Step 2 How to Check Performance of the JavaPOS Device Service This step describes the method to test whether or not the test program for checking performance of the JavaPOS Device Service CheckHealth jar successfully runs Step 3 How to Use The JavaPOS Device Service This step describes the method to create a unique application using the JavaPOS Device Service Keylock Drawer MSR LineDisplay Scanner POSPrinter Example of Creating An Application Using the JavaPOS Device Service This chapter explains the method to operate the JavaPOS Device Service using an example The demo program described here is a sample code which uses the JavaPOS Device Service to create the application 4 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A 1 How to Build An Operating Environment This chapter describes the method to build an environment where the JavaPOS Device Service opera
31. awerPanel public DrawerPanel initComponents drawer new CashDrawer e Import Jpos e Specify a variable for CashDrawer type for example drawer e By specifying new create a Device Control object To receive events implement events which are defined by each device For details of implementation refer to Supplemental Explanation 2 Receipt of events 64 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 2 Enable a device drawer open LOGICALNAME drawer claim 100 drawer setDeviceEnabled true e Open a device by specifying a device logical name e Set a timeout and perform an exclusive process e Set the DeviceEnabled property to TRUE 4 Specify a logical device name for LOGICALNAME 2 For devices which do not perform an exclusive processing no claim handlings are required 3 For the claim handling specify a timeout period in milliseconds in the round brackets as argument 3 Call to a device specific method and get a property Bool status drawer openDrawer status drawer getOpened e Define a variable to get a status e By calling to the CashDrawer specific method a cash drawer opens e Astatus is obtained 4 Device specific methods differ for each device For details please refer to the Application User Manual of each Device Service 2 Get method and Set method differ for each property
32. bes the major setup items For details of the setup method please refer to the Application User Manual of each JavaPOS Device Service 57 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved e lt JposEntry logicalName DefaultDisplay value 0 gt A description to set a logical device name Change the shaded area e lt prop name portName type String value COM4 gt A description to set COM ports of a device Change the shaded area e lt prop name baudRate type String value 9600 gt A description to set baud rate of a device Change the shaded area k 2Defference in descriptions between Windows and Linux As for portName COMX is used for Windows and dev ttySX is used for Linux X serial port no Note that COMX starts from 1 while dev ttySX starts from 0 Windows Linux value COM1 value dev ttyS0 value COM2 value dev ttyS1 value value log4j xml Destination to save Root directory of project Description A setup file for a log to be output To be copied in the directory where the execution file exists The following focuses on the major setup items descried in the file Please create your own file e lt param name file value log ST A20 log gt A description to set a file name of log to be output e lt priority value info gt A description to set a log level Fatal Fatal error error Error warn Warning info Information debug De
33. booted This command must be executed every time the operating system is rebooted 12 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 3 Confirmation of install J Ismod Execute the above command to make sure the driver has been successfully installed 4 Generation of link file Select Driver gt CashDrawer Driver gt Linux gt JNI Copy the libTECCashDrawerJni so 0 0 to the location you want to run the program Then generate a link file 13 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved Patch application to Keyboard Driver lt Linux SLED10 SP1 gt The source file of a keyboard driver is rewritten using tec_kbd 2 6 11 patch file e usr src linux drivers input keyboard atkbd c e usr src linux drivers input serio i8042 c e usr src linux drivers char keyboard 1 Copy files Copy the following files to home tec tecdrv from Driver gt Linux Keyboard patch gt SLED10SP1 folder in this Kit e tec_kbd 2 6 11 patch Execute the following command Then a patch is applied and a source file can be rewritten cp p home tec tecdrv tec_kbd 2 6 11 patch usr src linux cd usr src linux patch p0 lt tec_kbd 2 6 11 patch Rebuild a kernel after these two procedures are completed Cautions Rebuild a kernel takes several hours 2 Rebuild the kernel Execute the
34. bug trace Trace Log4j dtd Destination to save Root directory of project Description A file to define XML tags To be copied in the directory where the execution file exists Please create your own file 58 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL fan log4j 1 2 12 jar Destination to save Description Available from commons logging jar Destination to save Description Available from RXTXcomm jar Destination to save Description Available from swing layout 1 0 3 jar Destination to save Description Available from xerces Impl jar Destination to save Description Available from Any location A library file to output a log As with JavaPOS DeviceService this file must be imported in a project logging log4j 1 2 12 zip on the web site http archive apache org dist logging log4j 1 2 12 or http logging apache org Any location A library file to output a log To be imported when creating an application commons logging 1 0 4 zip on the web site http archive apache org dist commons logging binaries or http commons apache org logging Any location A library file to access a Device which uses a COM component object model To be imported when creating an application rxtx 2 1 7 bins r2 zip on the web site http rxtx qbang org pub rxtx or http users frii com jarvi rxtx do
35. compatible Driver lt Linux SLED10SP1 and SLED11 gt If a keyboard compatible driver is installed setkeycodes command can be executed even when a PS 2 keyboard has not been connected Note Restarting the operating system clears this setting The procedure must be performed whenever the operating system is restarted Note It is necessary to execute this procedure ahead of the procedure since 3 3 1 Copy files Copy the following files to home tec tecdrv from Driver gt Linux compat kbd gt SLED10SP1 or SLED11 Please select OS used folder in this Kit e compat_keyb ko Execute the following command to install a Keyboard compatible driver 4 This setup is cleared whenever the operating system is rebooted This command must be executed every time the operating system is rebooted insmod home tec tecdrv compat_keyb ko 16 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL fa Installation of iButton Driver lt Windows gt Download the file from the following web site and implement the 1 Wire Drivers http japan maxim ic com products ibutton software tmex index cfm lt Linux SLED10SP1 gt It is a required setup when using the iButton driver Execute this procedure in advance Copy files Copy the following files to nome tec tecdrv from Driver gt Linux iButton Driver gt Driver gt SL
36. ctive CheckHealth Result Track1 Track2 Tracks Track4 To exit click on the Fin button Please swipe Card OK OK OK n E 5 Display of result JPOS Check Health Application Check Health Program v 001 003 Pps POS Device Entry m o EA Information P lamy MSR C MeRST A10 C MSRTFTST 76 C MSRPKBST 5x mm Line Display e o oe oe s Cash Drawer Eey Keylock lt f Scanner lt POS Printer lt Reading failed gt MSR Interactive CheckHealth Start Result Please swipe Card Track1 Track2 Tracks Track4 MSR Internal External Interactive Result SUCCESS CheckHealthText Interactive HCheck Successful Values displayed in the Result and CheckHealth Text boxes differ depending on the reading result There are the following two value combinations 48 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A e When a reading operation in Step E 4 did not fail even once Result SUCCESS CheckHealthText Interactive Hcheck Successful e When a reading operation in Step E 4 failed at least once Result SUCCESS CheckHealthText Interactive Hcheck Error 49 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL F 1 Scanner panel display JPOS Check Health Application Line Display
37. device 2 Device enable button Performs a process required to enable the device Specifically performs Open and Claim then set the DeviceEnabled property to TRUE 3 Device disable button Performs a process required to disable the device Specifically set the DeviceEnabled property to FALSE and then performs Release and Close 68 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 4 Calls to a method to operate a device Calls to a device specific device to operate a device This example calls a drawerOpened property to explain the case of CashDrawer 5 Property status label A label is to display property information This example displays the drawerOpened property to explain the case of CashDrawer 69 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved
38. hen using the xml files compile all xml files into one file and name it jpos xml lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE JposEntries PUBLIC JavaPOS DTD EN jpos res jcl dtd gt lt JposEntry logicalName DefaultDisplay gt lt creation factoryClass jpos toshibatec linedisplay loader JavaPOSServiceFactory serviceClass jpos toshibatec linedisplay services LineDisplayService gt lt vendor name TOSHIBA TEC Corporation url http www toshibatec co jp gt lt jpos category LineDisplay version 1 11 gt lt product description TEC LUIST 51 Serial Line Display name TECLineDisplay url http www toshibatec co jp gt lt Other non JavaPOS required property mostly vendor properties and bus specific properties i e RS232 gt lt prop name portName type String value COM4 gt lt prop name countryCode type String value 3 gt lt prop name dataBits type String value 8 gt lt prop name parity type String value None gt lt prop name modelName type String value LIUST 51 gt lt prop name flowControl type String value Xon Xoff gt lt prop name stopBits type String value 1 gt lt prop name deviceBus type String value RS232 gt lt prop name baudRate type String value 9600 gt lt JposEntry gt lt JposEntries gt Descriptions for other devices lt JposEntry gt lt JposEntries gt The following descri
39. ight C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 3 Installation of TRST A1x TECUSB driver Connect TRST A1x by USB and turn on a power supply The following dialogue is displayed Found New Hardware Wizard Welcome to the Found New Hardware Wizard Windows will search for current and updated software by looking on your computer on the hardware installation CD or on the Windows Update Web site with your permission Read our privacy policy Can Windows connect to Windows Update to search for software O Yes this time only every time connect a device Click Next to continue Choose No not this time Click on the Next gt button Found New Hardware Wizard This wizard helps you install software for TEC TRST A15 USB POS Printer F f 9 If your hardware came with an installation CD Z or floppy disk insert it now What do you want the wizard to do O Install the software automatically Recommended Install from a list or specific location Advanced Click Next to continue Choose Install from a list or specific location Advanced Click on the Next gt button 22 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Found New Hardware Wizard Please choose your search and installation options Ot Ss Search for the best driver in the
40. indow appears Click on the Yes button 4 Result of registry addition Registry Editor Lb Information in DRW REG has been successfuly entered into the registry a When the registry has been successfully added the window shown above appears Click on the OK button 5 Permission to install the driver Hardware Installation The software you ace instaling for this hardware TOSHIBA TEC DRAWER Driver has not passed Windows Logo testing to verily Rs compatibilty with Windows XP Led me why this testing is important Continuing your installation of this software may impair os destabilize the conect operation of your system either immediately or in the future Microsoft strongly When the window shown above appears click on the Continue Anyway button 8 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL 6 Confirmation of installation F Display 4 Floppy disk controllers ky Human Interface Devices IDE ATAJATAPI controllers gt Keyboards TS Mice and other pointing devices coe S Monitors E Network adapters 6 A Other devices i TOSHIBA TEC DRAWER Driver Y Ports COM amp LPT 8 Processors Sound video and game controllers lt Storage volumes Hg ag at Start the Device Manager and check that the CashDrawer driver has been successfully installed Then open the system32 folder C WINDOWS system32 and m
41. ine Display par g ee Cash Drawer lt 3 Result gt esp Kevlock k A sa success e S Pos pine CheckHealthText O TRSTAIxU C TRSTAIxS o Interactive HCheck Successfull A value is displayed in the Result box and the CheckHealth Text box Either of the following two value combinations will be displayed in these boxes e When exited with the OK button in Step G 3 Result SUCCESS CheckHealthText Interactive Hcheck Successful e When exited with the NG button in Step G 3 Result SUCCESS CheckHealthText Interactive Hcheck Error 54 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL a 3 How to Use the JavaPOS Device Service This chapter describes the setups required to use the JavaPOS Device Service assuming that the operating environment described in Chapter 1 has been built up Required files In order to use the JavaPOS Device Service provided by the Kit the following files are required besides the library file 4 9 3 4 5 6 7 jpos111 jar jpos xml log4j xml log4j dtd log4j 1 2 12 jar commons logging jar RXTXcomm jar swing layout 1 0 3 jar xerces Impl jar xml apis jar jcl_editor jar rxtxSerial dll 1 librxtxSerial so 2 rxtxParallel dlle1 librxtxParallel so 2 TECCashDrawerJni dll 3 libT ECCashDrawerJni so 4 lib TECiButtonJni so s JimiProClasses jar TECUSB dll 6
42. install the hardware automatically Recommended Install the hardware that manually select from a list Advanced Select Show All Devices then Click Next button From the list below select the type of hardware you are installing if you do not see the hardware category you want click Show All Devices Common hardware types Ea IDE ATA ATAPI controllers dep JEEE 1284 4 compatible printer MBB JEEE 1284 4 devices q IEEE 1394 Bus host controllers z Imaging devices F Infrared devices MB niais Canter Etandar 10 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Click Have Disk button Select the device driver you want to install for this hardware Select the manufacturer and model of your hardware device and then click Next f you have a disk that contains the driver you want to install click Have Disk Retrieving a list of all devices Click Browse button and select DRW INF file in the C OPOS TEC SYS folder Insert the manufacturer s installation disk and then ox make sure that the correct drive is selected below Copy manufacturer s files from ne h Click Next button Finally click Finish button to finish the hardware addition The wizard is ready to install your hardware Hardware to install H TOSHIBA TEC DRAWER Driver To st
43. ion MSR 7 Internal External Interactive Sh Liu Line Display o Cash Drawer g roo Result C iButton success PKBST5x BA eorne CheckHealthText S gt POS Printer interactive HCheck Successful A value is displayed in the Result box and the CheckHealthText Text box Either of the following two value combinations will be displayed in these boxes e When exited with the OK button in Step B 4 Result SUCCESS CheckHealthText Interactive Hcheck Successful e When exited with the NG button in Step B 4 Result SUCCESS CheckHealthText Interactive Hcheck Error Keylock 39 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL C 1 Drawer panel display JPOS Check Health Application Config Vender Product Name Category LogiclaName MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay LIUST 53 TOSHIBA TEC Corporation TECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer _ TRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer f Cash Drawer LineDisplay LIUST A10 TOSHIBA TEC Corporation TECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR mee S Cash brawl CashDrawer DRWST50Ex TOSHIBA TEC Corporation TECCashDrawerEx J TRSTAIU_CashDraw Keylock iButton
44. l the driver The above is an example when usbposkbd ko has been copied to home tec tecdrv 2 Keycode configuration MCR setkeycodes 0x61 121 Keylock setkeycodes 0x63 123 29 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A 2 How to Check Performance of the JavaPOS Device Service This chapter describes the method to check performance of the JavaPOS Device Service assuming that the operating environment described in Chapter 1 has been built up Here the setup method is referred to as PREPARE and the operation method of the Device Health Check Program as OPERATION In this chapter the device health check method is explained for the following devices e LineDisplay e Keylock e CashDrawer e MSR e Scanner e POSPrinter PREPARE Copy of Device Health Check Program modules at Windows CashDrawer Driver RelNote pdf Adobe Acrobat Document 142 KB Adobe 410 0900 001 Open the Kit CD then copy the Device Health Check Program folder to a desired location in the local computer j The subsequent procedures are separately explained for Windows and Linux below 30 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL lt Windows gt Change of setup file name jpos xml librxtxSerial so libTECCash xml t rxtx5efial dll Change the na
45. me of the Windows_jpos xml file in the Device Health Check Program folder to jpos xml lt Linux gt 1 Change of setup file name CheackHealth sh lt Linux_jpos xml Change the name of the Linux_jpos xml file in the Device Health Check Program folder to jpos xml 31 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved 2 Grant of execute authority chmod 775 home tec Device Health Check Program CheackHealth sh Execute the above command to grant the CheackHealth sh file an execute authority The above is an example when the Device Health Check Program folder has been copied to home tec 3 Generation of CashDrawerJni link file In s home tec Device Health Check Program libTECCashDrawerJni so 0 0 home tec Device Health Check Program libTECCashDrawerJni so Execute the above command to generate link file The above command is needed to use drawer driver 4 Generation of PKBFilterJNI link file In s home tec Device Health Check Program libTECPKBFilterJNI so 0 0 home tec Device Health Check Program libTECPKBFilterJNI so 5 Generation of TECUSBUJNI link file In s home tec Device Health Check Program libTECUSBJNI so 0 0 home tec Device Health Check Program libTECUSBJNI so 6 Generation of TECUSB link file In s home tec Device Health Check Program libtecusb so 0 0 home tec Device Health Check Program libtecusb so 32 Copyright C 2008 201
46. n copied to home tec tecdrv 3 Confirmation of install J Ismod Execute the above command to make sure the driver has been successfully installed 4 Installation of library j cp p home tec tecdrv libtecusb so 0 0 usr lib j ldconfig n usr lib j In s usr lib libtecusb so 0 0 usr lib libtecusb so Execute the above commands to install the library The above is an example when libtecusb so 0 0 has been copied to home tec tecdrv 25 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved Installation of Keyboard Driver lt Windows USB gt Before this installation execute Installation of TECUSB procedure Windows 2000 XP and WEPOS 1 Startup of driver setup batch file LogMner dll TECPKBFilt Select Driver gt Keyboard Driver gt Windows and then double click on the BAT file to execute Windows 2000 USB_W2K_SETUP BAT Windows XP WEPOS USB_XP_WEPOS_Vista_SETUP BAT 2 Start of installation cx C WINDOWS system32 cmd exe C Documents and Settings TTEC Desktop Windows gt echo off Wddsssssshstshidhssssssssssstshsshhsssshsdssssssssssssssssad Drawer Driver Setup Wdhssssssssssssssssssssssssssshsssdsssssssssssssssssssisssad Installation of a drawer driver Press any key to continue m Press any key to start the installation 26 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit O
47. n the Result box and the CheckHealthText Text box Either of the following two value combinations will be displayed in these boxes e When exited with the OK button in Step D 3 Result SUCCESS CheckHealthText Interactive Hcheck Successful e When exited with the NG button in Step D 3 Result SUCCESS CheckHealthText Interactive Hcheck Error 45 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL E 1 MSR panel display JPOS Check Health Application a C MSRTFTST 76 MSRPKBST 5x o mm Line Display ee br f Cash Drawer o eee Keylock im 7 E kA Scanner yy POS Printer Config Category LogiclaName vender Product Name MSR MCRST A10 TOSHIBA TEC Corporation TECMSR LineDisplay LIUST 53 TOSHIBA TEC Corporation TECLineDisplay CashDrawer TRSTA1S_CashDrawer TOSHIBA TEC Corporation TECCashDrawer CashDrawer ITRSTA1U_CashDrawer TOSHIBA TEC Corporation TECCashDrawer LineDisplay LIUST A10 TOSHIBA TEC Corporation ITECLineDisplay MSR MSRTFTST 76 TOSHIBA TEC Corporation TECMSR CashDrawer DRWST50Ex TOSHIBA TEC Corporation TECCashDrawerEx Keylock iButton TOSHIBA TEC Corporation TECKeylock CashDrawer DRWST50 TOSHIBA TEC Corporation TECCashDrawer Keylock PKBST5x TOSHIBA TEC Corporation
48. r HS530RS MSR MSRPKBST 5x ik Scanner HS530RSEx D TRsTaAtxs TOSHIBA TEC Corporation TECMSR TOSHIBA TEC Corporation TECScannerEx Click on a node under the POSPrinter node POSPrinter has the following nine kinds e TRSTA1P e TRSTAxS TRSTA1S or TRSTAOOS e TRSTAXU x TRSTA1U QM TRSTA1U CN or TRSTAOOU e TRSTA1LX TRSTA1L1 TRSTA1L2 or TRSTA1L3 G 2 Call to the Interactive Check Health method JPOS Check Health Application Check Health Program v 001 003 BR Device Entry POS P ri n te r 5 F Information o MSR Internal External Line Displ mm ine Display Result gt gj Kevlock m o Qf earner e S Pos printer CheckHealthText D TRSTA1xU j C TRSTAIxS i Click on the Interactive button at the right 53 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A POSPrinter G 3 Execute of Print POS Printer Interactive checkHealth X Command Print ASCII Code Feed Cut Bitmap Dual Side Print Printer Status When the above window appears execute each function x To exit click on the OK or NG button G 4 Display of result JPOS Check Health Application Check Health Program v 001 003 grow POSPrinter S E information 2 my OR Internal External Interactive g mm L
49. se locations Use the check boxes below to limit or expand the default search which includes local paths and removable media The best driver found will be installed C Search removable media floppy CD ROM Include this location in the search C ATECUSB Driversindows Don t search will choose the driver to install Choose this option to select the device driver from a list Windows does not guarantee that the driver you choose will be the best match for your hardware Exclude a check box of Search removable media floppy CD ROM Choose check box of Include this location in the search Click on the Browse button And appoint a folder with the TecUSBDEx INF file Click on the Next gt button Found New Hardware Wizard Please wait while the wizard installs the software Toshiba TEC TRST 41x USB POS Printer te z Setting a system restore point and backing up old files in case your system needs to be restored in the future Cancel The installation of the TECUSB driver is started 23 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for Toshiba TEC TRST A1x USB POS Printer Click Finish to close the wizard Back Canc If an above screen is displayed
50. t status CashDrawer interactive CheckHealth The drawer opens and a message OPEN is displayed on the Drawer Status box at the upper right in the window on the screen To exit click on the OK or NG button 41 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A CashDrawer C5 Display of result JPOS Check Health Application Check Health Program v 001 003 POS Device Entry 9 gt Erd Information oS usr P Internal External Interactive amp mm Line Display pan oy Cash Drawer Drawer imemisicacroaw Result C TRSTAIU_CashDraw LT DRWST50Ex CheckHealthText Sj Awi Interactive HCheck Successful v Scanner y POS Printer SUCCESS A value is displayed in the Result box and the CheckHealthText Text box Either of the following two value combinations will be displayed in these boxes e When exited with the OK button in Step C 4 Result SUCCESS CheckHealthText Interactive Hcheck Successful e When exited with the NG button in Step C 4 Result SUCCESS CheckHealthText Interactive Hcheck Error 42 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL D 1 LineDisplay panel display JPOS Check Health Application g Er Information o Wor am Line Display cS LIUST A10
51. t thei deletes eae dened PEAS a TAEA Tina 5 Installation of Java Runtime Environment ccccccceceeeceteceeeeeceeeeteeeeseedeeeeuenearens 6 Installation of Drawer Drivef s ssiriiea sisii ipie n anenetacese duce ENARA EE KEARN aAa 7 Patch application to Keyboard Driver ccccccsseceseeseeeseseeceeeseneeseeseeesneneaees 14 Installation of the Linux Keyboard compatible Driver cccececeeeeeeeee teens ee es 16 Installation Of iButton DIIVEP prisio gea otn tecc dss eu kedv awe coc sein beeen weeds coda wane Saves 17 Installation of TECWSB ce esses ceeds n EEE OE aE E A EEA AESA coated ex ibaa 21 Installation of Keyboard Driver 31 ccesieess oni cee wie ares ee 26 2 How to Check Performance of the JavaPOS Device Service 30 PREPARE AU 2s ods oa 100 a Set E Sel Sele E tN Otel ete 30 Default VAMC less ccgctavvdlecieseaadeeaedccesaungcbe sine ceus vaneesegaceardaiacegcka such ccuetecenaediees 33 OPERATION oeiia ste ieee Eea Ce EO hi NaN iter tade teen 34 3 How to Use the JavaPOS Device Service cscesecessessesesesesesesteteneneteteenineneees 55 Example of Creating An Application Using the JavaPOS Device Service 64 Coding Process seb scs recess sree cutee wee es eed esas ana Races ate ee en Reed eae ese 64 Creation of WINdOW sri ornidin E AEE ETNE dle Ru hans Ce SoS A te Na 68 3 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved Introduction The Kit JavaPOS Driver Kit provides the J
52. tes Please take this step Step 1 first then go to Step 2 Chapter 2 How to Check Performance of the JavaPOS Device Service or Step 3 Chapter 3 How to Use the JavaPOS Device Service Supported Product e ST A10 ST A10 does not support Linux OS e ST A20 Operating Environment Performance of the JavaPOS Device Service was checked under the following environment Operating system Windows 2000 Windows XP WEPOS Windows Vista SUSE Linux Enterprise Desktop 10 SP1 SUSE Linux Enterprise Desktop 11 none SP1 JavaRuntime JRE1 4 2 JavaPOS JavaPOS 1 11 Supported Devices Keylock gt KITST A10 BTNK gt PKBST 52 Keylock CashDrawer gt DRWST 5x Cash Drawer gt DRWST 5x Cash Drawer Extension gt Cash Drawer connected to TRST Axx LineDisplay gt LIUST A10 gt WD 111 MSR gt MCRST A10 gt PKBST 52 MSR MSR JavaPOS Device Service does not support MCRST 76 under Linux OS 5 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Scanner gt HS 530 RS Serial Barcode Scanner gt HS 530 RS Serial Barcode Scanner Extension Scanner JavaPOS Device Service does not support HS 530 RS under SLED11 POSPrinter TRST A10 S QM R TRST A10 P QM R TRST A10 U QM R TRST A10 L QM R TRST A15 S QM R TRST A10 P QM R TRST A15 U QM R TRST A10 S CN R TRST A10 P QM R TRST A10 U CN R TRST A15 S CN R TRST A10 P QM R TRST A15 U CN R TRST
53. this Kit e load_usbibutton e usbibutton ko Installation of module Before installing the USB iButton driver connect the USB iButton adapter 2 This setup is cleared whenever the operating system is rebooted This command must be executed every time the operating system is rebooted insmod home tec tecdrv compat_keyb ko cd home tec tecdrv chmod 777 load_usbibutton load_usbibutton setkeycodes 0x68 93 20 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL Installation of TECUSB lt Windows gt 1 Copy of driver module J C ATRST Alx JayaPOS TECUSB Driver PS sy spa ke a new folder alish this Folder to the Copy a TRST A1x JavaPOS TECUSB Driver Windows folder in the suitable place 2 Execute of Batch file Windows 2000 Windows XP WEPOS Carry out TECUSB_LIBRARY_SETUP BAT in the folder which stored by procedure 1 After practice the following file is copied by a folder of Windows system32 in the case of the Windows 2000 Winnt system32 e TECUSB dIl e LogMngr dll e TECUSBJNI dll e TECUSBPM exe Windows Vista In case of Windows Vista copy the following files to each directory manual operation Windows system32 directory e TECUSB dll e LogMngr dll e TECUSBUJNI dIl Root directory of project ex A folder same as CheckHealth bat e TECUSBPM exe 21 Copyr
54. veral hours 3 Rebuild the kernel Execute the following commands in order from the top cd usr src linux Movement to a directory with the source file of a kernel make oldconfig Obtains configuration information of the kernel in operation make clean Deletes all interim files make Complies the kernel and driver modules make install Installs the kernel make modules _install Installs the drivers When the touch panel driver provided by Elo TouchSystems has been installed dependency information among the touch panel modules will disappear Execute the following commands and register the dependency information again cd etc opt elo ser setup or etc opt elo install sh Finally restart the operating system Installation of module 4 Before installing the USB iButton driver connect the USB iButton adapter 2 This setup is cleared whenever the operating system is rebooted This command must be executed every time the operating system is rebooted insmod home tec tecdrv compat_keyb ko J cd home tec tecdrv chmod 777 load_usbibutton load_usbibutton setkeycodes 0x68 93 19 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL A lt Linux SLED11 gt Copy files Copy the following files to nome tec tecdrv from Driver gt Linux iButton Driver gt Driver gt SLED11 folder in
55. wnload html Any location A library file to use swing To be imported when creating an application swing layout 1 0 3 jar on the web site http java sun com products archive jfc 1 0 3 index html or http www sun com Any location A library file to convert into text or other XML format To be imported when creating an application Xerces J bin 2 9 0 zip on the web site http apache adcserver com ar xml xerces j or http xerces apache org 59 Copyright C 2008 2010 TOSHIBA TEC CORPORATION All Rights Reserved JavaPOS Driver Kit OPERATION MANUAL fan xml apis jar Destination to save Description Available from JposEntryEditor jar Destination to save Description Available from JimiProClasses jar Destination to save Description Available from rxtxSerial dll Destination to save Description Available from librxtxSerial so Destination to save Description Available from Any location A library file to convert into text or other XML format To be imported when creating an application Xerces J bin 2 9 0 zip on the web site http apache adcserver com ar xml xerces j or http xerces apache org Any location A library file to access an XML file To be imported when creating an application jcl2 2 0 zip on the web site http Availablefromforge net project showfiles php group id 128804 amp packag e id 141062 amp release_id 306139 or http jooslo

OPERATION MANUAL

Contents

Download Pdf Manuals

Related Search

Related Contents