EPSON JavaPOS ADK Version 1.9 Release Notes Seiko Epson Corporation December 27, 2005 1. Outline EPSON JavaPOS ADK Version 1.9 has been released. Using this release, you can develop applications that are compatible with UnifiedPOS specification Ver 1.9. Note: The newest information is written to this release notes, although release notes will be copied to an installation directory if the JavaPOS is installed. 2. Confirmed operating environment Operation of EPSON JavaPOS ADK has been confirmed in the following environment. (1) OS (Operating system) Windows 2000 Professional Service Pack4 Windows XP Professional Service Pack2 Red Hat Linux 9 SuSE Linux 9.3 (2) Java operating environment Java2 Standard Edition 1.4.2_10 http://java.sun.com/j2se/1.4.2/ (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.2 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. 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 [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.00 TM-J2000/2100 (I/F: S, U, E) Ver 2.10 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-T88II (I/F: S, U, E) Ver 3.48 TM-T88III 80mm (I/F: S, U, E) Ver 7.03 TM-T88III 58mm (I/F: S, U, E) Ver 7.04 TM-T88IV (I/F: S, U, E) Ver10.00 TM-P60 (I/F: S, E) Ver 1.00 TM-U210A (I/F: S, U, E) Ver 1.24 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 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-J2000/2100 (I/F: S, U, E) Ver 2.10 TM-T90 (I/F: S, U, E) Ver 1.08 TM-L90 (I/F: S, U, E) Ver 1.06 TM-T88II (I/F: S, U, E) Ver 3.49 TM-T88III(GB2312) (I/F: S, U, E) Ver 7.05 TM-T88III(GB18030) (I/F: S, U, E) Ver 8.00 TM-U210A (I/F: S, U, E) Ver 1.24 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 [Traditional Chinese models] TM-H5000II (I/F: S, U, E) Ver 3.49 TM-H6000II (I/F: S, U, E) Ver 4.01 TM-J2000/2100 (I/F: S, U, E) Ver 2.10 TM-T90 (I/F: S, U, E) Ver 1.08 TM-L90 (I/F: S, U, E) Ver 1.06 TM-T88II (I/F: S, U, E) Ver 3.49 TM-T88III (I/F: S, U, E) Ver 7.05 TM-U210A (I/F: S, U, E) Ver 1.24 TM-U220A/B/D (I/F: S, U, E) Ver 3.10 TM-T88IIIX 180dpi (Windows only) (I/F: S) Ver 7.05 * 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 * 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.00 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 * Magnetic stripe reader (Windows only) DM-MX112 (I/F: U) DM-MX123 (I/F: U) * Key lock (Windows only) EPSON DM-KX060 (I/F: U) 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 - 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" in the following directory. Windows \Documents and Settings\All Users Linux /var Temporary files and information files required by DeviceService operations are saved in this "epson" directory. Do not delete this directory. * When using the tracing (log) function - Tracing results are saved in the following directory. Windows \Documents and Settings\All Users\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 9.3. 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. * 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. * 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. * 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". * 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. * Installer - Installer and Uninstaller were able to start for the second time. However, this action is not supported.(Linux only) - Although the silent installation function was documented in the install manual, it is not supported. * Sample programs - The step13 sample program of POSPrinter does not operate except Japanese environment. Please comment out the 1291th line 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. 6. Changes from the earlier version * UnifiedPOS Specifications Ver. 1.9 is now supported. * The installation destination of EPSON JavaPOS ADK has changed. It is now installed in the JVM ext folder selected with the installer. * The error codes have been completely revised. For detailed error codes, see "Error Code List." * directIO codes have been completely revised. For directIO commands supported by DeviceService, see the reference manual of each device. * Functions and other items have been completely revised. For details, see the reference manual of each device.