EPSON OPOS ADK Version1.95E Release Note SEIKO EPSON CORPORATION Epson Software Development Laboratory, Inc. Oct 17, 2000 1. Overview We are proud to announce the release of the OPOS ADK Version 1.95E. Using this development kit makes it easy to build applications based on the OPOS Application Programmer's Guide, Release 1.3. This kit is designed for use with Microsoft Visual Basic Version 4.0, Visual C++ 4.0, or another 32-bit development environment. 2. Explanation of OPOS ADK Version 1.95E Contents The following diskettes are shipped in the development kit: [Program installation disks] * OPOS ADK Ver 1.95E Disk-1 (Installation Disk 1) * OPOS ADK Ver 1.95E Disk-2 (Installation Disk 2) * OPOS ADK Ver 1.95E Disk-3 (Installation Disk 3) The three disks above are used to install or uninstall the OPOS ADK program. These diskettes do not contain debug symbols and therefore cannot be used for debugging purposes. If you wish to use trace or debug functions, please obtain the additional OPOS ADK (Debug version). [USB interface devices] * Supported OS The USB interface devices are supported by Windows 98 Second Edition/Windows2000. USB interface devices cannot be installed on Windows 98, or Windows2000. (See note) * port setting See the user's manual for details. * Line Display When connecting a line display to the UB-BOARD (UB-U01/02) the following connection sequence is neccesary. 1. Connect the UB-BOARD to the TM-Printer Master device. 2. Connect the line display to the DM-D port on the UB-BOARD. 3. Turn on the Line display power. 4. Turn on the Printer power. If this sequence is not followed the line display will not be properly detected. * Note Install the USB driver from the hard disk. (Driver is automatically copied in the folder in which OPOS has installed. (\OPOS\EPSON1)) See the user's manual for details. [Notes on using the 9-pin serial interface board (called the UB-S09 hereafter)] * The UB-S09 has a DM-D connector and is installed in an EPSON TM printer. The UB-S09 enables a connection with a DM display even if the TM printer is not equipped with a DM-D connector via a Y-connection. With the TM printer and a DM-D display connected, the UB-S09 can communicate with the serial interface of the host computer at a maximum speed of 115.2 K bps (bps: bits per second). 1. Set the jumper on the UB-S09 or the DIP switch on the TM printer to the appropriate positions if necessary when the DM-D display is connected to the DM-D connector of the UB-S09 or to the TM printer. A DM-D display cannot be connected to both the UB-S09 and a TM printer simultaneously. Connect the DM-D display to either one of the DM-D connectors. Refer to the user's manual of the UB-S09 or the TM printer for the correct jumper or DIP switch settings. 2. The serial communication condition of the UB-S09 depends on the DIP switch of the TM printer itself. Refer to the user's manual of the TM printer to be used for the correct DIP switch settings. 3. When a DM-D display is connected to the UB-S09, the power is supplied to the DM-D display from the TM printer regardless of whether the power switch of the TM printer is on or off (except for the TM-J8000). Note that the DM-D display always receives its power from the TM printer. 4. When the UB-S09 is connected to the RP-U420, the DM-D display cannot be used through the DM-D connector of the UB-S09 since the power is not supplied from the RP-U420 to the DM-D display. However, the RP-U420 works normally except for this. [The Network Interface Device (hereafter, UB-E01)] The UB-E01 can be installed in the TM printer which is compatible with the interface board system. If the UB-E01 is installed, the line display (DM-D) connector with which the TM printer is equipped can not be used. The UB-E01 enables communications by 10BASE-T and is compatible with the TCP/IP protocol. If it is to be used (each setting), ask the network administrator who is in charge. During Open, or Claim, the TM printer's power Off / On operation is supported, but after it is turned On, it cannot be guaranteed that it will reconnect, so exercise caution. During Open or Claim, that PC has a monopoly on its connection with the TM printer. (Another PC cannot connect with it.) However, if the TM printer's power is turned OFF once, then turned On again, any PC existing on the network can connect with that TM printer. At that time, the OPOS of a PC which is in the middle of a Claim will attempt to reconnect automatically, but if another PC's OPOS also attempts to make a Claim, it is not clear which will be able to make the connection. The PC which is the earliest to request connection can establish the connection. Accordingly, a TM printer which has had its power turned Off and On after Open or Claim, may not necessarily be available to reconnect to, so exercise caution.When the TM printer's power is turned On, and when it is reset, it takes approximately 20 seconds until the network function is operated, so exercise caution. [Sample programs] * OPOS ADK Ver1.95E Disk-4 (Sample Program Disk) This disk contains various sample programs developed in Microsoft Visual Basic and Microsoft Visual C++. You can copy the programs to the hard drive of your host machine and run them from there. The contents of this disk are compressed into two self-extracting archives (VBSample.exe, VCSample.exe). An explanation of how to use these files is found in the ReadMe.txt file on Disk-4. [Manuals (Documentation files)] OPOS ADK Ver 1.95E Disk-5 (Manual Disk) DISK5.EXE is a self-extracting archive containing files for the manuals. The list of manuals and their contents is found in the readme.txt file on Disk-5. These manuals have been confirmed to print correctly from Microsoft Word 6.0 and 7.0. However, printing of these files in a Microsoft Windows 95/98 English environment has not been tested. 3. Installation To install the OPOS ADK program, insert the diskette labeled "OPOS ADK Ver 1.95E Disk-1" in the host machine's diskette drive and run SETUP.EXE. In Windows 95/98 ,Windows NT 4.0 and Windows2000, you can use the "Add/Remove Programs" icon in the Control Panel to install. After initiating the SETUP.EXE program, follow the instructions. For further details on installing this program, see the User's Guide. 4. Supported Devices This release note contains limited information on the devices below, and it is recommended that the developer read all warnings in the Application Programmer's Guide before beginning. The Application Programmer's Guide contains a great deal of information, many more items to consider than listed here. A device may be listed here as having no known problems; however, the Application Programmer's Guide may provide relevant information to note on that device. * Line Displays EPSON DM-D101/102/105/106/110 EPSON DM-D202/203/205/206/210 EPSON DM-D102U/106U/203U/206U/110U/210U (USB) EPSON DM-D500 EPSON DM-D500U(USB) EPSON DM-D102-015/106-115 ( For IM-300/IM-310(EPSON IR) ) EPSON DM-D106-315 ( For IM-300/IM-310(EPSON IR) ) * MICR EPSON TM-H5000 with MICR EPSON TM-H5000P with MICR EPSON TM-H5000E with MICR (Ethernet) EPSON TM-H5000II with MICR EPSON TM-H5000IIP with MICR EPSON TM-H5000IIU with MICR (USB) EPSON TM-H5000IIE with MICR (Ethernet) EPSON TM-H6000 with MICR EPSON TM-H6000P with MICR EPSON TM-H6000U with MICR (USB) EPSON TM-H6000E with MICR (Ethernet) EPSON TM-U675 with MICR EPSON TM-U675P with MICR EPSON TM-U675U with MICR (USB) EPSON TM-U675E with MICR (Ethernet) EPSON TM-U925 with MICR EPSON TM-U950 with MICR * POS Printers EPSON RP-U420 EPSON RP-U420P EPSON TM-295 EPSON TM-295P EPSON TM-300A EPSON TM-300B EPSON TM-300C EPSON TM-300D EPSON TM-H3000R ( For IM-300/IM-310(EPSON IR) ) EPSON TM-H5000 EPSON TM-H5000P EPSON TM-H5000E (Ethernet) EPSON TM-H5000II EPSON TM-H5000IIP EPSON TM-H5000IIU (USB) EPSON TM-H5000IIE (Ethernet) EPSON TM-H5000IIM EPSON TM-H5000IIMU (USB) EPSON TM-H5000IIME (Ethernet) EPSON TM-H6000 EPSON TM-H6000P EPSON TM-H6000U (USB) EPSON TM-H6000E (Ethernet) EPSON TM-H6000M EPSON TM-H6000MU (USB) EPSON TM-H6000ME (Ethernet) EPSON TM-J8000 EPSON TM-J8000P EPSON TM-J8000U (USB) EPSON TM-J8000E (Ethernet) EPSON TM-L60II EPSON TM-L60IIP EPSON TM-T80 EPSON TM-T85 EPSON TM-T88 EPSON TM-T88P EPSON TM-T88E (Ethernet) EPSON TM-T88R ( For IM-300/IM-310(EPSON IR) ) EPSON TM-T88II EPSON TM-T88IIP EPSON TM-T88IIU (USB) EPSON TM-T88IIE (Ethernet) EPSON TM-T88IIM EPSON TM-T88IIMU (USB) EPSON TM-T88IIME (Ethernet) EPSON TM-T88IIR ( For IM-300/IM-310(EPSON IR) ) EPSON TM-T88IIRM ( For IM-300/IM-310(EPSON IR) ) EPSON TM-U200B EPSON TM-U200BP EPSON TM-U200BE (Ethernet) EPSON TM-U200D EPSON TM-U200DP EPSON TM-U200DE (Ethernet) EPSON TM-U210A EPSON TM-U210AP EPSON TM-U210AU (USB) EPSON TM-U210AE (Ethernet) EPSON TM-U210AM EPSON TM-U210AMU (USB) EPSON TM-U210AME (Ethernet) EPSON TM-U210AR ( For IM-300/IM-310(EPSON IR) ) EPSON TM-U210ARM ( For IM-300/IM-310(EPSON IR) ) EPSON TM-U210B EPSON TM-U210BP EPSON TM-U210BE (Ethernet) EPSON TM-U210D EPSON TM-U210DP EPSON TM-U210DE (Ethernet) EPSON TM-U230 EPSON TM-U230P EPSON TM-U230U (USB) EPSON TM-U230E (Ethernet) EPSON TM-U325 EPSON TM-U325P EPSON TM-U325U (USB) EPSON TM-U325E (Ethernet) EPSON TM-U375 EPSON TM-U375P EPSON TM-U590 EPSON TM-U590P EPSON TM-U590U (USB) EPSON TM-U590E (Ethernet) EPSON TM-U590M EPSON TM-U590MU (USB) EPSON TM-U590ME (Ethernet) EPSON TM-U675 EPSON TM-U675P EPSON TM-U675U (USB) EPSON TM-U675E (Ethernet) EPSON TM-U675M EPSON TM-U675MU (USB) EPSON TM-U675ME (Ethernet) EPSON TM-U925 EPSON TM-U950 EPSON TM-U950P * Cash Drawer Standard Cash Drawer for TM series (Serial,Parallel,USB,Ethernet) Multi Cash Drawer for EPSON IM-600 Port A ( For IM-600(EPSON SR) ) Multi Cash Drawer for EPSON IM-600 Port B ( For IM-600(EPSON SR) ) * Hard Totals EPSON IM-505 NVRAM EPSON IM-515 NVRAM EPSON IM-300 NVRAM ( For IM-300(EPSON IR) ) EPSON IM-310 NVRAM ( For IM-310(EPSON IR) ) EPSON IM-310 CompactFlash ( For IM-310(EPSON IR) ) EPSON IM-600 CompactFlash ( For IM-600(EPSON SR) ) * MSR DM-MR111-012 ( For IM-300/IM-310(EPSON IR) ) DM-MR111-013 ( For IM-300/IM-310(EPSON IR) ) DM-MR123 ( For IM-300/IM-310(EPSON IR) ) DM-MS123 ( For IM-600(EPSON SR) ) * Keylock IM-300 ( For IM-300(EPSON IR) ) IM-310 ( For IM-310(EPSON IR) ) 5. Support for devices in future releases The following list describes items restricted in this release and how to deal with problems. Also, please be sure to refer to the Application Development Guide notes. This list mainly takes up items not specified in the Application Development Guide. However, the fact that an item is not included here does not mean there are no restrictions on that item. * Line Display none * MICR none * POS Printer * Using the Open & Claim method when Printer errors occur and operation when DeviceEnabled=TRUE. When a printer error occurs and the claim method is used while DeviceEnabled=TRUE, each provider value showing the printer status is set and StatusUpdateEvent is issued. Afterwards, the provider values are changed and StatusUpdateEvent issued only after the cause of all the errors have been eliminated and the printer is back online. Any other errors that occurred during that error cannot be found with StatusUpdateEvent. Once the printer is back online, any subsequent changes in the printer status can be accurately determined. If the power to the printer has been turned off or the printer is not correctly connected, the printer status cannot be accurately determined by means of the provider or event. Even if the display is directly connected to the printer DM-D connector, the printer status cannot be accurately determined by means of the provider or event. Also, in cases such as where more than one error occurs or when the timing for cancelling the error and implementing the method overlap each other, the initial StatusUpdateEvent may sometimes not be issued due to the provider settings or due to use of the method that accompanies output of data to the printer, even if the printer error has been cancelled and the printer is back online. If the printer uses parallel ports, printer status cannot be determined by means of the provider or event when a printer error occurs, even if the power is on and the connections are correct. The above examples are all problems that only occur during a printer error (ERROR lamp lights or flashes) when using the Open or Claim methods while set to DeviceEnabled=TRUE. During operation, we recommend first checking that the printer is operating correctly and then running the Open or Claim methods with DeviceEnabled=TRUE. * Cash Drawer * The CashDrawer supported by EPSON OPOS is controlled through the POSPrinter. Therefore the OpenDrawer method can be influenced by POSPrinter action. For example, if the OpenDrawer method is executed while data is printing on POSPrinter, the OpenDrawer method return a timeout error. But after a little later, the StatusUpdateEvent may fire, resulting in an Open CashDrawer. To avoid this case, it is recommended that the OpenDrawer method be executed before printing data on POSPrinter. * The drawer sets the DrawerOpened property, and fires the StatusUpdateEvent when DeviceEnabled property becomes true. However, when the POSPrinter that connected with the CashDrawer is in an error state, the CashDrawer cannot detect state changes until a CashDrawer method is called. Please confirm printer's state before setting DeviceOpened property to true. * Hard Totals Hard Totals using EPSON series NVRAM needs a driver to access the NVRAM: EPSON NVRAM Driver. In an environment where the EPSON NVRAM Driver is not installed, Hard Totals cannot be installed. To install Hard Totals onto a machine on which you are going to use the EPSON NVRAM Driver, install the driver first. For how to purchase the EPSON NVRAM Driver, check with the company where you bought the IM hardware. * SetupPOS * Do not set an independent device or the other hydra-linked device to a COM port that is already set up to support a hydra-linked device. When a printer and display are hydra-connected to COM 1 and you wish to connect another display(printer) directly to COM 2,follow the steps below: When you add a display (printer), and a message that it cannot be set to COM1 is displayed, please change the port setting to COM2 in device specifics. If an incorrect hydra connection is set, a dialog box warning of the conflict in the registry setting may display an error for the hydra setting. If incorrect hydra settings are ignored, a Hydra Setting warning dialog box may be displayed. If this happens, choose OK button as soon as possible for correct the hydra settings. * Installation * If you wish to upgrade( or downgrade ) the OPOS ADK, and have already performed in OPOS ADK uninstallation, please reboot system first. * If devices are specified in a custom install, and a .REG file containing unspecified device information is used to initialize the registry, the SetupPOS utility may show a warning about the port setting. Choose OK and reset the port, or press Cancel to ignore the warning. * After finishing uninstall, run the _ISDEL.EXE to complete the post installation procedure. An error may cause the target directory and the _ISDEL.EXE to be left on the hard drive. In that case, please delete them using the Microsoft Windows (95/98,NT,2000) Explorer or File Manager. * If the installation fails for some reason and you cancel in the middle of it, be sure to do it again. If this happens, there is a possibility that files and environment can't be cleaned even if you execute uninstall. * EPSON IM series(Windows 2000 Support) * EPSON IM-310/600 Windows 2000 is supported. * EPSON IM-505/515/300 Operation under Windows 2000 is not supported. There are no plans to support this configuration. 6. Other Considerations (1) When you create multiple forms and set them up to access a single ADK object in a Visual Basic project, the following problems occur when properties are accessed or methods are called: * The method or property accessed first does not return until all processing has been completed. (The project hangs.) * The Close() method causes a Visual Basic error when called. Please make sure that all methods and properties accessed by one from are completely finished before any other form accesses a method or property. (2) Sharing with previous versions (Versions 1.40 and 1.50) * Previous versions (Versions 1.40 and 1.50) can be shared with this version (see the User's Guide), but you cannot use this version either to install or uninstall them. Also, if you are sharing with previous versions, be sure to install from the lower version and uninstall from the last installed version. Example: First install : OPOS ADK Ver1.40 Second install : OPOS ADK Ver1.95 First uninstall : OPOS ADK Ver1.95 Second install : OPOS ADK Ver1.40 If you do not follow the order, operation is not guaranteed. In this case, you must reinstall from the beginning. * If two version of OPOS ADK has been installed in two different directories, you must use the proper SetupPOS utility. (Ver1.40 and Ver1.50 shortcut name is "EPSON SetupPOS",Ver1.95 is "SetupPOS". ) To add a device, please use the SetupPOS utility corresponding to your version. * If you share this version with Ver1.40 or Ver1.50, it rarely happens that uninstallation with Ver1.40 or Ver1.50, is failed. In this case, please execute uninstallation again. Also, after you install Ver1.40 or Ver1.50, if OPOS folder is not made, please reset the system and reinstall it. (3) The DoEvents Process in Visual Basic If you want to get an Event in the midst of a procedure, use DoEvents. For example,for a cash drawer, which you programmed to execute WaitforDrawerClose immediately after executing the OpenDrawer method, an Event never occurs until control returns to the application. Putting a DoEvents instruction between the OpenDrawer method and WaitforDrawerClose method executes StatusUpdateEvent and enables you to get an Event. (4) This version supports LPT1 through LPT3. However LPT3 has not been fully tested. (5) The OPOS APG/CPG documents are available at: http://www.microsoft.com/industry/retail/developers/initiatives/opos/home.stm