therein are owned by ZIH Corp. and Zebra’s licensors. 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.
ZebraLink, Element Energy Equalizer, E3 and all product names and numbers are trademarks, and Zebra, the Zebra
head graphic, ZPL and ZPL II 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 manual contains proprietary information of Zebra Technologies Corporation and its
subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described 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 Corporation.
Product Improvements Continuous improvement of products is a policy of Zebra Technologies Corporation.
All specifications and designs are subject to change without notice.
Liability Disclaimer Zebra Technologies Corporation takes steps to ensure that its published Engineering
specifications and manuals are correct; however, errors do occur. Zebra Technologies Corporation reserves the right
to correct any such errors and disclaims liability resulting therefrom.
Limitation of Liability In no event shall Zebra Technologies Corporation or anyone else involved in the creation,
production, or delivery of the accompanying product (including hardware 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 Corporation 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.
This manual is updated from time to time when printer functions and features are added or
amended. You can find the latest edition on our website at
functions not found in this manual edition, please contact
the Zebra partner from which you purchased the printer.
www.zebra.com. If you require
Technical Support for your region or
09/18/2014TTP 2100™ Technical ManualP1003640-004
Introduction
8
About this Manual
P1003640-004TTP 2100™ Technical Manual09/18/2014
2
Product Presentation
Contents
TTP 2100 Series ........................................................ 9
The TTP 2100 series of ticket printers are available both for Kiosk integration and Desktop
use. These printers are Common Use Self-Service (CUSS) capable.
These ticket printers print on most ticket media from 50 mm to 82.5 mm wide using direct
thermal printing. The ticket media can be up to 0.25 mm thick, fanfold, roll, or single cut
handfed.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Product Presentation
10
TTP 2100 Series
The printers have an integrated guillotine cutter, straight presenter, and control board. The
print speed is up to 150 mm/s and the eject speed 300 mm/s to ensure high throughput.
The cut can be synchronized with:
• Gaps between tickets, or punched holes
• Black marks on the non thermal side of the ticket stock
• Ticket corner radius
• Label gaps (for adhesive labels on backing/liner)
You can also print fixed-length or variable-length tickets without synchronization. The
presenter can be set to eject the ticket into a tray or hold it by the back edge until the customer
takes it. The top can easily be opened to give the operator access to the paper path and
printhead for maintenance purposes.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Figure 1 • Principle of Operation
Product Presentation
TTP 2100 Series
9
11
5
4
3
2
1
Control panel on both sides
1
Cutter
2
Tickets fall (into tray)
3
Ticket sensor (taken/fallen)
4
Straight presenter
5
Ticket load sensor
6
Printhead
7
Upper media sensor (IR light source), adjustable sideways
8
Top release lever
9
Paper entry
10
Lower media sensor (IR light receiver), adjustable sideways
11
Control board
12
6
7
8
10
11
12
The upper media sensor is an IR light source that illuminates the media. The lower media
sensor is an IR light receiver. These sensors must work together to sense media gaps or out-ofmedia conditions.
The printer is available with two different control boards; the TTP 2110 with serial interface
and the TTP 2130 with USB interface.
A printer driver for Microsoft Windows™ is available, and the TTP 2130 interface is
compatible with the Plug and Play standard.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Product Presentation
12
Presenter
Presenter
Eject Mode
Hold Mode
The KPL control command language makes it easy to print directly from the ticket software
without using a driver. This is especially useful for the serial interface version with its limited
data transfer rate.
The TTP 2100 does not loop the media. The presenter carries the media through the printer for
presentation to the user.
The ticket is ejected after being cut. The printer is designed so that the ticket always drops
down. A sensor is located at the exit of the presenter to ensure that the printer can verify that
the ticket drops down. To enable this functionality, in the Properties dialog, click the Device Settings tab, and under Presenter Settings set the Clear presenter value to Ye s .
When presented, only the very end of the printout is held by the printer so the customer can
easily take the printout no matter how long or short it is. If a customer is printing more than
one ticket, the printer can detect when the first is taken and automatically print the next and
hold that ticket until taken, continuing this process until all tickets have been printed.
Figure 2 • The Presenter
Print and drop
Print and take
P1003640-004TTP 2100™ Technical Manual09/18/2014
Controls
Cover lock
Feed Button
Figure 3 • Rear View
Product Presentation
Controls
13
The buttons and indicators are duplicated on both sides of the printer so that they are easily
accessible regardless of how the printer is installed.
Feed Button
The Blue Feed button has several functions:
• Press and release will feed, cut, and present a complete page.
• Any data in the print buffer will be printed.
If the buffer is empty the page will be blank.
In black mark mode, the page will be synchronized with the black mark.
Power Indicator
Status Indicator
Earth
Screw
Interface
Connector
Paper low
Connector
Power
Connector
• Press and hold Feed for three seconds to print a self-test printout (See
Making a Self-Test
Printout).
• With no paper in the printer, hold the Feed button pressed while closing the printhead to
enter TOF mark calibration mode (see
Note • If the printer has firmware version 3.82 or lower, press and hold the Feed button
Print Setup).
while turning on the printer to print a self-test printout.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Product Presentation
14
Controls
Power Indicator
Status Indicator
● When the green power indicator is illuminated, a 24V supply is connected to the printer.
● The status indicator has several functions:
• ON constantly — the printer is operational
• Flash, flash, pause, flash, flash — is the warning-code for paper low.
The warning-code is reset automatically when the condition causing it is removed.
This behavior is disabled by default but can be enabled by setting parameter 52
(Warning Level) to 1.
• Flashes rapidly — indicates error. Hold down the Feed button and the number of flashes
will reflect the status-code.
Table 1 • Status Indicator Flash Codes
Number of
Flashes
1Presenter jam, paper cannot be ejected
2Cutter cannot return to home position
3Out of paper
4Printhead lifted
5Paper did not reach presenter sensor in time
6Temp error, printhead is above 60
7Paper jam during present
10TOF mark not found (on media load)
11TOF mark calibration error
Fast flashesChecksum error at firmware loading
Steady lightWrong firmware type
Constantly offWaiting for paper in TOF mark calibration mode
Status codes are reset:
Description
°C
• When the conditions causing them are removed.
• When the printer is power cycled (turned off and then on).
• For all paper jam conditions, after the jam is cleared, lifting and lowering the printhead.
P1003640-004TTP 2100™ Technical Manual09/18/2014
3
Installation
Contents
Installing a Paper Guide .................................................. 15
Top of Form (TOF) Sensor ................................................ 19
Installing a Paper-low Sensor (Optional) ..................................... 26
Connecting to the Computer .............................................. 27
Connecting the Power ................................................... 29
Making a Self-Test Printout ............................................... 31
Installing a Printer Driver ................................................. 33
Installing a Paper Guide
Caution • Before proceeding, always disconnect the printer from power to avoid the
guide installation short circuiting the electronics in the printer. If the printer is installed in
a Kiosk, then all Kiosk power should be turned off to prevent the screw or media guide
bracket from accidentally falling into powered up Kiosk components (e.g., the screw or
bracket may fall and bounce into the Kiosk components mounted adjacent to or
mounted below the printer).
TTP 2100 printers are delivered without the paper guide fitted. TTP 2100 paper guides are
available in widths ranging from 51 mm to 82.5 mm. A dual paper guide is available with a
54 mm and 82.5 mm paper path.
1. Push the green printhead open lever backwards.
2. Lift up the printhead. See Clearing Paper Jams.
3. Insert the T-shaped tabs of the paper guide into the “T”-holes, press the rear of the guide
down, and using your fingers or a 5 mm wrench tighten the knurled nut.
4. Close the printhead.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
16
Installing a Paper Guide
Figure 4 • Fitting the TTP 2100 Paper Guide
When a guide is fitted, make an auto calibration (see Calibrating the TOF Sensor
on page 20) with the ticket media that you are going to use in the printer. Most ticket
media auto calibrate perfectly, and the printer is ready to use.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Figure 5 • TTP 2100 Dual Paper Guide
Installation
Installing a Paper Guide
17
If you use the TTP 2100 Dual Paper Guide 01990-400 on your printer, you must calibrate
twice (once in the wide paper path and once in the narrow paper path). The printer chooses
the appropriate set of parameters based on which paper path contains ticket stock.
If auto calibration fails on your media, set up paper width parameter n48, and sensor
selected parameter n63 to reflect your media. Then redo the auto calibration.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
18
Installing a Paper Guide
5. Start the utility program Zebra Toolbox. This application is available from
www.zebra.com.
6. On the Tools menu, click Parameter Settings.
7. Select 048 Paper Width, click Value, and enter the value in millimeters of the desired
print width.
Paper WidthSetting
82.5 mm n48=80
80 mm n48=72
76 mm n48=70
60 mm n48=54
54 mm n48=50
51 mm n48=46
8. Click Upload One.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Installation
Top of Form (TOF) Sensor
9. Select 063 BM Sensor and enter the desired value. Recommended values are:
ValueWhen Used
0Auto selects between 1, 2, 3, and 4 based on width of media loaded
1(edge sensor) for ATB tickets without hole in the perforation
2 (center sensor) for ISO tickets, most other ticket types, and adhesive labels
317.5 mm from center sensor
412.5 mm from center sensor (for baggage tags according to IATA 740)
10. Click Upload One.
11. Click Store Values to Flash PROM.
12. Wait for the printer to buzz as a confirmation that the new value is stored.
Note • It is recommended that you run the auto calibration routine when the printer is
taken out of the box and whenever you change the media. Running auto calibration after
a head open event is recommended but is only necessary to insure proper first ticket
registration.
19
Top of Form (TOF) Sensor
The TTP 2100 has a flexible top of form detection system. When delivered the printer is
configured with fork (transmissive) sensor to detect holes/gaps between tickets. The
holes/gaps should be in the paper center, 12.5 mm to the right of the center (Bag tags
according to IATA resolution 740), 17.5 mm to the right of the center, or at the edge of
82.5 mm wide tickets (Boarding cards).
If the Top Of Form (TOF) mark is at a suitable position, an auto calibration routine configures
everything for you.
You can force the printer to use a specific sensor. If you switch to reflex sensor for black mark
detection by setting up the parameters in the printer to enable the use of non-standard sensor
positions, you can physically move the sensor to other positions.
Selecting Fork (Transmissive) or Reflex (Black Mark) TOF Sensor
The TTP 2100 can use a fork (transmissive) sensor that looks for holes between tickets, or a
reflex (black mark) sensor that looks for black marks on the back of the ticket stock. Sensor
mode is selected with parameter n61, see
Summary of Parameter Settings.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
20
Top of Form (TOF) Sensor
Calibrating the TOF Sensor
1. Open the printhead.
2. Remove the ticket stock.
3. Press and hold the Feed button, and then close the printhead (keeping the button pressed
the entire time).
4. Release the button.
The Status LED should be off.
5. Load ticket stock (slide it into the paper guide and let the printer auto load the paper).
Note • To ensure good calibration conditions, lightly press the ticket stock towards the
bottom of the input guide during calibration.
The printer will forward the paper until it finds two TOF marks and then stop and save all
TOF-mark parameters.
6. Open the printhead and remove the ticket stock.
7. Close the printhead and feed the tickets in through the paper guide again.
The printer is ready for use.
Repeat this procedure if the calibration fails or if the printer is used with tickets that differ
from the original specification.
Note • If you use the Dual guide 01990-400 on your printer, you must calibrate twice (once
in the wide paper path and once in the narrow). The printer will choose the appropriate set of
parameters based on which paper path contains ticket stock.
Positioning the TOF Sensor
Note • Moving the sensor and IR source require customized paper guides with holes for the
new sensor position. Please contact Zebra Development Services (CAG) if your application
requires a non-standard sensor position.
The sensor board containing the lower media sensor sits on a bracket that can slide left and
right in a groove (see Figure 32, Sensor Positioning, on page 110). This bracket is located
below the ticket entry. The IR light source (upper media sensor) sits on a similar bracket above
the ticket entry. When delivered, the bracket is positioned to the far right. In this position
Sensor 1 is at the right side ready to detect the corner radius of Boarding cards, Sensor 2 is at
the center of the page, and Sensor 4 is 12.5 mm to the right of the center at the position
determined for baggage tags in IATA resolution 740. To configure the printer for other papers
that do not fall into any of the three categories, complete the following steps:
1. Loosen the screw holding the sensor 1 ½ turns.
2. Press the screw in with the screwdriver and carefully slide it to the new position making
sure the cables to the sensor do not obstruct the movement.
P1003640-004TTP 2100™ Technical Manual09/18/2014
3. Tighten the screw.
4. Move the IR light source (upper media sensor) to the same position, directly above the
sensor.
Installation Considerations
The TTP 2100 Kiosk printer is for embedded applications and should be installed in an
enclosure such as a self-service Kiosk.
Installation
Installation Considerations
a3
21
Upper sensor
adjuster
Lower sensor
adjuster
Caution • NEVER use screws that go into the printer more than 4 mm! Longer screws will
destroy the electronics inside.
The TTP 2100 Desktop printer is a stand alone printer in a housing. The housings can be
stacked so two or more printers can reside on top of each other to save space.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
22
Installation Considerations
Orientation
The TTP 2100 printer can be installed horizontally or vertically. Horizontal is the most
common use but vertical with the ticket presenting upwards can be used if you want the ticket
to come up from the desk surface. Vertical with the ticket presented downwards can be used if
you want to stack many tickets before picking them up.
• Using slides with leaf spring retainers and the quick-fit hubs
Ticket exit
Figure7•Front, Bottom View
Push down
Installation
Installation Considerations
Quick-fit hubs
23
Optional
quick-fit
hubs
Keyholes
Lock spring
Push
forward
Fitted
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
24
Installation Considerations
Design Your Own Mounting
The illustration below gives an example of a printer-mounting shelf. See Dimensions, and the
3D solid models and outline drawings for CAD that are available on
www.zebra.com.
Figure 8 • Example of a Simple Shelf for Fastening a Standard Printer Using
Quick-Fit Hubs and a Leaf Spring Retainer (Order No. 01473-000)
m
m
5
.
1
Leaf spring
01473-000
Inner corner of bend
134 mm
110 m m
90.8 m m
10 mm
∅12 mm
Center
10 mm
Min. 100 mm
∅6.5 mm
+ 10 mm
Paper width
8 mm
44 mm
10 mm
Add material for corner radius
Additional space is required for paper loading and paper jam removal, Consider mounting the
printer on a movable platform so that the printer can be maintained outside the printer
enclosure.
We recommend that you make the output slot 97 mm wide. This way you will be able to use
all paper widths that the TTP 2100 series of printers can handle.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Caution • NEVER use screws that go into the printer more than 4 mm! This will destroy the
electronics inside.
Electrostatic Discharges and Earth Currents
Preventing ESD and earth currents from affecting the printer operation requires proper
connection of the printer chassis to protective earth through a mounting platform or through a
separate earth conductor. A threaded hole for an M4 earth screw is provided on the back of the
printer. Use an M4 x 10 screw and two lock washers when fastening the ground cable.
Figure 9 • Location of Earth Grounding Screw
Installation
Installation Considerations
25
Earth
Screw
Note • An optional antistatic brush can be fitted to the front of the printer if required.
Ambient Light
There is an optical sensor at the paper exit at the front of the printer.
To ensure proper printer operation, design the Kiosk so that it prevents direct sunlight or light
from indoor lamps from reaching the sensor through the paper exit.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
26
Installing a Paper-low Sensor (Optional)
Installing a Paper-low Sensor (Optional)
A paper-low sensor alerts the system that the media stock level is running low. The paper-low
sensor works with paper rolls and fanfold media.The purpose of this sensor is to get an early
alert so that you can replace the ticket stock in time in remotely located Kiosks.
The paper-low sensor operates by reflecting a light against the side of a media roll to detect it.
When the media is low, no light is reflected.
The printer automatically reads the paper-low sensor to check media status every time a
printout is cut. After three successive readings show that no paper is present at the sensor, the
status is set to paper low which alerts the system that the media needs to be replaced. Three
successive readings are required to prevent false paper low readings if the side of the media
roll is not clean. When a new roll of media is installed, the printer reads the sensor when the
printout is cut and the paper-low status is changed to paper present or paper not low.
Roll holders supplied by Zebra can be equipped with paper-low sensors. Attach the sensor and
connect the cable to the paper low connector at the back of the printer.
Paper roll
New
Near
end
Figure 10 • Paper-low Sensor Connection
Roll holder shaft
Paper-low
sensor
J10
+5
3
2
1
PL SENSE
Gray = Connection
inside printe r
+5
200 ohm
100 pF
SW97081F
P1003640-004TTP 2100™ Technical Manual09/18/2014
Installation
Connecting to the Computer
27
Figure 11 • Location of Paper-low Connector
Paper Low
Connector
Connecting to the Computer
Figure 12 • Location of Interface Connector
Interface
Connector
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
28
Connecting to the Computer
TTP 2110
Connect a Zebra serial cable (part No. 10825-000) between the printer and the computer to be
used. We strongly recommend using the Zebra cable because many incompatible cables are
available, which may cause communication problems.
Figure 13 • Serial Interface Cable 10825-000.
2RxDRxD2
3TxDTxD3
4DTRDTR4
PC
594837261
Female
Serial Cable 10825-000
6DSRDS R6
7RTSRTS7
8CTSCTS8
1DCDDCD1
5GNDGND5
9RIRI9
Printer
594837261
Female
TTP 2130
Dotted leads are not connected in the printer. To be able to connect the cable in any direction,
make symmetrical cables.
Connect the printer to the USB port of the computer or the USB hub to be used. USB
connectors can be recognized by the following symbol:
.
The connector on the printer is a 4-pin USB type B connector. See Table 4 for pin assignment.
A suitable cable is available from Zebra, part number 105850-028.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Figure 14 • USB Cable with Type A and Type B Connectors
PCPrinter
Position 1Position 1
Connecting the Power
Installation
Connecting the Power
29
Caution • Using a non-Zebra power supply may cause excessive EMC interferences and
void the EMC certifications of the printer.
Caution • To avoid electrical shock and printer damage, wiring of a non-Zebra power
supply should only be done by qualified service personnel. Use ONLY a power supply
which meets the following minimum requirements:
•24 VDC ±5%
•70W (2.92A)
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
30
Connecting the Power
Figure 15 • Location of Power Connector
Power
Connector
Caution • On power supplies with line voltage selector, make sure it is set to your local line
voltage.
Using the appropriate Zebra power supply for TTP 2100 Desktop, or Embedded (
Power
Supply):
1. Connect the cable from the power supply to the power connector on the back of the
printer.
2. Connect the power cable to the line outlet.
3. Turn ON the power.
In Kiosk applications you may draw power from a common PSU in the Kiosk if the
characteristics are suitable. In such a case, cables that fit the connector on the back of the
TTP 2100 are available from Zebra (see
Part Number List on page 133). If you make cables of
your own, connect the voltages according to the following illustration.
Note • Protective ground and minus output should not be interconnected in the power supply.
A 600 mm power cable is available from Zebra. Use this if you have a common power supply
for the entire Kiosk and power the printer from there. Use the connector shown below if you
want to make cables of other lengths. At the printer end of the cable, use a TE Connectivity
Mate-N-Lok connector housing and two contact-sockets.
P1003640-004TTP 2100™ Technical Manual09/18/2014
GND
+24 V
Figure 16 • Power Connection
Installation
Making a Self-Test Printout
31
Housing:
TE Connectivity P/N 350777-1
Table 2 • Current Consumption
Mode58-60 mm paper width80-82.5 mm paper width
Idle150 mA150 mA
Standard text printing0.7 A average1 A average
All black printing4 A6 A
Making a Self-Test Printout
A Self-Test Printout provides a printout showing information specific to the printer, including:
• Firmware version
• Control board (PCA) revision
• Paper width
• Serial number
• Installed fonts and logotypes
Socket:
TE Connectivity P/N 350689-1
• Parameter settings
• Barcode support
09/18/2014TTP 2100™ Technical ManualP1003640-004
Installation
32
Making a Self-Test Printout
To make a Self-Test Printout:
1. Enter Self-Test Mode using one of the following methods:
If…Then…
The printer has firmware
version 3.83 or higher
The printer has firmware
lower than version 3.83
Figure 17 • Locate the Feed Button and On/Off Switch
Press and hold the Feed button for 3 seconds.
a. Press and hold the Feed button just after closing the
print head.
b. See Figure 17. Press and hold the Feed button (1)
while turning on the power (2) to the printer.
c. Hold down the Feed button until printing starts.
Each successive time the Feed button is pressed
will produce an additional Self-Test printout until
Self-Test Mode is exited.
d. Exit Self-Test Mode by power cycling the printer
(turning the power off then on again). If the power
switch is not easily accessible, open and close the
print head.
P1003640-004TTP 2100™ Technical Manual09/18/2014
Customizing the Self-Test Printout
The self test printout starts with a text line, and then a Zebra logotype. This logotype is just a
printout of logotype No. 0, so if you want to personalize the self test printouts in your
installation, delete all logotypes and store your own logotype as No. 0 (see
Figure 18 • Logotype No. 0 is Printed on the Self-Test Printout
Installation
Installing a Printer Driver
Logotypes).
33
Installing a Printer Driver
The Microsoft Windows™ printer driver for the TTP 2100 is available on the Zebra website at
www.zebra.com/drivers. Please follow the installation instructions in the Zebra Kiosk Printer
Status Reporting ....................................................... 89
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
42
Programming Overview
Programming Overview
There are two ways of generating a printout with the TTP 2100 printer: using the KPL control
language or using a printer driver.
KPL Control
Language
Printer DriverTTP 2130 printers can print documents through a driver. When a Windows driver is used,
When operating in this mode, you have direct control over what the printer does using
KPL command sequences. The printer has two operation modes you can choose from.
In variable page mode, the printer can act as a simple word processor, printing text that it
receives. It can also print some types of barcodes and basic graphics in this mode. The
selection of fonts and barcode types that are available are limited to what is stored in the
flash PROM and the firmware of the printer. In this mode, information is printed in the
same sequence as it is received.
In fixed page mode, you can place rotated text, barcodes, images, and ruled lines. This
mode provides more flexibility than variable page mode, but is limited by available
printer memory. Printout elements can be specified in any order. You instruct the printer
when your layout is complete, and it is all printed at once.
Selection of the mode is controlled by the setting of parameter n36. (Refer to Document
Mode for more information about parameter n36)
Use the Zebra Toolbox (available from
designs.
you can use any Windows program to design the ticket with text, graphics, barcodes or
whatever you want to print and in any orientation. When using a driver, printout is not
limited by printer memory.
The Windows driver issues all the necessary commands. By setting up printing
preferences in the driver you select how the printer should cut and present the printout.
www.zebra.com) to easily build text oriented
Figure 25 • Printout Styles
KPL Control Language receiptDriver (Windows) receipt
P1003640-004TTP 2100™09/18/2014
How the Commands are Described
Programming
How the Commands are Described
43
Mnemonic
Is the popular command name that should be easy to remember.
Hex
Give the command in hex representation.
Decimal
Give the command in decimal representation.
Mnemonic
ESC ! n1
1B 21 n1 Hex
27 33 n1 Dec
Decimal representation of command
Hex representation of command
Select font
Purpose of command
SW 03002
Values
n1, n2, etc. represent values that you specify to control how the command behaves. These are
different for each command and are explained in the text that follows each command
description.
Examples
Command examples are formatted in Courier and typed in the same way as used in the
Zebra Toolbox:
Where <ESC> means the escape character 27 decimal (hexadecimal 1B). Numbers between
less-than and greater-than characters, for example <1><19>, means 1 and 19 decimal. When
the numbers indicate a hex value,
value (<h 1><h 13>).
Example • <65>, <h 41> and A are three different ways of expressing the character A.
<ESC>&P<1><19>
a leading h and then a space is placed before the hex
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
44
How the Commands are Described
Two-Byte Character Definitions
Some commands and parameters are used with a two-byte value definition because the internal
structure of the printer's firmware limits access to values greater than 255.
To represent values greater than 255 in this two-byte format, divide the value by 256. The
whole number (quotient) is the value of the leading byte and the remainder (modulo) is the
value of the trailing byte.
Example • To represent 731 in two-byte notation, divide 731 by 256.
:
731 ÷ 256 = 2 with a remainder of 219 (2 x 256 + 219 = 731)
Therefore, the two-byte representation of 731 is <2><219>.
1B 62 n1...n527 98 n1...n5Print Bitmap at XY-Position62
1B 42 n127 66 n1Bold51
1B 42 43 n127 66 67 n1Barcode Clear59
1B 42 53 n1...n1127 66 83 n1...n11Barcode Field Specify57
1B 42 57 n127 66 87 n1Barcode Write58
1B 64 n127 100 n1Make n Linefeeds54
1B 05 01 27 5 1 Status Enquiry74
73
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
46
Summary of Control Codes and Escape Sequences
CommandHexDecimalFunctionPage
ESC ENQ 2
ESC ENQ 4
ESC ENQ 5
ESC ENQ 6
ESC ENQ 7
ESC ENQ 9
ESC ENQ 10
ESC ENQ 11
ESC ENQ 12
ESC ENQ c
ESC ENQ E
ESC ENQ H
ESC ENQ P n1
ESC ENQ = ?
ESC FF n1
ESC g
n1...n5
1B 05 02 27 5 2 Paper-Near-End Enquiry76
1B 05 04 27 5 4 Fonts and Logotype Enquiry77
1B 05 05 27 5 5 Sensor Enquiry78
1B 05 06 27 5 6 Status Report79
1B 05 07 27 5 7 Firmware-Version Enquiry80
1B 05 09 27 5 9 Serial-Number Enquiry80
1B 05 0A 27 5 10 Control Board Revision Enquiry80
1B 05 0B 27 5 11 Head Temperature Enquiry81
1B 05 0C 27 5 12 Bootware Version Enquiry81
1B 05 63 27 5 99 Device ID Enquiry82
1B 05 45 27 5 69 Read Extended Status82
1B 05 48 27 5 72 Read Printer Info82
1B 05 50 n127 5 80 n1Parameter-Setting Data Enquiry83
1B 05 3D 3F27 5 61 63Media Loaded into Tray Enquiry83
1B 0C n127 12 n1Eject (Run Presenter)69
1B 67 n1...n527 103 n1...n5Print Logotype64
ESC h n1
ESC i n1
ESC j n1
ESC J n1
ESC L n1
ESC N n1
ESC NUL
ESC o n1
ESC p
ESC P n1
ESC Q n1 n2
ESC r
n1...n9
ESC RS
ESC s n1 data
ESC t n1...n5
1B 68 n127 104 n1Text Height52
1B 69 n127 105 n1Italics51
1B 6A n127 106 n1Paper Reverse66
1B 4A n127 74 n1Paper Advance66
1B 4C n127 76 n1Print Logotype at Current
Position
1B 4E n127 78 n1Align Text50
1B 00 27 0 Load Firmware74
1B 6F n1 27 111 n1Text and Logotype Orientation 49
1B 70 27 112 Print65
1B 50 n127 80 n1Print Self-Test Printout66
1B 51 n1...n227 81 n1...n2Quick Advance67
1B 72 n1...n927 114 n1...n9Print Ruler Line63
1B 1E 27 30 Cut Only, No Eject68
1B 73 n127 115 n1Send Dot-Line, 203 dpi63
1B 74 n1...n527 116 n1...n5Print Text at XY53
65
P1003640-004TTP 2100™09/18/2014
Programming
Summary of Control Codes and Escape Sequences
CommandHexDecimalFunctionPage
47
ESC T n1
ESC u n1
ESC w n1
ESC Z
FF
HT
LF
RS
US
Note • In all responses from the printer the most significant byte (MSB) is transmitted first.
1B 54 n127 84 n1Reversed/Inversed Text51
1B 75 n127 117 n1Underline52
1B 77 n127 119 n1Text Width52
1B 5A 27 90Go to Next Top of Form48
0C 12Form Feed55
09 9Horizontal Tabulation55
0A 10 Linefeed54
1E 30Cut and Eject67
1F031Partial Cut (Unit Separate)68
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
48
Software Command Syntax
Software Command Syntax
The commands in this section are grouped after what they do, and these groups are sorted in a
theoretical usage sequence. It starts with commands for specifying the printed page—through
text-and-graphics commands—to cut-and-present commands. System and status commands
are presented at the end.
Black Mark (Top-of-Form) Commands
See Aligning Preprint and Thermal Print.
ESC #
1B 23Hex
27 35Decimal
ESC Z
1B 5A Hex
27 90Decimal
Calibrate TOF Sensor
When the printer is not in black mark mode, the calibration measures the out of paper level
(parameter 58) and the whiteness of the paper.
In Black Mark Mode, it also determines if it should trigger on black marks or holes, then
measures the contrast of the mark and distance between marks, then sets parameters n37-n40,
n51, n57 bit 3, and n58 to suitable values for the analyzed ticket.
To make the calibration permanent, send <ESC>&<4> to store parameter values.
Note • If black mark calibrations fails, the printer will indicate error code 11 by blinking 11
times when you press and hold the Feed button, and by answering <NAK><11> to the status
enquiry.
Go to Next Top of Form
In black mark mode, an <ESC>Z starts looking for a black mark at the current position and
continues for one page length. If no black mark is found, bit 3 in status byte 1 is set to 1 and
the printer will report <NAK><10> on the next status query.
When black mark mode is disabled, <ESC>Z will perform a form feed.
P1003640-004TTP 2100™09/18/2014
Text Commands
Text received by the printer is printed with the currently selected font and font attributes. Text
exceeding the page width is wrapped with the line spacing selected.
Programming
Software Command Syntax
49
ESCon1
1B 6F n1 Hex
27 111 n1 Decimal
Text and Logotype Orientation
Changes the orientation of text and logotypes in Fixed Page Mode (n36=0).
n1 = 0Gives portrait orientation
n1 = 1Gives landscape orientation
n1 = 2Gives upside down portrait orientation
n1 = 3Gives upside down landscape orientation
Portrait and landscape or upside-down portrait and upside-down landscape can be mixed on
the same printout (see Figure 26, Printing Orientations, on page 49). There are four cursors,
one for each orientation. The cursor always starts at the top left corner of the selected
orientation. Looking at the paper when it exits the printer, the portrait cursor is at the top left
corner of the printout, moving to the right as text is typed, while the landscape cursor is at the
top right corner, moving downwards, etc.
Note • The printer is capable of printing all four orientations on a single fixed page. This is valid
in firmware versions 3.90 and higher.
<ESC>o<2>Upside down Portrait<LF>
<ESC>o<3>Upside down Landscape<LF>
<RS>
Upside down portrait
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
50
Software Command Syntax
ESCNn1
1B 4E n1Hex
27 78 n1Decimal
Align Text
Changes the alignment of text, barcodes, and logotypes printed with <ESC>L on the current
line; on subsequent lines, it defaults back to Left align. The alignment can be changed multiple
times per text line.
n1 = 0Left
n1 = 1Center
n1 = 2Right
ESC!n1
1B 21 n1Hex
27 33 n1Decimal
Select Font
This command selects one of the printer’s eight installed fonts. The font design depends on
which fonts have been loaded into the printer’s flash PROM. Make a test printout to see which
fonts are available in your printer.
n1 = 0Normal font (font 0)
n1 = 1Font 1
n1 = 2Font 2
n1 = 3Font 3
n1 = 4Font 4
n1 = 5Font 5
n1 = 6Font 6
n1 = 7Font 7
Note • For information on loading fonts, see Font Loading.
This command performs the same function as setting parameter n14, Font Selection. Refer to
Font Selection for more information.
If a line of text is too long to be printed due to the font, position, print width, or any other
factor, the text line will be automatically wrapped. If wrapping occurs, any alignment
command is canceled. Different fonts can be used on the same line.
Selecting an empty font location will set bit 4 of byte 1 in the <ESC><ENQ><6> response
to 1. The printer will also return a <NAK><12> on the next <ESC><ENQ><1> enquiry. This
<NAK><12> is a one-time error that will clear after read.
Note • If more than 379 characters are sent to the printer before an LF, the text buffer is
printed automatically. Each font or text style change consumes two bytes in this buffer. The
text is formatted based on the formatting commands as they were received.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
51
ESCBn1
1B 42 n1Hex
27 66 n1Decimal
ESCin1
1B 69 n1Hex
27 105 n1Decimal
Bold
Bold command works best with normal character width. With higher widths, the effect of bold
becomes less pronounced. The Bold command can be applied to single characters, words, or
text lines.
Bold remains in effect until deactivated or until the printer is reset.
a
n1 = 0Turns OFF bold (Normal)
n1 = 1Turns ON bold
Italics
The Italics command works best with normal character width and height. At other values, the
output can become pixelated. The Italics command can be applied to single characters, words,
or text lines.
Italics remains in effect until deactivated or until the printer is reset.
n1 = 0Turns OFF Italics (Normal)
ESC T n1
1B 54 n1Hex
27 84 n1Decimal
n1 = 1Turns ON Italics
Reverse Text and Background
Selects normal black text on a white background or reversed white text on a black background.
Single characters, words, or complete text can be reversed.
This command remains in effect until deactivated or until the printer is reset.
n1 = 0Gives normal print, black on white
n1 = 1Gives reversed print, white on black
Note • Reverse text and underline invert the print data. This means that the order in which
the commands are issued affect the printout if the text overlaps, such as in the case of italics.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
52
Software Command Syntax
ESCun1
1B 75 n1Hex
27 117 n1Decimal
ESChn1
1B 68 n1Hex
27 104 n1Decimal
Underline
n1 = 0Turns OFF underline
n1 = 1...7Turns ON a 1–7 pixel thick underline
Characters, single words, or complete text lines can be underlined.
Text Height
This command scales the height of the text printed by a factor of up to 16x. The valid range of
values is 0 to 15.
n1 = 0Resets the character height to the base character height
n1 = 1...15Increases the character height to 2...16 times the base character height.
In combination with variable character width (<ESC>w<n1>), gives highly legible characters
depending on the font to which the command has been applied.
Different heights can be mixed on the same print line.
ESC w n1
1B 77 n1Hex
27 119 n1Decimal
Text Width
This command scales the width of the text printed by a factor of up to 8x. The valid range of
values is 0 to 7.
n1 = 0Resets the character width to the base character width
n1 = 1...7Increases the character width to 2...8 times the base character width.
In combination with variable character height (<ESC>h<n1>), gives highly legible characters
depending on the font to which the command has been applied.
Different widths can be mixed on the same print line.
Important • Use of the multiple width function when printing barcodes is not recommended
as the text data may become illegible.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
53
ESC t n1...n5data
1B 74 n1...n5dataHex
27 116 n1...n5dataDecimal
Prints a text string at the specified XY position. The string is formatted based on the current
active formatting attributes except for alignment.
n1n2Two byte definition of the X print position (in pixels).
n3n4Two byte definition of the Y print position (in pixels).
n5The number of characters in the string. To avoid having to count characters
dataThe text string. If text string length is specified with n5, the length must be
After the data has been printed, the cursor will return to the position it had before the print text.
Note • The Y coordinate will be ignored if the printer is in variable document mode (n36=1).
Note • <ESC>t<n1...n5> clears the text buffer each time it is used, destroying any
unprinted text on the same line. Commands will not be cleared.
Print Text at XY
you can set n5 to <0> (null) and then terminate the text string with null.
exactly the number of characters specified, otherwise the printer will stop,
waiting for more characters. Data that extends off the edge of the printable
area will not be wrapped to the next line.
BS
08 Hex
8 Decimal
CAN
18 Hex
24 Decimal
Backspace
Moves the print-position one step to the left. Backspace can be used to combine characters.
For instance to print a Ø, send text command O<BS>/ to the printer, and the slash will
overprint the O.
The print position can only be moved one step to the left. Multiple backspaces in succession
are ignored.
Cancel
Cancels text and attributes sent before the <CAN> command on the same line.
Commands are not cancelled.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
54
Software Command Syntax
CR
0D Hex
13 Decimal
LF
0AHex
10 Decimal
Carriage Return
By default, carriage return is ignored.
Parameter n33 (CR/LF Behavior) can be changed so the printer interprets <CR> as follows:
• Interpret it as <CR>, returning the print position to beginning of line without line feed.
• Interpret <CR> as <CR><LF>, inserting line space as specified by the line spacing setting
(see parameter n13), and returning the print position to beginning of the line.
See CR/LF Behavior.
Linefeed
Linefeed is interpreted as <CR><LF> by default. This inserts line spacing as specified by the
line spacing setting (see parameter n13), and returns the print position to beginning of the line.
<LF> also converts text from the text buffer to pixel lines and stores them in the line buffer,
ready to be printed.
By changing the default settings, you can:
• Interpret <LF> as Linefeed. This inserts line space as specified by the line spacing setting
(see parameter n13), without returning the print position to the beginning of the line.
ESC d n1
1B 64 n1Hex
27 100 n1Decimal
• Ignore <LF>.
See CR/LF Behavior.
Make n Linefeeds
Executes the number of linefeeds as defined by variable n1. The length of each line feed is
determined by the default value for selected font or the line spacing setting specified by n13,
whichever is greater (refer to parameter Line Spacing).
If an <LF> has not yet been sent to convert the text buffer to the line buffer, the lines printed
by <ESC>d<n1> are copies of that line. Following this, the print position is returned to the
beginning of the line.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
55
FF
0C Hex
12 Decimal
HT
09 Hex
9Decimal
Form Feed
Prints data from the text buffer and feeds the paper to the top of the next page.
In fixed document length mode (n36 = 0) this command prints data in the text buffer and feeds
the paper to the top of next page.
In variable document length mode, <FF> advances to the minimum page length as specified
by n37 and n38. If the printout already is longer than the minimum page length, <FF> does
not feed any additional paper.
In black mark mode, the <FF> command looks for a black mark, see ESC Z .
If Auto Cut (n34) is set to 1 (see Auto Cut After FF), <FF> affects form-feed, cut, and eject.
Note • Use parameter p37 and p38 to define page length.
Horizontal Tabulation
Shifts the current print position to the next Tab position
Set tab positions with parameters n15 – n30. Refer to Tab Stop.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
56
Software Command Syntax
Barcode Commands
A standard TTP 2100 can print 1-D barcodes EAN 8, EAN 13, EAN128, UPC, 2-of-5
Interleaved, ISBN, Code39, and Code128, plus 2-D barcodes PDF417, and Aztec.
Older versions of the printer (serial numbers lower than 2-0913-27444) can only print the 1-D
barcodes as standard, but can be upgraded with a firmware that replaces the 1-D barcodes with
PDF417 only. See
Firmware and 2-D Barcode Print (PDF 417).
Printing Barcodes Without Text
The 1-D barcodes print the encoded message under the code itself, see Samples of Barcodes. If
you want to print only the barcode without the text, follow the procedure below:
1. Load the font “1x1 blank” that comes with the Zebra Toolbox utility.
2. Select that font with the <ESC>!<n> command.
3. Send the commands for the barcode.
4. Return to the normal font after the barcode data.
Figure 27 • Samples of Barcodes
P1003640-004TTP 2100™09/18/2014
ESC B S n1...n11
1B 42 53 n1...n11Hex
27 66 83 n1...n11Decimal
Barcodes can only be printed in portrait mode unless Fixed Document Mode is selected. See
Document Mode
Programming
Software Command Syntax
Example • This example will print an EAN barcode with height = 10 mm, 15 mm in from
the left margin.
<ESC>BS<0><0><72><0><0><0><0><64><0><2><2>
<ESC>BW<0>733104000099<0>
<LF><RS>
Barcode Field Specify
n1Specifies the barcode field number. The valid range is 0 – 15. Barcode fields may
be specified in any order.
n2n3Specifies the X coordinate of the barcode field origin (n2 is the higher order byte
and n3 the low order byte).
n2 and n3 are one-byte numbers. Refer to
Two-Byte Character Definitions for more
information about two-byte values. Values that place the barcode outside the
printable area may cause the barcode to be partially printed and be unreadable.
57
n4n5Specifies the Y coordinate of the barcode field origin (n4 is the high order byte and
n5 is the low order byte).
n4 and n5 are one-byte numbers. Refer to
Two-Byte Character Definitions for more
information about two-byte values. Values that place the barcode outside the
printable area may cause the barcode to be partially printed and be unreadable.
n6Must be specified but is not used.
n7n8Specifies the height of the bars in pixels (n7 is the high order byte and n8 is the low
order byte).
n9Specifies the type of barcode. The following types are supported.
n9 = 0 EAN 8 or 13 (auto detect). The printer calculates the necessary check digit.
n9 = 1 UPC
n9 = 2 2/5 Interleaved (even number of characters must be sent)
n9 = 3 ISBN
n9 = 4 Code128 (Start data string with C2h to encode EAN128)
n9 = 6 Code39
n10Specifies the thickness of the narrow bar 0=1 pixel, 1=2 pixel, and so on.
n11Specifies the wide-bar-to-narrow-bar ratio. Only used in Code 39 and 2-of-5
interleaved where different ratios are allowed
This command reserves an information field as a barcode field. The command also identifies
the type, number of digits, and the configuration of bars to be placed in the barcode field.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
58
Software Command Syntax
Code 128 / EAN128
ESC BWn1nx
1B42 57n1nxHex
027066 087n1nxDecimal
The following codes select function codes in Code 128:
NameDecHex
FNC1 193 C1h
FNC2194C2h
FNC3 195C3h
FNC4 196 C4h
Starting the data string with FNC1 generates an EAN128 code.
Note • By default, the printer will print barcodes with human readable characters. To avoid
this behavior, load the font 1x1_blank.swf to the PROM and select that font with ESC !
before you specify the barcode. After the ESC BW command, you can return to the normal
font. This font is available in the Toolbox application.
Barcode Write
Writes data to the barcode field reserved by the ESC BS command.
n1Specifies the barcode field number. The valid range is 0 - 15. This number must
be the same number used to specify the field using the ESC BS command.
Fields can be specified in any order but other values than 0 to 15 are ignored.
n2 . . . nxSpecifies barcode data bytes. Up to 80 bytes may be specified.
To create a barcode add-on, insert a space character and then the data for the
add-on. Two of five characters are allowed of the add-on.
NUL Must be placed at the end of the barcode data.
Any invalid barcode character terminates the command, and prints <Invalid bar code>
on the printout.
Example • This example will print one barcode with height = 10 mm and located 15 mm to
Clears the barcode field reserved by command <ESC><BS><n1>.
n1Specifies which barcode field to clear. The range is 0 to 15. The fields may be
ESC|5
1B7C05n2-nxHex
0271245n2-nxDecimal
n2-nx
This command positions and prints a PDF 417 2-D barcode.
Note • 2-D barcodes are standard in all printers starting with serial number 93J. Older
printers require special firmware to be loaded. See Firmware.
n1Specifies the type of barcode.
n1 = 5PDF 417
n2n3Specifies the X-coordinate of the barcode field origin. n2 is the most
n4n5Specifies the Y-coordinate of the barcode field origin. The Y-coordinate is
Barcode Clear
.
cleared in any order.
2-D Barcode Print (PDF 417)
significant byte (MSB). n3 is the least significant byte (LSB).
discarded in variable document mode. n4 is the most significant byte
(MSB). n5 is the least significant byte (LSB).
n6 (PDF 417)Rows of barcode data. The valid range is 0 for automatic row calculation
or 3–90 to specify the number of rows.
n7Columns of barcode data. The valid range is 0 for automatic column
calculation or 1–30 to specify the number of columns.
n8Specifies the error correction level for the PDF 417 barcode. The valid
range is 0 for automatic calculation or 1–9 to specify an error level
(ErrorLevel 0 to ErrorLevel 8, respectively).
n9Specifies in pixels the height of each row of the barcode.
n10Specifies the scaling factor of the barcode
n11n12Specifies the length of the data to follow.
Both n11 and n12 are specified as 0. The data field (n13...nx) is terminated
by a null.
If n11 and n12 are non-zero, they specify the length of the n13...nx data
that follows. The valid range for this parameter is 0 (which species the null
terminated behavior) and 1 to 2710.
Even when using the null terminated behavior, you cannot specify more
than 2710 bytes (not including the terminating null).
n13...nxByte data to be encoded. Data must be null-terminated if n11 and n12 are 0
or must be the length specified by n11 and n12 otherwise.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
60
Software Command Syntax
Example • To print Zebra as a PDF 417 barcode, send the following to the printer:
n2n3<x_msb> <x_lsb> Sets the X-coordinate of the barcode field origin.
n4n5<y_msb> <y_lsb> Sets the Y-coordinate of the barcode field origin.
The Y-coordinate is discarded in variable document mode.
n6Flag - Instructs the barcode engine how it should interpret <27> bytes in
the data stream.
If set to <0>, Data is assumed to be straight bytes to be encoded.
If set to <1>, placing <27> in Data is interpreted to be FLG markers to be
encoded in the barcode.
The byte in Data after <27> represents the FLG to be encoded. To encode
<27> in when Flag is 1, send <27><27>.
n7Menu - If non-zero, the barcode is encoded as an Aztec menu barcode.
n8Multi - The number of symbols to use in encoding the barcode. The valid
range is <1> to <26>.
n9n10Layer - The encoding scheme and error correction. n9 is always <0>.
The following values are valid for this field:
<0> = Default Error Correction Level
<1> to <99> = Minimum Error Correction Percentage
<101> to <104> = 1 to 4-layer Compact Symbol
<201> to <232> = 1 to 32-layer Full-Range Symbol
n11Scale - The size in pixels of a single dot element.
n12n13
The length of the data to follow. The maximum number of bytes that can
be encoded is 1914 (<7><122>), however the maximum readable size is
dependent on many factors including print speed, burn time, media quality,
scale, error correction percentage, and reader quality.
If set to <0>, <nul> indicates the end of the data block <data>.
If length is set to other values, the value indicates the number of bytes in
<data>.
<data>
Data to be encoded.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
62
Software Command Syntax
Graphics Commands
Example • To print Zebra as an Aztec barcode, send the following to the printer:
This example will print a barcode that looks like this:
ESC b n1...n5data
1B 62 n1...n5dataHex
27 98 n1...n5dataDecimal
Prints a black & white (1-bit color depth) Windows bitmap (BMP file) at the specified
X-Y position. The bitmap must be a complete uncompressed Windows bitmap where the data
starts with BM. The maximum bitmap size is limited to the free RAM printed on the self-test
printout.
n1Always 0
n2n3Two byte definition of the X print position (in pixels)
n4n5Two byte definition of the Y print position (in pixels)
dataBitmap data
After the bitmap has been printed, the cursor will return to the X-position that it had before the
bitmap command was issued.
Selecting horizontal mode (with <ESC>o<0>) prints the image in portrait orientation, while
selecting the vertical mode (with <ESC>o<1>) prints the image in landscape orientation.
Note • The Y print-position and horizontal/vertical orientation only works if Fixed
Document Mode is set. See Document Mode.
Print Bitmap at XY-position
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
63
ESC s n1 data
1B 73 n1dataHex
27 115 n1dataDecimal
Sends one line of dot data. This command is used to build images, one dot line at a time by the
printer driver and should not be combined with text commands.
n1Determines the number of bytes. Range: 1-255.
<data>1 – x bytes, where x is the paper width in bytes. The paper width is set by
Caution • Always send the number of bytes that you specify with n1.
If you transmit more data than the number of bytes specified by n1, the rest of the bytes will
be interpreted as text or commands. This can cause numerous problems in the printer as
graphics data can contain any hex value.
ESC r n1...n9
1B 72 n1...n9Hex
27 114 n1...n9Decimal
Send Dot-Line, 203 dpi
parameter n48. If n48 is set to 0 (automatic width), 58 mm and 60 mm printers will
use 54 bytes, while 80 mm and 82.5 mm printers use 72 bytes. The maximum
width setting is 80 bytes.
If you specify more bytes in n1 than the paper width of the printer, the additional
bytes are discarded. If you specify less bytes in n1 than the paper width of the
printer, the printer will fill the remaining portion of the dot line with blank pixels.
Print Ruler Line
Prints a ruler line across the paper.
A ruler line is normally used to divide the printout into logical parts to make it easier to read. A
ruler line is actually an area defined by a start X-Y position and a stop X-Y position. This area
is filled with black or a checkered pattern.
n1n2Two byte definition of the X print position to start the ruler line (in pixels)
n3n4Two byte definition of the Y print position to start the ruler line (in pixels)
n5n6Two byte definition of the X print position to stop the ruler line (in pixels). This
value must be larger than the X start position.
n7n9Two byte definition of the Y print position to stop the ruler line (in pixels). This
value must be larger than the Y start position.
n9Specifies the fill pattern. The valid range is 0 to 3. 0 is black and 1-3 are various
checkered patterns. Values out of range are interpreted as 0.
Note • The Y print-position and horizontal/vertical orientation only works if Fixed
Document Mode is set. See Document Mode.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
64
Software Command Syntax
Figure 28 • Printout with Checkered Ruler Line
<ESC>r<0><0><0><0><1><193><0><24><3>
X sta r tY sta r tX stopY s top
F ill:
0 = black
1 = ne
2 = me dium
3 = coarse
SW99006
ESC g n1...n5
1B 67 n1...n5Hex
27 103 n1...n5Decimal
Print Logotype
Prints a customized logotype stored in the flash PROM. See also Logotypes.
n1One-byte logotype identification number. The valid range is 0 to 15.
n2n3Two byte definition of the X print position to place the upper left corner of the
logotype (in pixels). If the logotype extends outside the printable area, it will
be cropped.
n4n5Two byte definition of the Y print position to place the upper left corner of the
logotype (in pixels). If the logotype extends outside the printable area, it will
be cropped.
Note • The Y print position and horizontal/vertical orientation only works if Fixed
Document Mode is set. Refer to Document Mode for more information.
Note • For information about logotype loading, refer to ESC & 001.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
65
ESCLn1
1B 4C n1Hex
27 76 n1Decimal
Prints a customized logotype stored in the flash PROM at the position of the cursor. The
bottom edge of the logotype is positioned at the baseline of the text on the line. If the logotype
is taller than the text, the line spacing is increased as necessary.
n1One-byte logotype identification number. The valid range is 0 to 15.
Note • When using <ESC>L the logotype is added to the text buffer, so a text printing
command such as <LF> or <FF> must be used to generate the printout.
Print Commands
ESC p
1B 70 Hex
27 112 Decimal
This command makes the printer print the contents of the line buffer.
Text is converted to image data in the line buffer when an <LF> is received. If the line buffer
is empty when <ESC>p is received, nothing is printed.
Print Logotype at Current Position
Print
Text to be printed <LF><ESC>p prints “Text to be printed” on the paper.
Printout occurs automatically at:
Cut <RS> and <ESC><RS>
Form feed<FF>
Clear presenter <ENQ>
Run presenter <ESC><FF><n>
Text or line buffer full
When the Feed button is pressed
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
66
Software Command Syntax
ESCPn1
1B 50 n1Hex
27 80 n1Decimal
ESCJn1
1B 4A n1Hex
27 74 n1Decimal
Print Self-test Printout
This command makes the printer generate a self-test page based on the current parameter
settings and print that page. The parameter values printed are the ones currently being used.
They can differ from Power-ON default values if for example a printout has been made by a
driver before ESC P is sent to the printer.
For more information, refer to Making a Self-Test Printout.
n1 = 0 Gives standard self-test printout.
n1 = 1 Gives a character set printout using the font selected by parameter n14.
Paper Advance
The value n1 represents the number of dot lines the paper is to be transported forwards. The
valid range is 1 to 255.
A dot line is 0.125 mm, and 255 dot lines equal approximately 32 mm.
Important • Using paper feeding command (<ESC>J<n>, <ESC>j<n>, and <ESC>Q<n>)
when operating in fixed page mode (n36 = 0) causes the fixed page to be printed and then the
feed operation occurs. To create white space without generating a printout of the fixed page,
use <LF>.
ESCjn1
1B 6A n1Hex
27 106 n1Decimal
Paper Reverse
The value n1 represents the number of dot lines the paper is to be transported backwards. The
valid range is 0 to 255.
A dot line is 0.125 mm, and 255 dot lines equal approximately 32 mm.
Caution • NEVER reverse more than 7 mm (n1 = 56) at top of page! The platen can lose
grip on the media, which can fall out of the printer.
Important • Using paper feeding command (<ESC>J<n>, <ESC>j<n>, and <ESC>Q<n>)
when operating in fixed page mode (n36 = 0) causes the fixed page to be printed and then the
feed operation occurs. To create white space without generating a printout of the fixed page,
use <LF>.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
67
ESCQn1n2
1B 51 n1Hex
1B 81 n1Decimal
The value n1 n2 represents high byte and low byte of the number of dot lines the paper is to be
transported forwards. Minimum value is 1, and maximum value is 32767.
A dot line is 0.125 mm, and 32767 dot lines equals approximately 4.1 m.
Using paper feeding command (<ESC>J<n>, <ESC>j<n>, and <ESC>Q<n> when
operating in fixed page mode (n36 = 0) causes the fixed page to be printed and then the feed
operation occurs. To create white space without generating a printout of the fixed page, use
<LF>.
Cut and Present Commands
Important • The printer will not receive data while cut and present commands are executed.
RS
1E Hex
30 Decimal
The paper is cut and presented through the presenter module. The <RS> command
automatically gives the presentation length of 50 mm in addition to the amount specified by
parameter n47.
Quick Advance
Cut and Present Media
If the printout length is less than the minimum page length (75 mm or the value specified by
n37 and n38, whichever is greater), paper is fed until the minimum printout length is reached
before execution of any cut command.
Note • The cut position is 9 mm after the print line. This makes the last 72 dot lines of the
previous page end up on the beginning of the next page. To have the printer position the cut
after these dot lines, set parameter n49 = 1 (Advance before cut to automatic distance
calculation). The auto advance function also adds an additional 16 dot lines (2 mm) of feed
due to the width of the cutter blade.
If you prefer to set n49 to 0 (off), you can use a paper advance command to perform the same
task:
<ESC>J<88><RS>
This will position the cut 16 dot lines (2 mm) after the end of the print data.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
68
Software Command Syntax
ESC RS
1B 1E Hex
27 30 Decimal
Cut Only, No Present
<ESC><RS> causes the paper to be cut but performs no present operation.
Eject can be effected with the <ESC><FF><n> command (see Present Media).
To avoid thin strips of paper in the printer, multiple cut commands without paper feed inbetween will not be performed. If the printout length is less than the minimum page length
(75 mm or the value specified by n37 and n38, whichever is greater), paper is fed until the
minimum printout length is reached before execution of any cut command.
Also, refer to the note in RS concerning the cut position with regard to the print line.
Text to be printed<CR><LF>
<ESC><RS>
<ESC><FF><30>
will print “Text to be printed” and cut and then eject 30 mm.
Note • Use the Cut Only command if you want full control over the printer from your
system. When using <ESC><RS>, you must add commands to feed to the correct cut
position (if n49 is not set to 1) and commands to eject the paper so that the customer can
retrieve the printout.
US
1FHex
031Decimal
Partial Cut (Unit Separate)
Prints a dotted line, a pair of scissors, and partially cuts the paper from both edges towards the
center to make it easier to tear off the paper. This command causes all data in the image buffer
to be printed and generates the printout of a fixed page when n36 = 0.
The length of the partial cut can be set with parameter n60. Refer to Partial Cut Length for
more information.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
69
ESC FF n1
1B 0C n1Hex
27 12 n1Decimal
Present Media
<ESC><FF> presents a piece of media that has been previously cut. Variable n1 represents
the present length in millimeters. The setting of parameter n47 is always added to the value of
n1.
Present
length in mm
The valid range for n is 1 to 127. The range 128-255 is reserved for future use.
Place this command after a cut command (<ESC><RS>) to partially present the printout to the
customer. Set the present length so that the customer sees that the printout comes out of the
Kiosk wall. The pull detector gives motorized eject of the rest of the printout when the
customer begins to pull the paper.
EM n1
19 n1Hex
25 n1Decimal
ENQ
05 Hex
5 Decimal
Note • The cut and present command <RS>, automatically presents 50 mm in addition to the
amount stored in parameter n47.
Note • No matter how long a present you set, the printer will not loose grip of the printout.
To eject fully, use the <ENQ> command.
Enforced Clear Presenter
<EM><n1> functions the same as <ENQ>. The valid range of n1 is 0 to 255. The command
will clear the presenter immediately (with printing synchronization).
Clear Presenter
<ENQ> clears the paper path of the presenter from printouts. This command completely ejects
a document that has not been removed during the print/cut/present operation.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
70
Software Command Syntax
System Related Commands
ESC ?
1B 3F Hex
27 63 Decimal
ESC @
1B 40 Hex
27 64 Decimal
ESC & 001
1B 26 01 Hex
27 38 1 Decimal
Reset (Full)
<ESC>? restarts the printer with a complete reset. During this operation, all buffers are
purged, all memory is cleared, and stored parameters are reloaded. USB printers will go off the
bus during execution of this command and will reconnect when the reset is complete. After
issuing this command, wait approximately 3 seconds for the printer to reset before issuing data
to the printer.
Reset (Initialize)
<ESC>@ terminates command processing and reinitializes the control board. All parameters
are set to power on values and all buffers are purged. After issuing this command, wait
approximately 3 seconds for the printer to reset before issuing data to the printer.
Load Logotype
<ESC>&<1> stores a logotype bitmap in the flash PROM. The logotype is stored to flash
memory and the printer is reset. The logotype can then be printed with <ESC>g<n1> and
<ESC>L<n1> commands, see ESC g n1...n5 and ESC L n1. Also see Logotypes. The printer
indicates that storage is complete by operating the presenter motor for a short period of time.
ESC&L
1B 26 4C Hex
27 38 76 Decimal
ESC & 004
1B 26 04 Hex
27 38 4 Decimal
Erase All Logotypes
<ESC>&L erases all logotypes stored in the flash PROM. The printer indicates that erasure is
complete by operating the presenter motor for a short period of time.
Store Current Parameter Values
<ESC>&<4> stores the current setting of all parameter values in the printer’s flash memory.
These parameters are then used as default power on parameters. Storing the parameters to
flash memory takes approximately 4 seconds, during which time the printer cannot
communicate. The printer indicates that storage is complete by operating the presenter motor
for a short period of time.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
71
ESC & 000
1B 26 00 Hex
27 38 0 Decimal
<ESC>&<0> is used to load a font to the printer flash PROM. The font is placed in the first
free position. The printer indicates that storage is complete by operating the presenter motor
for a short period of time. The font position is determined by the order that the fonts are loaded
into the printer.
A Kiosk printer font file consists of a header containing data describing the font as well as data
for each individual character in the font.
Fonts can be designed with the FastFont application included with Toolbox and can be loaded
or deleted using the Toolbox application. The fonts loaded are not used by the Windows
driver, so it is not necessary to load fonts into the printer to use the Windows driver.
For complete specification of the font format, refer to Font Loading.
Note • The available font memory is printed on the self-test printout. A maximum of 8 fonts
may be loaded (numbered 0 to 7). If you attempt to load a font that is larger than available
memory or attempt to load more than 8 fonts, the font loading command will not load the
font.
ESC&bn1n2n3
1B 26 62Hex
27 38 98Decimal
Load Font
Set Bit Field Parameters
ESC&C
1B 26 43 Hex
27 38 67 Decimal
<ESC>&b<n1><n2><n3> sets the bit field parameters using the following:
n1 Parameter number
n2 Operation (1=set to 1(on), 0=set to 0(off))
n3Mask
Example • This example sets bits 0 and 3 of n64 to 0
<ESC>&b<64><0><b 00000101>
Erase All Fonts
<ESC>&C erases all fonts stored in the flash PROM. The printer indicates that erasure is
complete by operating the presenter motor for a short period of time.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
72
Software Command Syntax
ESC&D
1B 26 44 Hex
27 38 68 Decimal
ESC&F
1B 26 46Hex
27 38 70Decimal
ESC & P n1...n2
1B 26 50 n1...n2Hex
27 38 80 n1...n2Decimal
Erase Fonts 4 to 7
<ESC>&D erases the fonts in positions 4–7. Fonts in positions 0–3 are not affected by this
command.
The font position is determined by the order that the fonts are loaded into the printer. This
command can take up to 20 seconds to execute.
Reset Parameter Profile
<ESC>&F temporarily sets all parameters to predefined default values that are stored in the
firmware. To make the default values permanent, store them in the EEPROM with command
<ESC>&<4>.
Unless the parameters are stored, a reset command or power cycle will return the parameters to
the settings stored in the EEPROM.
Set Parameter Value
The printer stores its configuration settings in an EEPROM. When the printer is powered on,
the values are loaded from the EEPROM. Using this command, a parameter value can be
temporarily overridden. The value can later be made permanent with the <ESC>&<4>
command. Permanently stored values are loaded after a printer reset or at power on.
n1 Parameter number, range 1-255.
n2 Parameter value. Refer to Default Parameter Settings for information about
the valid range for each parameter number.
P1003640-004TTP 2100™09/18/2014
Set Several Parameters at Once
You can use this command to set multiple parameters at once. The format for this option is as
follows:
<ESC>&P<0><n2><n3><data>
When operating in this mode, specify a value of 0 for n1, the first parameter you want to set for
n2, and the number of parameters to set for n3, followed immediately by the parameter data.
To set parameters that extend over a range in which the parameter number is not defined,
specify 0 for the parameters that do not exist. For example, to set n4 to n7, you must provide
all four parameters in data even though n6 does not exist.
Example • This example sets the first 5 tabs to 5, 10, 15, 20, and 25. (n2 = 5, n3 = 5)
<ESC>&P<0><15><5><5><10><15><20><25>
Store parameters permanently by sending <ESC>&<4>.
Programming
Software Command Syntax
73
ESC&sn1
1B 26 73 0AHex
27 38 115 10Decimal
ESC&S
1B 26 53 Hex
27 38 83 Decimal
Load SPI Slave Firmware
This command is only valid for the following:
• TTP 2110, serial number higher than 2-0913-27444, or starting with 93J
• TTP 2130, serial number higher than 2-0913-27471, or starting with 93J
The TOF sensor has its own firmware that can be upgraded using this command.
n1 SPI Slave address, for the sensor board, the address is 10 dec.
<file>the bin file with the new firmware
Return to Saved Values
If parameters are temporarily set in RAM, this command returns them to the values stored in
the non volatile memory.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
74
Software Command Syntax
ESC NUL
1B 00 Hex
27 0 Decimal
This command should be used when you integrate firmware loading into your Kiosk program.
After transmitting this command, send the firmware binary file. If the firmware is the proper
version for the printer and the firmware checksum is valid, the firmware is then programmed
into the printer's flash memory. This process can take up to 60 seconds and the printer will
reset when the process is complete, and reappear on the USB bus. Therefore, if your
application needs to know when the upgrade is ready, monitor the USB bus for the printer
return.
Note • The Toolbox application can be used to load new firmware.
Status Reporting Commands
Important • All status commands except for the acknowledge marker are immediate. This
means that these commands bypass the print queue and are answered as soon as they possibly
can be.
Status codes are reset when:
• the conditions causing them are removed
Load Firmware
• the printer is power cycled (turned off/on)
• the printhead is lifted and then lowered to clear a paper jam.
ESC ENQ 1
1B 05 01 Hex
27 5 1 Decimal
Status Enquir y
<ESC><ENQ><1> issues a status enquiry that results in response <ACK> (hex 06) if there are
no errors, or <NAK> (hex 15) and a byte indicating an error if one or more sensors report some
condition.
Table 3 • Status Codes
Status CodeMeaning
ACKOK (printer is operable)
NAK 1Paper left in presenter module. Attempt to clear the paper path failed.
NAK 2Cutter jammed
NAK 3Out of paper
NAK 4Printhead lifted
NAK 5Paper-feed error. No paper detected in presenter although 10 cm has been printed. Paper
might be wound around the platen or, in some way, has been forced above the presenter
module.
NAK 6Temperature error. The printhead temperature has exceeded the 60 °C maximum limit.
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
Table 3 • Status Codes
Status CodeMeaning
NAK 7Presenter not running
NAK 0ABlack mark not found
NAK 0BBlack mark calibration error
NAK 0CIndex error
NAK 0DChecksum error
NAK 0EWrong firmware type or target for firmware loading
NAK 0FFirmware cannot start because no firmware is loaded or firmware checksum is wrong.
Note • Errors 0B, 0C, and 10 are one-time errors that clear once they are read.
Important • Errors 2 and 5 are terminal faults that require you to reset the printer before it
will be operable again. A reset means that any data in the buffer is lost. The printer
automatically recovers from the other conditions as soon as the condition is corrected.
75
<ESC><ENQ><1> can only return one status code at a time. If there are two or more
simultaneous conditions, each condition should be cleared and the status enquiry repeated in
order to get a complete report of all status codes.
The host computer cannot be certain that all conditions have been cleared until an ACK is
received.
In the case of multiple error conditions, the one with the lowest number is reported.
Note • To read out all status information at once, use <ESC><ENQ>E.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
76
Software Command Syntax
ESC ENQ 2
1B 05 02 Hex
27 5 2 Decimal
Paper-near-end Enquiry
This command requests a paper-near-end sensor (paper low) status from the printer in a 1-byte
format.
Value = 1indicates “No paper”
Value = 0 indicates “Paper present” at the sensor position
The status of the sensor is sampled every time the printout is cut. If three successive samples
show that there is no paper present at the sensor, the status reply changes to 1. This is to
prevent false readings if the side of the paper roll is not clean. If you want instantaneous
status of the sensor, use <ESC><ENQ><6> and examine the paper near end bit.
If you do not have a paper-low sensor connected, the reply to this query will be 1, “No paper
at the sensor position.”
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
77
ESC ENQ 4
1B 05 04 Hex
27 5 4 Decimal
Fonts and Logotype Enquiry
<ESC><ENQ><4> requests information regarding loaded fonts and logotypes. This command
does not return information about the length of the structure, so you must read all the data up
to the last <CR><LF>.
<ESC><ENQ><5> returns a 2-byte response, reflecting the status of all virtual sensors.
Virtual sensors maintain their functionality in all configurations of this printer, while physical
sensors reported by <ESC><ENQ><6> may signal differently depending on installation
factors such as vertical or horizontal installation.
The same physical sensor can give several virtual statuses depending on when the sensor is
activated in the print cycle.
The first byte of the response is reserved for future use.
Second Byte:
76543210Bit
Sensor 1, Paper before head
Sensor 2, Black mark
Sensor 3, Paper after head
Sensor 4, not used
Sensor 5, presenter
Sensor 6, not used
Sensor 7, not used
Sensor 8, not used
Figure 29 • Physical-to-Virtual Sensor Mapping
Printout exit
Cutter
Paper entry
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
79
ESC ENQ 6
1B 05 06 Hex
27 5 6 Decimal
Status code available*
Status Report
Note • The sensor status reported in the status report are for compatibility with older printers.
Please use <ESC><ENQ><5> in new applications. Refer to ESC ENQ 5 on page 78 for more
information.
Results in a 2-byte response, reflecting the status of each sensor. This command is intended as
a go/no go indication.
First Byte:
7654321 0Bit
Do not use!
Do not use!
Error black mark
Power has been OFF
Print data exists**
Second Byte:
7654321 0Bit
Out of paper
Paper-near-end***
Paper at presenter
Cutter stuck
Printhead lifted
*This bit indicates that a status code is available. Use <ESC><ENQ><1> or
<ESC><ENQ>E to fetch it.
**This bit tells you that there are data in the printer that have not yet been
printed. There are two possible reasons for that:
1. The last command received by the printer was not a command that
triggers a printout.
2. The printer is printing.
***This paper-near-end bit differs from the <ESC><ENQ><2> response.
Bit 4 and 5 in the first byte are reset when read.
Note • Mask away the undefined bits in your application program to avoid having to change
the application, if future firmware releases starts using them.
•Mask first reply byte with E8.
•Mask second reply byte with BB.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
80
Software Command Syntax
ESC ENQ 7
1B 05 07 Hex
27 5 7 Decimal
ESC ENQ 9
1B 05 09 Hex
27 5 9 Decimal
Firmware-Version Enquiry
Results in a 2-byte response representing the version of the installed firmware.
The first byte represents major versions, and the second byte minor versions.
If no firmware is loaded, the printer will answer with <0><0>.
Example •
Send<ESC><ENQ><7>
Read <3><96>
That is, a response with the value <3><96> indicates version 3.96.
Main Logic Board Serial-Number Enquiry
Results in an 6-byte response representing the serial number of the control board, however the
TTP 2100 series of printers do not have a serial No. chip on the control board so this query
always gives 000000 as the reply.
ESC ENQ 10
1B 05 0A Hex
27 5 10 Decimal
In printers with serial number starting with 93J, the printer serial number is stored and can be
read out with the command <ESC><ENQ>HSN<0>.
Control Board Revision Enquiry
Results in a 1-byte response representing the control board revision. A minus sign indicates
that no revision has been made, while A indicates the first revision, and so on.
Example •
Send<ESC><ENQ><10>
Read n
Where n can be ‘A’ (ASCII) or 41h (hex) or 065 (dec).
P1003640-004TTP 2100™09/18/2014
Programming
Software Command Syntax
81
ESC ENQ 11
1B 05 0B Hex
27 5 11 Decimal
ESC ENQ 12
1B 05 0C Hex
27 5 12 Decimal
Head Temperature Enquiry
Results in a 1-byte response representing the temperature of the printhead.
Example •
Send<ESC><ENQ><11>
Readn
Where n is a value representing the approximate temperature in Celsius.
The answer is a signed byte (two's complement). If bit 7 is 1 then it is a negative value; invert
all bits and add 1 the get the value.
Bootware Version Enquiry
Results in a 2-byte response representing the version of the installed bootware.
The first byte represents major versions, and the second byte minor versions.
Example •
Send<ESC><ENQ><12>
Read<1><30>
That is, a response with the value <1><48> indicates version 1.48.
Note • TTP 2100 does not store the bootware in the printer so this query will always return
<0><0>.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
82
Software Command Syntax
ESC ENQ c
1B 05 63 Hex
27 5 99 Decimal
ESC ENQ E
1B 05 45 Hex
27 5 69 Decimal
Device ID Enquiry
Results in a string containing the device ID in the Windows Plug and Play string format. The
two first bytes represent the string length.
Example •
Send<ESC><ENQ>c
Read<0><106>
This indicates that the string is 104 characters (plus two characters
indicating the string length).
Extended status is status from the printer together with devices connected to the I
bus available in some Zebra printers (the TTP 2100 series does not have any I
Read Extended Status
2
C options-
2
C bus so these
parts of the command can be ignored). The short message protocol gives replies up to 255
bytes. Other protocols may be defined in the future. Protocols are described in separate
documents.
<ESC><ENQ>E results in a variable length reply:
n1Protocol version, 11h = Short Message Protocol
n2Protocol length in bytes
n3-n255Data specified by the protocol
Short Message Status Examples
Example 1 • Out of paper presenter Jam, and shutter open error.
Tag message length (bytes)
Tag ID: Status messages
Protocol Length in bytes
Protocol SM, version 1 (short message)
83
ESC ENQ P n1
1B 05 50 n1
27 5 80 n1
ESC ENQ = ?
1B 05 3D 3FHex
27 5 61 63Decimal
Hex
Decimal
Parameter-Setting Data Enquiry
This command requests information about the setting of parameter n1, that is, the parameter
value stored in EEPROM or any parameter value temporarily set by other ESC commands.
n1= 1Gives the setting of parameter 1, etc. The parameter names are listed under
Summary of Parameter Settings.
n1 = 0Gives a response where the first two bytes specify the length of data to
come, and then follows a block of data for all parameters in the temporary
setup.
Media Loaded into Tray Enquiry
This command enquires the printer if media is loaded or not and if yes, into which input tray.
The result is a 1-byte response representing tray status.
0No media loaded
1Media in wide tray
2Media in narrow tray
The printer has two virtual trays that you only see when the dual media guide 01990-400 is
fitted to the printer. This guide has two trays:
• one wide tray or ticket path for 82.5 mm wide tickets like boarding passes
• one narrow tray or ticket path for 54 mm wide tickets like baggage tags
This command is very useful if you need to send special set up commands to the printer once
you discover which media is being loaded, and when you need to have your application format
the print to fit the loaded media.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
84
Software Command Syntax
ESC ENQ H
1B 05 48 Hex
27 5 72 Decimal
ESC ACK n1
1B 06 n1Hex
27 6 n1Decimal
Read Printer INFO
This command gives extra information about the printer.
Valid types are: SN, PN, MODEL. MOD, AST.
ESC><ENQ>HSN<0> (Serial Number)
<
<
ESC><ENQ>HPN<0> (Part Number)
<
ESC><ENQ>HMODEL<0> (Printer model)
ESC><ENQ>HMOD<0> (Modification level)
<
<
ESC><ENQ>HAST<0> (Asset tag)
Most of the fields are only populated in printers with serial number starting with 93J.
Acknowledge Marker
n1 =One-byte marker. Range <1> to <255>.
The “acknowledge marker” n is placed in the command queue and when the execution of
commands reaches the marker it is sent back to the host computer. This is an addition to the
status commands that pass the queue and are answered immediately when received.
Example •
"Print data" <LF><ESC>p<ESC><ACK><1>
Wait for <1>
<RS><ESC><ACK><2>
Wait for <2>
The printer will send <1> when <print data> has executed and <2> when the ejecting
has been performed.
Note • You must wait for the acknowledge marker to return before sending any more data to
the printer.
Note • Acknowledge marker cannot be used for events that write to the flash PROM, for
instance font loading. This is because the writing procedure erases the buffer, including the
markers, and uses all RAM in the printer.
P1003640-004TTP 2100™09/18/2014
Font Loading
The printer can store 8 fonts in its flash PROM. The memory available for fonts is printed on
the self-test printout. The character size is fixed, so you must load one font file for each
character size you require. The fonts are given font numbers when they are loaded into the
printer. The first font is assigned number 0 and the next font 1 etc. up to font 7. Parameter p14
“Font Selection” will determine what font to use when no font selection command has been
received (see Font Selection).
Programming
Font Loading
85
You cannot erase a single font, but must erase font 4-7 with command <ESC>&D
fonts with <ESC>&C, then reload the fonts you wanted to keep.
In a Windows environment, the Zebra Toolbox utility can be used for font generation and
management and is available for download from
load fonts in a non-Windows environment, use the ESC
The time required for processing the font data that is loaded is typically 15–20 seconds per
font, excluding transfer time. During this time, any data sent to the printer will be lost.
Note • The font processing ends with a reset. The presenter motor runs momentarily to
indicate that the printer is ready to be used.
Caution • Loading to the flash PROM will erase the RAM completely since the RAM is
used during the loading process. Any print data residing in RAM will thus be lost.
File Format
A font consists of a header describing the font, then data for every character in the font. The
header has to be downloaded even if the font consists of a single character only. Below is a
description of the font header.
, or all eight
http://www.zebra.com/support. If you need to
&NUL command.
1 byteReservedShould always be 0 (zero)
1 byteReservedShould always be 0 (zero)
1 byteChar. width (X)The number of bytes required for the width of one character,
usually 2 or 3. Range 1 to 8.
1 byteCharacter pitchThe maximum width of one character in the set. This value is
used for tab position calculation. Range 1 to 255.
1 byteChar. height (Y) The maximum height of one character matrix measured in
pixels. This is also the minimum line spacing for this character
set.
27 byteFont nameString of characters used to identify the character set. This will
be printed on status printouts. (e.g., Swiss 10 cpi.)
Char_matrix table: 256 records, each containing 3 bytes.
Char_bitmap data: Bitmap data for all characters that are to be defined.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
86
Font Loading
Char_sizeY
Baseline
Character Bitmap Data
A character is made up of a bitmap the size of which is:
Char. width (X) * Char. Height (Y) bytes.
Char_width
A
Char_sizeX
Char_Ystart
Char_Yheight
0
4
ROW
COLUMN
0
1
Char_width
A
Char_pitch
2
Char_width
W
Char_pitch
Char_width
g
Char_pitch
Col 0Col 1
MSBLSB MSBLSB
Row 1
=03H=FFH=80H
The bitmap data consists of bitmap patterns for each character in a character set for which the
parameter Char_width in the Char_matrix table is set to a value between 1 and 24. A character
that has its Char_width set to zero, is not included in the bitmap data.
The bitmap for one character is then defined according to the following table:
Example • In this example, each row consists of 3 columns equal to 3 bytes.
In order to minimize the required storage space, only rows between Ystart and Ystart +
Yheight are included in the character bitmap.
Logotypes
Up to 16 logotypes can be stored in the flash PROM of the printer. The logotypes can be
positioned and printed out with commands <ESC>g or <ESC>L.
The exact number of logotypes and their sizes is determined by the total amount of memory
used for fonts, logotypes and loaded firmware. Make a test printout to see how much memory
is available.
Note • Logotype No. 0 is printed in the top of the self test printout, so this can be used to
customize the self test printout.
Loading
Windows software that converts black and white BMP bitmap files to logotypes and loads
them into the printer is available in the Zebra Toolbox utility, which is available to download
from
http://www.zebra.com/support.
Programming
Logotypes
87
If you need to load logotypes in a non-Windows environment, use the ESC & 1 command.
The time required by the printer to process logotype data, excluding transfer time from the PC,
is typically 15 to 20 seconds, per logotype. During this time, any data sent to the printer will be
lost.
File Format
A header containing information about the logotype number, size and logotype name shall
define each loaded logotype. Immediately after the header follows the actual bitmap of the
logotype.
<ESC>&<1><Header><Bitmap>
Header
Byte 0Logotype number used to identify the logotype when printing.
Byte 1X size measured in bytes.
Byte 2Y size measured in pixels.
Byte 3-15A logotype name that will be printed on test printouts.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
88
Logotypes
Bitmap
The bitmap must have exactly (X size * Y size) number of bytes. 1=black, 0=white dot.
Bit No. 7 in byte 0 represents the top left corner of the logotype.
X size
Printing
7
Byte 0
0
Y size
To print a logotype you can use two commands, <ESC>L<n1>, prints the logotype at the
current cursor position, just like any character. <ESC>g<n1>...<n5> prints the logotype at
a specified X-Y position.
n1One byte logotype number, (0-15)
n2n3Two byte X position measured in pixels from the left hand edge of the print
window.
n4n5Two byte Y position in pixels from top of the page. These bytes must
always be inserted but they are ignored in variable-page-length mode where
logotypes are always printed at the current Y-position.
Erasing
All logotypes are erased with the <ESC>&<L> command.
Caution • Loading to the flash PROM will erase the RAM completely since the RAM is
used during the loading process. Any print data residing in RAM will thus be lost.
P1003640-004TTP 2100™09/18/2014
Status Reporting
The printer is equipped with a number of sensors that report the printer status and various
conditions such as out-of-paper, previous printout not removed, etc.
Ticket
sensor
taken/fallen)
(
Figure 30 • Sensor placement in the printer
Ticket load
sensor
Upper media sensor
(IR light source)
Cutter
Programming
Status Reporting
Paper entry
89
Printhead
closed
sensor
Cutter hom e sensor
Lower media sensor
(IR light receiver)
A good practice in unattended printer applications is to check for errors and paper availability
before printing.
1. Send a Status Report Query (<ESC><ENQ><6>) and check that the answer is "No errors"
2. If “Status codes available” is indicated, read out the status message with Status Request
(<ESC><ENQ><1>), and take appropriate actions.
3. Send a paper-near-end query (<ESC><ENQ><2>) to see if the sensor reports low paper
level.
4. If paper-near-end is indicated, report the condition to the systems supervisor to schedule a
service visit to the printer.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Programming
90
Status Reporting
5. Print the printout.
Notes • A status reply must be read! Sending a second status query without reading the reply
of the first query may lock the printer.
When using a multitask OS, status queries and responses may not be transferred immediately
from your application to the printer and vice versa. So write your program in such a way that
it repeats the query if it gets a timeout or an invalid reply. Good practice is to ask once every
ten seconds, five times before giving up.
You should construct your application in such a way so as not to request status while
Some of the printer settings can be stored in an EEPROM so that they will be used also after
power OFF.
The stored parameter settings are printed out on the self-test printout.
The number in front of the function is the parameter number (n) used when setting the
parameter with the command <ESC>&P<n><v>.
You can use the parameter settings like normal commands. Either send the parameter values
with each printout, or set them up once and then send <ESC>&<4> to store all settings in the
EEPROM.
You can always return to factory default settings by sending <ESC>&F, and then storing those
settings with <ESC>&<4>
Note • The parameters can be locked so that no changes are possible. Check parameter 53 on
the self-test printout to find out.
Note • If you try to set a parameter to an invalid value, the parameter will be set to the nearest
valid value below.
.
09/18/2014TTP 2100™ Technical ManualP1003640-004
Default Parameter Settings
92
How the Parameters are Described
How the Parameters are Described
47
Default Value
The default values indicated are “factory default settings” you get by sending <ESC>&F.
These are not necessarily the settings that your printer was originally delivered with because
many printers have customized settings when delivered.
Examples
Command examples are formatted in Courier and typed in the same way as used in the
Zebra Toolbox:
<ESC>&P<1><19>
Parameter number
Default value
40 Default
0 Min
255 Max
Description as printed on self test printout
Windows driver overrides setting
Wall compensation (mm)
Range
DRV indicates that the
DRV
SW 02001
Where <ESC> means the escape character 27 decimal (hex 1B). Numbers between less-than
and greater-than characters, for example <1><15>, means 1 and 15 decimal (hex 1 and F).
Summary of Parameter Settings
ParameterDescriptionESC&F DefaultPage
1
2
3
4
7
8
10
12
13
Baud rate96 (9600 Baud)
Data bits8
Parity0 (No parity)
Flow control2 (Hardware)
Burn time9
Print speed17 (123 mm/s)
Pulse control3 (2 burn pulses)
Font attributes0 (off)
Line spacing0 (Auto)
TTP model
21102130
94X
94X
94X
95X
95XX
95XX
95XX
96XX
96XX
P1003640-004TTP 2100™ Technical Manual09/18/2014
Default Parameter Settings
Summary of Parameter Settings
ParameterDescriptionESC&F DefaultPage
93
TTP model
21102130
14
15 to 30
31
33
34
35
36
37 & 38
39
40
41 & 42
43 & 44
46
47
48
49
51
52
53
56
57
58
59
60
61
62
63
64
65
Font selection0 (ATM9)
Tab stop4, 8, 12 etc.
Presenter speed150
CR/LF0 (LF = CR/LF, CR=Ignored)
Auto cut after FF1 (Off)
Black mark sync1 (On)
Document mode1 (Variable)
Page length, Minimum /
2, 88 (75 mm)
fixed / BM
Max black mark length80 (10 mm)
Min black mark length24 (3 mm)
Black Mark cut offset0, 0 (0 mm)
Black Mark top margin0, 0 (Disabled)
Cut position calibration0 (no adjustment)
Wall compensation0
Print width0 (Auto)
Advance before cut0 (Off)
Black mark level75
Warning level0 (Off)
Lock parameters0 (Unlocked)
Max status code255 (Show all)
System247 (Gap sensor)
Out of paper level0
Vendor class mode0 (Disabled)
Partial cut length10
TOF Sensor Mode2 (Gap sensor)
TOF Sensor Mask11 (Masks away sensor BM 3)
BM Sensor0 (Auto select between sensors 1, 2, 3,
and 4)
Bit Operations1 (move back to home position)
Sensor selectedInformation only field
96XX
96XX
97XX
97XX
97XX
98XX
98XX
99XX
93XX
93XX
93XX
101XX
102XX
102XX
103XX
103XX
93XX
104XX
104XX
104XX
105XX
105XX
106XX
106XX
107
XX
107XX
107XX
108XX
108XX
09/18/2014TTP 2100™ Technical ManualP1003640-004
Default Parameter Settings
94
Serial Interface Set-up
Note • When the printer is set up the way you like it to be, you send <ESC>&4h, and all
settings will be stored.
Serial Interface Set-up
96Default
11Min
1
96Max
Stores the communication speed on the serial interface.
<ESC>&P<1><24>2400 bps
<ESC>&P<1><48>4800 bps
<ESC>&P<1><96>9600 bps
<ESC>&P<1><19>19200 bps
<ESC>&P<1><38>38400 bps
Baud Rate
2
3
8Default
7Min
8Max
0 Default
0 Min
2 Max
<ESC>&P<1><57>57600 bps
<ESC>&P<1><11>115200 bps
Note • If you set an invalid value, the baud rate will return to the previous value.
Data Bits
Selects if 7-bit ASCII, or 8-bit, is used on the serial interface.
<ESC>&P<2><8>8-bits (characters 0-255)
<ESC>&P<2><7>7-bits (characters 0-127)
Note • In 7-bit mode you cannot print graphic, read status or set parameters because no value
can ever be greater than 127.
Parity
Select what parity to use on the serial interface.
<ESC>&P<3><0>No parity
<ESC>&P<3><1>Odd parity
<ESC>&P<3><2>Even parity
P1003640-004TTP 2100™ Technical Manual09/18/2014
2 Default
0 Min
4
2 Max
Select the handshaking method to use on the serial interface.
<ESC>&P<4><0>No flow control
<ESC>&P<4><1>Xon / Xoff
<ESC>&P<4><2>Hardware
Print Setup
9 Default
1 Min
7
15 Max
A long burn time gives darker print. On insensitive paper types you may have to increase the
burn time to get an acceptable print quality.
Flow-control
Burn Time
Default Parameter Settings
Print Setup
DRV
95
8
10
17 Default
1 Min
17 Max
3 Default
1 Min
7 Max
Max Print Speed
DRV
The main reason to decrease the print speed is to enhance print quality, and to reduce average
current consumption.
Note • Low speed settings may result in printer chassis resonance causing increased noise and
deteriorated print quality.
Printhead Pulse Control
Controls how the printhead burns the pixels. Four burn pulses give a more even blackness
over the width of the paper and a lower peak current consumption. Two burn pulses give faster
printouts at high burn times. At normal burn times the speed is the same for both settings.;
<ESC>&P<10><3>2 burn pulses
<ESC>&P<10><7>4 burn pulses
Caution • Values 3 and 7 are the only allowed settings. Do not set anything else!
09/18/2014TTP 2100™ Technical ManualP1003640-004
Default Parameter Settings
96
Print Setup
0 Default
12
13
0 Min
255 Max
0 Default
0 Min
30 Max
Font Attributes
Selects which font attributes are selected at power ON or after reset. Font attributes bold,
height and width are stored in this parameter.
bits 0-3 Height Multiplier
bits 4-6 Width Multiplier
bit 7 Bold enable
Line Spacing
The line spacing is normally set by the font height. With this parameter you can set a line
spacing that is higher that the font height. Line spacing settings lower than the font height will
be ignored.
14
15 to 30
0 Default
0 Min
7 Max
- Default
1 Min
255 Max
<ESC>&P<13><30>30 pixels or font height, whichever is the largest
Font Selection
Store which font number is used if no font is specified. Font is selected using the “Select Font”
command <ESC>!<n>. Selecting an invalid font gives a software error status message
(invalid index).
Tab Stop
Stores 16 different TAB stop positions. The position is set in increments of 2.5-mm.
Tab position 255 sets a tab stop on the last position of the line. Use this if you want underline
or reversed text to extend across the full paper width.
To set all tab stops at once, follow the procedure Set Several Parameters at Once.
To move a single tab stop, use the set parameter command <ESC>&P. For example:
Example • This example sets the first tab stop 25 mm from the left margin.
<ESC>&P<15><10>
Default positions are one TAB on each cm; that is parameter values 4, 8, 12 etc.
P1003640-004TTP 2100™ Technical Manual09/18/2014
31
33
150 Default
0 Min
150 Max
0 Default
0 Min
4 Max
Default Parameter Settings
Print Setup
Presenter Speed
Sets the speed at which the paper is presented/ejected. 1 = 10 steps/s, therefore the default
setting of 150 means 1500 steps/s. Do not exceed the default setting, as this may cause the
motor to stall. To print in cold weather conditions, it may be necessary to reduce the speed. In
addition, parameter 8 may need to be adjusted for temperature.
<ESC>&P<31><150>Sets speed at default setting of 150
(1500 steps/s)
CR/LF Behavior
Carriage Return and Line Feed can be interpreted in five different ways to suit different
operating systems.
<ESC>&P<33><0>LF = CR/LFCR = Ignored
97
34
1 Default
0 Min
1 Max
<ESC>&P<33><1>LF = CR/LFCR = CR
<ESC>&P<33><2>LF = LFCR = CR
<ESC>&P<33><3>LF = LFCR = CR/LF
<ESC>&P<33><4>LF = IgnoredCR = CR/LF
Note • The character currently interpreted as LF converts text from the input buffer to pixels
on the paper. If no such character has been received after 379 characters, a linefeed is inserted
automatically.
Auto Cut After FF
Decides if the printer should cut after executing an FF command, or if it should just feed the
form length.
<ESC>&P<34><0>No cut
<ESC>&P<34><1>Cut
09/18/2014TTP 2100™ Technical ManualP1003640-004
Default Parameter Settings
98
Print Setup
1 Default
35
0 Min
1 Max
Black Mark Sync
Determines what should control the page length:
<ESC>&P<35><0>No synchronization
<ESC>&P<35><1>Cuts will be synchronized with black marks /
gaps.
This parameter also determines the function of auto sensor calibration:
• If black mark / gap sync is enabled, the auto calibration will set n37 - n40, n51, n57 bit 3,
n58, n61, and n62.
• If set to zero, only the BM level n51, and out of paper level n58 will be set.
Note • Use parameter n61 to select if gaps or black marks should be detected. The default
behavior is to detect gaps.
DRV
36
1 Default
0 Min
1 Max
Document Mode
DRV
Determines what should control the page length:
<ESC>&P<36><0>Fixed Document Mode. Shorter documents will automatically be
extended, while longer documents will be divided into several
pages of the desired length. Page length will be the length set by
parameters 37 and 38.
<ESC>&P<36><1>Variable Document Mode. The length of the page varies with the
contents (printouts shorter than the value specified by parameters
37 and 38 will be extended to that length).
<ESC>&P<36><3>Single Page Mode. The printout is limited to a single page and
will stop printing when a delimiter (e.g., black mark, gaps, and
punched holes, etc.) is reached. It will not print or feed any more
until a cut command is received.
Note • Max page length in Fixed Document Mode is determined by free RAM (printed on
self test printout) and print width setting parameter n48. For example, if print width is 50 mm
and free RAM is 180267 bytes, max page length is 180267/(50x8)=450 mm.
P1003640-004TTP 2100™ Technical Manual09/18/2014
37&38
2, 88Default
0, 0Min
255, 255 Max
Default Parameter Settings
Print Setup
Page Length
DRV
Defines three different things:
1. The minimum length of a page in variable document mode
2. The actual page length in fixed document mode
3. The distance between black marks in black mark mode
Note • If auto calibration has been used, it is not necessary to make any changes to this
parameter.
One step is 0.125 mm. Settings shorter than 37 mm will be extended to 37 mm when printing.
<ESC>&P<37><2><ESC>&P<38><88>Set page length to 75 mm.
Figure 31 • Definition of Page Size
99
Length
p37p38
40 mm<1><64>
75 mm<2><88>
85.6 mm<2><173>
156 mm<4><224>
203 mm<6><90>
16”<12><180>
19”<15><21>
21”<16><171>
Top m a r g in
(Distance between cut and print line, 9 mm)
Page length
(minimum 40 mm)
Page width =
applicable print
window width
TE X T
Te x t t e x t
Paper transport
direction
TE X T
Te x t t e x t
SW97063-R5
09/18/2014TTP 2100™ Technical ManualP1003640-004
100
Default Parameter Settings
Print Setup
Fixed Document Mode
In fixed document mode, the printable length depends on the amount of free RAM and the print
width setting. Make a self-test printout to check how much is available in your printer
(depends on firmware version).
lengthPrintable
bytesinRAMFree
Print width setting (n48) × 8
To get the paper length, you must add the top and bottom margins in mm to the printable
length. Paper width is in bytes or mm (1 byte = 1 mm).
Example • Free RAM on a TTP 2100 is 114627 bytes, print width is 80 mm = 80 bytes, top
margin is 20 mm, and bottom margin 10 mm.
114627
lengthPage+ 20 + 10 = 209 mm
If a too large fixed page is specified the printout will be blank from memory full to the cut.
Note • If the length is too short one can stack fixed documents print lengths one after another
with a print command between and make printouts of any size. Each of these stacked squares
can have different lengths, and build a 21” bag tag for example, with all its individual
elements in the right places.
×
80
Printable
length
8
Top
margin
Bottom
margin
CUT ˧
CUT ˧
X˧
Portrait
Y˨
direction
X˧
Y˨
First print area
Y˨
X˧
Upside down landscape
X˧
Portrait
Y˨
X˧
Y˨
Second
print area
without cut
between
Y˨
X˧
Upside down landscape
Feed
Landscape
<ESC>&P<36><000><* Document Mode: Fixed>
X˧
Y˨
<ESC>&P<37><002><* Printout length fist area (High Byte)>
<ESC>&P<38><048><* Printout length fist area (Low Byte)><ESC>o<0>Portrait<LF>
<ESC>o<1>Landscape<LF>
<ESC>o<2>Upside down Portrait<LF>
<ESC>o<3>Upside down Landscape<LF>
Upside down portrait
<ESC>p
Landscape
<ESC>&P<37><001><* Printout length second area (High Byte)>
X˧
Y˨
<ESC>&P<38><224><* Printout length second area (Low Byte)>
<ESC>o<0>Portrait<LF>
<ESC>o<1>Landscape<LF>
<ESC>o<2>Upside down Portrait<LF>
<ESC>o<3>Upside down Landscape<LF>
Upside down portrait
<RS>
P1003640-004TTP 2100™ Technical Manual09/18/2014
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.