Zebra KR203 Software Integrator Guide

Zebra® KR203

Kiosk Receipt Printer

Software Integrator

Guide

P1028248-001 Rev. A

© 2010 ZIH Corp. The copyrights in this manual and the softwa re and/or fir mware 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
Equalizer

®

Circuit; E3®; and Monotype Imaging fonts. Software © ZIH Corp. All rights

®

, ZPL II®, and ZebraLink™ programs; Element Energy

reserved worldwide.
ZebraLink and all product names and numbers are trademarks, and Zebra, the Zebra

logo, ZPL, ZPL II, Element Energy Equalizer Circuit, and E

3

Circuit are registered

trademarks of ZIH Corp. All rights reserved worldwide.
All other brand names, product names, or trademarks belong to their respective holders.

For additional trademark information, please see “Trademarks” on the product CD.

Proprietary Statement This man ual contains proprietary information of Zebra

Technologies Corporation and it s subsid iaries (“Zeb ra Technologies”). It is intended solely
for the information and use of parties operating and ma in taining the eq uip m ent de scr ibe d
herein. Such proprietary information may not be used, reproduced, or disclosed to any
other parties for any other purpose without the express, written permission of Zebra
Technologies.

Product Improvements Continuous improvement of product s is a policy of Zebra

Technologies. All specifications and designs are subject to change without notice.

Liability Disclaimer Zebra Technologies takes steps to ensure that its published

Engineering specifications and manuals are correct; however, errors do occur. Zebra
Technologies reserves the right to correct any such errors and disclaims liability resulting
therefrom.

Limitation of Liability In no event shall Zebra Technologies or anyone else involved in

the creation, production, or delivery of the accompanying produ ct (including hardwar e and
software) be liable for any damages whatsoever (including, without limitation,
consequential damages including loss of business profits, business interruption, or loss of
business information) arising out of the use of, the results of use of, or inability to use such
product, even if Zebra Technologies has been advised of the possibility of such damages.
Some jurisdictions do not allow the exclusion or limitation of incidental or consequential
damages, so the above limitation or exclusion may not apply to you.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Contents

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Who Should Use This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

How This Document Is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Windows Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Driver Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Printer Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Repair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Disconnecting the Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Color Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Device Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Printer Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Import/Export Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

About. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Setting Black Mark Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

2

Contents

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Status Light Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Application LED States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Application User Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Print Quality Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Media Sensing Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Other Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Resetting the Factory Default Values . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Contact Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Windows Compatible Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Statuses Defined in winspool.h. . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Windows Incompatible Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

Appendix B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Background. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Implementation in Calling Application . . . . . . . . . . . . . . . . . . . . . . . . . B-3

Implementation in Monitor Thread. . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4

WMI Script to get Basic Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8

Appendix C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

Setup Printer Forms in Windows XP and Vista . . . . . . . . . . . . . . . . . . C-1

Viewing and Creating Printer Forms . . . . . . . . . . . . . . . . . . . . . . . C-2

Setup Printer Forms in Windows 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . C-3

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Who Should Use This Document

This guide is intended for use by any person who needs to setup software for use with the
KR203 printer.

1

Introduction

How This Document Is Organized

The manual is set up as follows:

Introduction
Windows Driver Installation, documentation, preferences, and properties.

Troubleshooting

Appendix A

Appendix B Programming Samples
Appendix C Setting up forms.

This manual will be updated from time to time as printer functions and features may be
added or amended. You will always find the latest edition on our web site (http://

www.zebra.com). If you require information for functions not found in this manual edition,

please contact Technical Support for your region or the Zebra partner the printer was
purchased from.

Contact information, document conventions.

Status Light description, User Interface, Error Handling,
and fixes to common printing problems.

Windows Compatible Status - equivalent Windows to driver
error codes.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Introduction

2

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: [e-mail]

• Subject line: Emaillist

Self Service Knowledge Base: www.zebra.com/knowledgebase
Online Case Registration: www.zebra.com/techrequest

Which Department

Do You Need?

Regional Headquarters

Technica l Sup port

For questions on the operation
of Zebra equipment and
software, please call your
distributor. For additional
assistance, contact us.

Please have your model and
serial numbers available.

Repair Service Department

For back-to-base service and
repair.

Techni cal Training
Department

For Zebra product training
courses.

Inquiry Department

For product literature and
distributor and dealer
information.

Customer Service
Department (US)
Internal Sales Department
(UK)

For printers, parts, media, and
ribbon, please call your
distributor or contact us.

Key:

T: Telephone
F: Facsimile
E: E-mail

The Americas

Zebra Technologies Inter national,
LLC
475 Half Day Road, Suite 500
Lincolnshire, IL 60069 USA

T: [phone]
Toll-free [phone]
F: [phone]

T: +1 877 ASK ZEBRA (275 9327)
F: [phone]

Hardware: [e-mail]
Software: [e-mail]

Kiosk Printers:

T: [phone]

[e-mail]

T: +1 877 ASK ZEBRA (275 9327)
F: [phone]

E: [e-mail]
To request a repair in the U.S.,

go to www.zebra.com/repair
T: [phone]

T: [phone]
F: [phone]

E: [e-mail]

T: +1 877 ASK ZEBRA (275 9327)
E: [e-mail]

T: +1 877 ASK ZEBRA (275 9327)
E: [e-mail]

.

Europe, Africa,

Middle East, India

Zebra Technologies Europe Limited
Dukes Meadow
Millboard Road
Bourne End
Buckinghamshire, SL8 5XF
United Kingdom

T: [phone]
F: [phone]

T: [phone]
F: [phone]

E: [e-mail]

T: [phone]
F: [phone]

New requests: [e-mail]
Status updates:

[e-mail]

T: [phone]
F: [phone]

E: [e-mail]

T: [phone]
F: [phone]

E: [e-mail]

T: [phone]
F: [phone]

E: [e-mail]

Asia Pacific

Zebra Technologies Asia Pacific
Pte. Ltd.
120 Robinson Road
#06-01 Parakou Building
Singapore 068913

T: + 65 6858 0722
F: [phone]

T: [phone]
F: [phone]

E: China: [e-mail]

All other areas:

[e-mail]

T: [phone]
F: [phone]

E: China: [e-mail]

All other areas:

[e-mail]

T: + 65 6858 0722
F: [phone]

E: China: [e-mail]

All other areas:

[e-mail]

E: China:

[e-mail]

All other areas:

AP [e-mail]
m

T: [phone]
F: [phone]

E: China: [e-mail]

All other areas:

[e-mail]

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Document Conventions

The following conventions are used throughout this document to convey certain
information:

Alternate Color – Cross-references contain links to othe r sections in this guide. If you are
viewing this guide online, click the blue text to jump to its location.

Important • Advises you of information that is essential to complete a task.
Note • Indicates information that emphasizes or supplements important points of the main

text.

Introduction

Document Conventions

3

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Introduction

4

Document Conventions

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Description

The Windows driver is the only method of communicating with the printer. The driver’s
functions also include: the rendering engine, user interface, and a language monitor for
reporting printer functions. The driver interface includes tools for updating the printer
firmware, checking and printing configuration status, and setting up for different types of
media.

2

Windows Driver

The driver currently runs on Windows XP, Windows Vista, Windows 7, Windows Server
2003, and Windows Server 2008.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

6

Installation

Installation

Driver Installation

Important • To update the driver to a newer version it is recommended that any previous

version be removed prior to updating. Refer to "Uninstall"on page 11.
Note • Make sure you download the latest driver from the Zebra website (see

"Contacts" on page 2). The driver will be downloaded as a ZIP file - you will need an

extraction utility to access the driver installer file.

1. Double-click on the Zebra Kiosk Printer Driver icon to launch the installer.

The Welcome Window is displayed.

2. Click Next.

A window containing important information is displayed. This information covers
continued installation instructions.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Windows Driver

3. Click Next.

4. Depending on your Windows configuration and us er leve l, a warnin g ma y be

displayed informing you that the software has not passed Windows Logo testing.

Installation

7

5. Click Continue Anyway.

The installation will proceed by installing the necessary files onto your computer.
The default directory ocation for the installed files is

C:\Zebra\Kiosk\WindowsDriver\KR203.

Once the installation has completed, the Completed Window will be displayed.

Make sure the printer has power and connect the USB cable to the printer and to the
computer.

6. Click Finish.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

8

Installation

Printer Installation

Apply power to the printer and connect the USB cable to the printer and to the host
computer.

The Windows Found New Hardware Wizard will be displayed.

1. Select “No, not this time” and click Next.

A dialog box will appear asking how to install the printer. Select “Install software
automatically (Recommended)”.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Windows Driver

2. Click Next.

Depending on your Windows configuration and us er leve l, a warnin g ma y be
displayed informing you that the software has not passed Windows Logo testing.

3. Click Continue Anyway.

Installation

9

A dialog box will appear asking you to insert the disk containing the Zebra Driver. Click
OK.

4. A dialog box will appear prompting you for the location of the Zebra Driver. Click

Browse and navigate to C:\Zebra\Kiosk\WindowsDriver\KR203..

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

10

Installation

5. Click OK..

6. Click Finish.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Uninstall

Windows Driver

1. Disconnect the USB cable from the host computer.

2. Double-click on the Zebra Kiosk Printer Driver icon to launch the installer.

The Welcome Window is displayed.

3. Select “Uninstall”.

Installation

11

4. Click Next.

The Utility will remove the files from the computer.

5. Click Finish.

6. Restart the computer.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

12

Installation

Repair

If the driver is not functioning properly , rather than uninst alling and rein stalling the driver it
can be repaired.

1. Disconnect the USB cable from the host computer.

2. Double-click on the Zebra Kiosk Printer Driver icon to launch the installer.

The Welcome Window is displayed.

3. Select “Repair Application”.

4. Click Next.

The Utility will reinstall the necessary files onto the computer.

5. Click Finish.

6. Restart the computer.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Disconnecting the Printer

The printer may become disconnected from the host computer due to po wer loss or due to
repair procedures. If the host computer is running Windows XP, Windows Vista, Windows
7, Windows Server 2003, or Windows Server 2008, the host computer will automatically
recognize the printer upon reconnecting.

Proceed with the repair procedures or po wer on proced ures, or wait ten seconds and the n
reconnect the printer to the host computer.

Windows Driver

Installation

When the printer is disconnected, the printer icon will show
“Offline” then “Offline-Offline”. The printer icon will also be
“grayed out” as it cannot be found by the host computer.

The printer icon will show “Offline” then “Not Available”.

13

Press and release feed button on the printer to feed a blank receipt.

The printer icon will show “Output Bin Full - Not Available”
then “Output Bin Full”.

Remove the receipt from the presenter.

The printer icon will show “Ready”.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

14

Properties

Properties

General

The Zebra Kiosk Printer Windows driver is based on the Microsoft Unidriver arch itecture
for raster based printers. Zebra provides two OEM libraries (UI and Rendering) to enable
specific printer functionality within the driver. In addition to the standard Microsoft driver,
Zebra provides a bi-directional interface through a Language Monitor DLL.

All of the OEM features will be described below.
To access the printer properties, in the control panel select Printers and Faxes; right click

on the printer icon and select properties. In Windows 7, log in as an Administrator and
open the Print Management window; right click on the printer and select properties.

The General Tab enables access to the printers basic settings.

Printer Name – Assigning the printer a custom name makes it easier to identify it if

there is an error.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010

Windows Driver

Properties

Location – Entering a location let’s you know where the printer is should an error need

to be corrected.
Comment – Any additional information about the printer that may be helpful.
Printing Preferences – Simple information about the page layout and paper quality.

15

Advanced settings such as output, graphic options, and document options.

Print Test Page – Sends a page to the printer to see if everything is working properly.

8/6/2010 KR203 Software Integrator Guide P1028248-001 Rev. A

Windows Driver

16

Properties

Sharing

The sharing tab enables you to share the printer with other computers.

P1028248-001 Rev. A KR203 Software Integrator Guide 8/6/2010