Zebra® KR203 Kiosk Receipt Printer Windows® CE Software Integrator Guide P1028251-001 Rev.
© 2011 ZIH Corp. The copyrights in this manual and the software and/or firmware in the printer described therein are owned by ZIH Corp. Unauthorized reproduction of this manual or the software and/or firmware in the printer may result in imprisonment of up to one year and fines of up to $10,000 (17 U.S.C.506). Copyright violators may be subject to civil liability. This product may contain ZPL®, ZPL II®, and ZebraLink™ programs; Element Energy Equalizer® Circuit; E3®; and Monotype Imaging fonts.
Contents Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Who Should Use This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ii Contents Bottom Margin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cutter Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Partial Cut Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Presenter Loop Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Eject Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Present Length Addition . . . . . . . . . . . . . . . . . .
1 Introduction Who Should Use This Document This guide is intended for use by any person who needs to setup the KR203 printer for use with a Windows CE device. How This Document Is Organized The manual is set up as follows: Introduction Contact information, document conventions. Windows CE Driver Installation, updates, preferences, and properties. Troubleshooting Status light description, user interface, error handling, and fixes to common printing problems. Appendix A KR203 status codes.
2 Introduction Contacts Contacts Technical Support via the Internet is available 24 hours per day, 365 days per year. Web Site: www.zebra.com E-mail Back Technical Library: • E-mail address: emb@zebra.com • Subject line: Emaillist Self Service Knowledge Base: www.zebra.com/knowledgebase Online Case Registration: www.zebra.
Introduction Document Conventions Document Conventions The following conventions are used in this document to convey certain information: Alternate Color – Cross-references contain links to other sections in this guide. If you are viewing this guide online, click the blue text to jump to its location. Note • Indicates information that emphasizes or supplements important points of the main text. 3/1/2011 KR203 Windows CE Software Integrator Guide P1028251-001 Rev.
4 Introduction Document Conventions P1028251-001 Rev.
2 Windows CE Driver Description Windows CE Driver The following description applies to CE 5.0 and CE 6.0. The illustration shows the relationship between the various system components involved in printing. APPLICATION DISPLAY DRIVER GDI PRINTER DRIVER PORT MONITOR USB PORT PRINTER Figure 2-1 • System Flowchart 3/1/2011 KR203 Windows CE Software Integrator Guide P1028251-001 Rev.
6 Windows CE Driver Description Printer Driver The printer driver for the KR203 is named KR203.DLL. The Windows CE graphics device interface (GDI) and display driver perform most of the work involved in printing. At the beginning of the printing process, GDI creates a device context with attributes that are retrieved from the printer driver during a call to DrvEnablePDEV.
Windows CE Driver Description Table 2-1 • Driver Functions Function Description DrvGetModes Lists the modes supported by a specified device. DrvStartDoc Called by the GDI to start a print job. DrvStartPage Called by the GDI to start printing the next page of a print job. GetPrinterInfo Obtains information about printers, such as the name of the printer or whether the printer can print in color. PrinterClose Closes a printer handle previously opened by a call to the PrinterOpen function.
8 Windows CE Driver Description GetPrinterStatus This function gets the specific Printer status for the KR203. Syntax DWORD WINAPI GetPrinterStatus(HANDLE hPrinter, LPPRINTERSTATUS status) Parm hPrinter - HANDLE - Handle to the printer status - LPPRINTERSTATUS - The status to be set.
Windows CE Driver Description Table 2-2 • Printer Status Codes Number Name Type Group LED Reporting 41 System calibration error One-time Informational Not signaled 42 System calibration success One-time Informational Not signaled Control Panel Extension In order to open the control panel and double click the program icon, a control panel extension is supplied with the driver. KR203CPL This component enables users to change settings for the printer and printer driver.
10 Windows CE Driver Installation Installation Driver Installation The Zebra CE driver ZIP package includes the following files: • Control Panel extension • KR203CPL.CPL - This component enables users to change settings for the printer and printer driver. • KR203.DLL - The Printer Driver. • KRPort.DLL - The Port Monitor. • KRErr.DLL - The error handler. • KR203.CPY - A sample copy file. • KRDevice.EXE - The Parameter setup application. • KRConfig.DLL - A helper DLL for the parameter setup application.
Windows CE Driver Update Firmware Update Firmware UI Option Check the firmware version installed on the printer by printing a configuration label (see “Tools” on page 17), the firmware version will be shown. Go to the Zebra Website at www.zebra.com and follow the instructions to download the latest version to your computer. Copy the firmware package to the device to which the printer is connected and that runs the driver. Select the port the target printer is connected to and then click “Select FW”.
12 Windows CE Driver Printer Settings Printer Settings Device Setting This dialog is used to control the Printer and driver settings: Figure 2-2 • Device Settings Tab P1028251-001 Rev.
Windows CE Driver Printer Settings The following table describes the values and defaults of the parameters: Table 2-3 • Parameter Settings and Defaults Parameter Value Range Default Value Media Width 58mm, 60mm, 80mm, 82mm 80mm Media Height 100mm to 600mm 100mm Darkness 0 to 30 20 Max Print Speed 75mm to 152mm 152mm Media Tracking Continuous, Variable Length, Mark Sensing Variable Length Top Margin 2mm to 12mm 12mm Bottom Margin 0 to 9mm 0 Cutter Mode None, Every Page, End of Docum
14 Windows CE Driver Printer Settings Darkness The Darkness can be set between 0 and 30 with zero being the lightest. The default setting is 20. Figure 2-3 • Darkness set to 20 (default) Figure 2-4 • Darkness set to 0 (zero) Max Print Speed The max print speed can be set between 75 mm and 152 mm per second (mm/s). The default setting is 152 mm/s. The actual print speed may vary depending on the darkness and the content printed.
Windows CE Driver Printer Settings Top Margin The Top Margin is the equivalent to the distance between the cutter and the print head and is by default 12 mm. If it is set between the minimum of 2 mm or 11 mm it will reverse the paper. Bottom Margin The Bottom margin can be set between 0 and 9 mm and will be added to the bottom of the page in Variable Mode and will limit the printable area in Continuous Mode and Mark Sensing. The default is 0.
16 Windows CE Driver Printer Settings Present Length Addition Presenter Length Addition is an additional length to compensate for the thickness of the kiosk wall. The range is from 0 to 255mm with the default set to 0. Presenter Timeout Presenter Timeout determines how long the presenter will hold the receipt before ejecting it. The range for the timeout is from 0 to 300 seconds with the default set at 0.
Windows CE Driver Printer Settings Tools The Tools tab enables printer maintenance functions. Figure 2-6 • Tools Tab Printer Port setting – Tells the driver which port the printer is connected to. Clear Kiosk Presenter – Ejects any media in the presenter. Send PRN File – Sends a saved PRN file to the printer. Set Black Mark Mode – Sets the printer to use black mark media. Set Continuous Mode – Set the printer to print continuous pages. Feed One Receipt – Feeds a single blank receipt.
18 Windows CE Driver Printer Settings About The About Tab shows the current driver version. Figure 2-7 • About Tab P1028251-001 Rev.
Windows CE Driver Setting Black Mark Mode Setting Black Mark Mode The printer is optimized to detect black marks printed with IR sensitive ink and ignore preprint in IR blind ink. For information on black mark media requirements, refer to the Hardware Integrator Guide (P1028247). For 80 and 82.
20 Windows CE Driver Setting Black Mark Mode P1028251-001 Rev.
3 Troubleshooting Status Light Descriptions Application LED States Immediately after power is applied to the printer, a brief self test is performed and the status light will report the following conditions: Table 3-1 • Application LED States 3/1/2011 Solid Green 0 - OK This code is reported when no other codes are active. It indicates the printer is functioning normally. One Red Flash 1 - Paper Jam in Presenter This code indicates that media is stuck in the presenter.
20 Troubleshooting Status Light Descriptions Table 3-1 • Application LED States Three Red Flashes 3 - Out of Paper This code indicates that the selected EOP sensor has detected no media present. This value is signaled wither when the mark engine has detected a mark larger than "TOF marker length” plus 5mm, or when the A/D reading of the EOP sensor drops below the “End of paper threshold”. This error is cleared after successful media load (either via calibration of via regular media load).
Troubleshooting Print Quality Problems Application User Interface With the printer power on, press and hold the feed button. Continue holding the feed button until the status indicator flash sequence occurs. The next flash sequence occurs after completion of the previous flash sequence. The flash sequences perform the following functions: Table 3-2 • Application User Interface Status Flash Sequence Action One Flash, then Solid Green Appears for one second. This will print an internal self-test page.
22 Troubleshooting Print Quality Problems The printed image does not look right. • The printhead is dirty. Clean the printhead. Refer to the Service Manual (P1028249) for instructions. • The printhead has worn out. The printhead is a consumable item and will wear out due to friction between the media and printhead. Using unapproved media may shorten life or damage your printhead. Replace the printhead. Refer to the Service Manual (P1028249) for instructions. • Adjust the print darkness and/or print speed.
Troubleshooting Media Sensing Problems Media Sensing Problems The KR203 printer default media mode is Continuous. The printer will remain in this mode until it is changed by the Windows Driver. The KR203 printer has automatic media calibration capability for black mark media. Once the printer is printing or feeding media, the printer continually checks and adjusts the media sensing to accommodate for minor changes in media parameters from page to page on a roll, and from roll to roll of media.
24 Troubleshooting Other Problems • There is a jam under the printhead. Refer to the Service Manual (P1028249) for instructions. • The large media roll may be over torquing the feed motor. Install the large media roll adapter. Refer to the Hardware Integrator Guide (P1028247) for instructions. The printer will not eject the media. • The presenter rollers are dirty or damaged. • The presenter rollers are dirty. Refer to the Service Manual (P1028249) for instructions.
Troubleshooting Other Problems • The cutter motor may need to be replaced. Refer to the Service Manual (P1028249) for instructions. • The cutter drive gear, drive pin, or cutter actuator may be damaged or worn. Refer to the Service Manual (P1028249) for instructions. • Check for the latest firmware and driver version. There are no lights on the printer. • Make sure there is power applied to the printer. • The control panel may be dirty or damaged. Refer to the Service Manual (P1028249) for instructions.
26 Troubleshooting Resetting the Factory Default Values Resetting the Factory Default Values Sometimes, resetting the printer to the factory defaults may solve some problems. Refer to the four-flash sequence of "Application User Interface" on page 21. Contact Technical Support Technical Support via the Internet is available 24 hours per day, 365 days per year. www.zebra.com For questions on the operation of Zebra equipment and software, please call your distributor. For additional assistance, contact us.
Appendix A KR203 Status codes Table A-1 • Status Codes Number Name Type Group LED Reporting 0 Ok Normal Informational Solid green 1 Paper jam in presenter Normal Severe 1 red flash 2 Cutter Jam Normal Severe 2 red flashes 4 Print head lifted Normal Severe 4 red flashes 3 Out of paper Normal Severe 3 red flashes 5 Paper feed error Normal Severe 5 red flashes 6 Head temperature error Normal Severe autoclear Yellow flashing 10 Black mark not found One-time Informatio
A-2 Appendix A KR203 Status codes P1028251-001 Rev.
Appendix B Programming Example Background In order to incorporate the way status monitoring works for the KR203 printer setup, it is important to understand what happens in a kiosk when you print, and when status monitoring should take place. Status monitoring can be handled in two ways: • Monitoring in the printing application. • Monitoring in a separate application.
B-2 Appendix B Programming Example Monitoring While Idle In order to get status any time a status thread has to be implemented which reads printer status and provides changed status information in the same manner. The following code snippet in C# may be used as a guide to develop such an application. The code is using the KRConfig DLL. KRConfig config = new KRConfig(); config.Load();//Load settings from registry string msg = ""; try { config.