EPSON OPOS ADK for .NET Version 1.11.12 Release Notes Seiko Epson Corporation Last Updated: March 26, 2010 1. Outline EPSON OPOS ADK for .NET Version 1.11.12 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.12 Standard install] 2. Confirmed operating environment 3. Installation and uninstallation 4. OPOS.NET 1.11.12 Standard install [EPSON OPOS ADK for .NET 1.11.12 TM-T88V only install] 2. Confirmed operating environment 3. Installation and uninstallation 5. OPOS.NET 1.11.12 TM-T88V only install [EPSON OPOS ADK for .NET 1.11.12 TM-T20 only install] 2. Confirmed operating environment 3. Installation and uninstallation 6. OPOS.NET 1.11.12 TM-T20 only install Note: The newest information is written to this release notes, although release notes will be copied to an installation directory if the OPOS ADK for .NET is installed. 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 Service Pack 3 (32bit) Windows Vista Service Pack 2 (32bit) Windows Server 2008 Service Pack 2 (32bit) Windows Server 2008 R2 (64bit) Windows 7 (32bit) Windows 7 (64bit) Windows Embedded Standard (32bit) Windows Embedded POSReady 2009 (32bit) Note: Standard install does not support 64bitOS. (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.12 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 - 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 [Port Name]. 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 is 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, if you change to a device with a different USB serial number, it is necessary to change 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.10 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.12] (1) POSPrinter - Added support for the TM-T88V(Japanese models) - 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.12 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 models] 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 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 - 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 [Port Name]. 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 is 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, if you change to a device with a different USB serial number, it is necessary to change the SetupPOS settings. 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.12] - Added support for the TM-T88V(Japanese models) - Added the Multi-tone printing feature. - Added the Optional external buzzer. [Version 1.11.11] - Initial version 6. OPOS.NET 1.11.12 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). * POS printer Confirmed Firmware version [ANK model] TM-T20 (I/F: U) Ver 1.00 TM-T20-42C (I/F: U) Ver 1.00 * Drawer Standard (I/F: U) * Electronic Journal Confirmed Firmware version TM-T20 (I/F: U) Ver 1.00 TM-T20-42C (I/F: U) Ver 1.00 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 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. 6.2.7 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 [Port Name]. 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 is 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, if you change to a device with a different USB serial number, it is necessary to change 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.10 or later). 6.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. 6.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. 6.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. 6.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 6.3 Revision history [Version 1.11.12] - Initial version