EPSON JavaPOS ADK Version 1.11.13 Release Notes
Seiko Epson Corporation
Jun. 30, 2010
1. Outline
EPSON JavaPOS ADK Version 1.11.13 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.13 Standard install]
2. Confirmed operating environment
3. Installation and uninstallation
4. JavaPOS 1.11.13 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
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)
Red Hat Enterprise Linux 5.3 (32bit)
SuSE Linux Enterprise 11 (32bit)
(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.13 Standard install
4.1 Supported devices and confirmed firmware versions
* POS printer Confirmed Firmware version
TM-T81 (I/F: S, U) Ver 1.00
Please refer to "SupportedDevicesList.txt" for a list of other supported
devices.
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:
<System Drive>:\Documents and Settings\All Users
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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:
<System Drive>:\Documents and Settings\All Users\EPSON\pos\tm\Trace
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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
- 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.
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.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:
<System Drive>:\Documents and Settings\All Users
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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:
<System Drive>:\Documents and Settings\All Users\EPSON\pos\tm\Trace
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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
- 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.
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:
<System Drive>:\Documents and Settings\All Users
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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:
<System Drive>:\Documents and Settings\All Users\EPSON\pos\tm\Trace
Windows Vista/2008 Server/Windows 7:
<System Drive>:\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
- 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.
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
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.