EPSON OPOS ADK for .NET Version 1.11.18 Release Notes Seiko Epson Corporation May 20, 2011 1. Outline EPSON OPOS ADK for .NET Version 1.11.18 has been released. Using this release, you can develop applications that are compatible with Microsoft POS for .NET 1.11 (corresponding to UnifiedPOS specification Ver 1.11). When developing applications, use a separate development environment such as Microsoft Visual Studio .NET. This release note contains information for multiple packages. Please refer to the information for the product you are installing. [EPSON OPOS ADK for .NET 1.11.18 Standard install] 2. Confirmed operating environment 3. Installation and uninstallation 4. OPOS.NET 1.11.18 Standard install [EPSON OPOS ADK for .NET 1.11.18 TM-T88V only install] 2. Confirmed operating environment 3. Installation and uninstallation 5. OPOS.NET 1.11.18 TM-T88V only install [EPSON OPOS ADK for .NET 1.11.18 TM-T20 only install] 2. Confirmed operating environment 3. Installation and uninstallation 6. OPOS.NET 1.11.18 TM-T20 only install [EPSON OPOS ADK for .NET 1.11.18 TM-T81 only install] 2. Confirmed operating environment 3. Installation and uninstallation 7. OPOS.NET 1.11.18 TM-T81 only install [EPSON OPOS ADK for .NET 1.11.18 TM-T82 only install] 2. Confirmed operating environment 3. Installation and uninstallation 8. OPOS.NET 1.11.18 TM-T82 only install 2. Confirmed operating environment Operation of EPSON OPOS ADK for .NET has been confirmed in the following environment. (1) OS (Operating system) Windows Embedded for Point of Service (32bit) Windows XP Professional SP3 (32bit) Windows Vista SP2 (32bit) Windows Server 2008 SP2 (32bit) Windows Server 2008 R2 SP1 (64bit) Windows 7 SP1 (32bit) Windows 7 SP1 (64bit) Windows Embedded Standard (32bit) Windows Embedded POSReady 2009 (32bit) Windows Embedded Standard 7 (32bit) Windows Embedded Standard 7 (64bit) (2) .NET Framework Microsoft .NET Framework 2.0 Microsoft .NET Framework 3.0 Microsoft .NET Framework 3.5 (3) Programming languages Microsoft Visual C# .NET Microsoft Visual Basic .NET (4) Build platform settings The build platform for applications must be set to "Any CPU". (5) POS for .NET Microsoft POS for .NET 1.11 3. Installation and uninstallation Please note that due to the limitations imposed by InstallShield 12 on the EPSON OPOS for .NET ADK installer, initialization and clearing of installer processes may be slowed down. Follow the procedure in "EPSON OPOS ADK for .NET Installation Guide" for installation and uninstallation. 4. OPOS.NET 1.11.18 Standard install 4.1 Supported devices and confirmed firmware versions Please refer to "SupportedDevicesList.txt" for details. 4.2. Special notes 4.2.1 Sample program - When you use the sample program, the Logon ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : PosPrinter LineDisplay : LineDisplay Micr : Micr CheckScanner : CheckScanner CashDrawer : CashDrawer Scanner : Scanner Msr : Msr Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. That is why, it does not guarantee the correct operations for all the settings of all the devices. 4.2.2 Installation and uninstallation - When installing the software, create a directory with the name "EPSON" in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\ Windows Vista/2008 Server/Windows 7: :\ProgramData\ Temporary files and information files required by ServiceObject operations are saved in this "EPSON" directory. Do not delete the directory. 4.2.3 When using the EPSON original constant - The EPSON original constant is defined in the "Epson.opos.tm.common.dll." When using the EPSON original constant, add a reference to "Epson.opos.tm.common.dll" in the install directory. 4.2.4 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace 4.2.5 Serial interface - Normally COM ports COM1 through COM9 can be used. To use COM ports COM10 and above, it is necessary to add "\\.\" to the start of the port name registered in SetupPOS. For example, to use COM10, register "\\.\COM10." 4.2.6 Parallel interface - After turning the device off, there is a delay of several seconds before the ServiceObject recognizes that the power is off. - The ECP mode is not supported for the parallel mode set in the BIOS. Also the EPP mode is not recommended. 4.2.7 USB interface If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. Note that the procedure varies by model. - If the devices below are registered in SetupPOS registration, configure the settings in "4.2.7.1 Procedure A". - TM-T88V/TM-T20/TM-T20-42C/TM-H6000IV/TM-H2000/TM-T81/TM-T82/ TM-T82-42C - If models other than those above are used, configure the settings in "4.2.7.2 Procedure B". 4.2.7.1 Procedure A 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows 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 Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. Example: Default path of device settings information file Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\Microsoft\ Point Of Service\Configuration\Configuration.xml Windows Vista/2008 Server/Windows 7: C:\ProgramData\Microsoft\Point Of Service\Configuration\ Configuration.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. 4.2.7.2 Procedure B 1) Set the USB port setting [Port Name Type] to [Serial Number]. 2) Specify the USB serial number as the port name. The USB serial number is a serial number provided exclusively for USB. The USB serial number can be checked with the following procedure. - Perform a printer self-test print. Generally, if the printer is turned on with the printer cover closed and the FEED switch held down, self-test printing is performed on roll paper. - The serial number can be identified from the print results. When the print results are in format a), the part shown as "ID" is the USB serial number (in the example below YYYYYYYYYYYYYY is the serial number). When the print results are in format b), the USB serial number is the same as the printer serial number. In this case, check the label attached to the printer. a) When the USB serial number is printed ---------- : Firmware Version X.XX ESC/POS Interface UB-UXXXX Ver.X.XX ID :YYYYYYYYYYYYYY : : ---------- b) When the USB serial number is not printed ---------- : Firmware Version X.XX ESC/POS USB Interface or other : : ---------- * "USB Interface or other" shown above may be printed simply as "USB Interface." Note that when setting the device using this method, changing a device with a different USB serial number, requires changing the SetupPOS settings. 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.15 or later). 4.2.8 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. - 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.9 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 OPOS.NET has been used. This status is used so that OPOS.NET will recognize when the printer is on. 4.2.10 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.11 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - When using a non-switching hub with the Ethernet i/f: High traffic may cause many packets to be dropped and the printer to appear Offline. - The following configuration is a known limitation: - Default guest account of OS and the Ethernet interface. Note: A known workaround is to not use the "Default" guest account, but to create and use another guest account. - 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 4.3 Revision history [Version 1.11.18] (1) POSPrinter - Ethernet was added to the TM-T20 support interfaces. - Ethernet was added to the TM-T20-42C support interfaces. (2) ElectronicJournal - Ethernet was added to the TM-T20 support interfaces. - Ethernet was added to the TM-T20-42C support interfaces. [Version 1.11.17] (1) POSPrinter EPSON OPOS ADK for .NET 1.11.17 TM-T82 only install: - Added support for South Asian languages in a multilingual model of the TM-T82. - Added support for South Asian languages in a multilingual model of the TM-T82-42C. - Ethernet was added to the TM-T82 support interfaces. - Ethernet was added to the TM-T82-42C support interfaces. [Version 1.11.16] (1) Common - Added support for Windows 7 SP1 (32bit), Windows 7 SP1 (64bit), and Windows Server 2008 R2 SP1 (64bit). (2) POSPrinter - TM-H6000IV Multilingual Character model was added as a supported device. [Version 1.11.15] (1) POSPrinter - TM-T82 model was added as a supported device. - TM-T82-42C model was added as a supported device. [Version 1.11.14] (1) Common - Added support for Windows Embedded Standard 7 (32bit) and Windows Embedded Standard 7 (64bit). (2) POSPrinter - Added support for the TM-H6000IV(ANK model) - Added support for the TM-H2000 - Added support for the TM-T81(Simplified Chinese(GB18030) model) - Added support for the TM-T81(South Asia model) (3) MICR - Added support for the TM-H6000IV(ANK model) - Added support for the TM-H2000 (4) ElectronicJournal - Added support for the TM-H6000IV(ANK model) [Version 1.11.13] (1) POSPrinter - Added support for the TM-T20(Japanese model) - Added support for the TM-T20-42C(Japanese model) - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. (2) ElectronicJournal - Added support for the TM-T20(Japanese model) - Added support for the TM-T20-42C(Japanese model) - 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(Japanese 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) (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 Server 2008 R2, Windows Embedded Standard, Windows Embedded POSReady 2009, 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) (3) ElectronicJournal - Added support for the TM-T88V 5. OPOS.NET 1.11.18 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, P = Parallel, U = USB, E = Ethernet (including wireless). Notes: [1] Indicates a devices that is only supported on the following OSes: Windows XP, Windows Embedded for Point Of Service, Windows Embedded Standard, Windows Embedded POSReady 2009 (Japanese models) POS printer's Japanese language models are confirmed only on the Japanese edition of the OS. * POS printer Confirmed Firmware version [ANK model] TM-T88V (I/F: S, P, U, E) Ver 30.12 [Japanese language model] TM-T88V (I/F: S, P, U, E) Ver 30.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) Ver 1.03 [1] * Drawer Standard (I/F: S, P, U, E) * Electronic Journal Confirmed Firmware version [ANK model] TM-T88V (I/F: S, P, U, E) Ver 30.12 [Japanese language model] TM-T88V (I/F: S, P, U, E) Ver 30.12 5.2 Special notes 5.2.1 Sample program - When you use the sample program, the Logon ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : PosPrinter LineDisplay : LineDisplay Micr : Micr CheckScanner : CheckScanner CashDrawer : CashDrawer Scanner : Scanner Msr : Msr Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. That is why, it does not guarantee the correct operations for all the settings of all the devices. 5.2.2 Installation and uninstallation - When installing the software, create a directory with the name "EPSON" in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\ Windows Vista/2008 Server/Windows 7: :\ProgramData\ Temporary files and information files required by ServiceObject operations are saved in this "EPSON" directory. Do not delete the directory. 5.2.3 When using the EPSON original constant - The EPSON original constant is defined in the "Epson.opos.tm.common.dll." When using the EPSON original constant, add a reference to "Epson.opos.tm.common.dll" in the install directory. 5.2.4 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace 5.2.5 Serial interface - Normally COM ports COM1 through COM9 can be used. To use COM ports COM10 and above, it is necessary to add "\\.\" to the start of the port name registered in SetupPOS. For example, to use COM10, register "\\.\COM10." 5.2.6 Parallel interface - After turning the device off, there is a delay of several seconds before the ServiceObject recognizes that the power is off. - The ECP mode is not supported for the parallel mode set in the BIOS. Also the EPP mode is not recommended. 5.2.7 USB interface If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 5.2.7.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows 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 Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. Example: Default path of device settings information file Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\Microsoft\ Point Of Service\Configuration\Configuration.xml Windows Vista/2008 Server/Windows 7: C:\ProgramData\Microsoft\Point Of Service\Configuration\ Configuration.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. 5.2.8 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. - 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.9 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 OPOS.NET has been used. This status is used so that OPOS.NET will recognize when the printer is on. 5.2.10 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.11 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - When using a non-switching hub with the Ethernet i/f: High traffic may cause many packets to be dropped and the printer to appear Offline. - The following configuration is a known limitation: - Default guest account of OS and the Ethernet interface. Note: A known workaround is to not use the "Default" guest account, but to create and use another guest account. - 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 5.3 Revision history [Version 1.11.18] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.18. This update does not affect the standalone TM-T88V package. [Version 1.11.17] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.17. This update does not affect the standalone TM-T88V package. [Version 1.11.16] (1) Common - Added support for Windows Embedded Standard 7 (32bit) and Windows Embedded Standard 7 (64bit). - Added support for Windows 7 SP1 (32bit), Windows 7 SP1 (64bit), and Windows Server 2008 R2 SP1 (64bit). [Version 1.11.12] - Added support for the TM-T88V(Japanese model) - Added the Multi-tone printing feature. - Added the Optional external buzzer. [Version 1.11.11] - Initial version 6. OPOS.NET 1.11.18 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, P = Parallel, U = USB, E = Ethernet (including wireless). Notes: [1] Indicates a devices that is only supported on the following OSes: Windows XP, Windows Embedded for Point Of Service, Windows Embedded Standard, Windows Embedded POSReady 2009 (Japanese models) POS printer's Japanese language models are confirmed only on the Japanese edition of the OS. * POS printer Confirmed Firmware version [ANK models] TM-T20 (I/F: S,U) Ver 1.00 TM-T20 (I/F: E) Ver 2.00 TM-T20-42C (I/F: S,U) Ver 1.00 TM-T20-42C (I/F: E) Ver 2.00 [Japanese language models] TM-T20 (I/F: U) Ver 1.01 TM-T20-42C (I/F: U) Ver 1.01 * Line display Confirmed Firmware version DM-D110 (I/F: S) Ver 1.01 DM-D210 (I/F: S) Ver 1.01 DM-D500 (I/F: S) Ver 1.10 DM-D120 (I/F: S) Ver 1.03 [1] * Drawer Standard (I/F: S,U,E) * Electronic Journal Confirmed Firmware version [ANK models] TM-T20 (I/F: S,U) Ver 1.00 TM-T20 (I/F: E) Ver 2.00 TM-T20-42C (I/F: S,U) Ver 1.00 TM-T20-42C (I/F: E) Ver 2.00 [Japanese language models] TM-T20 (I/F: U) Ver 1.01 TM-T20-42C (I/F: U) Ver 1.01 6.2 Special notes 6.2.1 Sample program - When you use the sample program, the Logon ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : PosPrinter LineDisplay : LineDisplay Micr : Micr CheckScanner : CheckScanner CashDrawer : CashDrawer Scanner : Scanner Msr : Msr Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. That is why, it does not guarantee the correct operations for all the settings of all the devices. 6.2.2 Installation and uninstallation - When installing the software, create a directory with the name "EPSON" in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\ Windows Vista/2008 Server/Windows 7: :\ProgramData\ Temporary files and information files required by ServiceObject operations are saved in this "EPSON" directory. Do not delete the directory. 6.2.3 When using the EPSON original constant - The EPSON original constant is defined in the "Epson.opos.tm.common.dll." When using the EPSON original constant, add a reference to "Epson.opos.tm.common.dll" in the install directory. 6.2.4 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace 6.2.5 Serial interface - Normally COM ports COM1 through COM9 can be used. To use COM ports COM10 and above, it is necessary to add "\\.\" to the start of the port name registered in SetupPOS. For example, to use COM10, register "\\.\COM10." 6.2.6 USB interface If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 6.2.6.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows 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 Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. Example: Default path of device settings information file Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\Microsoft\ Point Of Service\Configuration\Configuration.xml Windows Vista/2008 Server/Windows 7: C:\ProgramData\Microsoft\Point Of Service\Configuration\ Configuration.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.10 or later). 6.2.7 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. 6.2.8 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after OPOS.NET has been used. This status is used so that OPOS.NET will recognize when the printer is on. 6.2.9 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 6.2.10 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - When using a non-switching hub with the Ethernet i/f: High traffic may cause many packets to be dropped and the printer to appear Offline. - The following configuration is a known limitation: - Default guest account of OS and the Ethernet interface. Note: A known workaround is to not use the "Default" guest account, but to create and use another guest account. - 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. 6.3 Revision history [Version 1.11.18] (1) POSPrinter - Ethernet was added to the TM-T20 support interfaces. - Ethernet was added to the TM-T20-42C support interfaces. (2) ElectronicJournal - Ethernet was added to the TM-T20 support interfaces. - Ethernet was added to the TM-T20-42C support interfaces. [Version 1.11.17] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.17. This update does not affect the standalone TM-T20 package. [Version 1.11.16] (1) Common - Added support for Windows Embedded Standard 7 (32bit) and Windows Embedded Standard 7 (64bit). - Added support for Windows 7 SP1 (32bit), Windows 7 SP1 (64bit), and Windows Server 2008 R2 SP1 (64bit). [Version 1.11.13] (1) POSPrinter - Added support for the TM-T20(Japanese model) - Added support for the TM-T20-42C(Japanese model) - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. (2) ElectronicJournal - Added support for the TM-T20(Japanese model) - Added support for the TM-T20-42C(Japanese model) - Added support for the TM-T20 with a serial connection. - Added support for the TM-T20-42C with a serial connection. [Version 1.11.12] - Initial version 7. OPOS.NET 1.11.18 TM-T81 only install 7.1 Supported devices and confirmed firmware versions In this release, the following devices are supported. If the model has a confirmed version shown, it is recommended that you use that version of the firmware. Use the indicated firmware version or newer. Although it will work with an earlier version, use the indicated version (or newer) if you experience any difficulties. The symbols used in the I/F (interface) column in the following table are S = Serial, P = Parallel, U = USB, E = Ethernet (including wireless). * POS printer Confirmed Firmware version [Simplified Chinese(GB18030) models] TM-T81 (I/F: S, P, U, E) Ver 2.00 [South Asia models] TM-T81 (I/F: S, P, U, E) Ver 2.00 * Drawer Standard (I/F: S, P, U, E) 7.2. Special notes 7.2.1 Sample program - When you use the sample program, the Logon ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : PosPrinter LineDisplay : LineDisplay Micr : Micr CheckScanner : CheckScanner CashDrawer : CashDrawer Scanner : Scanner Msr : Msr Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. That is why, it does not guarantee the correct operations for all the settings of all the devices. 7.2.2 Installation and uninstallation - When installing the software, create a directory with the name "EPSON" in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\ Windows Vista/2008 Server/Windows 7: :\ProgramData\ Temporary files and information files required by ServiceObject operations are saved in this "EPSON" directory. Do not delete the directory. 7.2.3 When using the EPSON original constant - The EPSON original constant is defined in the "Epson.opos.tm.common.dll." When using the EPSON original constant, add a reference to "Epson.opos.tm.common.dll" in the install directory. 7.2.4 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace 7.2.5 Serial interface - Normally COM ports COM1 through COM9 can be used. To use COM ports COM10 and above, it is necessary to add "\\.\" to the start of the port name registered in SetupPOS. For example, to use COM10, register "\\.\COM10." 7.2.6 Parallel interface - After turning the device off, there is a delay of several seconds before the ServiceObject recognizes that the power is off. - The ECP mode is not supported for the parallel mode set in the BIOS. Also the EPP mode is not recommended. 7.2.7 USB interface If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 7.2.7.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows 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 Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. Example: Default path of device settings information file Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\Microsoft\ Point Of Service\Configuration\Configuration.xml Windows Vista/2008 Server/Windows 7: C:\ProgramData\Microsoft\Point Of Service\Configuration\ Configuration.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. 7.2.8 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. - 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. 7.2.9 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 OPOS.NET has been used. This status is used so that OPOS.NET will recognize when the printer is on. 7.2.10 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 7.2.11 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - When using a non-switching hub with the Ethernet i/f: High traffic may cause many packets to be dropped and the printer to appear Offline. - The following configuration is a known limitation: - Default guest account of OS and the Ethernet interface. Note: A known workaround is to not use the "Default" guest account, but to create and use another guest account. - 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 7.3 Revision history [Version 1.11.18] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.18. This update does not affect the standalone TM-T81 package. [Version 1.11.17] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.17. This update does not affect the standalone TM-T81 package. [Version 1.11.16] (1) Common - Added support for Windows 7 SP1 (32bit), Windows 7 SP1 (64bit), and Windows Server 2008 R2 SP1 (64bit). [Version 1.11.14] - Initial version 8. OPOS.NET 1.11.18 TM-T82 only install 8.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, P = Parallel, U = USB, E = Ethernet (including wireless). * POS printer Confirmed Firmware version [Simplified Chinese(GB18030) models] TM-T82 (I/F: S, U) Ver 1.00 TM-T82 (I/F: E) Ver 2.00 TM-T82-42C (I/F: S, U) Ver 1.00 TM-T82-42C (I/F: E) Ver 2.00 [South Asia models] TM-T82 (I/F: S, U) Ver 1.00 TM-T82 (I/F: E) Ver 2.00 TM-T82-42C (I/F: S, U) Ver 1.00 TM-T82-42C (I/F: E) Ver 2.00 * Drawer Standard (I/F: S, U, E) 8.2 Special notes 8.2.1 Sample program - When you use the sample program, the Logon ID needs to be the Administrator account group. - Register with the logical device name. POSPrinter : PosPrinter LineDisplay : LineDisplay Micr : Micr CheckScanner : CheckScanner CashDrawer : CashDrawer Scanner : Scanner Msr : Msr Keylock : Keylock ElectronicJournal: ElectronicJournal - The sample program shows an example(s) of control methods. That is why, it does not guarantee the correct operations for all the settings of all the devices. 8.2.2 Installation and uninstallation - When installing the software, create a directory with the name "EPSON" in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\ Windows Vista/2008 Server/Windows 7: :\ProgramData\ Temporary files and information files required by ServiceObject operations are saved in this "EPSON" directory. Do not delete the directory. 8.2.3 When using the EPSON original constant - The EPSON original constant is defined in the "Epson.opos.tm.common.dll." When using the EPSON original constant, add a reference to "Epson.opos.tm.common.dll" in the install directory. 8.2.4 The Trace function When using the tracing (log) function - Tracing results are saved in the following directory. Windows XP/Embedded: :\Documents and Settings\All Users\EPSON\pos\tm\Trace Windows Vista/2008 Server/Windows 7: :\ProgramData\EPSON\pos\tm\Trace 8.2.5 Serial interface - Normally COM ports COM1 through COM9 can be used. To use COM ports COM10 and above, it is necessary to add "\\.\" to the start of the port name registered in SetupPOS. For example, to use COM10, register "\\.\COM10." 8.2.6 USB interface If multiple models of the same type are used in USB connections at the same time, settings must be configured manually. 8.2.6.1 Procedure 1) Turn on the power of all devices to be connected. 2) Refer to the settings file of the communication module and check the port names that the communication module assigned to the devices. 2.1) To check the port names, open the settings file of the communication module in a text editor. Example: Path of settings file of communication module Windows 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 Example: Entries in settings file of communication module (when two devices are connected) - Omitted - 2.2) Check the assigned port names. is the port name assigned to each device. 3) Associate the device settings information registered in SetupPOS with the port name assigned to the device by the communication module. 3.1) Open the device settings information file registered in SetupPOS in a text editor. Example: Default path of device settings information file Windows 2000/XP/Embedded: C:\Documents and Settings\All Users\Application Data\Microsoft\ Point Of Service\Configuration\Configuration.xml Windows Vista/2008 Server/Windows 7: C:\ProgramData\Microsoft\Point Of Service\Configuration\ Configuration.xml Example: Entries in device settings information file (when two devices are registered) - Omitted - - Omitted - - Omitted - 3.2) The same port name is entered in the settings information of multiple devices. Change to different port names as appropriate. is the port name. For the new port names, refer to the "port names assigned by the communication module to the devices" that you checked in 2.2). Before change: - Omitted - - Omitted - - Omitted - After change: - Omitted - - Omitted - - Omitted - 3.3) Save the device settings information file. If the "Found new hardware wizard" is displayed when the printer is turned ON/OFF, cancel the wizard and install the EPSON Advanced Printer Driver (Version 4.14 or later). 8.2.7 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. 8.2.8 Status transmission from the printer when it is turned on - Some printers are set to transmit three bytes of printer status to the host PC when the power is turned on after OPOS.NET has been used. This status is used so that OPOS.NET will recognize when the printer is on. 8.2.9 The logo utility (TMFlogo, etc.) - The logo utility is not in this package. For uploading logo data to nonvolatile memory, please use SetBitmap method, or please obtain the logo utility. 8.2.10 Other special notes - When turning the device off/on, always wait at least 5 seconds after turning it off before turning it on again. - When using a non-switching hub with the Ethernet i/f: High traffic may cause many packets to be dropped and the printer to appear Offline. - The following configuration is a known limitation: - Default guest account of OS and the Ethernet interface. Note: A known workaround is to not use the "Default" guest account, but to create and use another guest account. - 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. 8.3 Revision history [Version 1.11.18] (1) Common - EPSON OPOS ADK for .NET was updated to version 1.11.18. This update does not affect the standalone TM-T82 package. [Version 1.11.17] (1) POSPrinter - Added support for South Asian languages in a multilingual model of the TM-T82. - Added support for South Asian languages in a multilingual model of the TM-T82-42C. - Ethernet was added to the TM-T82 support interfaces. - Ethernet was added to the TM-T82-42C support interfaces. [Version 1.11.16] (1) Common - Added support for Windows 7 SP1 (32bit), Windows 7 SP1 (64bit), and Windows Server 2008 R2 SP1 (64bit). [Version 1.11.15] - Initial version