EPSON JavaPOS ADK Version 1.11.14 Release Notes Seiko Epson Corporation Jan. 27, 2011 1. Outline EPSON JavaPOS ADK Version 1.11.14 has been released. Using this release, you can develop applications that are compatible with UnifiedPOS specification Ver 1.11. This release note contains information for multiple packages. Please refer to the information for the product you are installing. [EPSON JavaPOS ADK 1.11.14 Standard install] 2. Confirmed operating environment 3. Installation and uninstallation 4. JavaPOS 1.11.14 Standard install [EPSON JavaPOS ADK 1.11.13 TM-T88V only install] 2. Confirmed operating environment 3. Installation and uninstallation 5. JavaPOS 1.11.13 TM-T88V only install [EPSON JavaPOS ADK 1.11.13 TM-T20 only install] 2. Confirmed operating environment 3. Installation and uninstallation 6. JavaPOS 1.11.13 TM-T20 only install [EPSON JavaPOS ADK 1.11.14 TM-T81 only install] 2. Confirmed operating environment 3. Installation and uninstallation 7. JavaPOS 1.11.14 TM-T81 only install 2. Confirmed operating environment Operation of EPSON JavaPOS ADK has been confirmed in the following environment. (1) OS (Operating system) Windows 2000 Professional Service Pack 4 (32bit) Windows XP Professional Service Pack 3 (32bit) Windows Vista Service Pack 2 (32bit) Windows Vista Service Pack 2 (64bit) Windows Server 2008 Service Pack 2 (32bit) Windows Server 2008 Service Pack 2 (64bit) Windows 7 (32bit) Windows 7 (64bit) Windows Server 2008 R2 (64bit) Windows Embedded Standard (32bit) Windows Embedded Standard 7 (32bit) Windows Embedded Standard 7 (64bit) Red Hat Enterprise Linux 5.3 (32bit) Red Hat Enterprise Linux 5.3 (64bit) SuSE Linux Enterprise 11 (32bit) SuSE Linux Enterprise 11 (64bit) (English language only) (2) Java operating environment Java Standard Edition 6 Update 16 http://java.sun.com/javase/6/ (3) Serial port driver (Linux only) Java Communications API 2.0 This component is copied to the JavaPOS install folder by the JavaPOS installer. RXTX 2.0-5 http://www.rxtx.org/ (4) Imaging API Java Advanced Imaging 1.1.3 http://java.sun.com/products/java-media/jai/ 3. Installation and uninstallation Follow the procedures in "EPSON JavaPOS ADK Installation Guide" for installation and uninstallation. Note that cancelling or abruptly terminating the installer during file installation could put the system in a state where further installation cannot be completed. In order to install JavaPOS in this situation, use the "Forced Uninstall" option and then run the installer again. If the process is cancelled while the "Forced Uninstall" options is used, it's possible that the system remain in a state where further re-installation cannot be completed. In this case, use the "Forced Uninstall" option again. When running the installer on a system where JavaPOS was previously installed, it is necessary to install to the same location. If JavaPOS is installed to a different location, previous settings may inhibit correct operation. In order to install JavaPOS to a different location in this case, use the "Forced Uninstall" option to clear all previous settings before running the installer. 4. JavaPOS 1.11.14 Standard install 4.1 Supported devices and confirmed firmware versions Please refer to "SupportedDevicesList.txt" for details. 4.2 Special notes 4.2.1 Sample program - When you use the sample program, the Login ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : POSPrinter LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer MSR : MSR Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. Therefore, it does not guarantee the correct operations for all the settings of all the devices. - The step13 sample program of POSPrinter does not operate except Japanese environment. Please comment out from the 1291th line to the 1295th in operating this sample program. 4.2.2 Installation and uninstallation - When installing the software, create a folder with the name "epson\pos" in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\ProgramData Linux /var Temporary files and information files required by DeviceService operations are saved in this "epson\pos" directory. Do not delete this directory. - If you select "Custom" for the install type and execute installing, do not specify the root directory ("/") for a shortcut folder. The shortcut folder will not be created. (Linux Only) - For installation, a restart is required when the "msvcr71.dll" file is copied to or updated in the \WINDOWS\System32\ directory, or if a file to be installed by the installer is in use at install time. - For uninstallation, a restart is required when a file to be uninstalled by the uninstaller is in use at uninstall time. - Installer and Uninstaller were able to start for the second time. However, this action is not supported.(Linux only) - There is a known issue with the uninstaller following an upgrade installation where the uninstaller will be unable to remove all installation directories. For default installation directory locations, the "/opt/EpsonJavaPOS" directory will not be removed by the uninstaller on Linux systems; the "C:\Program Files\Epson\JavaPOS" and "C:\Program Files\Epson" directories will not be removed by the uninstaller on Windows systems. You can manually delete these directories after the uninstaller runs to completion. - If you select "Custom" for the install type and change the location where to install the services of JavaPOS, you cannot start up the CheckHealth tool from the shortcut of the CheckHealth tool created by the installer. In that case, follow the instructions below to correct the Shell script (or batch file) that is the basis of the shortcut. - After the uninstaller is finished in Red Hat Linux 9, it is possible that a dialog will appear with the message "Application "gnome-terminal" (process xxxx) has crashed due to a fatal error. (Aborted)". This is a known issue and does not affect the uninstallation of the ADK. - After installing on Linux, there may be a "java.lang.NullPointerException" error with the "RPMSpecFile" indicated in the installer log file (Details: "ERROR - There was a problem creating the RPM package. You may not be running as root or may not have installed RPM Builder correctly."). This is an RPM issue and does not affect the operation of the ADK. 1) Delete -jar option 2) Classpath setting Jar files that require setting for Classpath are as follows: CheckHealthTest.jar (in the same directory as the Shell script of the CheckHealth tool) jpos111.jar (in the directory where services of JavaPOS are installed) epsonupos.jar (in the directory where services of JavaPOS are installed) epsonupos.admin.jar (in the directory where services of JavaPOS are installed) epsonupos.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) epsonupos.trace.jar (in the directory where services of JavaPOS are installed) epsonupos.T88V.jar (in the directory where services of JavaPOS are installed) epsonupos.T20.jar (in the directory where services of JavaPOS are installed) pos.jar (in the directory where services of JavaPOS are installed) pos.v2.0001.jar (in the directory where services of JavaPOS are installed) uposcommon.jar (in the directory where services of JavaPOS are installed) uposcommon.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) xercesImpl.jar (in the directory where services of JavaPOS are installed) xml-apis.jar (in the directory where services of JavaPOS are installed) 3) Application class name The application class stored in the CheckHealthTest.jar file is "checkhealthtool.CheckHealthTool." - While it is possible to rollback to an older version with silent installation, this is not supported. Please only use the silent installer properties file with the version of the installer that was used to create it. 4.2.3 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 4.2.4 Serial communication Special notes on serial communication (Linux only) - Devices connected to serial ports can be controlled by serial port driver in JavaPOS. Such control is permitted only when you log on as root (as a default status). Use the following procedure to enable users, in addition to root, to control the devices. 1) Add a user to the group that the /var/lock directory belongs to. After opening a serial port, the serial port driver creates a lock file in the /var/lock directory. General users do not have authority to access this file using the default configuration. Therefore, users who want to use the serial port must be added to the group that this lock directory belongs to. To add a user to the group, edit the /etc/group file. The /var/lock directory belongs to the lock group. [Example on modifying the /etc/group file] The following example shows how to add a user "jpos" to the group by modifying the /etc/group file. Before modification After modification lock:x:54:lock lock:x:54:lock,jpos To add more users, use a comma "," to separate the names. The following example shows how to add another user "jpos2" in addition to "jpos". Before modification After modification lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) Restarting the PC Users in addition to root can now access the serial ports. 4.2.5 USB communication Special notes on usage of USB communication (Linux only) - Devices connected to USB ports can be controlled by USB port driver in JavaPOS. /dev/usb/usbtm* is used when JavaPOS with a USB connection access devices that can be accessed by any users. Set an appropriate access when necessary. - For SuSE Linux Enterprise 10 SP1, after installing the USB driver, open the "/etc/udev/rules.d/99-epson-usbtm.rules" file with a text editor and ensure that the rule reads as follows: KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" Two "=" signs are required after the word "KERNEL" for the USB driver to function properly. If only one "=" sign is present, add a second "=" sign and then save the file. This is required due to a change in the UDEV rule syntax in newer versions. - When a device is powered on, several seconds are required for the kernel to initialize the USB port. The device cannot be communicated with during this time. When using a USB interface: If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. Note that the procedure varies by model. - If the devices below are registered in SetupPOS registration, configure the settings in "4.2.5.1 Procedure A". Linux : All devices Windows : TM-T88V/TM-T20/TM-T20-42C/TM-H6000IV/TM-H2000/TM-T81 - If models other than those above are used in Windows, configure the settings in "4.2.5.2 Procedure B". 4.2.5.1 Procedure A 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\EPSON\EPuras\ EpsonPuras.properties Windows Vista/2008 Server/Windows 7: C:\ProgramData\EPSON\EPuras\EpsonPuras.properties Linux /opt/epson/epuras/EpsonPuras.properties Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. If the location for saving the settings information file was specified when the settings were saved in SetupPOS, open the file that was specified. Example: Default path of device settings information file Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. 4.2.5.2 Procedure B 1) Set the USB port setting [Port Name Type] to [Serial Number]. 2) Specify the USB serial number as the port name. The USB serial number is a serial number provided exclusively for USB. The USB serial number can be checked with the following procedure. - Perform a printer self-test print. Generally, if the printer is turned on with the printer cover closed and the FEED switch held down, self-test printing is performed on roll paper. - The serial number can be identified from the print results. When the print results are in format a), the part shown as "ID" is the USB serial number (in the example below YYYYYYYYYYYYYY is the serial number). When the print results are in format b), the USB serial number is the same as the printer serial number. In this case, check the label attached to the printer. a) When the USB serial number is printed ---------- : Firmware Version X.XX ESC/POS Interface UB-UXXXX Ver.X.XX ID :YYYYYYYYYYYYYY : : ---------- b) When the USB serial number is not printed ---------- : Firmware Version X.XX ESC/POS USB Interface or other : : ---------- * "USB Interface or other" shown above may be printed simply as "USB Interface." Note that when setting the device using this method, changing a device with a different USB serial number, requires changing the SetupPOS settings. Note that on Linux When using the Serial Number as the Port Name Type for a USB connection, only the first 17 characters of the Serial Number should be entered in SetupPOS. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.10 or later). (Windows only) 4.2.6 POSPrinter - Although it is possible to send commands directly to the printer by specifying OUTPUT_NORMAL or OUTPUT_REALTIME for the Command parameter of the DirectIO method, do not send commands that affect the printer settings. - Do not use the TM-L90 Peeler in the peeling issuing mode in a place with strong light. - The print position (left justify/center/right justify) in the PageMode can only be changed at the beginning of a line. - The TM-U950 ANK model does not have a stamp function. There is the setting item of this function in SetupPOS. This item must be set OFF. - In the case of the following, the DeviceService compares the matching of the image's registration information of the device and oneself when the NVRAM of a device is used the registration of images. * Call setBitmap method. * Call claim method. * Recovery processing of power supply off/on. There processing reqires many time if information of a device and the DeviceService deffer. - When using the RightToLeft and LeftToRight directions in PageMode, a selected Bitmap will not be printed under the following conditions: - The print station is Receipt - The Bitmap is the second (or higher) registered by SetBitmap - RecLetterQuality is set to FALSE when SetBitmap is executed The above conditions apply to the following devices: - TM-T88III - TM-T88IIIX - TM-H5000II - TM-H5200 In order to resolve this issue, set RecLetterQuality to TRUE when executing SetBitmap - Multi-tone printing: Because the Multi-tone printing uses more print data, printing through the serial or Ethernet I/F may become intermittent, and white streaks may appear on the printout. 4.2.7 LineDisplay - This version of the LineDisplay Service doesn't support a Stand Alone connection (LineDisplay used separately).(Linux only) If you wish to use a Stand Alone connection, please download the latest driver from one of the sites given below. Please go to one of the following web sites and follow the on-screen instructions. North America customers: http://www.epsonexpert.com/ Customers in other countries: http://www.epson-pos.com/ 4.2.8 CashDrawer - A drawer can not be opened with the openDrawer method when a printer has an error. In this case, please use directIO method. 4.2.9 Keylock - Restrictions for using Windows2000. The key lock function of the DM-KX060 (which is an optional keyboard for the IR-700) is not available. - Although the SetupPOS function was documented in the DM-KX060 manual, this setting is not included to the current SetupPOS. "KeyPosition Compatibility Mode" will be set "UPOS Specification". 4.2.10 Electronic Journal - When using the Electronic Journal, do not turn OFF the option "Ink on Paper for Completion" for the POS Printer in SetupPOS 4.2.11 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after JavaPOS has been used. This status is used so that JavaPOS will recognize when the printer is on. 4.2.12 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 4.2.13 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - The right of access to data (Linux only) To store the necessary information, JavaPOS creates a directory called "/var/epson/pos". Set the access rights of the "/var/epson/pos" directory, all sub directories, and all files so JavaPOS-using users are allowed to write. - PDF file The JavaPOS installer uses the "xpdf" module to view the instalation manual. Please use the latest "xpdf" module to view the instalation manual correctly.(Linux only) Also, we recommend that latest Acrobat Reader is used even when you will view the manual with Acrobat Reader. - Since it is possible that the driver will become unstable if the computer goes into stand by/hibernation mode while the printer is in use, stand by/hibernation mode is not supported - The Drag & Drop function in SetupPOS requires GTK 2.10.4 or later. - When SetupPOS is launched through a terminal on SLED 11 environment, GTK-warning will be displayed. However the operation of SetupPOS will not be affected. 4.3 Revision history [Version 1.11.14] (1) Common - Added support for Red Hat Enterprise Linux 5.3 (64bit), SuSE Linux Enterprise 11 (64bit), Windows Embedded Standard 7 (32bit) and Windows Embedded Standard 7 (64bit). (2) POSPrinter - Added support for the TM-H6000IV - Added support for the TM-H2000 - Added support for the TM-T81 (3) MICR - Added support for the TM-H6000IV - Added support for the TM-H2000 (4) ElectronicJournal - Added support for the TM-H6000IV [Version 1.11.13] (1) Common - Added support for Windows Vista (64bit), Windows 7 (64bit), Windows Server 2008 R2 (64bit), Red Hat Enterprise Linux 5.3 (32bit), SuSE Linux Enterprise 11 (32bit). - Removed support for Red Hat Linux 9 (32bit), Red Hat Enterprise Linux 5 (32bit) and SuSE Linux Enterprise 10 SP1 (32bit). (2) POSPrinter - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. (3) ElectronicJournal - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. [Version 1.11.12] (1) POSPrinter - Added support for the TM-T88V(Simplified Chinese(GB18030) model) - Added support for the TM-T88V(Traditional Chinese model) - Added support for the TM-T20 - Added support for the TM-T20-42C - Added the Multi-tone printing feature.(TM-T88V only) - Added the Optional external buzzer.(TM-T88V only) - Added a setting to allow the default character set to be changed. (TM-T20) - Add support the Unicode for the printing of the character string. (TM-T20) (2) ElectronicJournal - Added support for the TM-T20 - Added support for the TM-T20-42C [Version 1.11.11] (1) Common - Added support for the Unit package - Added support for Windows Server 2008 SP2, Windows Embedded Standard, and Windows 7 (2) POSPrinter - Added support for the TM-T88V - Added a setting to allow the default character set to be changed. (TM-T88V only) - Add support the Unicode for the printing of the character string. (TM-T88V only) (3) ElectronicJournal - Added support for the TM-T88V 5. JavaPOS 1.11.13 TM-T88V only install 5.1 Supported devices and confirmed firmware versions In this release, the following devices are supported. If the model has a confirmed version shown, it is recommended that you use that version of the firmware. Use the indicated firmware version or newer. Although it will work with an earlier version, use the indicated version (or newer) if you experience any difficulties. The symbols used in the I/F (interface) column in the following table are: S = Serial, U = USB, E = Ethernet (including wireless). Notes: [1] Indicates a devices that is only supported on the following OSes: Windows 2000/XP, Windows Embedded Standard * POS printer Confirmed Firmware version [ANK model] TM-T88V (I/F: S, U, E) Ver30.12 [Simplified Chinese(GB18030) model] TM-T88V (I/F: S, U, E) Ver30.12 [Traditional Chinese model] TM-T88V (I/F: S, U, E) Ver30.12 * Line display Confirmed Firmware version DM-D110 (I/F: S, U) Ver 1.01 DM-D210 (I/F: S, U) Ver 1.01 DM-D500 (I/F: S, U) Ver 1.10 DM-D120 (I/F: S, U) Ver 1.03 [1] * Drawer Standard (I/F: S, U, E) * Electronic Journal Confirmed Firmware version TM-T88V (I/F: S, U, E) Ver30.12 5.2 Special notes 5.2.1 Sample programs - When you use the sample program, the Login ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : POSPrinter LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer MSR : MSR Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. Therefore, it does not guarantee the correct operations for all the settings of all the devices. - The step13 sample program of POSPrinter does not operate except Japanese environment. Please comment out from the 1291th line to the 1295th in operating this sample program. 5.2.2 Installation and uninstallation - When installing the software, create a folder with the name "epson\pos" in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\ProgramData Linux /var Temporary files and information files required by DeviceService operations are saved in this "epson\pos" directory. Do not delete this directory. - If you select "Custom" for the install type and execute installing, do not specify the root directory ("/") for a shortcut folder. The shortcut folder will not be created. (Linux Only) - For installation, a restart is required when the "msvcr71.dll" file is copied to or updated in the \WINDOWS\System32\ directory, or if a file to be installed by the installer is in use at install time. - For uninstallation, a restart is required when a file to be uninstalled by the uninstaller is in use at uninstall time. - Installer and Uninstaller were able to start for the second time. However, this action is not supported.(Linux only) - There is a known issue with the uninstaller following an upgrade installation where the uninstaller will be unable to remove all installation directories. For default installation directory locations, the "/opt/EpsonJavaPOS" directory will not be removed by the uninstaller on Linux systems; the "C:\Program Files\Epson\JavaPOS" and "C:\Program Files\Epson" directories will not be removed by the uninstaller on Windows systems. You can manually delete these directories after the uninstaller runs to completion. - If you select "Custom" for the install type and change the location where to install the services of JavaPOS, you cannot start up the CheckHealth tool from the shortcut of the CheckHealth tool created by the installer. In that case, follow the instructions below to correct the Shell script (or batch file) that is the basis of the shortcut. - After the uninstaller is finished in Red Hat Linux 9, it is possible that a dialog will appear with the message "Application "gnome- terminal" (process xxxx) has crashed due to a fatal error. (Aborted)". This is a known issue and does not affect the uninstallation of the ADK. - After installing on Linux, there may be a "java.lang.NullPointerException" error with the "RPMSpecFile" indicated in the installer log file (Details: "ERROR - There was a problem creating the RPM package. You may not be running as root or may not have installed RPM Builder correctly."). This is an RPM issue and does not affect the operation of the ADK. - Older version of the software cannot be installed on an environment where this version is already installed. In order to install both versions, please install the older version first and then install this version. 1) Delete -jar option 2) Classpath setting Jar files that require setting for Classpath are as follows: CheckHealthTest.jar (in the same directory as the Shell script of the CheckHealth tool) jpos111.jar (in the directory where services of JavaPOS are installed) epsonupos.jar (in the directory where services of JavaPOS are installed) epsonupos.admin.jar (in the directory where services of JavaPOS are installed) epsonupos.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) epsonupos.trace.jar (in the directory where services of JavaPOS are installed) epsonupos.T88V.jar (in the directory where services of JavaPOS are installed) pos.v2.0001.jar (in the directory where services of JavaPOS are installed) uposcommon.jar (in the directory where services of JavaPOS are installed) uposcommon.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) xercesImpl.jar (in the directory where services of JavaPOS are installed) xml-apis.jar (in the directory where services of JavaPOS are installed) 3) Application class name The application class stored in the CheckHealthTest.jar file is "checkhealthtool.CheckHealthTool." - While it is possible to rollback to an older version with silent installation, this is not supported. Please only use the silent installer properties file with the version of the installer that was used to create it. 5.2.3 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 5.2.4 Serial communication Special notes on serial communication (Linux only) - Devices connected to serial ports can be controlled by serial port driver in JavaPOS. Such control is permitted only when you log on as root (as a default status). Use the following procedure to enable users, in addition to root, to control the devices. 1) Add a user to the group that the /var/lock directory belongs to. After opening a serial port, the serial port driver creates a lock file in the /var/lock directory. General users do not have authority to access this file using the default configuration. Therefore, users who want to use the serial port must be added to the group that this lock directory belongs to. To add a user to the group, edit the /etc/group file. The /var/lock directory belongs to the lock group. [Example on modifying the /etc/group file] The following example shows how to add a user "jpos" to the group by modifying the /etc/group file. Before modification After modification lock:x:54:lock lock:x:54:lock,jpos To add more users, use a comma "," to separate the names. The following example shows how to add another user "jpos2" in addition to "jpos". Before modification After modification lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) Restarting the PC Users in addition to root can now access the serial ports. 5.2.5 USB communication Special notes on usage of USB communication (Linux only) - Devices connected to USB ports can be controlled by USB port driver in JavaPOS. /dev/usb/usbtm* is used when JavaPOS with a USB connection access devices that can be accessed by any users. Set an appropriate access when necessary. - For SuSE Linux Enterprise 10 SP1, after installing the USB driver, open the "/etc/udev/rules.d/99-epson-usbtm.rules" file with a text editor and ensure that the rule reads as follows: KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" Two "=" signs are required after the word "KERNEL" for the USB driver to function properly. If only one "=" sign is present, add a second "=" sign and then save the file. This is required due to a change in the UDEV rule syntax in newer versions. - When a device is powered on, several seconds are required for the kernel to initialize the USB port. The device cannot be communicated with during this time. When using a USB interface: If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 5.2.5.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\EPSON\EPuras\ EpsonPuras.properties Windows Vista/2008 Server/Windows 7: C:\ProgramData\EPSON\EPuras\EpsonPuras.properties Linux /opt/epson/epuras/EpsonPuras.properties Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. If the location for saving the settings information file was specified when the settings were saved in SetupPOS, open the file that was specified. Example: Default path of device settings information file Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.10 or later). (Windows only) 5.2.6 POSPrinter - Although it is possible to send commands directly to the printer by specifying OUTPUT_NORMAL or OUTPUT_REALTIME for the Command parameter of the DirectIO method, do not send commands that affect the printer settings. - The print position (left justify/center/right justify) in the PageMode can only be changed at the beginning of a line. - In the case of the following, the DeviceService compares the matching of the image's registration information of the device and oneself when the NVRAM of a device is used the registration of images. * Call setBitmap method. * Call claim method. * Recovery processing of power supply off/on. There processing reqires many time if information of a device and the DeviceService deffer. - Multi-tone printing: Because the Multi-tone printing uses more print data, printing through the serial or Ethernet I/F may become intermittent, and white streaks may appear on the printout. 5.2.7 LineDisplay - This version of the LineDisplay Service doesn't support a Stand Alone connection (LineDisplay used separately).(Linux only) If you wish to use a Stand Alone connection, please download the latest driver from one of the sites given below. Please go to one of the following web sites and follow the on-screen instructions. North America customers: http://www.epsonexpert.com/ Customers in other countries: http://www.epson-pos.com/ 5.2.8 CashDrawer - A drawer can not be opened with the openDrawer method when a printer has an error. In this case, please use directIO method. 5.2.9 Electronic Journal - When using the Electronic Journal, do not turn OFF the option "Ink on Paper for Completion" for the POS Printer in SetupPOS 5.2.10 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after JavaPOS has been used. This status is used so that JavaPOS will recognize when the printer is on. 5.2.11 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 5.2.12 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - The right of access to data (Linux only) To store the necessary information, JavaPOS creates a directory called "/var/epson/pos". Set the access rights of the "/var/epson/pos" directory, all sub directories, and all files so JavaPOS-using users are allowed to write. - PDF file The JavaPOS installer uses the "xpdf" module to view the instalation manual. Please use the latest "xpdf" module to view the instalation manual correctly.(Linux only) Also, we recommend that latest Acrobat Reader is used even when you will view the manual with Acrobat Reader. - Since it is possible that the driver will become unstable if the computer goes into stand by/hibernation mode while the printer is in use, stand by/hibernation mode is not supported - The Drag & Drop function in SetupPOS requires GTK 2.10.4 or later. - When SetupPOS is launched through a terminal on SLED 11 environment, GTK-warning will be displayed. However the operation of SetupPOS will not be affected. 5.3 Revision history [Version 1.11.13] (1) Common - Added support for Red Hat Enterprise Linux 5.3 (32bit), SuSE Linux Enterprise 11 (32bit) - Removed support for Red Hat Linux 9 (32bit), Red Hat Enterprise Linux 5 (32bit) and SuSE Linux Enterprise 10 SP1 (32bit). [Version 1.11.12] (1) POSPrinter - Added support for the TM-T88V(Simplified Chinese(GB18030) model) - Added support for the TM-T88V(Traditional Chinese model) - Added the Multi-tone printing feature. - Added the Optional external buzzer. [Version 1.11.11] - Initial version 6. JavaPOS 1.11.13 TM-T20 only install 6.1 Supported devices and confirmed firmware versions In this release, the following devices are supported. If the model has a confirmed version shown, it is recommended that you use that version of the firmware. Use the indicated firmware version or newer. Although it will work with an earlier version, use the indicated version (or newer) if you experience any difficulties. The symbols used in the I/F (interface) column in the following table are: S = Serial, U = USB, E = Ethernet (including wireless). Notes: [1] Indicates a devices that is only supported on the following OSes: Windows 2000/XP, Windows Embedded Standard * POS printer Confirmed Firmware version [ANK models] TM-T20 (I/F: S, U) Ver 1.00 TM-T20-42C (I/F: S, U) Ver 1.00 * Line display Confirmed Firmware version DM-D110 (I/F: S, U) Ver 1.01 DM-D210 (I/F: S, U) Ver 1.01 DM-D500 (I/F: S, U) Ver 1.10 DM-D120 (I/F: S, U) Ver 1.03 [1] * Drawer Standard (I/F: S, U) * Electronic Journal Confirmed Firmware version TM-T20 (I/F: S, U) Ver 1.00 TM-T20-42C (I/F: S, U) Ver 1.00 6.2 Special notes 6.2.1 Sample programs - When you use the sample program, the Login ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : POSPrinter LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer MSR : MSR Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. Therefore, it does not guarantee the correct operations for all the settings of all the devices. - The step13 sample program of POSPrinter does not operate except Japanese environment. Please comment out from the 1291th line to the 1295th in operating this sample program. 6.2.2 Installation and uninstallation - When installing the software, create a folder with the name "epson\pos" in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\ProgramData Linux /var Temporary files and information files required by DeviceService operations are saved in this "epson\pos" directory. Do not delete this directory. - If you select "Custom" for the install type and execute installing, do not specify the root directory ("/") for a shortcut folder. The shortcut folder will not be created. (Linux Only) - For installation, a restart is required when the "msvcr71.dll" file is copied to or updated in the \WINDOWS\System32\ directory, or if a file to be installed by the installer is in use at install time. - For uninstallation, a restart is required when a file to be uninstalled by the uninstaller is in use at uninstall time. - Installer and Uninstaller were able to start for the second time. However, this action is not supported.(Linux only) - There is a known issue with the uninstaller following an upgrade installation where the uninstaller will be unable to remove all installation directories. For default installation directory locations, the "/opt/EpsonJavaPOS" directory will not be removed by the uninstaller on Linux systems; the "C:\Program Files\Epson\JavaPOS" and "C:\Program Files\Epson" directories will not be removed by the uninstaller on Windows systems. You can manually delete these directories after the uninstaller runs to completion. - If you select "Custom" for the install type and change the location where to install the services of JavaPOS, you cannot start up the CheckHealth tool from the shortcut of the CheckHealth tool created by the installer. In that case, follow the instructions below to correct the Shell script (or batch file) that is the basis of the shortcut. - After the uninstaller is finished in Red Hat Linux 9, it is possible that a dialog will appear with the message "Application "gnome- terminal" (process xxxx) has crashed due to a fatal error. (Aborted)". This is a known issue and does not affect the uninstallation of the ADK. - After installing on Linux, there may be a "java.lang.NullPointerException" error with the "RPMSpecFile" indicated in the installer log file (Details: "ERROR - There was a problem creating the RPM package. You may not be running as root or may not have installed RPM Builder correctly."). This is an RPM issue and does not affect the operation of the ADK. - Older version of the software cannot be installed on an environment where this version is already installed. In order to install both versions, please install the older version first and then install this version. 1) Delete -jar option 2) Classpath setting Jar files that require setting for Classpath are as follows: CheckHealthTest.jar (in the same directory as the Shell script of the CheckHealth tool) jpos111.jar (in the directory where services of JavaPOS are installed) epsonupos.jar (in the directory where services of JavaPOS are installed) epsonupos.admin.jar (in the directory where services of JavaPOS are installed) epsonupos.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) epsonupos.trace.jar (in the directory where services of JavaPOS are installed) epsonupos.T20.jar (in the directory where services of JavaPOS are installed) pos.v2.0001.jar (in the directory where services of JavaPOS are installed) uposcommon.jar (in the directory where services of JavaPOS are installed) uposcommon.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) xercesImpl.jar (in the directory where services of JavaPOS are installed) xml-apis.jar (in the directory where services of JavaPOS are installed) 3) Application class name The application class stored in the CheckHealthTest.jar file is "checkhealthtool.CheckHealthTool." - While it is possible to rollback to an older version with silent installation, this is not supported. Please only use the silent installer properties file with the version of the installer that was used to create it. 6.2.3 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 6.2.4 Serial communication Special notes on serial communication (Linux only) - Devices connected to serial ports can be controlled by serial port driver in JavaPOS. Such control is permitted only when you log on as root (as a default status). Use the following procedure to enable users, in addition to root, to control the devices. 1) Add a user to the group that the /var/lock directory belongs to. After opening a serial port, the serial port driver creates a lock file in the /var/lock directory. General users do not have authority to access this file using the default configuration. Therefore, users who want to use the serial port must be added to the group that this lock directory belongs to. To add a user to the group, edit the /etc/group file. The /var/lock directory belongs to the lock group. [Example on modifying the /etc/group file] The following example shows how to add a user "jpos" to the group by modifying the /etc/group file. Before modification After modification lock:x:54:lock lock:x:54:lock,jpos To add more users, use a comma "," to separate the names. The following example shows how to add another user "jpos2" in addition to "jpos". Before modification After modification lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) Restarting the PC Users in addition to root can now access the serial ports. 6.2.5 USB communication Special notes on usage of USB communication (Linux only) - Devices connected to USB ports can be controlled by USB port driver in JavaPOS. /dev/usb/usbtm* is used when JavaPOS with a USB connection access devices that can be accessed by any users. Set an appropriate access when necessary. - For SuSE Linux Enterprise 10 SP1, after installing the USB driver, open the "/etc/udev/rules.d/99-epson-usbtm.rules" file with a text editor and ensure that the rule reads as follows: KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" Two "=" signs are required after the word "KERNEL" for the USB driver to function properly. If only one "=" sign is present, add a second "=" sign and then save the file. This is required due to a change in the UDEV rule syntax in newer versions. - When a device is powered on, several seconds are required for the kernel to initialize the USB port. The device cannot be communicated with during this time. When using a USB interface: If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 6.2.5.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\EPSON\EPuras\ EpsonPuras.properties Windows Vista/2008 Server/Windows 7: C:\ProgramData\EPSON\EPuras\EpsonPuras.properties Linux /opt/epson/epuras/EpsonPuras.properties Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. If the location for saving the settings information file was specified when the settings were saved in SetupPOS, open the file that was specified. Example: Default path of device settings information file Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.10 or later). (Windows only) 6.2.6 POSPrinter - Although it is possible to send commands directly to the printer by specifying OUTPUT_NORMAL or OUTPUT_REALTIME for the Command parameter of the DirectIO method, do not send commands that affect the printer settings. - The print position (left justify/center/right justify) in the PageMode can only be changed at the beginning of a line. - In the case of the following, the DeviceService compares the matching of the image's registration information of the device and oneself when the NVRAM of a device is used the registration of images. * Call setBitmap method. * Call claim method. * Recovery processing of power supply off/on. There processing reqires many time if information of a device and the DeviceService deffer. 6.2.7 LineDisplay - This version of the LineDisplay Service doesn't support a Stand Alone connection (LineDisplay used separately).(Linux only) If you wish to use a Stand Alone connection, please download the latest driver from one of the sites given below. Please go to one of the following web sites and follow the on-screen instructions. North America customers: http://www.epsonexpert.com/ Customers in other countries: http://www.epson-pos.com/ 6.2.8 CashDrawer - A drawer can not be opened with the openDrawer method when a printer has an error. In this case, please use directIO method. 6.2.9 Electronic Journal - When using the Electronic Journal, do not turn OFF the option "Ink on Paper for Completion" for the POS Printer in SetupPOS 6.2.10 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after JavaPOS has been used. This status is used so that JavaPOS will recognize when the printer is on. 6.2.11 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 6.2.12 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - The right of access to data (Linux only) To store the necessary information, JavaPOS creates a directory called "/var/epson/pos". Set the access rights of the "/var/epson/pos" directory, all sub directories, and all files so JavaPOS-using users are allowed to write. - PDF file The JavaPOS installer uses the "xpdf" module to view the instalation manual. Please use the latest "xpdf" module to view the instalation manual correctly.(Linux only) Also, we recommend that latest Acrobat Reader is used even when you will view the manual with Acrobat Reader. - Since it is possible that the driver will become unstable if the computer goes into stand by/hibernation mode while the printer is in use, stand by/hibernation mode is not supported - The Drag & Drop function in SetupPOS requires GTK 2.10.4 or later. - When SetupPOS is launched through a terminal on SLED 11 environment, GTK-warning will be displayed. However the operation of SetupPOS will not be affected. 6.3 Revision history [Version 1.11.13] (1) Common - Added support for Red Hat Enterprise Linux 5.3 (32bit), SuSE Linux Enterprise 11 (32bit). - Removed support for Red Hat Linux 9 (32bit), Red Hat Enterprise Linux 5 (32bit) and SuSE Linux Enterprise 10 SP1 (32bit). (2) POSPrinter - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. (3) ElectronicJournal - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. [Version 1.11.12] - Initial version 7. JavaPOS 1.11.14 TM-T81 only install 7.1 Supported devices and confirmed firmware versions In this release, the following devices are supported. If the model has a confirmed version shown, it is recommended that you use that version of the firmware. Use the indicated firmware version or newer. Although it will work with an earlier version, use the indicated version (or newer) if you experience any difficulties. The symbols used in the I/F (interface) column in the following table are: S = Serial, U = USB, E = Ethernet (including wireless). * POS printer Confirmed Firmware version [Simplified Chinese(GB18030) models] TM-T81 (I/F: S, U, E) Ver 2.00 [South Asia models] TM-T81 (I/F: S, U, E) Ver 2.00 * Drawer Standard (I/F: S, U, E) 7.2 Special notes 7.2.1 Sample programs - When you use the sample program, the Login ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : POSPrinter LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer MSR : MSR Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. Therefore, it does not guarantee the correct operations for all the settings of all the devices. - The step13 sample program of POSPrinter does not operate except Japanese environment. Please comment out from the 1291th line to the 1295th in operating this sample program. 7.2.2 Installation and uninstallation - When installing the software, create a folder with the name "epson\pos" in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\ProgramData Linux /var Temporary files and information files required by DeviceService operations are saved in this "epson\pos" directory. Do not delete this directory. - If you select "Custom" for the install type and execute installing, do not specify the root directory ("/") for a shortcut folder. The shortcut folder will not be created. (Linux Only) - For installation, a restart is required when the "msvcr71.dll" file is copied to or updated in the \WINDOWS\System32\ directory, or if a file to be installed by the installer is in use at install time. - For uninstallation, a restart is required when a file to be uninstalled by the uninstaller is in use at uninstall time. - Installer and Uninstaller were able to start for the second time. However, this action is not supported.(Linux only) - There is a known issue with the uninstaller following an upgrade installation where the uninstaller will be unable to remove all installation directories. For default installation directory locations, the "/opt/EpsonJavaPOS" directory will not be removed by the uninstaller on Linux systems; the "C:\Program Files\Epson\JavaPOS" and "C:\Program Files\Epson" directories will not be removed by the uninstaller on Windows systems. You can manually delete these directories after the uninstaller runs to completion. - If you select "Custom" for the install type and change the location where to install the services of JavaPOS, you cannot start up the CheckHealth tool from the shortcut of the CheckHealth tool created by the installer. In that case, follow the instructions below to correct the Shell script (or batch file) that is the basis of the shortcut. - After the uninstaller is finished in Red Hat Linux 9, it is possible that a dialog will appear with the message "Application "gnome- terminal" (process xxxx) has crashed due to a fatal error. (Aborted)". This is a known issue and does not affect the uninstallation of the ADK. - After installing on Linux, there may be a "java.lang.NullPointerException" error with the "RPMSpecFile" indicated in the installer log file (Details: "ERROR - There was a problem creating the RPM package. You may not be running as root or may not have installed RPM Builder correctly."). This is an RPM issue and does not affect the operation of the ADK. - Older version of the software cannot be installed on an environment where this version is already installed. In order to install both versions, please install the older version first and then install this version. 1) Delete -jar option 2) Classpath setting Jar files that require setting for Classpath are as follows: CheckHealthTest.jar (in the same directory as the Shell script of the CheckHealth tool) jpos111.jar (in the directory where services of JavaPOS are installed) epsonupos.jar (in the directory where services of JavaPOS are installed) epsonupos.admin.jar (in the directory where services of JavaPOS are installed) epsonupos.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) epsonupos.trace.jar (in the directory where services of JavaPOS are installed) epsonupos.T81.jar (in the directory where services of JavaPOS are installed) pos.v2.0001.jar (in the directory where services of JavaPOS are installed) uposcommon.jar (in the directory where services of JavaPOS are installed) uposcommon.core.v1.11.0001.jar (in the directory where services of JavaPOS are installed) xercesImpl.jar (in the directory where services of JavaPOS are installed) xml-apis.jar (in the directory where services of JavaPOS are installed) 3) Application class name The application class stored in the CheckHealthTest.jar file is "checkhealthtool.CheckHealthTool." - While it is possible to rollback to an older version with silent installation, this is not supported. Please only use the silent installer properties file with the version of the installer that was used to create it. 7.2.3 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 7.2.4 Serial communication Special notes on serial communication (Linux only) - Devices connected to serial ports can be controlled by serial port driver in JavaPOS. Such control is permitted only when you log on as root (as a default status). Use the following procedure to enable users, in addition to root, to control the devices. 1) Add a user to the group that the /var/lock directory belongs to. After opening a serial port, the serial port driver creates a lock file in the /var/lock directory. General users do not have authority to access this file using the default configuration. Therefore, users who want to use the serial port must be added to the group that this lock directory belongs to. To add a user to the group, edit the /etc/group file. The /var/lock directory belongs to the lock group. [Example on modifying the /etc/group file] The following example shows how to add a user "jpos" to the group by modifying the /etc/group file. Before modification After modification lock:x:54:lock lock:x:54:lock,jpos To add more users, use a comma "," to separate the names. The following example shows how to add another user "jpos2" in addition to "jpos". Before modification After modification lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) Restarting the PC Users in addition to root can now access the serial ports. 7.2.5 USB communication Special notes on usage of USB communication (Linux only) - Devices connected to USB ports can be controlled by USB port driver in JavaPOS. /dev/usb/usbtm* is used when JavaPOS with a USB connection access devices that can be accessed by any users. Set an appropriate access when necessary. - For SuSE Linux Enterprise 10 SP1, after installing the USB driver, open the "/etc/udev/rules.d/99-epson-usbtm.rules" file with a text editor and ensure that the rule reads as follows: KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" Two "=" signs are required after the word "KERNEL" for the USB driver to function properly. If only one "=" sign is present, add a second "=" sign and then save the file. This is required due to a change in the UDEV rule syntax in newer versions. - When a device is powered on, several seconds are required for the kernel to initialize the USB port. The device cannot be communicated with during this time. When using a USB interface: If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 7.2.5.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\EPSON\EPuras\ EpsonPuras.properties Windows Vista/2008 Server/Windows 7: C:\ProgramData\EPSON\EPuras\EpsonPuras.properties Linux /opt/epson/epuras/EpsonPuras.properties Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. If the location for saving the settings information file was specified when the settings were saved in SetupPOS, open the file that was specified. Example: Default path of device settings information file Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.10 or later). (Windows only) 7.2.6 POSPrinter - Although it is possible to send commands directly to the printer by specifying OUTPUT_NORMAL or OUTPUT_REALTIME for the Command parameter of the DirectIO method, do not send commands that affect the printer settings. - The print position (left justify/center/right justify) in the PageMode can only be changed at the beginning of a line. - In the case of the following, the DeviceService compares the matching of the image's registration information of the device and oneself when the NVRAM of a device is used the registration of images. * Call setBitmap method. * Call claim method. * Recovery processing of power supply off/on. There processing reqires many time if information of a device and the DeviceService deffer. 7.2.7 CashDrawer - A drawer can not be opened with the openDrawer method when a printer has an error. In this case, please use directIO method. 7.2.8 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after JavaPOS has been used. This status is used so that JavaPOS will recognize when the printer is on. 7.2.9 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 7.2.10 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - The right of access to data (Linux only) To store the necessary information, JavaPOS creates a directory called "/var/epson/pos". Set the access rights of the "/var/epson/pos" directory, all sub directories, and all files so JavaPOS-using users are allowed to write. - PDF file The JavaPOS installer uses the "xpdf" module to view the instalation manual. Please use the latest "xpdf" module to view the instalation manual correctly.(Linux only) Also, we recommend that latest Acrobat Reader is used even when you will view the manual with Acrobat Reader. - Since it is possible that the driver will become unstable if the computer goes into stand by/hibernation mode while the printer is in use, stand by/hibernation mode is not supported - The Drag & Drop function in SetupPOS requires GTK 2.10.4 or later. - When SetupPOS is launched through a terminal on SLED 11 environment, GTK-warning will be displayed. However the operation of SetupPOS will not be affected. 7.3 Revision history [Version 1.11.14] - Initial version