EPSON JavaPOS ADK Version 1.11.8 Release Notes Seiko Epson Corporation November 4, 2009 1. Outline EPSON JavaPOS ADK Version 1.11.8 has been released. Using this release, you can develop applications that are compatible with UnifiedPOS specification Ver 1.11. 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 Windows XP Professional Service Pack 3 Windows Vista (Business, Enterprise, Ultimate) Service Pack 1 Red Hat Linux 9 Red Hat Enterprise Linux 5 SuSE Linux Enterprise 10 SP1 (2) Java operating environment Java Standard Edition 6 Update 3 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. 4. 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). Note: - USB I/F is not supported in Red Hat Enterprise Linux 5. * POS printer Confirmed Firmware version [ANK model] TM-H5000II (I/F: S, U, E) Ver 5.08 TM-H5200 (I/F: S, U, E) Ver 1.04 TM-H6000II (I/F: S, U, E) Ver 3.51 TM-H6000II Validation (I/F: S, U, E) Ver 6.01 TM-H6000II 256 support (I/F: S, U, E) Ver 8.10 TM-H6000II Photo-ID (I/F: S, U, E) Ver 8.10 TM-H6000III (I/F: S, U, E) Ver10.01 TM-H6000III Validation (I/F: S, U, E) Ver11.00 TM-H6000III 256 support (I/F: S, U, E) Ver12.01 TM-H6000III Photo-ID (I/F: S, U, E) Ver12.01 TM-J2000/2100 (I/F: S, U, E) Ver 2.11 TM-J7000/7100 (I/F: S, U, E) Ver 1.03 TM-J7500/7600 (I/F: S, U, E) Ver 1.02 TM-T90 (I/F: S, U, E) Ver 1.09 TM-L90 (I/F: S, U, E) Ver 1.07 TM-L90Peeler (I/F: S, U, E) Ver 1.00 TM-T70 (I/F: S, U, E) Ver 1.00 TM-T88III 80mm (I/F: S, U, E) Ver 7.03 TM-T88III 58mm (I/F: S, P, U, E) Ver 7.04 TM-T88IV (I/F: S, U, E) Ver10.02 TM-P60 (I/F: S, E) Ver 1.00 TM-U220A/B/D (I/F: S, U, E) Ver 3.10 TM-U230 (I/F: S, U, E) Ver 1.02 TM-U950 (I/F: S) Ver 1.08 TM-U950 w/MICR (I/F: S) Ver 1.09 TM-T88IIIX 180dpi (Windows only) (I/F: S) Ver 7.05 (Not supported on Windows Vista) Note: The TM-H5200 is a product for the American market. [Simplified Chinese(GB2312/GB18030) models] TM-H5000II (I/F: S, U, E) Ver 3.49 TM-H6000II (I/F: S, U, E) Ver 4.01 TM-H6000III (I/F: S, U, E) Ver10.01 TM-J2000/2100 (I/F: S, U, E) Ver 2.11 TM-T90 (I/F: S, U, E) Ver 1.08 TM-L90 (I/F: S, U, E) Ver 1.06 TM-T88III(GB2312) (I/F: S, U, E) Ver 7.05 TM-T88III(GB18030) (I/F: S, U, E) Ver 8.00 TM-T88IV(GB18030) (I/F: S, U, E) Ver10.02 TM-U220A/B/D (I/F: S, U, E) Ver 3.10 TM-U220A/B/D Black Mark (Linux only) (I/F: S, U, E) Ver 3.10 TM-T88IIIX 180dpi (Windows only) (I/F: S) Ver 7.05 (Not supported on Windows Vista) [Traditional Chinese models] TM-H5000II (I/F: S, U, E) Ver 3.49 TM-H6000II (I/F: S, U, E) Ver 4.01 TM-H6000III (I/F: S, U, E) Ver10.01 TM-J2000/2100 (I/F: S, U, E) Ver 2.11 TM-T90 (I/F: S, U, E) Ver 1.08 TM-L90 (I/F: S, U, E) Ver 1.06 TM-T88III (I/F: S, U, E) Ver 7.05 TM-T88IV (I/F: S, U, E) Ver10.02 TM-U220A/B/D (I/F: S, U, E) Ver 3.10 TM-T88IIIX 180dpi (Windows only) (I/F: S) Ver 7.05 (Not supported on Windows Vista) * 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 (Windows only) (I/F: S, U) Ver 1.03 (Not supported on Windows Vista) * Drawer Standard (I/F: S, U, E) * MICR (magnetic ink reader) Confirmed Firmware version TM-H5000II (I/F: S, U, E) Ver 5.08 TM-H5200 (I/F: S, U, E) Ver 1.04 TM-H6000II (I/F: S, U, E) Ver 3.51 TM-H6000II Validation (I/F: S, U, E) Ver 6.01 TM-H6000II 256 support (I/F: S, U, E) Ver 8.10 TM-H6000II Photo-ID (I/F: S, U, E) Ver 8.10 TM-H6000III (I/F: S, U, E) Ver10.01 TM-H6000III Validation (I/F: S, U, E) Ver11.00 TM-H6000III 256 support (I/F: S, U, E) Ver12.01 TM-H6000III Photo-ID (I/F: S, U, E) Ver12.01 TM-J7000/7100 (I/F: S, U, E) Ver 1.03 TM-U950 (I/F: S) Ver 1.09 Note: The TM-H5200 is a product for the American market. * Check scanner Confirmed Firmware version TM-H6000II 256 support (I/F: S, U, E) Ver 8.10 TM-H6000II Photo-ID (I/F: S, U, E) Ver 8.10 TM-H6000III 256 support (I/F: S, U, E) Ver12.01 TM-H6000III Photo-ID (I/F: S, U, E) Ver12.01 * Magnetic stripe reader (Windows only) DM-MX112 (I/F: U) (Not supported on Windows Vista) DM-MX123 (I/F: U) (Not supported on Windows Vista) * Key lock (Windows only) EPSON DM-KX060 (I/F: U) (Not supported on Windows Vista) * Electronic Journal TM-H6000III (I/F: S, U, E) Ver 10.01 TM-H6000III Validation (I/F: S, U, E) Ver 11.00 TM-H6000III 256 support (I/F: S, U, E) Ver 12.01 TM-H6000III Photo-ID (I/F: S, U, E) Ver 12.01 TM-T88IV (I/F: S, U, E) Ver 10.02 5. Special notes * 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. * Installation and uninstallation - When installing the software, create a folder with the name "epson\pos" in the following directory. Windows Windows 2000/XP: :\Documents and Settings\All Users Windows Vista: :\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: CheckHealth.jar (in the same directory as the Shell script of the CheckHealth tool) jpos19.jar (in the directory where services of JavaPOS are installed) epsonupos.jar (in the directory where services of JavaPOS are installed) pos.jar (in the directory where services of JavaPOS are installed) uposcommon.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." * When using the tracing (log) function - Tracing results are saved in the following directory. Windows Windows 2000/XP: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista: :\ProgramData\EPSON\pos\tm\Trace Linux /var/epson/pos/trace * 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. * RxTx is not compiled on the SuSE Linux. Please modify the SerialImp.c as follows when you compile it. Delete the 5106th line and the 5107th line. Or delete the line feed code of the 5106th line. * 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 - When registering devices in SetupPOS with the default settings, it is not possible to use several devices that are the same model at the same time. To use several of the same model at the same time, use the following settings. 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. * 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 * CashDrawer - A drawer can not be opened with the openDrawer method when a printer has an error. In this case, please use directIO method. * 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". * Electronic Journal - When using the Electronic Journal, do not turn OFF the option "Ink on Paper for Completion" for the POS Printer in SetupPOS * 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. * Sample programs - 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. * TM Flash LOGO utility (TMFlogo) - TMFlogo is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain TMFlogo. * 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