EPSON JavaPOS ADK 1.11.18版本 发行说明 精工爱普生公司 2011年5月20日 1. 概述 EPSON JavaPOS ADK 1.11.18版本已被发行。使用该发行，您可以开发与UnifiedPOS 规格1.11版本兼容的应用程序。 本发行说明包含多个软件包的相关信息。请参照该相关信息了解您正安装的产品。 [EPSON JavaPOS ADK 1.11.18 标准安装] 2. 已确认的操作环境 3. 安装与卸载 4. JavaPOS 1.11.18 标准安装 [EPSON JavaPOS ADK 1.11.18 仅限TM-T81安装] 2. 已确认的操作环境 3. 安装与卸载 5. JavaPOS 1.11.18 仅限TM-T81安装 [EPSON JavaPOS ADK 1.11.18 仅限TM-T82安装] 2. 已确认的操作环境 3. 安装与卸载 6. JavaPOS 1.11.18 仅限TM-T82安装 2. 已确认的操作环境 EPSON JavaPOS ADK的操作在以下环境中已确认。 (1) OS (操作系统) Windows 2000 Professional SP4 (32位) Windows XP Professional SP3 (32位) Windows Vista SP2 (32位) Windows Vista SP2 (64位) Windows Server 2008 SP2 (32位) Windows Server 2008 SP2 (64位) Windows 7 SP1 (32位) Windows 7 SP1 (64位) Windows Server 2008 R2 SP1 (64位) Windows Embedded Standard (32位) Windows Embedded Standard 7 (32位) Windows Embedded Standard 7 (64位) Red Hat Enterprise Linux 5.3 (32位) Red Hat Enterprise Linux 5.3 (64位) SuSE Linux Enterprise 11 (32位) SuSE Linux Enterprise 11 (64位) (2) Java 操作环境 Java Standard Edition 6 Update 16 http://java.sun.com/javase/6/ (3) 串行端口驱动程序 (仅限Linux) Java Communications API 2.0 该组件由JavaPOS安装程序复制到JavaPOS安装文件夹中。 RXTX 2.0-5 http://www.rxtx.org/ (4) 图像处理API Java Advanced Imaging 1.1.3 http://java.sun.com/products/java-media/jai/ 3. 安装与卸载 请遵照“EPSON JavaPOS ADK 安装指南”中的步骤进行安装与卸载。 注意在文件安装期间取消或突然终止安装程序可能使系统处于无法完成进一步安装的 状态。为了在这种情况下安装JavaPOS，请使用“强制卸载”选项，然后再次运行 安装程序。如果当使用“强制卸载”选项时，该进程被取消，系统可能仍然处于无法 完成进一步重新安装的状态。在这种情况下，请再次使用“强制卸载”选项。 当在以前安装过JavaPOS的系统上运行该安装程序时，在同一位置进行安装是必要的。 如果JavaPOS被安装到不同的位置，之前的设置可能会抑制正确的操作。在这种情况 下为了将JavaPOS安装到不同的位置，在运行该安装程序之前请使用“强制卸载”选 项来清除所有之前的设置。 4. JavaPOS 1.11.18 标准安装 4.1 所支持的设备与已确认的固件版本 有关详情请参考“SupportedDevicesList.txt”。 4.2 特别说明 4.2.1 示例程序 - 当您使用该示例程序时，登录ID需要的是管理员帐户组。 - 使用逻辑设备名称注册。 POSPrinter : POSPrinter LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer MSR : MSR Keylock : Keylock ElectronicJournal : ElectronicJournal - 该示例程序显示一个(多个)控制方法的示例。 因此，不保证所有设备的所有设置均能正确操作。 4.2.2 安装与卸载 - 当安装该软件时，请在以下目录中创建一个名为“epson\pos”的目录。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\Program Files Linux /var DeviceService操作所要求的临时文件与信息文件保存在该“epson\pos”目录中。 不要删除该目录。 - 如果您选择“自定义”为安装类型并执行安装，不要为一个快捷文件夹指定根目 录(“/”)。快捷文件夹将不被创建。(仅限Linux) - 关于安装，当“msvcr71.dll”文件在\WINDOWS\System32\目录中被复制 或更新时，或者如果由安装程序进行安装的文件在安装时正在使用，则需要 重新启动。 - 关于卸载，由卸载程序进行卸载的文件在卸载时正在使用，则需要重新启动。 - 可以同时执行安装程序与卸载程序， 但是，该操作不被支持。(仅限Linux) - 在升级安装后，卸载程序有一个问题，即卸载程序无法删除所有安装目录。关于 默认安装目录位置，在Linux系统上卸载程序无法删除“/opt/EpsonJavaPOS” 目录；在Windows系统上卸载程序无法删除“C:\Program Files\Epson\JavaPOS” 与“C:\Program Files\Epson”目录。在卸载完成后您可以手动删除这些目录。 - 如果您选择“自定义”为安装类型并更改JavaPOS的服务的安装位置，您将无法 从安装程序所创建的CheckHealth工具的快捷方式上启动CheckHealth工具。 在这种情况下，请遵照以下说明更正快捷方式的基础Shell脚本(或批处理文件)。 - 在Red Hat Linux 9上完成卸载后，可能会出现对话框显示消息“由于严重错误， 应用程序‘gnome-terminal’(进程xxxx)已毁坏。(已中止)”。 这是一个已知 的问题且不影响ADK的卸载。 - 在Linux上完成安装后，在该安装程序日志文件中可能会有一个由 “RPMSpecFile”所表示的“java.lang.NullPointerException”错误 (详细信息：“错误-存在一个创建RPM软件包的问题。您可能不是作为root 正在运行或者没有正确安装RPM Builder”)。 这是一个RPM问题且不影响ADK的操作。 1) 删除 -jar选项 2) Classpath设置 要求Classpath设置的Jar文件如下所示： CheckHealthTest.jar (与CheckHealth工具的Shell脚本在同一目录中) jpos111.jar (位于JavaPOS的服务所在的安装目录) epsonupos.jar (位于JavaPOS的服务所在的安装目录) epsonupos.admin.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) epsonupos.trace.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T88V.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T20.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T81.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T82.jar (位于JavaPOS的服务所在的安装目录) pos.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0001.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0002.jar (位于JavaPOS的服务所在的安装目录) uposcommon.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) xercesImpl.jar (位于JavaPOS的服务所在的安装目录) xml-apis.jar (位于JavaPOS的服务所在的安装目录) 3) 应用程序类名称 存储在CheckHealthTest.jar文件中的应用程序类为 “checkhealthtool.CheckHealthTool.” - 虽然使用无提示安装可以回滚到一个较旧的版本，但不支持该操作。请仅使用用 于创建无提示安装程序属性文件的安装程序版本。 4.2.3 跟踪功能 当使用跟踪(日志)功能时 - 跟踪结果保存在以下目录中。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\Program Files\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 4.2.4 串行通信 关于串行通信的特别说明(仅限Linux) - 与串行端口相连接的设备可以由JavaPOS中的串行端口驱动程序控制。 仅当您以root登录时，才允许该控制 (作为默认状态)。 除了root之外，使用以下步骤使用户能够控制该设备。 1) 添加一个用户到/var/lock目录所属的组中。在打开一个串行端口后，串行端口 驱动程序在/var/lock目录中创建一个锁定文件。使用默认配置的普通用户没有 权限访问该文件。因此，想要使用串行端口的用户必须被添加到该锁定目录 所属的组中。 要添加一个用户到该组，请编辑/etc/group文件。/var/lock目录属于该锁定 组。 [修改/etc/group文件的示例] 以下示例显示如何通过修改/etc/group文件添加一个用户“jpos”到该组。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos 要添加更多用户，请使用逗号“,”来隔开用户名。以下示例显示除“jpos”之 外如何添加另一用户“jpos2”。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) 重新启动PC 除了以root登录外，用户现在可以访问该串行端口。 4.2.5 USB通信 关于使用USB通信的特别说明(仅限Linux) - 与USB端口相连接的设备可以由JavaPOS中的USB端口驱动程序控制。 当JavaPOS以USB连接方式访问可以由任何用户访问的设备时， 使用/dev/usb/usbtm*。必要时设置一个合适的访问。 - 关于SuSE Linux Enterprise 10 SP1，在安装USB驱动程序后，使用一个文本编 辑器打开“/etc/udev/rules.d/99-epson-usbtm.rules”文件， 并确保规则如下所示： KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" 单词“KERNEL”之后要求有两个“=”为了USB驱动程序功能正常。如果只 存在一个“=”，添加第二个“=”然后保存该文件。由于在更新版本中， UDEV规则语法有更改，故要求此操作。 - 当打开某一设备电源时，内核初始化USB端口需要几秒钟时间。在此期间无法与 该设备进行通信。 当使用USB接口时 如果同一类型的多个型号在USB连接中同时使用，必须手动配置设置。 注意：步骤因型号不同而有所改变。 - 如果以下设备在SetupPOS注册中注册，则在“4.2.5.1 步骤A”中配置设置。 Linux: All models Windows: TM-T88V/TM-T20/TM-T20-42C/TM-H6000IV/TM-H2000/TM-T81/ TM-T82/TM-T82-42C - 如果上述型号之外的其它型号在Windows中使用，则在“4.2.5.2 步骤B”中 配置设置。 4.2.5.1 步骤A 1) 打开要连接的所有设备的电源。 2) 参考通讯模块的设置文件并检查分配到设备的通讯模块的端口名称。 2.1) 要检查端口名称，在文本编辑器中打开通讯模块的设置文件。 例如：通讯模块的设置文件的路径 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 例如：通讯模块的设置文件中的输入（当两个设备被连接时） 　　　 　　　 　　 　　 - 已省略- 　　　 　　 　　 2.2) 检查所分配的端口名称。 　　　 是分配到各个设备的端口名称。 3) 将SetupPOS中注册的设备设置信息与通讯模块中分配到设备的端口名称联合。 3.1) 在文本编辑器中打开在SetupPOS中注册的设备设置信息文件。当在SetupPOS 中保存设置时，如果指定保存设置信息文件的位置，则打开所指定的文件。 例如：设备设置信息文件的默认路径 Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml 例如：设备设置信息文件中的输入（当两个设备被注册时） 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.2) 在多个设备的设置信息中输入同一端口名称。更改为合适的不同的端口名称。 　　　 是端口名称。 对于新的端口名称，请参考在2.2)中所检查的“由通讯模块分配到设备的 端口名称”。 　　　更改前： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 　　　更改后： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.3) 保存设备设置信息文件。 4.2.5.2 步骤B 1) 设置USB端口设置[端口名称类型]到[序列号]。 2) 指定USB序列号作为端口名称。 USB序列号是为USB独占提供的序列号。 USB序列号可以用以下步骤检查。 - 执行打印机自检打印。 通常，如果在打印机盖板关闭并按下进纸开关的情况下，打开打印机电源，自检 打印则在卷纸上执行。 - 从打印结果中可以识别序列号。 当打印结果为a)格式时，显示的“ID”部分为USB序列 号(以下示例中YYYYYYYYYYYYYY即为序列号)。当打印结果为b)格式时，USB 序列号与打印机序列号相同。 在这种情况下，检查打印机上所附的标签。 a) 当打印USB序列号时 ---------- : Firmware Version X.XX ESC/POS Interface UB-UXXXX Ver.X.XX ID :YYYYYYYYYYYYYY : : ---------- b) 当不打印USB序列号时 ---------- : Firmware Version X.XX ESC/POS USB Interface or other : : ---------- * 上述所示“USB Interface or other”可能简单地打印为“USB Interface”。 注意当使用此方法设置设备时，使用不同的USB序列号更改设备时，需要更改 SetupPOS的设置。 注意在Linux上当使用序列号作为USB连接的端口名称类型时， 需要在SetupPOS上仅输入序列号的前17个字符。 如果当打开/关闭打印机时，显示“找到新的硬件向导”，则取消该向导并安装 EPSON高级打印机驱动程序(4.15或更高版本)。(仅限Windows) 4.2.6 POSPrinter - 尽管可以通过将directIO方法的命令参数指定为OUTPUT_NORMAL 或OUTPUT_REALTIME来直接发送命令到打印机， 但不要发送影响打印机设置的命令。 - 请勿在强光处使用分离发行模式下的TM-L90 Peeler。 - 在PageMode下的打印位置(居左/居中/居右)只能够在一行的开始处更改。 - TM-U950 ANK型号没有标记功能。在SetupPOS中有该功能的设置项目。该项目 必须设置为OFF。 - 在以下的情况下，当设备的NVRAM使用图像的注册时DeviceService比较 设备的图像注册信息与自身的匹配度。 * 调用setBitmap方法。 * 调用claim方法。 * 电源关闭/打开的恢复处理。 如果设备的信息与DeviceService不同，则这种情况需要很长时间。 - 当在PageMode下使用RightToLeft与LeftToRight方向时，已选择的位图在 以下条件下将不被打印： - 打印站为收据 - 该位图是由setBitmap注册的第二个(或更高)的位图 - 当执行setBitmap时，RecLetterQuality被设置为FALSE 上述条件适用于以下设备： - TM-T88III - TM-T88IIIX - TM-H5000II - TM-H5200 为了解决该问题，当执行setBitmap时，将RecLetterQuality设置为TRUE - 多色阶打印： 由于多色阶打印要使用更多的打印数据，通过串行或Ethernet接口打印可 能会变得不稳定，且打印结果会出现白色条纹。 4.2.7 LineDisplay - 该版本的LineDisplay服务不支持独立连接(单独使用LineDisplay)。 (仅限Linux) 如果您希望使用独立连接，请从下列任一所给网址中下载最新版本的驱动程序。 请登录以下任一网址并遵照屏幕上的说明。 北美客户： http://www.epsonexpert.com/ 其他国家的客户： http://www.epson-pos.com/ 4.2.8 CashDrawer - 当打印机出现错误时，使用openDrawer方法无法打开钱箱。在这种情况下， 请使用directIO方法。 4.2.9 Keylock - 使用Windows2000时的限制。 DM-KX060的键盘锁定功能(为IR-700的一个可选键盘)不可用。 - 尽管在DM-KX060手册中SetupPOS功能已被编档， 但当前的SetupPOS并不包括该设置。 “键位兼容性模式”将被设置为“UPOS规格”。 4.2.10 ElectronicJournal - 当使用ElectronicJournal时，不要关闭SetupPOS中POSPrinter的 “确认打印操作的完成”选项。 4.2.11 打印机电源打开时的状态送信 - 在已经使用JavaPOS后，当打开打印机电源时，一些打印机被设置传送打印机 状态的三个字节到主机。使用该状态以便在打印机电源打开时JavaPOS可以识 别。 4.2.12 徽标实用程序(TMFlogo等) - 徽标实用程序不在该软件包中。要上载徽标数据到永久性内存，请使用 setBitmap方法，或获取该徽标实用程序。 4.2.13 其他特别说明 - 当关闭/打开设备电源时，请在关闭设备后经常要等待至少5秒钟后再打开设备。 - 访问数据的权限(仅限Linux) 要存储必要的信息，JavaPOS创建一个名为“/var/epson/pos”的目录。设置 “/var/epson/pos”目录，所有子目录与所有文件的访问权限， 以便使用JavaPOS的用户可以写入。 - PDF文件 JavaPOS安装程序使用“xpdf”模块查看安装手册。请使用最新的“xpdf”模块 正确查看安装手册。(仅限Linux) 同样，当您使用Acrobat Reader查看手册时，我们推荐您使用最新版本的 Acrobat Reader。 - 当打印机处于使用状态时，如果计算机进入待机/休眠模式，驱动程序有可能 变得不稳定，所以不支持待机/休眠模式。 - 在SetupPOS上的拖放功能需要GTK 2.10.4或更高版本。 - 当在SLED 11环境中通过一个终端启动SetupPOS时，将显示GTK-warning。 但是，SetupPOS的操作将不受影响。 4.3 修订历史记录 [1.11.18版本] (1) POSPrinter - TM-T20的支持端口中追加了以太网。 - TM-T20-42C的支持端口中追加了以太网。 (2) ElectronicJournal - TM-T20的支持端口中追加了以太网。 - TM-T20-42C的支持端口中追加了以太网。 [1.11.17版本] (1) POSPrinter 仅安装JavaPOS 1.11.17 TM-T82: - 支持TM-T82型号南亚字符。 - 支持TM-T82-42C型号南亚字符。 - TM-T82的支持端口中追加了以太网。 - TM-T82-42C的支持端口中追加了以太网。 [1.11.16版本] (1) 通用 - 已添加支持Windows 7 SP1 (32位)，Windows 7 SP1 (64位)，及Windows Server 2008 R2 SP1 (64位)。 (2) POSPrinter - TM-H6000IV多国语字符型号已被添加为被支持的设备。 [1.11.15版本] (1) POSPrinter - 已添加支持TM-T82。 - 已添加支持TM-T82-42C。 [1.11.14版本] (1) 通用 - 已添加支持Red Hat Enterprise Linux 5.3 (64位)。 - 已添加支持SuSE Linux Enterprise 11 (64位)。 - 已添加支持Windows Embedded Standard 7 (32位)。 - 已添加支持Windows Embedded Standard 7 (64位)。 (2) POSPrinter - 已添加支持TM-H6000IV。 - 已添加支持TM-H2000。 - 已添加支持TM-T81。 (3) MICR - 已添加支持TM-H6000IV。 - 已添加支持TM-H2000。 (4) ElectronicJournal - 已添加支持TM-H6000IV。 [1.11.13版本] (1) 通用 - 已添加支持Windows Vista (64位)，Windows 7 (64位)， Windows Server 2008 R2 (64位)，Red Hat Enterprise Linux 5.3 (32位)， 及SuSE Linux Enterprise 11 (32位)。 - 已删除支持Red Hat Linux 9 (32位)， Red Hat Enterprise Linux 5 (32位)及SuSE Linux Enterprise 10 SP1 (32位) (2) POSPrinter - 已添加支持以串行连接的TM-T20。 - 已添加支持以串行连接的TM-T20-42C。 (3) ElectronicJournal - 已添加支持以串行连接的TM-T20。 - 已添加支持以串行连接的TM-T20-42C。 [1.11.12版本] (1) POSPrinter - 已添加支持TM-T88V(简体中文(GB18030)型号)。 - 已添加支持TM-T88V(繁体中文型号)。 - 已添加支持TM-T20。 - 已添加支持TM-T20-42C。 - 已添加多色阶打印功能。(仅限TM-T88V) - 已添加可选的外部蜂鸣器。(仅限TM-T88V) - 已添加一项设置以允许更改默认字符设置。(TM-T20) - 添加支持字符串打印的Unicode。(TM-T20) (2) ElectronicJournal - 已添加支持TM-T20。 - 已添加支持TM-T20-42C。 [1.11.11版本] (1) 通用 - 已添加支持单位软件包。 - 已添加支持Windows Server 2008 SP2，Windows Server 2008 R2， Windows Embedded Standard，与Windows 7。 (2) POSPrinter - 已添加支持TM-T88V。 - 已添加一项设置以允许更改默认字符设置。 (仅限TM-T88V) - 添加支持字符串打印的Unicode。(仅限TM-T88V) (3) ElectronicJournal - 已添加支持TM-T88V。 5. 仅安装JavaPOS 1.11.18 TM-T81 5.1 所支持的设备与已确认的固件版本 本发行支持以下设备。如果该型号显示一个已确认的版本，则推荐您使用该固件版 本。使用所指示的固件版本或更新版本。尽管使用较早的版本设备也将运作，但如果 您遇到任何问题，请使用所指示的版本(或更新版本)。 下表的接口列中所使用的符号是： S = 串行，U = USB，E = Ethernet(包括wireless)。 * POSPrinter 已确认的固件版本 [简体中文(GB18030)型号] TM-T81 (接口: S, U, E) 2.00版本 [南亚型号] TM-T81 (接口: S, U, E) 2.00版本 * CashDrawer Standard (接口: S, U, E) 5.2 特别说明 5.2.1 示例程序 - 当您使用该示例程序时，登录ID需要的是管理员帐户组。 - 使用逻辑设备名称注册。 POSPrinter : POSPrinter *中文 LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer *中文 MSR : MSR Keylock : Keylock ElectronicJournal : ElectronicJournal - 该示例程序显示一个(多个)控制方法的示例。 因此，不保证所有设备的所有设置的正确操作。 5.2.2 安装与卸载 - 当安装该软件时，请在以下目录中创建一个名为“epson\pos”的目录。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\Program Files Linux /var DeviceService操作所要求的临时文件和信息文件保存在“epson\pos”目录中。 不要删除该目录。 - 如果您选择“自定义”为安装类型并执行安装，不要为一个快捷文件夹指定根目 录(“/”)。快捷文件夹将不被创建。(仅限Linux) - 关于安装，当“msvcr71.dll”文件在\WINDOWS\System32\目录中被复制 或更新时，或者如果由安装程序进行安装的文件在安装时正在使用，则需要 重新启动。 - 关于卸载，由卸载程序进行卸载的文件在卸载时正在使用，则需要重新启动。 - 可以同时执行安装程序与卸载程序， 但是，该操作不被支持。(仅限Linux) - 在升级安装后，卸载程序有一个问题，即卸载程序无法删除所有安装目录。关于 默认安装目录位置，在Linux系统上卸载程序无法删除“/opt/EpsonJavaPOS” 目录；在Windows系统上卸载程序无法删除“C:\Program Files\Epson\JavaPOS” 与“C:\Program Files\Epson”目录。在卸载完成后您可以手动删除这些目录。 - 如果您选择“自定义”为安装类型并更改JavaPOS的服务的安装位置，您将无法 从安装程序所创建的CheckHealth工具的快捷方式上启动CheckHealth工具。 在这种情况下，请遵照以下说明更正快捷方式的基础Shell脚本(或批处理文件)。 - 在Red Hat Linux 9上完成卸载后，可能会出现对话框显示消息“由于严重错误， 应用程序‘gnome-terminal’(进程xxxx)已毁坏。(已中止)”。 这是一个已知的问题且不影响ADK的卸载。 - 在Linux上完成安装后，在该安装程序日志文件中可能会有一个由 “RPMSpecFile”所表示的“java.lang.NullPointerException”错误 (详细信息：“错误-存在一个创建RPM软件包的问题。您可能不是作为root 正在运行或者没有正确安装RPM Builder”)。 这是一个RPM问题且不影响ADK的操作。 - 该软件的较旧版本无法在该版本已安装的环境下进行安装。 为了安装这两种版本，请首先安装较旧的版本，然后安装该版本。 1) 删除 –jar选项 2) Classpath设置 要求Classpath设置的Jar文件如下所示： CheckHealthTest.jar (与CheckHealth工具的Shell脚本在同一目录中) jpos111.jar (位于JavaPOS的服务所在的安装目录) epsonupos.jar (位于JavaPOS的服务所在的安装目录) epsonupos.admin.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) epsonupos.trace.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T81.jar (位于JavaPOS的服务所在的安装目录) pos.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0001.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0002.jar (位于JavaPOS的服务所在的安装目录) uposcommon.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) xercesImpl.jar (位于JavaPOS的服务所在的安装目录) xml-apis.jar (位于JavaPOS的服务所在的安装目录) 3) 应用程序类名称 存储在CheckHealthTest.jar文件中的应用程序类为 “checkhealthtool.CheckHealthTool.” - 虽然使用无提示安装可以回滚到一个较旧的版本，但不支持该操作。请仅使用用 于创建无提示安装程序属性文件的安装程序版本。 5.2.3 跟踪功能 当使用跟踪(日志)功能时 - 跟踪结果保存在以下目录中。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\Program Files\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 5.2.4 串行通信 关于串行通信的特别说明(仅限Linux) - 与串行端口相连接的设备可以由JavaPOS中的串行端口驱动程序控制。 仅当您以root登录时，才允许该控制 (作为默认状态)。 除了root之外，使用以下步骤使用户能够控制该设备。 1) 添加一个用户到/var/lock目录所属的组中。在打开一个串行端口后，串行端口 驱动程序在/var/lock目录中创建一个锁定文件。使用默认配置的普通用户没有 权限访问该文件。因此，想要使用串行端口的用户必须被添加到该锁定目录 所属的组中。要添加一个用户到该组，请编辑/etc/group文件。/var/lock目录 属于该锁定组。 [修改/etc/group文件的示例] 以下示例显示如何通过修改/etc/group文件添加一个用户“jpos”到该组。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos 要添加更多用户，请使用逗号“,”来隔开用户名。 以下示例显示除“jpos”之外如何添加另一用户“jpos2”。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) 重新启动PC 除了root之外，用户现在可以访问该串行端口。 5.2.5 USB通信 关于使用USB通信的特别说明(仅限Linux) - 与USB端口相连接的设备可以由JavaPOS中的USB端口驱动程序控制。 当JavaPOS以USB连接方式访问可以由任何用户访问的设备时，使用 /dev/usb/usbtm*。 必要时设置一个合适的访问。 - 关于SuSE Linux Enterprise 10 SP1， 在安装USB驱动程序后，使用一个 文本编辑器打开“/etc/udev/rules.d/99-epson-usbtm.rules”文件， 并确保规则如下所示： KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" 单词“KERNEL”之后要求有两个“=”为了USB驱动程序功能正常。如果只 存在一个“=”，添加第二个“=”然后保存该文件。由于在更新版本中， UDEV规则语法有更改，故要求此操作。 - 当打开某一设备电源时，内核初始化USB端口需要几秒钟时间。在此期间无法 与该设备进行通信。 当使用USB接口时 如果同一类型的多个型号在USB连接中同时使用，必须手动配置设置。 5.2.5.1 步骤 1) 打开要连接的所有设备的电源。 2) 参考通讯模块的设置文件并检查分配到设备的通讯模块的端口名称。 2.1) 要检查端口名称，在文本编辑器中打开通讯模块的设置文件。 例如：通讯模块的设置文件的路径 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 例如：通讯模块的设置文件中的输入（当两个设备被连接时） 　　　 　　　 　　 　　 - 已省略- 　　　 　　 　　 2.2) 检查所分配的端口名称。 　　　 是分配到各个设备的端口名称。 3) 将SetupPOS中注册的设备设置信息与通讯模块中分配到设备的端口名称联合。 3.1) 在文本编辑器中打开在SetupPOS中注册的设备设置信息文件。当在SetupPOS 中保存设置时，如果指定保存设置信息文件的位置，则打开所指定的文件。 例如：设备设置信息文件的默认路径 Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml 例如：设备设置信息文件中的输入（当两个设备被注册时） 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.2) 在多个设备的设置信息中输入同一端口名称。更改为合适的不同的端口名称。 　　　 是端口名称。 对于新的端口名称，请参考在2.2)中所检查的“由通讯模块分配到设备的 端口名称”。 　　　更改前： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 　　　更改后： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.3) 保存设备设置信息文件。 5.2.6 POSPrinter - 尽管可以通过将directIO方法的命令参数指定为OUTPUT_NORMAL 或OUTPUT_REALTIME来直接发送命令到打印机， 但不要发送影响打印机设置的命令。 - 在PageMode下的打印位置(居左/居中/居右)只能够在一行的开始处更改。 - 在以下的情况下，当设备的NVRAM使用图像的注册时DeviceService比较 设备的图像注册信息与自身的匹配度。 * 调用setBitmap方法。 * 调用claim方法。 * 电源关闭/打开的恢复处理。 如果设备的信息与DeviceService不同，则这种情况需要很长时间。 - 多色阶打印： 由于多色阶打印要使用更多的打印数据，通过串行或Ethernet接口打印可 能会变得不稳定，且打印结果会出现白色条纹。 5.2.7 CashDrawer - 当打印机出现错误时，使用openDrawer方法无法打开钱箱。在这种情况下， 请使用directIO方法。 5.2.8 打印机电源打开时的状态送信 - 在使用JavaPOS后，当打开打印机电源时，一些打印机被设置传送打印机状态 的三个字节到主机。 使用该状态以便在打印机电源打开时JavaPOS可以识别。 5.2.9 徽标实用程序(TMFlogo等) - 徽标实用程序不在该软件包中。要上载徽标数据到永久性内存，请使用 setBitmap方法，或获取该徽标实用程序。 5.2.10 其他特别说明 - 当关闭/打开设备电源时，请在关闭设备后经常要等待至少5秒钟后再打开设备。 - 访问数据的权限(仅限Linux) 要存储必要的信息，JavaPOS创建一个名为“/var/epson/pos”的目录。设置 “/var/epson/pos”目录，所有子目录与所有文件的访问权限，以便使用Java POS的用户可以写入。 - PDF文件 JavaPOS安装程序使用“xpdf”模块查看安装手册。请使用最新的“xpdf”模块 正确查看安装手册。(仅限Linux) 同样，当您使用Acrobat Reader查看手册时，我们推荐您使用最新版本的 Acrobat Reader。 - 当打印机处于使用状态时，如果计算机进入待机/休眠模式，驱动程序有可能 变得不稳定，所以不支持待机/休眠模式。 - 在SetupPOS上的拖放功能需要GTK 2.10.4或更高版本。 - 当在SLED 11环境中通过一个终端启动SetupPOS时，将显示GTK-warning。 但是，SetupPOS的操作将不受影响。 5.3 修订历史记录 [1.11.18版本] (1) 通用 - EPSON JavaPOS ADK的履历升级为1.11.18，但TM-T81单体软件包的内容不变。 [1.11.17版本] (1) 通用 - EPSON JavaPOS ADK的履历升级为1.11.17，但TM-T81单体软件包的内容不变。 [1.11.16版本] (1) 通用 - 已添加支持Windows 7 SP1 (32位)，Windows 7 SP1 (64位)，及Windows Server 2008 R2 SP1 (64位)。 [1.11.14版本] - 初始版本 6. 仅安装JavaPOS 1.11.18 TM-T82 6.1 所支持的设备与已确认的固件版本 本发行支持以下设备。如果该型号显示一个已确认的版本，则推荐您使用该固件版 本。使用所指示的固件版本或更新版本。尽管使用较早的版本设备也将运作，但如果 您遇到任何问题，请使用所指示的版本(或更新版本)。 下表的接口列中所使用的符号是： S = 串行，U = USB，E = Ethernet(包括wireless)。 * POSPrinter 已确认的固件版本 [简体中文(GB18030)型号] TM-T82 (接口: S, U) 1.00版本 TM-T82 (接口: E) 2.00版本 TM-T82-42C (接口: S, U) 1.00版本 TM-T82-42C (接口: E) 2.00版本 [南亚型号] TM-T82 (接口: S, U) 1.00版本 TM-T82 (接口: E) 2.00版本 TM-T82-42C (接口: S, U) 1.00版本 TM-T82-42C (接口: E) 2.00版本 * CashDrawer Standard (接口: S, U, E) 6.2 特别说明 6.2.1 示例程序 - 当您使用该示例程序时，登录ID需要的是管理员帐户组。 - 使用逻辑设备名称注册。 POSPrinter : POSPrinter *中文 LineDisplay : LineDisplay MICR : MICR CheckScanner : CheckScanner CashDrawer : CashDrawer *中文 MSR : MSR Keylock : Keylock ElectronicJournal : ElectronicJournal - 该示例程序显示一个(多个)控制方法的示例。 因此，不保证所有设备的所有设置的正确操作。 6.2.2 安装与卸载 - 当安装该软件时，请在以下目录中创建一个名为“epson\pos”的目录。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users Windows Vista/2008 Server/Windows 7: :\Program Files Linux /var DeviceService操作所要求的临时文件和信息文件保存在“epson\pos”目录中。 不要删除该目录。 - 如果您选择“自定义”为安装类型并执行安装，不要为一个快捷文件夹指定根目 录(“/”)。快捷文件夹将不被创建。(仅限Linux) - 关于安装，当“msvcr71.dll”文件在\WINDOWS\System32\目录中被复制 或更新时，或者如果由安装程序进行安装的文件在安装时正在使用，则需要 重新启动。 - 关于卸载，由卸载程序进行卸载的文件在卸载时正在使用，则需要重新启动。 - 可以同时执行安装程序与卸载程序， 但是，该操作不被支持。(仅限Linux) - 在升级安装后，卸载程序有一个问题，即卸载程序无法删除所有安装目录。 关于默认安装目录位置，在Linux系统上卸载程序无法删除“/opt/EpsonJava POS”目录；在Windows系统上卸载程序无法删除“C:\Program Files\Epson\ JavaPOS” 与“C:\Program Files\Epson”目录。在卸载完成后您可以手动删除这些目录。 - 如果您选择“自定义”为安装类型并更改JavaPOS的服务的安装位置，您将无法 从安装程序所创建的CheckHealth工具的快捷方式上启动CheckHealth工具。 在这种情况下，请遵照以下说明更正快捷方式的基础Shell脚本(或批处理文件)。 - 在Red Hat Linux 9上完成卸载后，可能会出现对话框显示消息“由于严重错误， 应用程序‘gnome-terminal’(进程xxxx)已毁坏。(已中止)”。 这是一个已知的问题且不影响ADK的卸载。 - 在Linux上完成安装后，在该安装程序日志文件中可能会有一个由“RPMSpec File”所表示的“java.lang.NullPointerException”错误 (详细信息：“错误-存在一个创建RPM软件包的问题。您可能不是作为root 正在运行或者没有正确安装RPM Builder”)。 这是一个RPM问题且不影响ADK的操作。 - 该软件的较旧版本无法在该版本已安装的环境下进行安装。 为了安装这两种版本，请首先安装较旧的版本，然后安装该版本。 1) 删除 –jar选项 2) Classpath设置 要求Classpath设置的Jar文件如下所示： CheckHealthTest.jar (与CheckHealth工具的Shell脚本在同一目录中) jpos111.jar (位于JavaPOS的服务所在的安装目录) epsonupos.jar (位于JavaPOS的服务所在的安装目录) epsonupos.admin.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) epsonupos.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) epsonupos.trace.jar (位于JavaPOS的服务所在的安装目录) epsonupos.T82.jar (位于JavaPOS的服务所在的安装目录) pos.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0001.jar (位于JavaPOS的服务所在的安装目录) pos.v2.0002.jar (位于JavaPOS的服务所在的安装目录) uposcommon.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0001.jar (位于JavaPOS的服务所在的安装目录) uposcommon.core.v1.11.0002.jar (位于JavaPOS的服务所在的安装目录) xercesImpl.jar (位于JavaPOS的服务所在的安装目录) xml-apis.jar (位于JavaPOS的服务所在的安装目录) 3) 应用程序类名称 存储在CheckHealthTest.jar文件中的应用程序类为 “checkhealthtool.CheckHealthTool.” - 虽然使用无提示安装可以回滚到一个较旧的版本，但不支持该操作。请仅使用用 于创建无提示安装程序属性文件的安装程序版本。 6.2.3 跟踪功能 当使用跟踪(日志)功能时 - 跟踪结果保存在以下目录中。 Windows Windows 2000/XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\Program Files\EPSON\pos\tm\Trace Linux /var/epson/pos/trace 6.2.4 串行通信 关于串行通信的特别说明(仅限Linux) - 与串行端口相连接的设备可以由JavaPOS中的串行端口驱动程序控制。 仅当您以root登录时，才允许该控制 (作为默认状态)。 除了root之外，使用以下步骤使用户能够控制该设备。 1) 添加一个用户到/var/lock目录所属的组中。在打开一个串行端口后，串行端口 驱动程序在/var/lock目录中创建一个锁定文件。使用默认配置的普通用户没有 权限访问该文件。因此，想要使用串行端口的用户必须被添加到该锁定目录 所属的组中。要添加一个用户到该组，请编辑/etc/group文件。/var/lock目录 属于该锁定组。 [修改/etc/group文件的示例] 以下示例显示如何通过修改/etc/group文件添加一个用户“jpos”到该组。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos 要添加更多用户，请使用逗号“,”来隔开用户名。 以下示例显示除“jpos”之外如何添加另一用户“jpos2”。 修改前 修改后 lock:x:54:lock lock:x:54:lock,jpos,jpos2 2) 重新启动PC 除了root之外，用户现在可以访问该串行端口。 6.2.5 USB通信 关于使用USB通信的特别说明(仅限Linux) - 与USB端口相连接的设备可以由JavaPOS中的USB端口驱动程序控制。 当JavaPOS以USB连接方式访问可以由任何用户访问的设备时，使用 /dev/usb/usbtm*。 必要时设置一个合适的访问。 - 关于SuSE Linux Enterprise 10 SP1， 在安装USB驱动程序后，使用一个 文本编辑器打开“/etc/udev/rules.d/99-epson-usbtm.rules”文件， 并确保规则如下所示： KERNEL=="usbtm*", NAME="usb/%k", MODE="0666" 单词“KERNEL”之后要求有两个“=”为了USB驱动程序功能正常。如果只 存在一个“=”，添加第二个“=”然后保存该文件。由于在更新版本中， UDEV规则语法有更改，故要求此操作。 - 当打开某一设备电源时，内核初始化USB端口需要几秒钟时间。在此期间无法 与该设备进行通信。 当使用USB接口时 如果同一类型的多个型号在USB连接中同时使用，必须手动配置设置。 6.2.5.1 步骤 1) 打开要连接的所有设备的电源。 2) 参考通讯模块的设置文件并检查分配到设备的通讯模块的端口名称。 2.1) 要检查端口名称，在文本编辑器中打开通讯模块的设置文件。 例如：通讯模块的设置文件的路径 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 例如：通讯模块的设置文件中的输入（当两个设备被连接时） 　　　 　　　 　　 　　 - 已省略- 　　　 　　 　　 2.2) 检查所分配的端口名称。 　　　 是分配到各个设备的端口名称。 3) 将SetupPOS中注册的设备设置信息与通讯模块中分配到设备的端口名称联合。 3.1) 在文本编辑器中打开在SetupPOS中注册的设备设置信息文件。当在SetupPOS 中保存设置时，如果指定保存设置信息文件的位置，则打开所指定的文件。 例如：设备设置信息文件的默认路径 Windows Windows 2000/XP/Embedded: Windows Vista/2008 Server/Windows 7: C:\Program Files\EPSON\JavaPOS\SetupPOS\jpos.xml Linux /jpos.xml 例如：设备设置信息文件中的输入（当两个设备被注册时） 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.2) 在多个设备的设置信息中输入同一端口名称。更改为合适的不同的端口名称。 　　　 是端口名称。 对于新的端口名称，请参考在2.2)中所检查的“由通讯模块分配到设备的 端口名称”。 　　　更改前： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 　　　更改后： 　　　 - 已省略- 　　　 - 已省略- 　　　 - 已省略- 　　　 3.3) 保存设备设置信息文件。 如果当打开/关闭打印机时，显示“找到新的硬件向导”，则取消该向导并安装 EPSON高级打印机驱动程序(4.14或更高版本)。(仅限Windows) 6.2.6 POSPrinter - 尽管可以通过将directIO方法的命令参数指定为OUTPUT_NORMAL 或OUTPUT_REALTIME来直接发送命令到打印机， 但不要发送影响打印机设置的命令。 - 在PageMode下的打印位置(居左/居中/居右)只能够在一行的开始处更改。 - 在以下的情况下，当设备的NVRAM使用图像的注册时DeviceService比较 设备的图像注册信息与自身的匹配度。 * 调用setBitmap方法。 * 调用claim方法。 * 电源关闭/打开的恢复处理。 如果设备的信息与DeviceService不同，则这种情况需要很长时间。 - 多色阶打印： 由于多色阶打印要使用更多的打印数据，通过串行或Ethernet接口打印可 能会变得不稳定，且打印结果会出现白色条纹。 6.2.7 CashDrawer - 当打印机出现错误时，使用openDrawer方法无法打开钱箱。在这种情况下， 请使用directIO方法。 6.2.8 打印机电源打开时的状态送信 - 在使用JavaPOS后，当打开打印机电源时，一些打印机被设置传送打印机状态 的三个字节到主机。 使用该状态以便在打印机电源打开时JavaPOS可以识别。 6.2.9 徽标实用程序(TMFlogo等) - 徽标实用程序不在该软件包中。要上载徽标数据到永久性内存，请使用 setBitmap方法，或获取该徽标实用程序。 6.2.10 其他特别说明 - 当关闭/打开设备电源时，请在关闭设备后经常要等待至少5秒钟后再打开设备。 - 访问数据的权限(仅限Linux) 要存储必要的信息，JavaPOS创建一个名为“/var/epson/pos”的目录。设置 “/var/epson/pos”目录，所有子目录与所有文件的访问权限，以便使用Java POS的用户可以写入。 - PDF文件 JavaPOS安装程序使用“xpdf”模块查看安装手册。请使用最新的“xpdf”模块 正确查看安装手册。(仅限Linux) 同样，当您使用Acrobat Reader查看手册时，我们推荐您使用最新版本的 Acrobat Reader。 - 当打印机处于使用状态时，如果计算机进入待机/休眠模式，驱动程序有可能 变得不稳定，所以不支持待机/休眠模式。 - 在SetupPOS上的拖放功能需要GTK 2.10.4或更高版本。 - 当在SLED 11环境中通过一个终端启动SetupPOS时，将显示GTK-warning。 但是，SetupPOS的操作将不受影响。 6.3 修订历史记录 [1.11.18版本] (1) 通用 - EPSON JavaPOS ADK的履历升级为1.11.18，但TM-T82单体软件包的内容不变。 [1.11.17版本] (1) POSPrinter - 支持TM-T82型号南亚字符。 - 支持TM-T82-42C型号南亚字符。 - TM-T82的支持端口中追加了以太网。 - TM-T82-42C的支持端口中追加了以太网。 [1.11.16版本] (1) 通用 - 已添加支持Windows 7 SP1 (32位)，Windows 7 SP1 (64位)，及Windows Server 2008 R2 SP1 (64位)。 [1.11.15版本] - 初始版本