P1066584-001 Rev. A
Zebra® KR203
Kiosk Receipt Printer
Programming Manual
TABLE OF CONTENTS
1 DESCRIPTION ...................................................................................... 6
1.1 Purpose ........................................................................................................... 6
1.2 Scope .............................................................................................................. 6
1.3 Document Format ............................................................................................. 6
2 USER INTERFACE ................................................................................ 7
2.1 User Interface Overview .................................................................................... 7
2.1.1 Application LED States................................................................................ 7
2.1.2 Application User Interface .......................................................................... 8
2.1.3 Additional UI Operations ............................................................................. 8
2.1.4 Bootware User Interface ........................................................................... 10
3 COMMANDS ........................................................................................ 11
3.1 Command Overview ........................................................................................ 11
3.2 General Notes on All Commands ...................................................................... 12
3.3 Enquiry Commands ......................................................................................... 12
3.3.1 Send status - <ESC><ENQ><1>.............................................................. 12
3.3.2 Send ack marker - <ESC><ACK><N1> .................................................... 12
3.3.3 Send information - <ESC><ENQ>c ........................................................... 13
3.3.4 Send sensor - <ESC><ENQ><5><N1> .................................................... 13
3.3.5 Send parameter - <ESC><ENQ>P<N1> ................................................... 14
3.3.6 Send all parameters - <ESC><ENQ>Q<N1> ............................................. 14
3.4 Graphics Commands ....................................................................................... 14
3.4.1 Print graphics line - <ESC>s<N1><N2>..<nX> ........................................ 14
3.5 Feed and Cut Commands ................................................................................ 15
3.5.1 Feed forward - <ESC>J<N1> ................................................................... 15
3.5.2 Feed backward - <ESC>j<N1> ................................................................. 15
3.5.3 Advance to TOF - <FF> ........................................................................... 15
3.5.4 Cut and present media - <RS><N1> ........................................................ 15
3.5.5 Cut media - <ESC><RS> ......................................................................... 16
3.5.6 Partial cut media - <US><N1> ................................................................. 16
3.5.7 Eject media - <ENQ> ............................................................................... 16
3.6 System Commands ......................................................................................... 17
3.6.1 Hard reset - <ESC>? ................................................................................ 17
3.6.2 Soft reset - <ESC>@ ............................................................................... 17
3.6.3 Set parameter in queue - <ESC>&p<N1><N2>..<NX> ............................. 17
3.6.4 Print test page - <ESC>P<N1> ................................................................ 17
3.6.5 Force print - <ESC>p ............................................................................... 18
3.6.6 Store parameters - <ESC>&<4><N1> ..................................................... 18
P1066584-001 KR203 KPL Programming Manual Page 2 of 58
3.6.7
Recall parameters - <ESC>&F<N1> ......................................................... 18
3.6.8 Exit application - <ESC><255><n1> ........................................................ 19
3.6.9 Load application - <ESC><0><Application data> ...................................... 19
3.6.10 Calibrate Media - <ESC># ........................................................................ 20
3.6.11 Calibrate System - <ESC>g ...................................................................... 20
4 PARAMETERS ..................................................................................... 22
4.1 Parameters Overview ...................................................................................... 22
4.1.1 6 – Secondary burn time .......................................................................... 23
4.1.2 7 – Primary burn time .............................................................................. 23
4.1.3 8 – Max print speed ................................................................................. 24
4.1.4 9 – Presenter loop length ......................................................................... 24
4.1.5 31 – Presenter speed ............................................................................... 24
4.1.6 34 – Auto cut and present after FF ............................................................ 24
4.1.7 35 – TOF Synchronization ......................................................................... 24
4.1.8 37 – Page length ...................................................................................... 25
4.1.9 39 – TOF marker length ........................................................................... 25
4.1.10 40 – Garbage fil ter ................................................................................... 25
4.1.11 41 – TOF cut offset .................................................................................. 25
4.1.12 45 – Eject timeout.................................................................................... 26
4.1.13 46 – Cut position calibration ..................................................................... 26
4.1.14 47 – Wall compensation ........................................................................... 26
4.1.15 48 – Print width ....................................................................................... 26
4.1.16 49 – Advance before cut ........................................................................... 26
4.1.17 51 – TOF marker sensitivity ...................................................................... 27
4.1.18 53 – Lock parameters ............................................................................... 27
4.1.19 57 – System ............................................................................................ 27
4.1.20 58 – Out of paper level ............................................................................. 27
4.1.21 65 – Status mode ..................................................................................... 28
4.1.22 66 – Status protocol ................................................................................. 28
4.1.23 67 – Information Level ............................................................................. 28
4.1.24 68 – End of paper threshold ..................................................................... 29
4.1.25 69 – Installed guide width ........................................................................ 29
4.1.26 70 – Presenter PWM percentage ............................................................... 29
4.1.27 71 – EOP PWM percentage ....................................................................... 29
4.1.28 75 – Keepalive timeout ............................................................................. 29
4.1.29 80 – Compensation mode ......................................................................... 30
4.1.30 81 – 84 Compensation ............................................................................. 31
4.1.31 248 – Last reset reason ............................................................................ 31
4.1.32 249 – Power down count .......................................................................... 32
4.1.33 250 – Media length (m) ............................................................................ 32
4.1.34 251 – Number of cuts............................................................................... 32
4.1.35 252 & 253 – Page Erases .......................................................................... 32
P1066584-001 KR203 KPL Programming Manual Page 3 of 58
4.1.36
254 – Uptime (s) ...................................................................................... 32
5 STATUS CODES .................................................................................. 33
5.1 Application Status Code Overview .................................................................... 33
5.2 Groups, Types and Reporting .......................................................................... 33
5.2.1 0 – Ok ..................................................................................................... 34
5.2.2 1 – Paper jam in presenter ....................................................................... 34
5.2.3 2 – Cutter Jam ......................................................................................... 34
5.2.4 3 – Out of paper ...................................................................................... 35
5.2.5 4 – Printhead lifted .................................................................................. 35
5.2.6 5 – Paper feed error ................................................................................. 35
5.2.7 6 – Head temperature error ...................................................................... 35
5.2.8 10 – Black mark not found ........................................................................ 35
5.2.9 11 – Black mark calibration error .............................................................. 36
5.2.10 12 – Index error ...................................................................................... 36
5.2.11 18 – Out of range .................................................................................... 36
5.2.12 19 – Paper low......................................................................................... 37
5.2.13 20 – Media in presenter ............................................................................ 37
5.2.14 40 – Printer entered USB bus .................................................................... 37
5.2.15 41 – Media guide detection error .............................................................. 37
5.2.16 42 – Media guide detection success .......................................................... 37
5.3 Bootware Status Code Overview ...................................................................... 38
5.3.1 0 – Ok ..................................................................................................... 38
5.3.2 13 – Checksum error ................................................................................ 38
5.3.3 14 – Wrong object type ............................................................................ 38
5.3.4 15 – Corrupt or missing application ........................................................... 39
5.3.5 21 – Boot/Application version mismatch .................................................... 39
5.3.6 22 – Wrong target ................................................................................... 39
5.3.7 23 – Tag system not found ....................................................................... 39
6 STATUS PROTOCOLS ......................................................................... 40
6.1 Status Protocol Overview ................................................................................ 40
6.2 XML Protocol .................................................................................................. 40
6.2.1 Header .................................................................................................... 41
6.2.2 Root Element ........................................................................................... 41
6.2.3 Send status block ..................................................................................... 42
6.2.4 Send ack marker ...................................................................................... 44
6.2.5 Send information ..................................................................................... 45
6.2.6 Send sensor ............................................................................................. 47
6.2.7 Send parameter ....................................................................................... 48
6.2.8 Send all parameters ................................................................................. 50
6.3 TTP Protocol ................................................................................................... 51
6.3.1 Send status ............................................................................................. 51
P1066584-001 KR203 KPL Programming Manual Page 4 of 58
Version
Date
Author(s)
Description
A
11 June
First Release Version
6.3.2
Send ack marker ...................................................................................... 51
6.3.3 Send information ..................................................................................... 51
6.3.4 Send tags ................................................................................................ 51
6.3.5 Send sensor ............................................................................................. 51
6.3.6 Send parameter ....................................................................................... 51
6.3.7 Send all parameters ................................................................................. 51
7 TUTORIALS ......................................................................................... 52
7.1 Text on KR203 ............................................................................................... 52
7.1.1 Introduction............................................................................................. 52
7.1.2 Document Format .................................................................................... 52
7.1.3 Overview ................................................................................................. 52
7.1.4 Print graphics line .................................................................................... 53
7.2 Status from KR203 .......................................................................................... 54
7.2.1 Introduction............................................................................................. 54
7.2.2 Document Format .................................................................................... 54
7.2.3 Overview ................................................................................................. 54
7.2.4 Set up the printer..................................................................................... 54
7.2.5 Send status – <ESC><ENQ><1> .............................................................. 55
7.2.6 Send ACK marker – <ESC><ACK><N1> ................................................... 55
7.2.7 Monitoring when customer takes receipt.................................................... 57
7.2.8 Printing valuable vouchers ........................................................................ 57
7.2.9 Summary of commands used: ................................................................... 58
REVISION HISTORY
2013
P1066584-001 KR203 KPL Programming Manual Page 5 of 58
1 Description
1.1 Purpose
This manual is for integrating KR203 into systems not using a printer driver supplied by Zebra
Technologies, for example embedded system using a proprietary controller and Operating
System.
1.2 Scope
This document covers the command set, settings and user interface of the KR203 kiosk
printer.
1.3 Document Format
In this document, binary data is represented in Zebra Toolbox format, which interprets data
within < and > symbols as binary data. Standard ASCII names such as <ESC> and <ENQ>
are converted to their equivalent binary values by Toolbox. Numbers such as <5> are sent
directly as binary d ata to the printer. Anything not appearing in bracket s, such as the & in
<ESC>&<4> is sent directly as ASCII text to the printer. See Toolbox help for more
information.
When values are specified in the format <N1 2> the space and the 2 indicate that the val ue
is a 16-bit value. Similarly, <N1 4> specifies that it is a 32-bit value.
P1066584-001 KR203 KPL Programming Manual Page 6 of 58
Status LED State
Definition
Solid Yellow
Starting up. Present for about 100ms at first power on. If the solid
yellow stays, the printer failed RAM test and cannot start.
Solid Green
Printer OK
Flashing Red
Printer has detected a severe error. The patt ern of flashing signals
the error. See below for error table.
Flashing or Flickering
Green
Printer is receiving data.
Flash Pattern
Definition
* _ * _
Paper jam in presenter, Error Code 1
* * _ * * _
Cutter jam, Error Code 2
* * * _ * * * _
Out of paper, Error Code 3
* * * * _ * * * * _
Printhead lifted, Error Code 4
* * * * * _ * * * * * _
Paper feed error, Error Code 5
Amber On and Off
Head temperature error, Error Code 6
2 User Interface
2.1 User Interface Overview
The KR203 printer adapts the standard Zebra user interface used on the GX series desktop
products with a couple modifications and extensions. The printe r has four LEDs, two on each
side. The LEDs are labeled Power and Status. There is also a button labeled Feed on each
side.
The user interface is the same on each side. Neither the buttons nor the LEDs are individually
addressable.
The Power LED is green and is always on when 24V is applied to the unit. The Power LED
monitors only the 24V system.
The Status LED displays the current printer status. This LED is bi-col or, and can signal green,
red and yellow. The followi ng table explains the LED states when the feed button is not
pressed.
The KR203 printer has two pieces of software, a bootware and an application.
2.1.1 Application LED States
When the printer is flashing red the following error states can be signaled:
The lowest number error is always reported with the exception of error 4, head open. If the
head is open and the paper is out, the head open will be reported. All errors can be cleared
by the conditions causing them being removed, except cutter jam, which requires a power
cycle or reset command to be issued.
In addition “Paper jam in presenter” will clear automatically when the paper is removed from
the presenter, and “Head temperature error” will clear when the head cools sufficiently. See
“Status Codes” for more information.
P1066584-001 KR203 KPL Programming Manual Page 7 of 58
While Button
Held
Meaning
Solid Green
Appears for 2 seconds, release during this time for a feed, cut and
present. Equivalent to command sequence <RS><0>.
One Flash,
then Solid Green
Release during this time to print the internal self test page. Equivalent
to command sequence <ESC>P<0>
Two Flashes,
Performs media guide detection, cutter calibration, and paper/TOF
sequence <ESC>g.
Three Flashes,
then Solid Green
Performs simulated USB cable disconnect and reconnect causing a
USB plug and play event to occur. No equivalent command.
Four Flashes,
Defaults all printer settings except “EOP Threshold”, and then
perform the calibration and resets all settings.
Five Flashes,
Prints a 50% grey pattern, cuts and ejects it; prints diagonal line
<ESC>P<4><ESC>P<5>
LED Off
Occurs if you continue to hold button beyond five flashes, releasing
button during this t ime does nothing.
Media Present
Meaning
Yes
Advances the media to the next mark in mark mode or the minimum
mode and then cuts media and presents minimum amount.
No
Prepares the printer for auto-load operation.
2.1.2 Application User Interface
The user interface is accessed via the feed button. To use the user interface, press and hold
the feed button. As soon as you depress the but ton, the user interface activates and signals
this by displaying a solid green LED on the status indicator.
The user interface can be accessed when the application is in an idle state, including while an
error has occurred. It cannot be accessed while the printer is already printing.
The function of the UI is dependent on how long the feed button is held. Continuing to hold
the button beyond a given entry in the t able proceeds to the next entry in the table.
then Solid Green
then Solid Green
then Solid green
calibration. Must be started with paper out or error is signaled, see
“Media Guide Detection” for more information. Equivalent to command
performs a media calibration. <ESC>&F<0> is similar but does not
pattern, cuts and presents it. Equivalent to command sequence
2.1.3 Additional UI Operations
In addition to the above items, the printer performs the following tasks:
When the printhead transitions from open to close the following operat ions occur :
amount of media required to maintain media control in continuous
2.1.3.1 Head Close Presenter Clearing
When the printhead is closed, the printer will attempt to clear the presenter if it detects
media is present at it and there is no media at the end of paper sensor. This is in preparation
for calibration. The calibration routine also does this check independently when media is
inserted.
2.1.3.2 Auto Load Operation (Calibration)
When the printer either starts up with no media present or the head is closed and no media
is detected, the printer prepares to auto load media. It also occurs after the defaulting as part
of the 4-flash operation.
P1066584-001 KR203 KPL Programming Manual Page 8 of 58
Reasons For Calibrat ion Failure
Media is pulled out during 1 second start delay.
Head is opened at any time during operation.
In mark mode, printer fails to detect a the first mark within 625mm.
In plain paper mode if the white level of the media varies excessively and cannot be
stabilized within 625mm.
If entire calibration process does not complete within 1250mm.
If any printing has occurred since the last cut (On ly when used as a command)
If the printer detects media in the presenter and is unable to clear it
Parameter No.
Description
35
TOF synchronization
37
Page length
39
TOF marker length
40
Garbage filter
51
TOF marker sensitivity
58
Out of paper level
70
Presenter PWM percentage
When media is inserted into the rear of the printer, it is detected by the active media sensor,
and after a 1 second delay the printer begins to accept the media into the printer, and the
printer will perform a media calibration.
During the one second delay, presenter calibration is performed, so it is important to ensure
no media is present in the presenter when starting a calibration or media load. The firmware
ensures this by attempting to clear the presenter if it detects media present at it when media
is detected at the EOP sensor.
This media calibration occurs when the printer is both continuous and mark mode. In mark
mode, it requires two full forms to complete the calibration. The calibration type depends on
the “TOF Synchro nization ” paramete r. Calibration can fail for the following reasons:
When calibration fails, the media will be cut and ejected, and no error is signaled on the LED,
although a “Black mark calibration error” is reported to the host. If calibration succeeds,
calibration settings are stored. The “Black mark calibration error” is only reported if there are
no other severe errors active.
The following parameters are stored on a successful calibration:
2.1.3.3 Manual Media Loading
Media can also be loaded by opening the printhead, placing media under the printhead and
then closing the printhead. When this happens, no calibration occurs and previous calibration
settings are used. The printer will feed media the minimum amount, move to cut position, cut
and eject the media.
2.1.3.4 Media Guide Detection
When the media guide is changed, the printer will signal media present even when none is.
You must instruct the printer to detect the sensor it should use. This is accomplished with the
two flash function.
This process must be done without media in the printer. If the process is attempted with
media in the printer a “Media guide detection error” (Code 41) occurs. Upon successful
detection of the guide, guide settings are stored, and a “Media guide detection success”
(Code 42) message occurs. The “End of paper threshold” (Parameter 68) is captured during
guide detection along with the read only “Installed guide width” (Parameter 69).
P1066584-001 KR203 KPL Programming Manual Page 9 of 58
Status LED State
Meaning
Rapid Flash Yellow
Firmware missing or corrupt
Fading in and out green
Bootware OK
Alternating Green-Red
Installing application – Do Not power off
Solid Off
Installing bootware – Do Not power off
2.1.3.5 Startup Behavior
The printer must ensure that at startup the printer is in a known state. When the printer is
powered on, it will make a small click to signal it has become ready.
2.1.3.6 Additional Notification
When settings are stored to flash with the <ESC>&<4> command, a small click will be made
to signal the storage.
2.1.4 Bootware User Interf ace
When the bootware is in error, holding the feed button down will signal the error condition:
Force entry into boot mode b y powering on the printer while holdi ng the feed button and
having the printhead open. Exit boot mode from a “Bootware OK” state by pressing and
holding the feed button for 10 seconds.
P1066584-001 KR203 KPL Programming Manual Page 10 of 58
Command
Modes
Category
Description
Page
<ESC><ENQ><1>
A & B
Enquiry
Send status
12
<ESC><ACK>
A
Enquiry
Send ack marker
12
<ESC><ENQ>c
A & B
Enquiry
Send information
13
<ESC><ENQ><5>
A
Enquiry
Send sensor
13
<ESC><ENQ>P
A
Enquiry
Send parameter
14
<ESC><ENQ>Q
A
Enquiry
Send all parameters
14
Print uncompressed graphics
line
<ESC>J
A
Feed
Feed forward
15
<ESC>j
A
Feed
Feed backward
15
<FF>
A
Feed
Advance to TOF
15
<RS>
A
Feed
Cut and present media
15
<ESC><RS>
A
Feed
Cut media
16
<US>
A
Feed
Partial cut media
16
<ENQ>
A
Feed
Eject media
16
<ESC>?
A & B
System
Hard reset
17
<ESC>@
A
System
Soft reset
17
<ESC>&p
A
System
Set parameter in queue
17
<ESC>P
A
System
Print test page
17
<ESC>p
A
System
Force print
18
<ESC>&<4>
A
System
Store parameters
18
<ESC>&F
A
System
Recall parameters
18
<ESC><255>
A
System
Exit application
19
<ESC><0>
B
System
Load application
19
<ESC>#
A
System
Calibrate Media
20
<ESC>g
A
System
Calibrate System
20
3 Commands
3.1 Command Overview
The following is a table of all commands implemented in the KR203 Kiosk printer.
The Mode field indicates what modes the command is available in, A indicates it is available in
the Application; B indicates it is availa b le in Bootware.
<ESC>s A Graphics
14
P1066584-001 KR203 KPL Programming Manual Page 11 of 58
Quick Command Facts
Name
Send status
Modes
Application and Boot
Parameters
None
Type
Enquiry
Execution
Immediate
Quick Command Facts
Name
Send ack marker
Modes
Application
Parameters
N1
Marker Number
0-255
Type
Enquiry
Execution
Synchronized, Initiate
3.2 General Notes on All Commands
Once transmission begins, a complete command must be received by the printer within 5
seconds. If the complete command is not received, the printer will automatically reset.
Commands marked “Immediate” will always operate as soon as they are parsed, regardless
of if there is any error conditions present.
Commands marked as “Synchronized” are placed into the printers command queue when
they are received.
Commands marked “Initiate” cause processing on the command queue to start as soon as
they are received by the printer.
Note that when any Severe error occurs, “Synchronized” commands that were present in the
print queue are not executed and are deleted. Some commands (such as Send ack marker)
do special things when they are deleted from the queue in this way. See individual
commands for more details.
Some of the parameters reference trays which are folders to store parameter data in. The
available trays are:
0 which is the current temporary values (these value s will be deleted during a power cycle)
1 which are the stored values (these values will rema in after a power cycle)
255 which are the default values of the firmware version loaded into the printer
3.3 Enquiry Commands
For all Enquiry commands, the status will be returned in the format selected by the “Status
protocol” parameter (number 66). The contents of the returned data vary based on the
selected protocol. See the “Status protocol” parameter, specifically the “Send Status” section
of the selected protocol.
3.3.1 Send status - <ESC><ENQ><1>
This command instructs the printer t o return its
current status to the host.
3.3.2 Send ack marker - <ESC><ACK><N1>
This command instructs the printer t o return an
ack marker to the host.
An ack marker is a marker that is returned to the
host when all the commands in the command
queue have been executed up to the point at
which the command was received. Executed
means physically printed in the case of motor or
feed commands, not just received by the printer.
N1 specifies the marker number to return. Resending the same marker will cause the same
marker to be returned twice.
P1066584-001 KR203 KPL Programming Manual Page 12 of 58
Number
Name
Range
Description
0
Returns information on all available sensors
1
End of paper selected
0,1
Determines if paper is out at the selected
paper sensor
2
Top of form
0,1
Determines if the paper is currently at top of
form position
5
Paper at presenter
0,1
Determines if there is paper present under the
presenter sensor
9
Printhead temperature (C)
-57..122
Determines the printhead temperature in
degrees Celsius
10
Environment temperature (C)
-60..127
Not implemented on KR203 printer.
11
Head down
0,1
Determines if the printhead is in the down and
locked position
12
Cutter home
0,1
Determines if the cutter is in home position
13
Paper low
0..2
Determines if paper is detected at the paper
connected.
14
24V level (V)
0..50
Determines the voltage of the 24v supply
below 18 volts.
15
Media width
60,80
Determines the sensed guide width. Set during
guide width” setting.
16
FF button
0,1
Determines if the feed button is depressed.
individually addressable.
17
Pull detect
0,1
Determines if the presenter feed motor is
be active during print.
Quick Command Facts
Name
Send information
Modes
Application & Boot
Parameters
None
Type
Enquiry
Execution
Immediate
Quick Command Facts
Name
Send sensor
Modes
Application
Parameters
N1
Sensor Number,
or 0 for all.
Type
Enquiry
Execution
Immediate
The contents of the returned data vary based on the selected protocol. See the “Status
protocol” parameter, specifically the “Send ack marker” section of the selected protocol. If
the protocol supports it, the marker can either be positive, meaning all commands up to this
point were executed, or negative, ind icating that an error occurred on a command executed
before this point.
3.3.3 Send info r m ation - <ESC><ENQ>c
This command instructs the printer t o return
system information to the host.
See the “Status protocol” parameter, specifically
the “Send information” section of the selected
protocol.
NOTE! – This command takes several seconds to execute if information level setting in
parameter n67 is set to High.
3.3.4 Send sensor - <ESC><ENQ><5><N1>
This command instructs the printer to information
about a sensor to the host.
A value of zero indicates a negative “NO” for the
sensor. A value of one indicates a positive “YES”
for the sensor.
Table of Sensor Numbers:
P1066584-001 KR203 KPL Programming Manual Page 13 of 58
low sensor. The result is 2 if no sensor is
running into the printer. Printer will reset
calibration, and the same as the “Installed
The two feed buttons are ganged and not
currently sensing motion. Note that this may
Number
Name
Range
Description
18
End of paper 80mm
0,1
Determines if paper is out at the 80mm sensor
guide.
19
End of paper 60mm
0,1
Determines if paper is out at the 60mm sensor
guide.
Quick Command Facts
Name
Send parameter
Modes
Application
Parameters
N1
Parameter
number
Type
Enquiry
Execution
Immediate
Quick Command Facts
Name
Send all parameters
Modes
Application
Parameters
N1
Tray Number
Type
Enquiry
Execution
Immediate
Quick Command Facts
Name
Print uncompressed graphics
line
Modes
Application
Parameters
N1
Data Size
N2…NX
Data
Type
Graphics
Execution
Synchronized
on the printer, regardless of the selected
on the printer, regardless of the selected
Specifying an inva lid sensor number for N1 will result in an “Index error”.
3.3.5 Send para meter - <ESC><ENQ>P<N1>
This command instructs the printer t o return a
parameter settings value.
N1 specifies the parameter number to return.
Specifying an invalid parameter number for N1
will result in an “Index error”.
For a list of available parameters see the “Parameters” section.
3.3.6 Send all parameters - <ESC><ENQ>Q<N1>
This command instructs t he printer to return all
parameters for a given tray value.
N1 specifies the tray to return.
The available trays are 0 which is the current
temporary values, tray 1 which are the stored
values and 255 which are the default values. Specifying a value for N1 other than these
values will result in an “Index error”.
3.4 Graphics Commands
3.4.1 Print graphics line - <ESC>s<N1><N2>..<nX>
This command sends a graphics stream to
the printer.
N1 specifies the stream size, which is the
number of bytes fron N2 to nX.
N2 specifies the graphic data to transmit to
the printer in raw binary format.
Any line for which less data than the current print width is specified, the remainder of the line
will be filled with blank dots. Excess data beyond the print width specified for a line will be
ignored.
When printing graphic lines, the print speed is deter mined by the burn time s ettings and the
compensation systems. The printer will drop speed when this occurs. Feed media commands
always moves media at the selected speed, so the rapid change between feed speed and
print speed can reduce print quality.
P1066584-001 KR203 KPL Programming Manual Page 14 of 58
Quick Command Facts
Name
Feed forward
Modes
Application
Parameters
N1
Amount
Type
Feed
Execution
Synchronized
Quick Command Facts
Name
Feed backward
Modes
Application
Parameters
N1
Amount
Type
Feed
Execution
Synchronized
Quick Command Facts
Name
Advance to TOF
Modes
Application
Parameters
None
Type
Feed
Execution
Synchronized, Initiate
Quick Command Facts
Name
Cut and present media
Modes
Application
Parameters
N1
Present Amount
Type
Feed
Execution
Synchronized, Initiate
N1 Value
Amount Presented
0
50mm
1-254
1-254mm respectively
255
Entire page lengt h minus
20mm.
3.5 Feed and Cut Commands
3.5.1 Feed forward - <ESC>J<N1>
This command feeds media forward, i.e.
feeds without printing.
N1 specifies the amount to feed in motor
steps. There are approximately 8 steps per
mm.
The media feed always occurs at the selected print speed.
3.5.2 Feed backward - <ESC>j<N1>
This command feeds media backward.
N1 specifies the amount to feed in motor
steps. There are approximately 8 steps per
mm.
The media feed always occurs at the
selected print speed.
Note that it is possible to back the media out of the printer. A reverse operation at the start
of a page should ne ver exceed 7mm, or a N1 value of 56.
3.5.3 Advance to TOF - <FF>
This command feeds media to the next top
of form. The top of form position is either
when the next mark i s detected when “TOF
Synchronization” is enabled, or the “Page
Length” when in continuous mode.
If the setting “Auto Cut After TOF” is
enabled, a cut occurs after the movement, and the cut media is presented the default
amount (50mm).
3.5.4 Cut and present media - <RS><N1>
This command feeds media to the next top
of form. The top of form position is either
when the next mark i s detected when “TOF
Synchronization” is enabled, or the “Page
Length” when in continuous mode, and then
cuts the media.
The media is then presented based on the amount specified by N1:
The first time media is presented, the
parameter “Wall Compensation” is added to
the present amount.
Subsequent presentations do not have this
addition performed.
P1066584-001 KR203 KPL Programming Manual Page 15 of 58
Quick Command Facts
Name
Cut media
Modes
Application
Parameters
None
Type
Feed
Execution
Synchronized, Initiate
Quick Command Facts
Name
Partial cut media
Modes
Application
Parameters
N1
Amount to leave
uncut in MM
Type
Feed
Execution
Synchronized, Initiate
Quick Command Facts
Name
Eject media
Modes
Application
Parameters
None
Type
Feed
Execution
Synchronized, Initiate
It is important to note that no presenting operation can cause the media to be completely
ejected from the printer. Only an eject command can completely remove the paper from the
printer. This cut is affected by the “Auto advance before cut” setting.
3.5.5 Cut m ed i a - <ESC><RS>
This command feeds media to the next top
of form. The top of form position is either
when the next mark i s detected when “TOF
Synchronization” is enabled, or the “Page
Length” when in continuous mode, and then
cuts the media.
No present operation occurs when using this command so a “Present media” command must
then be performed to present the media to the customer. This cut is affected by the “Auto
advance before cut” setting.
3.5.6 Partial cut media - <US><N1>
This command feeds media to the next top
of form. The top of form position is either
when the next mar k i s detected when “TOF
Synchronization” is enabled, or the “Page
Length” when in continuous mode, and then
partially cuts the media. The value specified
by N1 determines how much media is left
uncut in millimeters.
The amount specified is generally only accurate to 10mm increments, and has a range of 10-
60mm. Values above 60 result in no cut, a value of 0 results in a full cut, and is identical to
the <ESC><RS> command.
Note that if a partial cut fails, a full cut may occur in the process of trying to resolve the
error, but the customer will still be able to get both of their receipts, just fully separated.
A complete cut operation must be performed before the media can be ejected. This cut is
affected by the “Auto advance before cut” setting.
3.5.7 Eject media - <ENQ>
P1066584-001 KR203 KPL Programming Manual Page 16 of 58
This command completely ejects a cut piece
of media from the presenter.
This command does nothing if the media has
not been cut yet.
Quick Command Facts
Name
Hard reset
Modes
Application & Boot
Parameters
None
Type
System
Execution
Immediate
Quick Command Facts
Name
Soft reset
Modes
Application
Parameters
None
Type
System
Execution
Immediate
Quick Command Facts
Name
Set parameter in queue
Modes
Application
Parameters
N1
Parameter Number
N2…NX
Parameter Value
Type
System
Execution
Synchronized
Quick Command Facts
Name
Print test page
Modes
Application
Parameters
N1
Type of page
Type
System
Execution
Asynchronous, Initiate
3.6 System Commands
3.6.1 Ha rd reset - <ESC>?
3.6.2 So f t reset - <ESC>@
This command performs a hard printer reset.
This is equivalent to a power cycle.
When in the bootware, this command is
used to exit the bootware and start
execution of the application, provided a valid
application is installed.
This command performs a software reset of
the printer. A software reset resets all
communication interfaces, and emp ties all
queues and buffers.
3.6.3 Set parameter in queue - <ESC>&p<N1><N2>..<NX>
different sizes in the KR203, so it is critical to send the proper number of bytes for a given
setting.
If N1 is an invalid parameter number, an “Index error” will occur. If the value specified by
N2..NX is outside the valid range for parameter N1, an “Out of range” will occur.
For a list of available parameters see the “Parameters” section.
This command just loads the setting into the operating parameters; to store them, use
<ESC>&<4><1>
3.6.4 Print test page - <ESC>P<N1>
value for N1 will result in an “Index error”.
The execution of this command is Asynchronous, meaning that while it will be executed in
queue order; commands around it may also be executed at the same time. For this reason,
when executing these commands, other printing commands should not be executed; however
additional test pages can be executed.
P1066584-001 KR203 KPL Programming Manual Page 17 of 58
This command sets a parameter in the
printer. Parameters control all system
options in the printer.
N1 specifies the parameter number to set.
N2 to NX specifies a binary value to set the
parameter to. Different parameters are
This command instructs the printer to print a
built in test page.
N1 specifies the type of page to print. See
the table below for more details. Each print
is followed by a move to cut position, and a
cut and default eject. Specifying an invalid
N1 Value
Page Description
Continuous Mode Length
0
Self test page – Displays logo and firmware
version number
92mm
3
25% staggered dot page
177mm of printing, 190mm
total
4
50% 1-dot page
177mm of printing, 190mm
total
5
2-bit rotating pattern page
177mm of printing, 190mm
total
6
50% 2-dot page
177mm of printing, 190mm
total
7
Density pattern page
152mm of printing, 165mm
total
Quick Command Facts
Name
Force print
Modes
Application
Parameters
None
Type
System
Execution
Immediate, Initiate
Quick Command Facts
Name
Store parameters
Modes
Application
Parameters
N1
Tray to store
parameters in
Type
System
Execution
Immediate
Quick Command Facts
Name
Recall parameters
Modes
Application
Parameters
N1
Tray to load
parameters from
Type
System
Execution
Immediate
When “TOF Synchronization” is enabled, after the page is completed, the printer will advance
to the next mark, then cut and eject.
3.6.5 Force print - <ESC>p
This command forces all items in the
printer’s queue to be executed immediately
upon receipt of this command.
Note that when there is a severe error, the
queue is emptied, so sending this command
during a severe error has no effect.
3.6.6 St ore parameters - <ESC>&<4><N1>
This command instructs the printer to store
the current operating parameters in flash,
making them the power on settings.
N1 specifies the tray to store the parameters
in. Tray 1 is the only t ray present on the
KR203. Specifying an invalid tray will result
in an “Index error ”.
After execution of this command is complete, the printer will make a small click noise to give
the user acknowledgement that the save has occurred.
Note that parameters set with <ESC>&p as well as any temporary parameters send by an
installed driver will be stored via this command.
3.6.7 Recall parameters - <ESC>&F<N1>
This command instructs the printer to load
the current operating parameters from the
specified tray.
N1 specifies the tray to load the parameters
from.
On the KR203, tray 1 holds the parameter
values stored in flash, and tray 255 holds the factory defaul t values. Specifying any other
value will result in an “Index error”.
P1066584-001 KR203 KPL Programming Manual Page 18 of 58
Loading...