E-Class Mark III Basic and Advanced (Serial# 4xxxxxxx or greater)
E-Class Mark III Pro/Pro+
I-Class Mark II
RL3 & RL4
Page 2
CG Times (based upon Times New Roman), CG Triumvirate, MicroType, and TrueType are
trademarks of the AGFA Monotype Corporation.
PCL, Intellifont, and HP Laser JetII are trademarks of the Hewlett Packard Corporation.
Macintosh is a trademark of the Apple Corporation.
Windows is a trademark of the Microsoft Corporation.
All other brand and product names are trademarks, service marks, registered trademarks,
or registered service marks of their respective companies.
Information in this manual is subject to change without notice and does not represent a
commitment on the part of Datamax-O’Neil Corporation. No part of this manual may be
reproduced or transmitted in any form or by any means, for any purpose other than the
purchaser’s personal use, without the expressed written permission of Datamax-O’Neil
Corporation.
This manual is intended for programmers who wish to create their own label production
software.
This manual, arranged alphabetically by command, explains Datamax-O’Neil Programming
Language (DPL) and its related uses in the writing, loading and storing of programs for the
control and production of label formats (designs) for the following printers at, or above, the
listed firmware version below:
Model distinctions, including configurations and equipment types be indicated in this text to
differentiate command compatibility. The appendices of this manual also contain details that
cannot be ignored; the use of any command will require checking for possible exclusionary
conditions.
Who Should Use this Manual
The Scope of this Manual
Printer Firmware Version
E-Class Mark III Basic and Advanced Models
E-Class MARK III Pro/Pro+ All
I-Class Mark II All
RL3 & RL4 All
Serial# 4xxxxxxx or greater or Firmware
Version 9.04_0001 or greater
See the <STX>KC command for information regarding attainment of the printer’s firmware
•
version; and then, if necessary, upgrade that firmware. Upgrades are available at
http://www.datamax-oneil.com.
• Programming information for older Class Series printers Class Series II Programmer’s
Manual (part number 88-2341-01). All manuals can be downloaded from our web site at
http://www.datamax-oneil.com.
• References to “Menu Settings” refer either to the set-up menu or to the system menu of
the printer; consult to the appropriate Operator’s Manual for details.
• Where applicable, printer responses to a host device will depend upon the communication
port, port settings, and cabling.
1
Page 10
Overview
General Conventions
These are some of the conventions followed in this manual:
On the header of each page, the name of the section.
On the footer of each page, the page number and the title of the manual.
Names of other manuals referenced are in Italics.
Notes are added to bring your attention to important considerations, tips or helpful
suggestions.
Boldface is also used to bring your attention to important information.
This manual refers to IBM-PC based keyboard command characters for access to the
ASCII character set. Systems based on different formats (e.g., Apple’s Macintosh )
should use the appropriate keyboard command to access the desired ASCII
character. See Appendix A for the ASCII character set.
Computer Entry and Display Conventions
Command syntax and samples are formatted as follows:
The Courier font in boldface indicates the DPL command syntax, and Italics are
used to indicate the command syntax parameters.
Regular Courier font indicates sample commands, files and printer responses.
Square brackets ([ ]) indicate that the item is optional.
<CR>is used to identify the line termination character. Other strings placed
between < > in this manual represent the character of the same ASCII name, and
are single-byte hexadecimal values (e.g., <STX>, <CR>, and <0x0D> equal 02, 0D,
and 0D, respectively).
Hexadecimal values are often displayed in “C” programming language conventions
(e.g., 0x02 = 02 hex, 0x41 = 41 hex, etc.)
Important Safety Instructions
The exclamation point within an equilateral triangle is intended to alert the
user to the presence of important operating and maintenance instructions.
Special Instructions
The green check box is intended to alert the user to conventions used within this
text or to notable operating details of the printer.
2
Page 11
Overview
Typical Data Flow Sequence
The typical data flow sequence is summarized in the following bullets and detailed in the
table below. Printer Commands data is transmitted to the printer as shown in the table from
left to right, top to bottom.
Status commands
Configuration commands
Download commands
Label format
Status commands
Label reprint commands
Memory cleanup
Typical commands used in the various stages shown above are listed in the tables that
follow.
Status Commands
Commands are available for retrieving stored label formats, updating data, and adding
new data. These techniques are used for increasing throughput; see <STX>G, Label Recall
Command “r”, and Label Save Command “s”.
<STX>U01new data for field 01
<STX>E0005
<STX>G
<STX>xImagename<CR>
<STX>zA
“Status” commands: Get
Status, Request Memory
Module Storage
Information…
“Configuration”
commands, download
image…
“Download” commands,
image, fonts…
Begin label
Label Header record
Label Formatting Data
record –
Object type, orientation,
position, data
Label Quantity
Label Terminate record
Status command
Reprint with New Data
Records
Memory cleanup
Optional,
bidirectional
communication
required for these
commands.
See <STX>Kc to
reduce configuration
commands
transferred
RAM (temporary) or
Flash (semipermanent)
memory.
Existing label
formats may be
recalled. Label
header records are
not required.
Optional,
bidirectional
communication
required for these
commands.
Used for fast
reprints.
Typically used for
temporary storage.
3
Page 12
Overview
Configuration Commands
The following table lists some commands useful in controlling printer configuration.
These commands are generally effective only for the current power-up session; toggling
power restores the default configuration. See <STX>Kc for changes to the default powerup configuration. Changing the default power-up configuration and saving objects in
printer Flash memory can reduce the data transmitted for each label and therefore
improve throughput.
Configuration
Command
<STX>A
<STX>c
<STX>e
<STX>Kf
<STX>Kc
<STX>F
<STX>M
<STX>m
<STX>n
<STX>S
<STX>V
Download Commands
Download
Command
<STX>I
<STX>i
<ESC>
Set Date and Time Sets Date and Time.
Set Continuous Paper Length
Set Edge Sensor
Set Present Distance
Configuration Set
Send Form Feed
Set Maximum Label Length
Set to Metric Mode
Set to Inch Mode
Set Feed Rate Sets blank label movement speed.
Software Switch
Download Image
Download Scalable Font
Download Bitmapped Font
Name Function
Must be 0000 for gap media; not used
for reflective media.
Sets sensing for gap or registration hole
type stock.
Determines label stop position, head
relative. <STX>f edge sensor relative
equivalent command, older models.
Determines default power-up
configuration.
Sets the stop position of the printed
label.
Length to search for next gap or
reflective mark; not used with
continuous media.
Subsequent measurements interpreted
in metric (most units, mm/10). Label
equivalent command can be used.
Subsequent measurements interpreted
in inches (most units in/100) label
equivalent command can be used.
Enables optional hardware, cutter, and
present sensor.
Name Function
Downloads Image to selected memory
module.
Downloads Scalable Font to selected
memory module.
Downloads Bitmapped Font to selected
memory module.
4
Page 13
Overview
Label Header Commands
These commands determine how the label formatting occurs, the print quality and
quantity. They are typically issued immediately following the <STX>L start of the label
format. The Format Attribute (A) and the Offset (C, R) commands can be changed at
any point between format records to achieve desired effects.
Label Header Command Name
A
C
D
H
M
P
P
Q
R
S
Set Format Attribute
Column Offset
Set Width and Dot Size
Set Heat Setting
Set Mirror Mode
Set Print Speed
Set Backup Speed
Set Quantity
Set Row Offset
Set Feed Speed
5
Page 14
Overview
6
Page 15
Control Code Command Functions
2 Control Code Command Functions
Introduction
The printer requires a special “attention-getter” character in order to receive a command
sequence, informing the printer that it is about to receive a command and the type of
command it will be. Control Commands, System-Level Commands, and Font Loading
Commands have their own unique attention-getter, followed by a command character that
directs printer action.
Attention-Getters
The attention-getters (e.g., “SOH”) are standard ASCII control labels that represent a one
character control code (i.e., ^A or Ctrl A). Appendix A contains the entire ASCII Control
Code Chart.
Attention-Getter ASCII Character Decimal Value HEX Value
Immediate Commands
System-Level Commands
Font Loading Commands
SOH 1 01
STX 2 02
ESC 27 1B
Easy Control Codes
DPL has been enhanced to accept a 3-character SOH and STX sequence. Easy Control Codes
are always enabled, whether in Standard, Alternate, Alternate 2, or Custom Control Code
Mode. Two types of sequences have been created to meet any application’s requirements.
Use these sequences where you normally would use a single SOH or STX character.
These sequences will not function when the printer input mode is selected to “auto”.
Control Character
SOH %01^01
STX %02^02
3 “%” Character
Sequence
3 “^”Character
Sequence
Command Type
Control
System
7
Page 16
Control Code Command Functions
Alternate Control Code Modes
For systems unable to transmit certain control codes, Alternate Control Code Modes are
available. Configuring the printer to operate in an Alternate Control Code Mode (selected via
the Setup Menu, the <STX>Kc command or, where applicable, the <STX>KD command)
requires the substitution of Standard Control Characters with Alternate Control Characters in
what is otherwise a normal data stream.
Control
Character
Standard Alternate Alternate 2 Custom
SOH 0x01 0x5E 0x5E
STX 0x02 0x7E 0x7E
CR 0x0D 0x0D 0x7C
ESC 0x1B 0x1B 0x1B
“Count By”
[1]
See Label Formatting Commands, ^ set count by amount.
[1]
0x5E 0x40 0x40
Throughout this manual <SOH>, <STX>, <CR>, <ESC>, and ^ will be used to indicate control
codes. The actual values will depend on whether standard or alternate control codes are
enabled for the particular application.
User Defined
Command
Type
Control
System
Line Termination
Font Loading
Label Formatting
Alternate Line Terminator Example: Alternate Control Codes provide for substitution of
the line terminator, as well as the control characters listed above. For example using
Alternate 2, the line terminator <CR> (0x0D) is replaced by | (0x7C). The following is a
sample label format data stream for a printer configured for Alternate-2 Control Codes:
~L|1911A10001000101234560|X|~UT01ABCDE|~G|
8
Page 17
Immediate Command Functions
<
<
3 Immediate Command Functions
Introduction
When the printer receives an Immediate Command, its current operation will be
momentarily interrupted to respond to the command. Immediate Commands may be issued
before or after System-Level commands; however, they may not be issued among Label
Formatting Commands or during font or image downloading. Immediate Commands consist
of:
1. Attention-Getter, 0x01 or 0x5E; see Control Code Command Functions.
2. Command Character
SOH # Reset
This command resets the printer. Resetting the printer returns all settings to default and
clears both the communications and printing buffers. The command also clears DRAM
memory.
Syntax:
Printer Response: The printer will reset.
SOH * Reset
This command forces a soft reset of the microprocessor. The printer is initialized to the
same state as a power cycle.
Syntax:
Printer Response: The printer will reset.
SOH>#
<XON> T
SOH>*
<XON> R
(The T may come before the<XON>)
(The R may come before the<XON>)
9
Page 18
Immediate Command Functions
<
<
SOH A Send ASCII Status String
This command allows the host computer to check the current printer status. The printer
returns a string of eight characters, followed by a carriage return. Each character (see
below) indicates an associated condition, either true (Y) or false (N). Byte 1 is
transmitted first. See <SOH>F.
Syntax:
Sample:
Printer Response:
Where:
SOH a Send ASCII Extended Status String
This command allows the host computer to check an extended current printer status.
The printer returns a string of seventeen characters, followed by a carriage return. Most
characters (see below) indicate an associated condition, either true (Y) or false (N). Byte
1 is transmitted first. See <SOH>F.
Syntax:
Sample:
Printer Response:
The printer response size may grow as new requirements are defined. The response will
always be backward compatible and terminated with a <CR>. The user should not
assume a fixed length response.
SOH>A
<SOH>A
abcdefgh<CR>
Possible
Values
-
a
b
c
d
e
f
g
h
Y/N Y = Interpreter busy (imaging) 1
-
Y/N Y = Paper out or fault 2
-
Y/N Y = Ribbon out or fault 3
-
Y/N Y = Printing batch 4
-
Y/N Y = Busy printing 5
-
Y/N Y = Printer paused 6
-
Y/N Y = Label presented 7
-
Y/N Y = (Internal) Rewinder out or fault 8
Interpretation
SOH>a
<SOH>a
abcdefgh:ijklmnop:qrstuvwx<CR>
Transmit
Sequence
10
Page 19
Immediate Command Functions
<
Where:
SOH B Toggle Pause
This command toggles the printer’s paused state between “On” and “Off.” (This is the
same function achieved by pressing the PAUSE Key.)
Syntax:
Sample:
Printer Response: This command will illuminate the Paused/Stop Indicator and/or
Possible
Values
a
b
c
d
e
f
g
h
i
j
k
l
m
n
o
p
q
r
s
t
u
v
w
x
Interpretation
-
Y/N Y = Interpreter busy (imaging) 1
-
Y/N Y = Paper out or fault 2
-
Y/N Y = Ribbon out or fault 3
-
Y/N Y = Printing batch 4
-
Y/N Y = Busy printing 5
-
Y/N Y = Printer paused 6
-
Y/N Y = Label presented 7
-
Y/N Y = Rewinder out or fault 8
-
: : = Always : 9
-
Y/N Y = Cutter Fault 10
-
Y/N Y = Paper Out 11
-
Y/N Y = Ribbon Saver Fault 12
-
Y/N Y = Print Head Up 13
-
Y/N Y = Top of Form Fault 14
-
Y/N Y = Ribbon Low 15
-
Y/N Y = N (reserved for future) 16
-
Y/N Y = N (reserved for future) 17
-
: : = Always : 18
-
Y/N Y = Ready (no data or signal) 19
-
Y/N Y = Waitng for Signal 20
-
Y/N Y = Waitng for Data 21
-
Y/N Y = Com1 has data not parsed 22
-
Y/N Y = N (reserved for future) 23
-
Y/N Y = N (reserved for future) 24
-
Y/N Y = N (reserved for future) 25
-
Y/N Y = N (reserved for future) 26
<CR> 27
SOH>B
<SOH>B
indicate PAUSED on the LCD or graphics display panel, suspend
printing, and wait until one of the following occurs:
• The <SOH>B command is sent to the printer.
• The PAUSE Key is pressed.
Upon which the printer will turn the Paused/Stop Indicator “Off”
and/or remove PAUSED from the LCD or graphics display, then
resume operation from the point of interruption. (If the Receive
Buffer is not full, an <XON> character will be transmitted from
the printer.)
Transmit
Sequence
11
Page 20
Immediate Command Functions
<
<
SOH C Stop/Cancel
This command performs the same function as pressing the STOP/CANCEL Key (i.e., it
clears the current format from the print buffer, pauses the printer, and illuminates the
Paused/Stop Indicator). (The pause condition is terminated as described under <SOH>B.)
Syntax:
Sample:
Printer Response: The print buffer is cleared and the Paused/Stop Indicator is
SOH D SOH Shutdown
This command is ignored by the printer.
SOH E Send Batch Remaining Quantity
This command causes the printer to return a four-digit number indicating the quantity of
labels that remain to be printed in the current batch, followed by a carriage return.
Communications latency may cause this value to be higher than actual on some printers.
Syntax:
Printer response:
Where:
SOH>C
<SOH>C
illuminated (and/or PAUSED is displayed on the LCD or graphics
display) as operations are suspended, until one of the following
occurs:
• The <SOH>B command is sent to the printer; or
• The PAUSE Key is pressed.
Upon which the printer will turn the Paused/Stop Indicator
“Off” and/or remove PAUSED from the LCD or graphics
display. (If the Receive Buffer is not full, an <XON> character
will be transmitted from the printer.)
SOH>E
nnnn<CR>
nnnn -
Are four decimal digits, 0-9999.
12
Page 21
Immediate Command Functions
<
<
“
SOH e Send Batch Printed Quantity
This command causes the printer to return a four-digit number indicating the quantity of
labels that have been printed in the current batch, followed by a carriage return.
Communications latency may cause this value to be lower than actual on some printers.
Syntax:
Printer response:
Where:
SOH F Send Status Byte
This command instructs the printer to send a single status byte where each bit (1 or 0)
represents one of the printer’s status flags, followed by a carriage return (see below). If
an option is unavailable for the printer, the single bit will always be zero. See <SOH>A.
Syntax:
Response format:
Where:
SOH>e
nnnn<CR>
nnnn -
Are four decimal digits, 0-9999.
SOH>F
X<CR>
X” is 0 through 0xef with bits as indicated in the “Condition”
column below:
Bit* Value Condition
8 1 or 0 (Internal) Rewinder out or fault
7 1 or 0 Label presented
6 1 or 0 Printer paused
5 1 or 0 Busy printing
4 1 or 0 Printing batch
3 1 or 0 Ribbon out or Fault
2 1 or 0 Paper out or Fault
1 1 or 0 Command interpreter busy (imaging)
*
One is the least significant bit.
13
Page 22
Immediate Command Functions
14
Page 23
System-Level Command Functions
<
j
4 System-Level Command Functions
Introduction
The most commonly used commands are the System-Level Commands. These are used to
load and store graphics information, in addition to printer control. System-Level Commands
are used to override default parameter values (fixed and selectable) and may be used
before or after Immediate Commands but cannot be issued among Label Formatting
Commands. System-Level Commands consist of:
1. Attention-Getter, 0x02 or 0x7E; see Control Code Command Functions.
2. Command Character
3. Parameters (if any).
STX A Set Time and Date
This command sets the time and date. The initial setting of the date will be stored in the
printer’s internal inch counter. This date can be verified by printing a Configuration
Label.
Syntax:
Where:
Sample:
Printed response:
•
• Printers without the Real Time Clock option lose the set time/date when power is
• Response format is variable; see the Special Label Formatting Command <STX>T.
When set to 000, the Julian date is automatically calculated; otherwise, the Julian
date will print as entered, without daily increments. If factory defaults are restored
the actual Julian date will also be restored.
removed.
STX>AwmmddyyyyhhMMjj
w
mm
dd
yyyy
hh
MM
jjj
1 digit for day of week; 1 = Monday; 7 = Sunday
2 digits for month
2 digits for day
4 digits for year
2 digits for hour in 24 hour format
2 digits for minutes
3 digits for Julian date / constant; see notes below.
<STX>A1020319960855034
Mon. Feb 3, 1996, 8:55AM, 034
15
Page 24
System-Level Command Functions
<
<
STX a Enable Feedback Characters
This command enables the feedback ASCII hex characters to be returned from the
printer following specific events after each completed batch of labels when using serial
communications. The default value is ”OFF”.
Syntax:
Printer response: Event dependent. (Also see Appendix D for error codes.)
Where:
STX B Get Printer Time and Date Information
This command instructs the printer to retrieve its internal time and date information.
Syntax:
Sample:
Response format:
Where:
Response sample:
STX>a
Event Return Characters
Invalid character
Label printed
End of batch
STX>B
<STX>B
wmmddyyyyhhMMjjj<CR>
w
mm
dd
yyyy
hh
MM
jjj
* See <STX>A for details and restrictions.
1 digit for day of week; 1 = Monday
2 digits for month
2 digits for day
4 digits for year
2 digits for hour in 24 hour format
2 digits for minutes
3 digits for Julian date / constant*
1020319960855034<CR>
0x07 ( BEL )
0x1E ( RS )
0x1F ( US )
16
Page 25
System-Level Command Functions
<
<
>
STX c Set Continuous Paper Length
This command sets the label size for applications using continuous media. It disables the
top-of-form function performed by the Media Sensor. The sensor, however, continues to
monitor paper-out conditions. See <STX>M.
Syntax:
Where:
Sample:
This command must be reset to zero for edge or reflective sensing operation.
STX E Set Quantity for Stored Label
This command sets the number of labels for printing using the format currently in the
print buffer. (The printer automatically stores the most recent format received in the
buffer until the printer is reset or power is removed.) When used in conjunction with the
<STX>G command, this will print the format.
Syntax:
Where:
Sample:
Printer response: 25 labels of the current format in memory will be printed.
If no <CR> terminates the command, a four-digit quantity (nnnn) can be entered; and,
specifying 9999 will cause continuous printing.
STX>cnnnn
nnnn -
<STX>c0100
Specifies the length of the media feed for each label
format, in inches/100 or millimeters/10 (see <STX>m).
The sample above sets a label length of 100, which equals 1.00
inch (assuming Imperial Mode is selected).
STX>Ennnnn<CR
nnnnn -
<CR> -
<STX>E00025<CR>
<STX>G
A five-digit quantity, including leading zeros.
0x0d terminates the name.
17
Page 26
System-Level Command Functions
<
<
<
STX e Select Edge Sensor
This command enables transmissive (see-through) sensing for top-of-form detection of
die-cut and holed (notched) media. This sensor will detect a minimum gap of 0.1 inches
(2.5 mm) between labels (see the Operator’s Manual for media requirements). This is
the default setting.
Syntax:
This command is ignored when <STX>cnnnn is issued with a non-zero value for nnnn.
STX F Form Feed
This commands the printer to form feed to the next start of print.
Syntax:
Printer response: The printer will form feed.
STX f Set Form Stop Position (Backfeed Command)
This sets the stop position of the printed label, allowing the label to stop at a point past
the start-of-print position. When the next label format is sent, the printer motor
reverses direction to retract the media to the start-of-print position. If quantities of more
than one label are requested, the printer will operate without backfeeding. Backfeed will
then only occur when printing has stopped for a few seconds.
D-O recommend not using the <stx>Kf command instead of this command. This is a
legacy command.
Syntax:
Where:
Sample:
STX>e
STX>F
STX>fnnn
nnn -
Is a three-digit distance from the Media Sensor, in
inches/100 or mm/10. This distance is independent of
the start-of-print position (<STX>O), yet it must be
greater than the start-of-print position to take effect.
<STX>f230
The sample above sets a stop position distance of 230 (2.3 inches
from the Media Sensor’s eye).
18
Page 27
System-Level Command Functions
<
<
>
d
STX G Print Last Label Format
This command prints a previously formatted label and restarts a canceled batch job
following the last processed label. This is used when there is a label format in the buffer.
The <STX>E command is used to enter the quantity. (Without the <STX>E command, one
label will print.)
Syntax:
STX>G
STX I Input Image Data
This command must precede image downloading from the host to the printer. The data
that immediately follows the command string will be image data.
The native format for storing downloaded PCX and BMP images is RLE-2, which results
in a better compression ratio for less module space usage when downloading gray-scale
Syntax:
Where:
Sample:
images and images with large black or white areas.
STX>Iabfnn…n<CR
ata
a -
b -
f -
nn…n -
<CR> -
data -
<SOH>D
<STX>IDpTest <CR>
data...data <CR>
The sample above instructs the printer to (1) receive an 8-bit PCX
image sent by the host in an 8-bit data format, (2) name the
image “Test”, and (3) store it in Module D (with a .dim file
extension).
Memory Module Bank Select (see Appendix K).
Data Type (optional), A or omit:
b Value: Image Data Value Range:
A ASCII Characters 0-9, A-F, (7 bit)
omit 00-FF, (8 bit)
Format Designator:
f Designator:Format Type:
F
B
b
I
i
P
p
Up to 16 characters used as an image name.
0x0d terminates the name.
Image data
7-bit D-O image load file
.BMP 8-bit format, flipped, black
and white (B&W)
.BMP 8-bit format, B&W
.IMG 8-bit format, flipped, B&W
.IMG 8-bit format, B&W
.PCX 8-bit format, flipped, B&W
.PCX 8-bit format, B&W
19
Page 28
System-Level Command Functions
<
e
<CR>
x
…
<
STX i Scalable Font Downloading
The command structure for downloading TrueType (.TTF) scalable fonts (files may be
single-byte or double-byte character systems) is as follows:
Syntax:
STX>imtnnNam
Where:
Sample:
m -
The designator of the module where the font is to be
saved; see Appendix K.
t -
Type of scalable font being downloaded:
T = TrueType
nn -
Two-digit font reference ID. Valid range is 03-99,
9A-9Z, 9a-9z (base 62 numbers).
Name -
The title, up to 15 characters, for this font.
<CR> -
0x0d terminates the Name.
xx…x -
Eight-digit size of the font data, number of bytes,
hexadecimal, padded with leading zeros.
data -
The scalable font data.
<STX>iDT52Tree Frog<CR>000087C2data...
The sample above downloads a TrueType font to Module D, and
assigns it the Font ID of 52 with the name “Tree Frog” and file
extension .dtt. The size of the font data is 0x87C2 bytes long.
STX J Set Pause for Each Label
This command causes the printer to pause after printing each label. It is intended for
use with the peel mechanism or tear bar when the Present Sensor option is not installed.
After removing the printed label, the PAUSE Key must be pushed in order to print the
next label. (The printer must be reset to clear the <STX>J command.)
Syntax:
STX>J
STX K Extended System-Level Commands
This is an expansion of the System-Level Command structure; see Extended SystemLevel Commands for more information.
x…xdata
20
Page 29
System-Level Command Functions
<
<
<
<
STX k Test Communication Port
This command instructs the printer to transmit the Y character from the printer’s port
that received this command. (Failure to receive Y could indicate an interfacing problem.)
Syntax:
Printer response:
STX L Enter Label Formatting Command Mode
This command switches the printer to the Label Formatting Command Mode, where the
printer expects to receive only Record Structures and Label Formatting Commands.
Immediate, System-Level, and Font Loading commands will be ignored until the label
formatting mode is terminated with E, s, or X, (see Label Formatting Commands for
additional information).
Syntax:
STX M Set Maximum Label Length
This command instructs the printer move media this distance in search of the top-ofform (label edge, notch, black mark, etc.) before declaring a paper fault. A paper fault
condition can occur if this setting is too close (within 0.1 inch [2.54 mm]) to the physical
length of the label. Therefore, it is a good practice to set this command to 2.5 to 3 times
the actual label length used. The minimum value should be at least 5” (127 mm).
Syntax:
Where:
Sample:
STX m Set Printer to Metric Mode
This command sets the printer to interpret measurements as metric values (e.g.,
<STX>c0100 will equal 10.0 mm). The default is Imperial (see <STX>n).
Syntax:
STX>k
Y
STX>L
STX>Mnnnn
nnnn -
Is a four-digit length, 0000-9999, in/100 or mm/10.
Maximum setting is 9999 (99.99 inches or 2540
mm). The default setting is 16 inches/ 406.4 mm.
<STX>M0500
The sample above sets a maximum travel distance of 5 inches
(unless the printer is in metric mode; see <STX>m).
STX>m
21
Page 30
System-Level Command Functions
<
<
<
STX n Set Printer to Imperial Mode
This command sets the printer to interpret measurements as inch values (e.g.,
<STX>c0100 will equal 1.00 inch), and is the default mode.
Syntax:
STX O Set Start of Print (SOP) Position
This command sets the point to begin printing relative to the top-of-form (the label’s
edge as detected by the Media Sensor). The printer will feed from the top-of-form to the
value specified in this command to begin printing.
This value operates independently of the <STX>f command.
D-O recommend not using the row adjust feature instead of this command. This is a
legacy command.
Syntax:
Where:
Sample:
STX o Cycle Cutter
This command will cause the optional cutter mechanism to immediately perform a cut
after all previously received commands are executed. The cutter must be installed,
enabled and the interlock(s) closed for operation.
Syntax:
STX>n
STX>Onnnn
nnnn -
Is a four-digit offset value in inches/100 or mm/10.
The “zero” setting is the default value, and settings
below 50 are adjusted back to the default value.
The default setting is “Off” and the printer assumes
the natural SOP position.
<STX>O0210
The sample above will begin printing 0.1 inch closer to the leading
edge of the label if the 220 (Allegro) SOP Emulation was selected,
or 1.0 inch farther away from the leading edge if 110 (ProdPlus)
SOP Emulation was selected.
STX>o
22
Page 31
System-Level Command Functions
<
<
<
STX P Set Hex Dump Mode
This command instructs the printer to assume Hex Dump Mode. Instead of a formatted
product, data sent following this command will be printed in its raw ASCII format. To
capture all data, labels should be at least four inches (102 mm) long and as wide as the
maximum print width. This command has the same effect as turning “On” the printer
while depressing the FEED Key (return normal operation by manual reset).
Syntax:
Printer response is
data dependent
(layout may vary):
STX>P
STX p Controlled Pause
This command will cause the printer to pause only after all previously received
commands are executed, often useful between label batches. (This command will not
clear the pause condition; see <SOH>B).
Syntax:
STX>p
STX Q Clear All Modules
This command instructs the printer to clear all Flash and DRAM modules (except as
noted); see the corresponding Operator’s Manual for applicable module options. All stored data will be destroyed.
Syntax:
Will not affect Module Y or the ILPC Font module.
STX>Q
23
Page 32
System-Level Command Functions
<
<
<
STX q Clear Module
This command clears the selected Flash or DRAM module. During normal operations if a
module becomes corrupted (identifiable when the printer responds with a “No Modules
Available” message to a <STX>W command) it must be cleared. All stored data will be
destroyed.
Syntax:
Where:
Sample:
Will not affect Module Y or the ILPC Font module.
STX R Ribbon Saver Control
This command enables the operation of the optional Ribbon Saver. It is the only
command used to control the Ribbon Saver. Its operation is continuous when enabled.
The printer must be set to thermal transfer (ribbon) printing mode then, during
operation, the Ribbon Saver engages automatically, lifting when the minimum amount of
label white space is exceeded.
Syntax:
Where:
Sample:
STX>qa
a -
<STX>qA
Memory module designator; see Appendix K.
STX>Rx
x -
Y - Enabled (Default = Menu selection.)
N - Disabled
<STX>RY
The sample above will turn the ribbon saver on.
This command is ignored on non-equipped printers.
STX r Select Reflective Sensor
This command enables reflective (black mark) sensing for top-of-form detection of rolled
butt-cut, and fan-fold or tag stocks with reflective marks on the underside. This Media
Sensor will detect a minimum mark of 0.1 inches (2.54 mm) between labels (see the
Operator’s Manual for media requirements). The end of the black mark determines the
top of form. Use the <STX>O command to adjust the print position.
Syntax:
Default setting: Edge sensing
STX>r
24
Page 33
System-Level Command Functions
<
<
<
STX S Set Feed Speed
This command controls the output rate of the media when the FEED Key is pressed.
Syntax:
Where:
STX T Print Quality Label
This command instructs the printer to produce a Print Quality label, a format comprised
of different patterns and bar codes useful in printer setup. To capture all printed
information, use the labels as wide as the maximum print width (see Appendix K) and at
least four inches (102 mm) long.
Syntax:
Printer response
(dot patterns may
vary):
STX>Sn
n -
STX>T
Is a letter value (see Appendix L).
STX t Test DRAM Memory Module
This command tests the DRAM module. The printer returns a one-line message stating
the module condition (no message is returned if a module is unavailable). The printer
must have Feedback Characters enabled for this command to function. Feedback
Characters can be enabled via the menu (see the Operator’s Manual for additional
information).
Syntax:
3
Response format:
Where:
STX>t
Module D: xxxxK RAM Tested results <CR>
xxxx
Module size in Kbytes.
-
results
Test results given as “Good” or “Bad”.
-
25
Page 34
System-Level Command Functions
<
>
<
>
STX U Label Format String Replacement Field
This command places new label data into format fields to build a label. Two options are
available: Exact Length and Truncated Length.
To easily keep track of fields, place all of the fields to be updated with the command at
the beginning of the label format. A maximum of 99 format fields can be updated. Fields
are numbered consecutively 01 to 99 in the order received.
Exact Length Replacement Field Functions – The new data string must equal the
original string length and contain valid data. When the dynamic data is shorter than the
length of the originally defined data field, then field will be padded with blanks (or zero
when the Format Record header specifies a numeric bar code).
Syntax:
Where:
Exact Length
Sample:
Truncated Length Replacement Field Functions – A variant of the <STX>U command
includes the truncate option “T”, where dynamic data shorter than the originally defined
field length will not be padded and the original maximum field length is maintained for
subsequent replacements.
Syntax:
Where:
STX>Unnss…s<CR
nn
ss…s
- Is the format field number, 2 digits.
Is the new string data, followed by a <CR>
-
<STX>L
1A1100001000100data field 1<CR>
161100001100110data field 2<CR>
161100001200120data field 3<CR>
Q0001
E
<STX>U01123<CR>
<STX>U02New data F2<CR>
<STX>E0002
<STX>G
The sample above produces three labels. The first is formatted
with the commands between <STX>L and E. The next two labels
print with the replacement data contained in the <STX>U
commands (see <STX>E and <STX>G). The bar code is the same
length: 3 digits and nine spaces.
STX>UTnnss…s<CR
nn
T
ss…s
- Is the format field number, 2 digits.
-
Truncate option
-
Is the new string data, followed by a <CR>.
26
Page 35
System-Level Command Functions
<
Truncated Sample:
STX V Software Switch Settings
This command controls the printer options, where the appropriate value allows the
option(s) to be “On” or “Off.” Each option has a corresponding bit whose value is “1”
when enabled. The tables below indicate the bit assignments and corresponding
command value needed to enable the desired option(s). Printer options are set by
entering selections through the menu. The software setting command allows two of
these option settings to be modified without returning to the menu.
Syntax:
Where:
Sample:
Bit Assignment Printer Option
0 Cutter
1 N/A
2 Present Sensor
3 N/A
Use the bit assignment table above to determine the command value n in the binary
table below (e.g., the command value 5 sets the bits 0 and 2 to “1”).
n Value
0 0 0 0 0
1 0 0 0 1
4 0 1 0 0
5 0 1 0 1
<STX>L
1A1100001000100data field 1<CR>
161100001100110data field 2<CR>
161100001200120data field 3<CR>
Q0001
E
<STX>UT01123<CR>
<STX>U02New data F2<CR>
<STX>E0002
<STX>G
The sample above produces three labels. The first is formatted
with the commands between <STX>L and E. The next two labels
print with the replacement data contained in the <STX>U
commands (see <STX>E and <STX>G). The bar code is shortened;
it only has three digits (and no spaces).
STX>Vn
n
<STX>V5
The sample above corresponds to setting Bits 0 and 2, creating a
command value of 5. When applied, this enables the Present
Sensor and Cutter options.
- Is a single digit ASCII numeric value from 0-F. The
value of n is used to override the power-up option
settings. Reset or power-up returns the printer to the
original settings.
Command Values for Bits Assigned
Bit
3 2 1 0
27
Page 36
System-Level Command Functions
<
<
STX v Request Firmware Version
This command causes the printer to send its version string (same as printed on the
configuration label). The version may be different from printer to printer.
Syntax:
Printer Response:
STX W Request Memory Module Information
This command requests a memory module directory listing. Results may vary depending
on printer class, model, or firmware version.
Syntax:
Where:
Sample:
Printer response:
STX>v
VER: 9.02_0004 01/01/2008<CR>
STX>W[b][c]a
b s
c e
a -
<STX>WF
MODULE: D<CR>
S50 92244ttf50<CR>
AVAILABLE BYTES: 945152<CR>
MODULE: G<CR>
AVAILABLE BYTES: 852480<CR>
MODULE: X<CR>
AVAILABLE BYTES: 852480<CR>
MODULE: Y<CR>
AVAILABLE BYTES: 852480<CR>
optional – list file size also
optional – list file extension also
Data type:
F
=
G
L
C
X
N
M
f
p
*
Downloaded fonts
=
Graphics (Image)
=
Label formats
=
Configuration files
=
Menu language files
=
Plug-ins
=
Miscellaneous type files
=
Resident fonts
=
Entire module contents
=
All types
28
Page 37
System-Level Command Functions
<
<
STX w Test Flash Memory Module
This command tests the Flash module. The time for each test will vary from 20 to 120
seconds, depending upon the size of the module. All stored data will be destroyed. If
no module is present, there will be no printer response.
Syntax:
Where:
Response format:
Where:
STX X Set Default Module
This command, typically used prior to the loading of PCL-4 bitmapped fonts (see Font
Loading Commands), is designed to allow the user to select between modules when
downloading information. The default module is one of the following:
1. The first alpha designator of the existing modules if item 2 has not occurred.
2. The module selected by this command.
Syntax:
Where:
Sample:
The sample above sets “B” as the default module.
STX>wa
a
Module A: xxxxK results
A
xxxx
results - Test results given as “Good” or “Bad”.
STX>Xa
-
Module designator; see Appendix K.
Module tested.
-
-
Module size in Kbytes.
a
<STX>XB
- Module designator; See Appendix K.
29
Page 38
System-Level Command Functions
<
>
G
L F
S C X N M u
STX x Delete File from Module
This command removes a specific file from the specified module. The file name is
removed from the module directory and thus the file cannot be accessed. The actual
storage space occupied by the file is not released. To reclaim deleted file storage space
use <STX>z to pack the module.
Syntax:
Where:
Sample:
STX>xmtnn…n<CR
m
t
nn…n -
- Module designator; see Appendix K.
The file type identification code:
-
=
Image file
=
Label format file
=
Downloaded bitmapped font file
=
Downloaded scalable font file
=
Configuration file
=
Language file
=
Plug-in file
=
Miscellaneous file type
=
Unknown type – must use extension if
applicable
The file to delete, where:
• Font (bitmapped), three character font identifier;
• Font (scalable), two character font identifier;
• Graphic name, up to sixteen alphanumeric
characters; or,
• Label format name, up to sixteen alphanumeric
characters.
<STX>xDS50<CR>
The sample above deletes a downloaded scalable font with ID 50
from Module D.
30
Page 39
System-Level Command Functions
<
<
STX Y Output Sensor Values
This command causes a sensor value response. When <STX>Y is received, the printer will
respond with the digitally converted values of the internal analog sensors (see below).
To repeat the display of values, send the printer a “SPACE” character (20 hexadecimal);
or, send <ESC> to terminate this function.
The printer must have Feedback Characters enabled for this command to function.
(Feedback Mode [Characters] can be enabled via command or menu setting; see the
<STX>KcFM command or the Operator’s Manual for additional information).
Syntax:
Printer response:
Where:
•
• Some readings require printer-controlled paper movement to produce a meaningful
• Media Sensor readings require the appropriate sensor selection, transmissive
Equipped sensors vary with printer, model, and options;
value; and,
(<STX>e) or reflective (<STX>r), and label stock placed in the sensor.
Battery level: Good indicates a sufficient battery charge; Low indicates an insufficient charge.
STX y Select Font Symbol Set
This command selects the scalable font symbol set. The selected symbol set remains
active until another symbol set is selected. See the <STX>KS command and Appendices
E, I, and H for more information. Option dependent and not all symbol sets can be used
with all fonts.
Syntax:
Where:
Sample:
STX>ySxx
S
Byte-size designation; see Appendix H:
-
S = Single byte symbol sets.
U = Double byte symbol sets.
xx
-
Symbol set selection.
<STX>ySPM
The sample above selects the PC-850 multilingual set.
31
Page 40
System-Level Command Functions
<
<
STX Z Print Configuration Label
This command causes the printer to produce a Database Configuration Label. To capture
all printed information, use the labels as wide as the maximum print width (see
Appendix K) and at least four inches (102 mm) long.
Syntax:
Printer response:
STX>Z
CONFIGURATION
TUE 09:09 AM 10 FEB2009
PRINTER KEY:
4212-HE25-060224-090
APPLICATION VERSION:
83-2541-11H3 11.083 12/22/2008
MCL Version: 1.00.06-072
BOOT LOADER:
83-2539-11A 11.01 10/02/2007
UNLOCKED:
CG TIMES
FPGA:
HP10
iPH:
5x-00289 #163
MACM:
00-0d-70-03-8b-b9
MACO:
NOT SET
MACR:
00-90-c9-01-D0-64
SYSTEM INFORMATION
PRINT BUFFER SIZE:
100 in.
FLASH SIZE:
8 MB
RAM TEST:
PASS
MODE:
DISABLED
BACKUP DELAY (1/50s):
0
FONT EMULATION:
STANDARD FONTS
LABEL STORE:
STATE & FIELDS
MENU LANGUAGE:
ENGLISH
FAULT HANDLING:
LEVEL:
STANDARD
VOID DISTANCE:
0.50 in.
RETRY COUNT:
1
BACKFEED ON CLEAR:
DISABLED
COMMUNICATIONS
SERIAL PORT A:
BAUD RATE:
9600 BPS
PROTOCOL:
BOTH
PAR ITY:
NONE
DATA BITS:
8
Printed information will vary according to printer, model, firmware version, and options.
STX z Pack Module
Ignored.
This command causes the printer to reclaim all storage space associated with all deleted
files on the specified module (see <STX>X and <STX>x).
STX>zm
m
- The module identification character; see Appendix K.
Syntax:
Where:
ignored
32
Page 41
Extended System-Level Command Functions
Extended System-Level
5
Command Functions
Introduction
Issued in the same context as System-Level Commands, the Extended System-Level
Commands expand certain System-Level Commands to provide an extra degree of printer
control.
STX K}E Empty Sensor Calibration
This command causes the printer to determine and save the calibration value for an
empty media sensor condition. This calibration function should be performed when no
material is installed in the media sensor. Depending upon the printer model, different
front panel LED flash sequences and printer responses (below) will indicate calibration
progress and outcome; see the corresponding printer operator manual for LED flash
sequences details.
Printer Response Alternate
REMOVE STOCK[CR] N/A
ENTER TO CONTINUE[CR] N/A
PASSED CALIBRATION[CR] FAILED CALIBRATION[CR]
33
Page 42
Extended System-Level Command Functions
STX K}M Manual Media Calibration
This command causes the printer to save the sampled calibration values as an operator
places different portions of label stock within the media sensor. Depending upon the
printer model, different front panel LED flash sequences and printer responses (below)
will indicate calibration progress and outcome; see the corresponding printer operator
manual for LED flash sequences details. Sending <ESC> to the printer instead of <CR>
will terminate the process and leave the TOF Sensor values unchanged.
Printer Response Alternate
LOAD STOCK[CR]
ENTER TO CONTINUE[CR]
LOAD MARK[CR]
ENTER TO CONTINUE[CR]
REMOVE STOCK[CR]
ENTER TO CONTINUE[CR]
N/A
LOAD GAP[CR]
N/A
PASSED CALIBRATION[CR] FAILED CALIBRATION[CR]
STX K}Q Quick Media Calibration
This command causes the printer to move media, sample, and then save sensor samples
as calibration values. This calibration function should be performed with media installed
over the TOF sensor in the printer. Depending upon the printer model, different front
panel LED flash sequences and printer responses (below) will indicate calibration
progress and outcome; see the corresponding printer operator manual for LED flash
sequences details.
Printer Response Alternate
FAILED CALIBRATION[CR]
ADJUST GAIN SETTING[CR]
N/A
PASSED CALIBRATION[CR] FAILED CALIBRATION[CR]
34
Page 43
Extended System-Level Command Functions
<
e
<CR>
STX KaR Read Data from RFID Tag
(Direct Mode – Generic Read/Write Interface)
This command instructs the RFID device to read data from the tag and then place that
data into a replaceable field. It is expected that the tag transponder will be within the
read / write distance of the RFID programming device; otherwise, “Void” will be printed
in the text or bar code label field.
Syntax:
Where:
Sample:
STX>KaRAaaabbbcde
A
aaa
bbb
c
d
ee
<STX>L
1911A1802000010TEXT
U
X
<STX>KaR0000010001
<STX>G
- Optional – for data in the ASCII format.
The number of bytes to read.
-
HF - Starting block number (000 maximum block
number, which is dependent upon the
transponder manufacturer).
UHF – Should be 000.
Command 1. Reserved. Should be 0.
-
Command 2. Reserved. Should be 0.
-
-
Field number in which to place the data (must be 01,
02, 03, etc.) matching the order of Label Formatting
command U.
The 00 value will send read data to the host with no
printing.
The sample above creates a replaceable text field (01), recalls data
from the RFID tag block zero (reading only one block), and prints
the data in the location specified by the replaceable field. Since
there are two digits per each hex value, replaceable fields should be
twice as long than if using ASCII data (e.g., the character “A” would
be returned as “41”).
35
Page 44
Extended System-Level Command Functions
<
e
<CR>
<
>
STX KaW Write Data to RFID Tag
(Direct Mode – Generic Read/Write Interface)
This command instructs the RFID device to write data to the tag. It is expected that the
tag transponder will be within the read / write distance of the RFID programming device;
otherwise, a warning will occur and a warning message (Read / Write Fail) will be
displayed.
Syntax:
STX>KaWAaaabbbcdee…
Where:
Aaaa
-
Optional – for data in the ASCII format, followed by
the byte count (000-999).
bbb
HF – Starting block number (000 maximum block
-
number, which is dependent upon the
transponder manufacturer).
UHF – Should be 000.
c
Command 1. Reserved for Future (should be 0)
-
d
Command 2. Reserved for Future (should be 0)
-
ee…e
Data to be encoded on RFID tag (HF – the last used
-
block will be null-padded, if necessary).
UHF ASCII formats must be 8 or 12 characters; and,
UHF Hexadecimal formats must be 16 or 24
character pairs.
Sample:
<STX>KaW0000054455354[CR]
The sample above writes the data “TEST” at block zero.
STX Kb Backfeed Time Delay
This command controls the time a printed label is allowed to remain “presented” before
being retracted to the start of print position.
Syntax:
Where:
STX>Kbnnn<CR
nnn
-
Seconds/10 (0 to 255)
36
Page 45
Extended System-Level Command Functions
<
>
STX KC Get Configuration
This command returns the configuration of the printer. The form of the returned data is
similar to that of a printed Configuration Label. This command should be parsed by KEYWORDS, not character positions. Each line is terminated by a CR (0x0d) & LF
(0x0a).
This command specifies the Power-up Configuration parameter values for the printer and
is equivalent to using other system commands followed by the <SOH>U. This command
is intended for easily configuring a custom setup, but NOT for dynamic
configuration changes. Configuration commands are examined for differences
relative to the current configuration, and have no impact when no differences exist.
Printers will reset upon completion of a command stream containing parameter value
changes. In any case, no commands should be sent to the printer until this reset is
complete. Other command highlights include the following:
• These parameter values are equivalent to changing the respective menu settings and
do not affect the factory default settings of the printer.
• If separated by a semi-colon (;), multiple parameter values may be sent in a single
command stream; see sample below.
• All values are stored in Flash memory and remain in effect until new values are
received or until factory defaults are restored.
• If system commands are sent that override the Power-up Configuration value(s), the
Power-up Configuration value(s) will be restored the next time the printer is powered
“On” or is reset.
• These parameters are the same as those found in the Menu System (display-
equipped models). The respective functions are documented in the appropriate
Operator’s Manual. Not all commands are effective on all printers.
Illegal or out of range parameter values may have unpredictable results. In addition,
media sensing scaling values, TOF Bias, etc. may not be effective on other same-type
printers due to hardware tolerances.
Syntax:
STX>Kcaa
al
;aa
al
1
1
I
I
[;aa
al
n
n
Where:
aa
1,
-
Are two letter parameter names.
aaI, aan
val
val
1,
I,
valn
-
Are parameter values, with ranges
appropriate for the associated parameter.
Sample:
<STX>KcPA120;CL600;STC<CR>
The sample above sets the Present Adjust to 120 dots, and the
Sensor Type to Continuous with a label length of six inches.
The following tablessummarize (alphabetically by name) different Configuration Set
command parameters, value ranges, command equivalents and applicability. If no
command equivalent is given, or where clarification is required, descriptions immediately
follow the table.
40
Page 49
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Configuration Set Commands
Value /
Range
Units /
Interpretation
Command
Equivalent
Alignment Length
Avalanche
Backup After Print
Backup Delay
Backup Label
Backup (Reverse) Speed
Blue Tooth
AL
AV
BA
BD
BL
BS or bS
BT
0 – 999 1/100 inch N/A
Y, N
Y = Enabled,
N = Disabled
0 – 255 1/50 second N/A
0 = Disabled,
0, 3, 4
3 = Active Low,
4 = Active High
alpha character Model specific ranges; see Appendix L.
N/A
N/A
pa
N/A
British Pound
Buzzer Enable
BP
BZ
Y, N
Y, N
41
Y = Enabled,
N = Disabled
Y = Enabled,
N = Disabled
N/A
N/A
Page 50
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Column Adjust Fine Tune
Column Offset
Comm Heat Commands
Comm Speed Commands
Comm TOF Commands
CF
CO
CH
CS
CT
+ / – dots
Resolution specific;
see Appendix K.
0 – 9999 1/100 in.
Y = Enabled,
Y, N
1, 0
N = Disabled
1 = Enabled,
0 = Disabled
Y = Enabled,
Y, N
1, 0
N = Disabled
1 = Enabled,
0 = Disabled
Y, N
Y = Enabled,
N = Disabled
N/A
Cnnnn
N/A
N/A
N/A
Configuration Builder
Continuous Label Length
CU
CL
0 – 9999 1/100 in.
<STX>c
42
Page 51
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Control Codes
Cutter Equipped
Darkness
Default Module
Delay Rate
(Test Labels)
Disable Symbol Set
Selection
CC
CE
DK
DM
DR
NS
S = Standard,
S, 1, 2
1 = Alternate,
2 = Alternate-2
A or Y = Auto,
E = Enabled,
A/Y, E, N/D
A, E/Y, N
N or D = Disabled
A = Auto,
<STX>V
E or Y = Enabled,
N = Disabled
1 – 64 N/A N/A
D, G
A, B
Module Letter
<STX>X
0 – 120 Seconds N/A
Y, N
Y = Enabled,
N = Disabled
N/A
N/A
Display Mode
Double Byte Symbol Set
DPI Emulation
GD
DS
DE
S, E
2-Byte alpha
character
152, 200, 300,
400, 600
S = Standard,
E = Enhanced
AA – ZZ, printer resident symbol set
Dots per inch N/A
43
N/A
<STX>y,
ySxx
Page 52
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Empty Sensor Level
End Character
End Of Print
ESC Sequences
Fault Handling
EV
EN
EP
ES
FH
0 – 255 N/A N/A
D N/A N/A
1 = Low Pulse,
1, 2, 3, 4
2 = High Pulse,
3 = Active Low,
N/A
4 = Active High
Y, N
Y = Enabled,
N = Disabled
N/A
L, D, R, B See Command N/A
Feed Speed
Feedback Mode
SS or sS
FM
Alpha character
Y, N
Model specific ranges;
see Appendix L.
Y = Enabled,
N = Disabled
44
Sa
<STX>a
Page 53
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Font Emulation
Format Attributes
Gain Reflective Value
Gap / Mark Value
GPIO Equipped
GPIO Error Pause
FE
FA
GR
GM
GE
GP
0 = No Substitution
0, 1, 2
1 = Sub CG Times SA0
N/A
2 = Sub User S50
X = XOR,
X, O, T
O = Opaque,
An
T = Transparent
0 – 31 N/A N/A
0 – 255 N/A N/A
A = Applicator,
A, V, N, 2
V = Verifier,
N = Disabled,
N/A
A = Applicator2
E, D
E = Enabled,
D = Disabled
N/A
GPIO Slew
Head Bias
GS
HB
0 – 4
L, R, C
0 = Standard,
1 = Low Pulse,
2 = High Pulse,
3 = Active Low,
4 = Active High
L = Leftmost dot is zero,
R = Rightmost dot is zero
C=Center
45
N/A
N/A
Page 54
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Head Cleaning
Heat
Host Timeout
Ignore Control Codes
Ignore Distances
HC
HE
HT
IC
IE
0 – 9999 Inches (or centimeters) multiplied by 1000 N/A
0 – 30 N/A
Hnn
1 – 60 Seconds N/A
Y = Enabled,
Y, N
1, 0
N = Disabled
1 = Enabled,
N/A
0 = Disabled
1, 0
1 = Enabled,
0 = Disabled
N/A
Imaging Mode
IL
M, S
M = Multiple label,
S = Single label
46
N/A
Page 55
<STX>Kc
Parameter Name
Input Mode
Parameter
Pneumonic
EM
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
0 = DPL,
1 = Line,
3 = PL-Z,
5 = PL-I,
0, 1, 3, 7, 9
7 = PL-B,
8 = PL-E,
9 = Auto,
10 = CPCL,
11 = EasyPrint
Command
Equivalent
N/A
Internal Module
Label Alignment
Label Rotation
Label Store
Label Width
Language Select
IM
LA
LR
LM
LW
LS
100 – up to max.
available; see
Kbytes N/A
Appendix K
N, A, Y See Command N/A
Y, N
F, S
Y = Rotate 180
N = None
F = Fields,
S = States & Fields
N/A
N/A
0075 – head
width; see
1/100 inch
<STX>KW
Appendix K
String Language Name N/A
47
Page 56
<STX>Kc
Parameter Name
Legacy Emulation
Parameter
Pneumonic
LE
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
N = None,
N, A, P, L
N, A, P, L, M
A = Allegro,
P = Prodigy,
L = Prodigy Plus,
M = Prodigy Max
Command
Equivalent
N/A
X = XL
Mark Value
Maximum Length Ignore
Maximum Length
Media Type
Menu Mode
Module Command
Network Configuration
(wired and wireless)
MV
SM
ML
MT
MM
MCC
NE
0 – 255 N/A N/A
0 =
0, 1
Normal processing,
N/A
1 = Ignore
0 – 9999 1/100 inch
D, T
U, A
D = Direct,
T = Thermal Transfer
U = User,
A = Advanced
<STX>M
N/A
N/A
Z, G
See Command N/A
B
No Reprint
NR
Y, N
48
Y = Enabled,
N = Disabled
N/A
Page 57
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Option Feedback
Paper Empty
Paper Value
Parallel Direction
Password Set
OF
PO
PV
PP
PW
D, Rx, S See Command N/A
0 – 9999 1/100 inch N/A
0 – 255 N/A N/A
xz See Command N/A
A – Z,
0 – 9
(or, if security is enabled then eight
Four characters
N/A
characters).
Pause Mode
Peel Mode
Present Adjust Fine Tune
PM
PE
PJ
Y, N
Y, N
+ / – dots
Y = Enabled,
N = Disabled
Y = Enabled,
N = Disabled
Dots (model specific),
see Appendix K.
49
<STX>J
N/A
N/A
Page 58
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Present Distance
Present Sensor Equipped
Print Contrast
Printer Level
Print Speed
Query Configuration
PD
PS
PC
PL
pS
QQ
0 – 400 1/100 inch
<STX>Kf
A or Y = Auto,
A/Y, E, N/D
E = Enabled,
<STX>V
N or D = Disabled
0 – 64 N/A N/A
000000 – FFFFFF Hex Codes N/A
Alpha character Model specific ranges; see Appendix L.
Pa
Q, K N/A N/A
Reflective Paper Value
Retract Delay
Rewinder Adjust
RV
RW
RR
0 – 255 N/A N/A
1 – 255
-xx, +yy
Specified value times
ten milliseconds
Applied torque, where -30 to +15 is the valid
range.
N/A
N/A
50
Page 59
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Rewinder Equipped
RFID Configuration
Ribbon Low Diameter
Ribbon Low Pause
Ribbon Low Signal
Row Adjust Fine Tune
RM
RI
RL
RP
RS
RF
A or Y = Auto,
A/Y, E, N/D
E = Enabled,
N or D = Disabled
A, B, D, E, L, M,
N, P, R, S, T, U,
See Command N/A
V, W
100 – 200 1/100 in. N/A
Y, N
3, 4
Y = Enabled,
N = Disabled
3 = Active Low,
4 = Active High
+ / – dots Resolution specific; see Appendix K. N/A
N/A
N/A
N/A
Row Offset
SOP Adjust
[1]
SOP Emulation
RO
SA
0 – 9999 1/100 in.
0 – 255
(128 nominal)
see Row Adjust Fine Tune
N/A,
Rnnnn
<STX>O
A = Allegro,
SE
A, L, P, D
L = Prodigy Plus,
P = Prodigy,
N/A
D = Disable
51
Page 60
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Save As Filename
Scalable Font Bolding
Scalable Font Cache
Scanner Configuration
Security Lock
Sensor Gain Value
SF
FB
SC
SN
Sl
SG
Alphanumeric
string
Up to 16 characters N/A
1 – 36 N/A N/A
100 – 8192 Kbytes N/A
C, H, M,
D, B, V
See Command N/A
N, Y, T See Command N/A
0 – 32 N/A N/A
Sensor Type
Alternate Gap Type (RL3
& RL4 Only)
ST
GA
G, C, R
E, D
G = Gap (edge),
C = Continuous,
R = Reflective
E = Enable
D = Disabled
52
<STX>e,<STX>r,<STX>c
N/A
Page 61
<STX>Kc
Parameter Name
Parameter
Pneumonic
Extended System-Level Command Functions
Value /
Range
Units /
Interpretation
Command
Equivalent
Serial Port
Single Byte Symbol Set
Slew Speed
Software Switch
Start of Print
Stop Location
TOF Precedence
User Label Mode
Unit of Measure
SP
AS
FS
SV
EQ
SL
TP
UD
UM
xyz See Command N/A
2-Byte alpha
character
AA – ZZ, printer resident symbol set
Alpha character Model specific ranges; see Appendix L.
Y, N
3, 4
A, H, P,
C, T, N
Y, N
Y, N
M, I
Y = Processed
N = Ignored
3 = Active Low,
4 = Active High
See Command N/A
Y = Enabled,
N = Disabled
Y = Enabled,
N = Disabled
M = Metric,
I = Imperial
<STX>y, ySxx
<STX>KZSx
N/A
N/A
N/A
N/A
<STX>m, <STX>n
Plug and Play ID Type
User Terminator
UN
UT
Y, N
Y = Unique
N = Static
N/A
ON N/A N/A
53
Page 62
Extended System-Level Command Functions
<STX>Kc Parameter Overviews
(AL) Alignment Length – This command, critical for small labels when Label
Alignment is set to YES, allows a length (measured from leading edge to leading
edge of two successive labels) to be entered. The measured length must be provided
to the nearest hundredth of an inch. For very small labels, errors of 0.01” can result
in noticeable print variations on the labels between the media sensor and the print
head. The number of labels that can be fit between the Media Sensor and the print
head will magnify any error in label alignment length. Errors in measurement are
more favorable on the low side rather than the high side.
(AS) Single Byte Symbol Set – This command allows for a default single-byte
symbol set. See <STX>y or ySxx for command details.
(AV)Avalanche Enabled Parameters – This command allows the printer to be
configured for the Avalanche utility..
Syntax:
<stx>KcAV[nnn
Where:
,vvvvi: Configuration Item – Value pairs
nnn
i
Decimal Item Numbers from 1 to 9999
nnn
i
, Decimal Item Number Delimiter
Item Value (syntax defined later)
vvvv
i
: Item Value Delimitermimitd
Example – Turn the Avalanche Enabler on:
<stx>KcAV[1,1:2,’192.168.99.1’:4,’Ava.Do.local’:8,b:9,10]
Enable Avalanche Enabler, Agent IP address is 192.168.99.1, Agent DNS name is
Ava.Do.local, Update model is both, and Update Interval is very 10 minutes.
Bluetooth parameters are defined by the following table:
Item
Number
1 Avalanche Enabler
Active
2 Agent IP Address Y String The IP address of the Avalanche
3 Agent Port Number Y Unsigned
Name Available
,vvvv1:nnn2,vvvv2:…,nnnn,vvvvn:];
1
Value Type Description
to User
(Y/N)
Y Unsigned
short
short
Flag to indicate that the Avalanche
Enabler is running or not
1 : Avalanche Enabler is running
0: Avalanche Enable is NOT
running (default).
Agent.
The TCP/IP port number. Default
value is 1777
54
Page 63
Item
Number
Extended System-Level Command Functions
Name Available
to User
Value Type Description
(Y/N)
4 Agent DNS Name
(max 255 chars)
Y String The DNS name of the Avalanche
Agent. Ex:
“AvaAgentName.DO.local”.
During the wireless update
process, Agent DNS Name will be
used to resolve to Agent IP
address. If Printer fails to obtain
the Agent IP address from the
Agent DNS Name, the Agent IP
Address (item number 2) will be
used as target address for printer
to connect to Avalanche Agent.
5 Connectivity Type Y Unsigned
short
Type of connectivity from
Avalanche Enabler (printer) to the
Avalanche Agent.
0: None
1: TCP/IP (default)
6 Printer Name (
max63 chars)
Y String This is the printer name that will
be displayed in the Wavelink
Management Console to represent
a printer.
7 Printer Model (max
Y String Model of a printer.
15 chars)
8 Update Mode Y Char Flag to indicate the Update Mode
for the Avalanche Enabler:
‘n’: None, No update even
Avalanched Enable Active is set
‘s’: Run the update process when
the printer is startup.
‘i’: Run the update process for
every Update Interval.
‘b’:Run the update process when
printer is started up and for every
Update Interval after that.
9 Update Interval Y Unsigned
short
The value for an Update Interval
(in minutes).
Default is 6 minutes.
When the Update Method is set to
‘i’ (for interval) or ‘b’ (for both),
Printer will contacts the Avalanche
Agent for every Update Interval
(minutes) and execute the update
software package.
10 Print Update Status
Result
Y Char Printer will print the result of the
software update process, such as
“Avalanche Upgrade Stastus:
Upgrade complete ( <Name of the
Update Software Package>).
‘y’: Print the status of the update
result’
‘n’: Do not printer the status of
the update result (default)
55
Page 64
Extended System-Level Command Functions
(BA) Backup After Print – This command determines the timing of the label back
up positioning when the present distance is set and the GPIO option or Present
Sensor option (including Peel and Present) is enabled. When enabled, the printer
immediately backs up the label after the applicator-issued start of print signal is
received or the label is removed, resulting in faster throughput. If disabled, the
printer will not initiate repositioning until the next label is ready to print (may help
prevent the curling of the label edge).
(BD) Backup Delay – This command sets a time delay for the retraction of a
presented label in one-fiftieth (1/50) of a second increments.
(BL) Backup Label – This command determines the timing of reverse label motion
when the GPIO option is installed and enabled; see Appendix J for details.
(BP) British Pound – This command, when enabled, will automatically switch from
the Number symbol (#) found at 0x23 (default PC-850 Multilingual Symbol Set) to
the British Pound symbol (£) at 0x9C.
(BS or bS) Backup Speed – This command controls the rate of label movement
during backup positioning for start of print, cutting or present distance; see Appendix
C for available speed ranges.
56
Page 65
Extended System-Level Command Functions
(BT) Bluetooth Parameters – This command configures the Bluetooth
Communication parameters.
Syntax:
<stx>KcBT[nnn
,vvvv1:nnn2,vvvv2:…,nnnn,vvvvn:];
1
Where:
,vvvvi: Configuration Item – Value pairs
nnn
i
Decimal Item Numbers from 1 to 9999
nnn
i
, Decimal Item Number Delimiter
Item Value (syntax defined later)
vvvv
i
: Item Value Delimitermimitd
Example – Discoverable on, service name is “smartchoice”, Bluetooth name is
“bestprinter”.
<stx>KcBT[1,’bestprinter’:2,’smartchoice’:3,1]
Bluetooth parameters are defined by the following table:
Item
Number
1 Bluetooth Name Y String Bluetooth Device Name
2 Bluetooth Service
Name
3 Discoverable or Not Y Boolean Discoverable: yes or no;
4 Connectable or Not Y Boolean Connectable: yes or no;
5 Bondable or Not Y Boolean Bondable: yes or no; Default is
6 Authentication on Y Boolean Authentication on or off.
7 Encryption on Y Boolean Encryption on or off. Default
Name Available
to User
(Y/N)
Y String Bluetooth Service name – 1 to
Value Type Description
(Friendly Name) 1 to 32
characters. Default ‘DatamaxOneil’
32 characters. Default
‘Datamax-Oneil’
Default YES.
0=no
1=yes
Default is NO
0=no
1=yes
NO.
0=no
1=yes
Default OFF.
0=no
1=yes
OFF
0=no
1=yes
57
Page 66
Extended System-Level Command Functions
Item
Number
8 Passkey Y String String up to 16 characters.
9 Inactive Disc Time Y Int 0 to 65535. Default is 60
10 Power Down Time Y Int 0 to 65535. Default is 60 (
11 Bluetooth Address Y String 12 hexadecimal characters
Name Available
to User
(Y/N)
Value Type Description
Valid characters are
alpha/numeric. Default – not
used.
0=no
1=yes
(Read and Write)
Read and Write)
(similar to MAC address) (Read
Only)
(BZ) Buzzer Enable – This command controls the audible signaling device that
acknowledges User Interface entries and, if enabled, sounds printer warning and
fault conditions.
(CC) Control Codes – This command, depending upon printer type, allows a change
to the prefix of the software commands interpreted by the printer:
(CE) Cutter Equipped – This command allows the printer to sense the cutter option.
“A” - automatically senses device presence; if undetected, no error is generated. “E” enables the device, where its presence must be detected; otherwise, a fault is
generated. “N” - disables device detection. One of these values is returned in
response to <STX>KcQQQ. Note that alternate values are accepted for backward
compatibility as follows: “Y” is equivalent to “A”.
(CF) Column Adjust Fine Tune – This command fine-tunes the Column Offset
setting by shifting both the horizontal start of print position and the Label Width
termination point to the right in dots (see Appendix K) to compensate for slight
mechanical differences sometimes evident when multiple printers share label
formats.
58
Page 67
Extended System-Level Command Functions
(CH) Communicated Heat Commands – This command causes the printer to
ignore DPL Heat commands. Ignore by setting value to N. Process by setting value
to Y (default). When set to ignore Heat commands values are controlled via the
menu setting.
(CL) Continuous Label Length – See <STX>c for command details.
(CO) Column Offset – See Cnnnn for command details.
(CS) Communicated Speed Commands – This command causes the printer to
ignore DPL speed commands. Ignore by setting value to N. Process by setting value
to Y (default). When set to ignore speed values are controlled via the menu setting.
(CT) Communicated TOF Commands – This command causes the printer to
ignore DPL TOF (Gap, Continuous, and Reflective) commands. Ignore by setting
value to N. Process by setting value to Y (default). When set to DPL TOF values are
controlled via the menu setting.
59
Page 68
Extended System-Level Command Functions
(CU) Configuration Upgrade Package Parameters – This command allows an
upgrade package to be created.
Syntax:
<stx>KcCU[nnn
,vvvv1:nnn2,vvvv2:…,nnnn,vvvvn:];
1
Where:
,vvvvi: Configuration Item – Value pairs
nnn
i
nnn
i
Decimal Item Numbers from 1 to 9999
, Decimal Item Number Delimiter
Item Value (syntax defined later)
vvvv
i
: Item Value Delimitermimitd
Example – Discoverable on, service name is “smartchoice”, Bluetooth name is
“bestprinter”.
Configuration Upgrade Package parameters are defined by the following table:
Item
Number
Name Available
to User
Value Type Description
(Y/N)
1 Wireless Upgrade
Type
Y Unsigned short 1-TFTP
2-Avalanche Wavelink
3-MSP
255 – Disable
2 Configuration File Y String Configuration file name (*.cfg)
for an Upgrade Package, 256
chars max.
3 TFTP IP address Y String IP address of TFTP server.
4 TFTP Port Y Unsigned short Port Number of TFTP Server,
default 69
5 Upgrade Package
Y String Read only.
Version
6 Wireless Upgrade
Y Char 0: Off; 1: On (Default).
Beeper
(DE) DPI Emulation – This command allows printers with higher resolutions to
emulate lower print resolutions, as follows:
• 600 DPI can emulate 300 and 203 DPI resolutions; and,
• 400 DPI can emulate a 203 DPI resolution; and,
• 300 DPI can emulate a 152 DPI resolution.
(DK) Darkness – This command adjusts the length of the print head strobe to finetune the HEAT setting.
60
Page 69
Extended System-Level Command Functions
(DM) Default Module – See <STX>X for command details.
(DR) Delay Rate – This command sets the number of minutes to delay between
multiple batch printings of Quick Test Labels. This command is provided as a
diagnostic tool.
(DS) Double Byte Symbol Set – See <STX>y or ySxx for command details.
(EM) Input Mode – This command determines the data processing mode:
Value Interpretation
0 DPL Character strings are parsed for standard DPL processing.
No parsing occurs; instead, each carriage return (<CR>)
1 Line
terminated data line is printed according to a stored template
(see Appendix S).
Input Mode Interpretation
Character strings are parsed for PL-Z processing, applicable
only if the appropriate firmware is installed, as indicated by a
“Z” in the version string.
3 PL-Z
For RFID, the hardware option, tag type and size
should be preselected, and a tag calibration performed.
Also, if possible, driver / software options to use
“Printer Defaults” should be chosen to minimize
potential conflicts.
5 PL-I
Character strings are parsed for PL-B processing, applicable
7 PL-B
only if the appropriate firmware is installed, as indicated by a
“B” in the version string.
61
Page 70
Extended System-Level Command Functions
Value Interpretation
8 PL-E
Character strings are automatically parsed and processed
according to the identified language.
9 Auto
10 CPCL
A clean file is required, where extra leading characters
may cause the language to be unrecognizable;
otherwise, the appropriate Input Mode must be
selected.
Input Mode Interpretation
11 O’Neil EZ Print
(EN) End Character – This command terminates a <STX>Kc string.
(EP) End of Print – This command defines the signal output used to signify the End
of Print (EOP) process:
Value Units End of Print Interpretation
1 Low Pulse
2 High Pulse
3 Active Low Outputs a logic low (zero) following printing.
4 Active High Outputs a logic high (one) following printing.
Outputs a low pulse (approximately 30 milliseconds long)
following printing.
Outputs a high pulse (approximately 30 milliseconds long)
following printing.
62
Page 71
Extended System-Level Command Functions
(EQ) Start of Print – This command defines the type of signal input required to
control the Start of Print (SOP) process:
Value Units Start of Print Interpretation
3 Active Low
4 Active High
SOP signal must go low for at least 50 milliseconds to initiate
printing.
SOP signal must go high for at least 50 milliseconds to
initiate printing.
(ES) ESC Sequences – This command allows data containing invalid ESC control
code sequences to be processed (helpful because some systems send a “banner” to
the printer). When set to “Disabled,” ESC sequences are ignored and the data is
processed. Bitmapped font downloads are disabled in this mode.
(EV) Empty Sensor Level – This command sets threshold value for the “Empty”
media sensor parameter.
(FA) Format Attribute – See the “An” command for details (Label Formatting
Command Functions).
(FB) Scalable Font Bolding – This command sets a bolding factor to fine tune
scalable fonts, where one causes the least amount of bolding and thirty-six the most
(default value is 8).
(FE) Font Emulation –This command allows font substitution for all internal fonts,
allowing a new default font to be defined without changing the host DPL data
streams. Selecting a default font that supports a desired character set could match
with third party software to print native characters without modifying the PC drivers.
In other words, match the PC font with the Printer Font then no interpretation would
be required by driver or printer. Depending on host drivers, the user may have to
disable Symbol Set commands and modify the Default Symbol set.
63
Page 72
Extended System-Level Command Functions
(FH) Fault Handling – This command determines the level of user intervention and
the disposition of the label being printed when a fault condition (ribbon out, media
out, etc.) occurs.
Value
Units /
Interpretation
Selection / Definition
Printing stops and a fault message is displayed. After the
0 = No Reprint
problem is corrected, the FEED Key must be pressed to
clear the fault. The label in process is not reprinted.
Printing stops and a fault message is displayed. After the
1 = Standard
problem is corrected, the FEED Key must be pressed to
clear the fault. The label in process is reprinted.
Depending upon the RETRY COUNT, one of the following
actions when faulted:
• If the Retry Count has not been exceeded, “VOID” is
printed on the label in process and reprinting occurs
automatically;
L
2 = Void and
Retry
(continued)
• If the Retry Count has been exceeded, printing stops and
a fault message is displayed. After the problem is
corrected, the FEED Key must be pressed to clear the
fault. The label in process is reprinted; or,
• If the CANCEL Key is pressed, the operator now has the
option of canceling the reprint. To allow reprinting, press
the ESCAPE Key; or, to cancel reprinting, press the
ENTER Key (and, the entire label batch will be cancelled
by pressing the ENTER Key again).
VOID will not be printed when insufficient text space
exists (see VOID DISTANCE, below) or if the fault
occurs after the label reaches its Present Distance
at, or above, the TOF.
64
Page 73
Extended System-Level Command Functions
Value
Units /
Interpretation
Selection / Definition
Increases throughput when bar codes reside near the
trailing edge of the label (in the direction of FEED).
• If unreadable, the fault will occur after the next
3 = Delayed
Scan Fault
L
label prints.
• The label immediately following a faulted label is
not scanned for errors.
• VOID AND RETRY and REPRINT are automatically
disabled; the job can only be cancelled.
4 = Void Retry
& Cont.
VOID is printed on a faulted label, with reprint attempts
occurring automatically, until the RETRY COUNT has been
exceeded and then that label will be skipped (discarded)
and printing will continue to the next label in queue.
Sets the distance (.10 - 2.00) to backup the faulted label to
print “VOID” on its trailing edge, which also indirectly
establishes the font size of the void message.
D
Void Distance
(.10 - 2.00)
Establishes the number of times a reprint will be attempted
R
Retry Count
(0 – 3)
when using the RFID or Scanner option; if the last label
printed in this count has been voided, a fault will be
declared.
B
Example: <STX>KcFHD112<CR>
Enable / Disable
Y, N
Retract from presented distance prior to feed-clear motion.
This option is intended for use with applicator equipment
that may require certain GPIO signals for proper operation.
The example above configures the printer to back up and print a one-inch tall “VOID”
message on a faulted label; if two successive faults occur during the printing of that
label, then the FEED Key must be pressed to clear the fault.
(FM) Feedback Mode – See <STX>a for command details.
(FS) Slew Speed - This command controls the rate of label movement between printing areas when the GPIO port is used; see Appendix L for ranges.
(GA) Alternate Gap Type – This command selects one of two Gap Sensing
algorithms. This parameter is valid for the RL3 / RL4 when Sensor Type is set to
Gap. Defaults to Disabled or Alternate not selected.
(GD) Display Mode– This command controls the size of displayed menu
characters, where Enhanced makes them larger.
65
Page 74
Extended System-Level Command Functions
(GE) GPIO Equipped – This command is used to interface the printer to external
controlling devices (see Appendix J):
Value
Units /
Interpretation
GPIO Enable Definition
Enables the standard applicator mode, de-asserting DRDY
A Applicator
as soon as last label starts printing, allowing FEED any
time, and not de-asserting DRDY when PAUSED.
N Disabled Disables the GPIO Port.
V Verifier Enables the GPIO Port for a bar code verifier.
Enables the alternate applicator mode, where Data Ready
(DRDY) is extended to overlap the End Of Print (EOP) signal
2 Applicator2
by about 1 msec when printing the last label; and, where
PAUSE or FAULT de-asserts the DRDY signal and inhibits
the FEED operation.
(GM) Gap / Mark Value – This command sets threshold value for the media
sensor’s “gap” or “mark” parameter.
(GP) GPIO Error Pause – This command enables or disables the printer from
sending a service required fault to the GPIO output (Applicator Interface CCA, Type 2
only).
(GR) Gain Reflective Value – This command sets the sensitivity of the reflective
media sensor.
(GS) GPIO Slew – This command sets the GPIO slew function and control:
Value Slew Interpretation
0 Standard (Active Low)
1 Low Pulse *
2 High Pulse *
3 Slews while low (Active Low)
4 Slews while high (Active High)
* Pulse must be at least 60 milliseconds in length; functions as if pressing the Feed Key,
clearing alarms and advancing media.
66
Page 75
Extended System-Level Command Functions
(HC) Head Cleaning – This command controls the print head cleaning routine. The
entered value specifies the inch (or centimeter) count to reach before prompting a
print head cleaning. If the number specified is exceeded three times, the printer will
fault until cleaning is initiated.
The number specified is multiplied by one thousand, and zero disables this function.
(HE) Heat – See Hnn for command details.
(HT) Host Timeout – This command controls the number of seconds a
communications port must be idle before the printer will process data from a
different port or use a different parsing method. The value is also used to “timeout”
an image / label format download (i.e., if, at any time, data flow stops before a
complete label format is received, the data will be ignored).
(IC) Ignore Control Codes – This command allows the user to remove control
codes (< 20 Hex) in the data field. The selected line terminator is processed. When
enabled, DPL Control Code (SOH, STX, CR, ESC, and ^) characters are removed
from the data string. (Note that some fonts do have printable characters in this
range and they will not be printed when enabled.)
(IE) Ignore Distances – This command, when enabled, prevents <STX>O
processing that will change the start of print position.
67
Page 76
Extended System-Level Command Functions
(IL) Imaging Mode – This command instructs the printer whether to pre-image the
label format:
Value
M Multiple Label
S Single Label
Units /
Interpretation
Imaging Mode Definition
The printer images multiple labels as memory
permits, achieving the fastest throughput; however,
if time-stamping, the time will reflect the moment
the label is imaged rather than when actually
printed.
The printer images the next label only after the
previous label has been successfully printed. Single
processing provides time-stamps that are more
accurate, but it slows label throughput time.
(IM) Internal Module – This command sets the number of 1K blocks allocated for
Module D.
(LE) Legacy Emulation – This command enables the <STX>O and <STX>f print
positioning commands to allow backward compatibility with label formats that were
designed for the Allegro
Equipped, also Prodigy Max
®
Prodigy®, and Prodigy Plus® (If the printer is Display-
®
emulation).
Use causes the printer to ignore Label commands A, M, n, and T.
(LR) Label Rotation – This command sets label rotation, allowing formats to be
flipped 180 degrees.
(LS) Language Select – This command selects the language for the menu system
messages and configuration label. Only languages that are resident will be available.
Language name limited to a twenty character maximum.
(LM) Label Store – This command selects the level of stored format recall to
include the label-formatting command fields, or the label-formatting command fields
and the printer state.
68
Page 77
Extended System-Level Command Functions
(LW) Label Width – This command sets the maximum limit for the printable width.
Objects extending beyond this limit will NOT print; see Appendix K.
(MCC) Module Command – This command adjusts the size of Flash module on the
optional Expansion Card according to the table below (see Appendix K for
appropriate module details):
Value Module Command Units / Interpretation
Zxx
Where xx =
Size: 1 – 7 Mbytes. This is the amount to be allocated to
Module Z; any remaining memory will be allocated to Module F.
Size: 1 – 56, in 128 Kbytes blocks. This is the amount to be
Gxx
Where xx =
allocated to Module G; any remaining memory will be allocated
to Module X.
(ML) Maximum (Label) Length – See <STX>M for command details.
(MM) Menu Mode – This command sets the menu access level of the printer – where User is a basic listing of menu settings and controls.
(MT) Media Type – This command selects the printing method: Direct Thermal for
use with heat sensitive media or Thermal Transfer for use with media requiring a
ribbon to create an image.
(MV) Mark Value – This command sets threshold value for the reflective media
sensor’s “mark” parameter.
69
Page 78
Extended System-Level Command Functions
(NE) Network Configuration – The enhanced configuration two character
identifier for the New Network Configuration Parameters will be ‘NE’ for Network
Ethernet. No Item-Value pairs will be defined for ‘NE’ but there will be the following
Sub-Groups:
General Network Configuration Parameters – Identifier ‘G’
The ‘G’ sub-group contains network configuration parameters that apply ‘globally’
or ‘generally’ to any ethernet interface used. No sub-groups are currently defined
for the ‘G’ sub-group of configuration parameters, only item-value pairs. The
‘Item-Value’ pairs within the ‘G’ sub-group are defined by the following table:
# Name Value Type Description
1 Primary Interface Char Indicates the primary or used ethernet
interface type. Interface types are Wired
Ethernet (802.3) and Wireless Ethernet
(802.11). It is called ‘Primary’ since, in the
future if multiple ethernet interfaces would
be supported, it would be the PRIMARY
interface used.
‘E’=Wired Ethernet
‘W’=WIFI
‘B’=Bluetooth
‘N’=None
2 Network Password String Provides the network password used for
WEB and TELNET sessions.
3 SNMP Enable Boolean Enables or Disables the SNMP services.
4 Telnet Enable Boolean Enables or Disables the TELNET services.
5 FTP Enable Boolean Enables or Disables the FTP Server.
6 HTTP Enable Boolean Enables or Disables the HTTP (WEB Pages)
Server.
7 LPD Enable Boolean Enables or Disables the LPD (Line Printer
Daemon) services.
8 NetBIOS Enable Boolean Enables or Disables the NetBIOS services.
9 Netcenter Enable Boolean Enables or Disables the Netcenter services.
10 Gratuitous ARP Period Decimal Value of the Gratuitous ARP Period in
seconds. 0 = Disabled.
24 WIFI Type Decimal WIFI Module type DO1=4. Values are 0
The ‘WE’ sub-group contains network configuration parameters that apply only to
the Wired Ethernet (802.3 Specification) ethernet interface. No sub-groups are
currently defined for the ‘WE’ sub-group of configuration parameters, only itemvalue pairs. The ‘Item-Value’ pairs within the ‘WE’ sub-group are defined by the
following table:
# Name Value
Type
1 DHCP Enable Char Indicates if the DHCP Protocol is to be used
to automatically obtain all required network
addresses. Formally known as IP
Discovery.
‘N’=Static
‘B’=BootP
‘Y’=DHCP
Note: For Wired Ethernet BootP is
considered as same as DHCP.
2 Static Printer IP
Address
3 Static Printer Subnet
Mask
4 Static Printer Default
Gateway or Router
String Static IP Address for the Printer in dotted
decimal notation.
String Static Subnet Mask for the Printer in dotted
decimal notation.
String Static Default Gateway (Router) IP Address
in dotted decimal notation.
5 PHY Mode Decimal Defines the ethernet PHY Mode (Auto,
9 Printer TCP Port Decimal Value of the TCP Port for Print Services.
Stationarey Printers - Default is 9100;
Portable Printers – Default is 515
11 Static Primary WINS
Server IP Address
12 Static Secondary WINS
Server IP Address
13 Static Primary DNS
Server IP Address
14 Static Secondary DNS
Server IP Address
String Static Primary WINS Server IP Address in
dotted decimal notation.
String Static Secondary WINS Server IP Address
in dotted decimal notation.
String Static Primary DNS Server IP Address in
dotted decimal notation.
String Static Secondary DNS Server IP Address in
dotted decimal notation.
15 SNMP TRAP IP Address String (future) SNMP TRAP IP Address in dotted
decimal notation.
16 SNMP Server Address String (future) SNMP Server IP Address in dotted
decimal notation.
17 NetBIOS Enable Boolean Enables or Disables the NetBIOS services.
18 NetBIOS Name String NetBIOS Name for the Printer.
20 UDP Port String UDP Port number to use for printing;
default 515
21 Inactivity Timeout Value Enter number of seconds of inactivity to
The ‘WIFI’ sub-group contains network configuration parameters that apply only
to the Wireless Ethernet (802.11 Specification) ethernet interface. Four (4) subgroups are currently defined for the ‘WIFI’ sub-group of configuration parameters
and are as follows:
DO Embedded – Identifier ‘DO1’
The previous subgroups which are not supported:
General WIFI Configuration Parameters – Identifier ‘G’ DPAC Version 1 – Identifier ‘DV1’ DPAC Version 2 (Veyron) – Identifier ‘DV2’ SILEX Version 1 – Identifier ‘SV1’
The ‘D01’ WIFI sub-group contains the configuration parameters that are specific
to the D-O WIFI solution that is based on the Green Hills / DeviceScape 802.11
software. The ‘Item-Value’ pairs within the ‘DO1’ sub-group of the ‘WIFI’ subgroup are defined by the following tables:
72
Page 81
Extended System-Level Command Functions
DNS Settings
# Ezprint Name Value Type
1 CTC:SDNS:Y|N Enable Static DNS String – 1
Using Static DNS or not. Default value is “N”.
Description
char long
2 CTC:DNS1:***.***.***.*** Preferred DNS Server IP4 string
IP address for preferred DNS server
format
3 CTC:DNS2:***.***.***.*** Secondary DNS Server IP4 string
IP address for secondary DNS server
format
4 CTC:DSUF:<DNS Suffix> DNS Suffix String 64 characters string + 1 NULL terminated character
Network Settings
# Ezprint Name Value Type
20 CTC:I2:<value> Inactive Timeout Unsigned
short
21 CTC:D:N|B|Y IP address method Unsigned
char
22 CTC:I:xxx.xxx.xxx.xxx Active IP address (READ ONLY)
23 CTC:M:xxx.xxx.xxx.xxx Active Subnet mask (READ
String This field is holding the value of the current active IP
String This field is holding the value of current active Subnet mask
ONLY)
Current connection will terminated if no network traffic
after a specific interval. Default value is 30 seconds
N: use static IP address
B: BootB enable
Y:DHCP enable
address. As the result of the query request:
1. If “IP address method” is set to “use static IP
address”, this field will hold the value of “Static IP
address”.
2. Otherwise, it will hold the value of the current active
IP address.
This field is using for reporting only. In order to set the
value for static IP address, use item number 32.
address.
As the result of the query request:
1. If “IP address method” is set to “use static Subnet
mask address”, this field will hold the value of “Static
Subnet mask address”.
2. Otherwise, it will hold the value of the current active
Subnet mask address.
This field is using for reporting only. In order to set the
value for static Subnet mask address, use item number 33.
Description
73
Page 82
Extended System-Level Command Functions
Network Settings
# Ezprint Name Value Type Description
24 CTC:G:xxx.xxx.xxx.xxx Active Gateway address (READ
ONLY)
String This field is holding the value of current active Gateway
address.
As the result of the query request:
1. If “IP address method” is set to “use static Subnet
mask address”, this field will hold the value of “Static
Gateway address”.
2. Otherwise, it will hold the value of the current active
Gateway address.
This field is using for reporting only. In order to set the
value for static Gate address, use item number 34.
25 CTC:N:<value> Printer DNS name String 64 characters + 1 NULL terminated charater
26 CTC:RDNS:Y|N Register To DNS String- 1
char long
27 CTC:UDNS:Y|N Use DNS Suffix String – 1
char long
28 CTC:P3:<value> UDP port Unsigned
Register Printer Name (~ Station Name) to DNS server.
Default value is “Y”
Using the DNS suffix for a fully qualification name when
referring to the DNS name. Default value is “N”
Default is 515
short
29 CTC:P:<value> TCP port Unsigned
TCP port number. Default is 515
short
30 CTC:CR:N|Y Enable Connection Status Unsigned
char
Y: enable of reporting connection status
N: disable of reporting connection status
31 CTC:DOP:<value> DHCP User Class Option Binary Data This is the data for the User Class Option for DHCP. Max.
length is 257 bytes.
32 Static IP Address String Printer statics IP address. Use this field to set or get the
value of printer static IP address.
33 Static Subnet mask String Printer statics Subnetmask address. Use this field to set or
get the value of printer static Subnet mask address.
34 Static Gateway String Printer static gateway address. Use this field to set or get
the value of printer static Gateway address.
35 LPD Port Unsigned
Default 515
short
36 LPD Enable Boolean Enables or Disables the LPD (Line Printer Daemon) services.
attribute!
48 CTC:W:1|2 WEP data encryption Unsigned
char
CTC:S:0|5|13 WEP AP authentication Unsigned
49
char
50 CTC:K:1|2|3|4 WEP Key Selected Unsigned
char
1: Enable WEP data encryption
2: Allow WEP unencrypted traffic (Default)
Indicate the AP authentication method via WEP. The value
specifies the WEP key length.
0: Open
5: uses Shared Key 40- bit WEP key
13: uses Shared Key 128-bit WEP key
Indicates which WEP key is currently selected for WEP AP
authentication, if specify.
75
Page 84
Extended System-Level Command Functions
WIFI Settings
# Ezprint Name Value Type Description
51 CTC:K1:<key value> WEP Key1 String 10 hexadecimal for 40-bit WEP key or 26 hexadecimal for
128-bit WEP key. Upon on the returning from query, this
field will contains “0”, ”5”, or “13” to specify the length of
WEP key.
52 CTC:K2:<key value> WEP Key2 String 10 hexadecimal for 40-bit WEP key or 26 hexadecimal for
128-bit WEP key. Upon on the returning from query, this
field will contains “0”, ”5”, or “13” to specify the length of
WEP key.
53 CTC:K3:<key value> WEP Key3 String 10 hexadecimal for 40-bit WEP key or 26 hexadecimal for
128-bit WEP key. Upon on the returning from query, this
field will contains “0”, ”5”, or “13” to specify the length of
WEP key.
54 CTC:K4:<key value> WEP Key4 String 10 hexadecimal for 40-bit WEP key or 26 hexadecimal for
128-bit WEP key. Upon on the returning from query, this
field will contains “0”, ”5”, or “13” to specify the length of
WEP key.
55 CTC:Q:Y|N Show Signal Strength Unsigned
char
56 CTC:P2:Y|N Power Saving Mode Unsigned
char
57 CTC:GC: Group Cipher Unsigned
Y: Show signal strength
N: Do not show signal strength (Default)
Y: enable Power Save Mode (Default)
N: disable Power Save Mode
For now, it sets as 4 as SWC_CIPHER_WEP104
short
58 MAC Address String MAC address of the Radio Module, String in format
“XX:XX:XX:XX:XX:XX”
59 Regulatory Domain Unsigned
short
60 Radio Physical Mode Unsigned
char
Regulatory Domain Country Code for International Setting;
Default = 0 (World Wide Roaming), per ISO 3166
1: 802.11 a only
2: 802.11 b/g
3: 802.11 a/b/g
4: 802.11 b only
5: 802.11 g only
61 LPD Enable Boolean Enables or Disables the LPD (Line Printer Daemon) services.
76
Page 85
Extended System-Level Command Functions
(NR) No Reprint – This command controls the label reprint function following the
correction of a fault condition. Upon detection of a fault (ribbon out, paper out, etc.),
printing stops and a fault indicator is illuminated. After the problem is corrected, the
FEED Key must be pressed to clear the fault and resume normal operation. When
enabled, the label in process is not reprinted.
(NS) Disable Symbol Set Selection – This command prevents the <STX>y and y
commands from changing the default single-byte symbol set. When enabled, DPL
Symbol Set commands are ignored.
When enabled, the only way to change the current symbol set is with the <STX>KcAS
(OF) Option Feedback Mode – This command configures the printer to output the
status of the RFID or Scanner option to the active port, as follows.
command.
Value Option Feedback Mode Units / Interpretation
D
= Disable
=
D, Rx, S
Rx
RFID Enable, where x is the response format:A = ASCII
H = Hexadecimal
S
= Scanner Enable
Once enabled, the printer will report information about the results of the last label
printed. One response per label is returned to the host (this includes each voided and
retried label). The format and contents of the returned information is as follows:
77
Page 86
Extended System-Level Command Functions
Response format:
Where:
<A;B;C;D;E;F>[CR]
A
- Device type: R = RFID
S = Scanner
B
- Resulting status: C = entire label complete
F = faulted (failed) label
U = unknown
C
- The number of expected reads for bar codes or tags,
given in two characters.
D
- The number of good reads for bar codes or tags, given in
two characters.
E
- The printer’s internal Job Identifier and Sub Job
Identifier, given in four characters each.
F
- The data read, delimited with semicolons (;) if multiple
reads.
RFID response sample differences: Since RFID commands vary in operation, the
data returned also differs. Write commands return entire tag data; Write/Verify
commands return the data written; and, Read commands return data and length
requested in the specified format. (See Appendix S for a listing of commands.)
(PC) Print Contrast – This command adjusts the relative print edge (gray)
component of the print quality, which allows fine-tuning for specific media/ribbon
mix.
(PD) Present Distance – This command sets the label stop position past the start
of print. When the next label format is received, the printer will automatically
backfeed to the start position. If the present distance is set to zero, the printer will
operate without reversing. (See Stop Location, below).
(PE) Peel Mode – This command, when enabled, specifies that a Feed operation be
prevented when the label is presented and not removed, or if the printer is to wait
for the GPIO start of print signal.
(PJ) Present Adjust Fine Tune – This command fine-tunes the Present Distance
setting in dots to compensate for slight mechanical differences sometimes evident if
multiple printers share label formats.
(PL) Printer Level – This command is used to upgrade the software feature level of
the printer.
(PM) Pause Mode – See <STX>J for command details.
79
Page 88
Extended System-Level Command Functions
(PO) Paper Empty – This command sets the length of travel before an out of stock
condition is declared.
(PP) Parallel Direction – This command controls the parallel port communications
settings:
Value Parallel Direction Units / Interpretation
x = Port ID
xz
z = Direction: U (unidirectional – one-way communication); or,
B (bidirectional – IEEE 1284 back-channel operation).
(PS) Present Sensor Equipped – This command allows the printer to sense the
present sensor option. A (or Y) - automatically senses device presence; if
undetected, no error will be generated. E - enables the device, where its presence
must be detected; otherwise, a fault is generated. N or D - disables device detection.
See <STX>V for command details.
(pS) Print Speed – See Label Formatting Command Function P for details.
(PT) Tear Position – This command sets the label stopping location at the tear
plate on the printer’s cover.
80
Page 89
Extended System-Level Command Functions
(PV) Paper Value – This command sets threshold value for the media sensor’s
“paper” parameter.
(PW) Password Set – This command modifies the numeric password required to
access the menu when security is enabled. If security is enabled, enter the new
password followed by the old password (with no spaces) in this form: XXXXXXXX
To be activated, the default password (0000) must be changed.
(QQ) Configuration Query – This command requires a parameter of either K or Q.
K causes the printer to respond with the Printer Key, used for generating Upgrade
Codes. A parameter value of Q causes the printer to respond with the current
configuration settings. The <STX>Kc response command stream format is sent to the
host computer via the same port as the query containing all parameters controlled
by the <STX>Kc command, and may be used for restoring the printer’s configuration
or for configuring other printers.
(RE) Ribbon Saver Equipped – This command allows the printer to sense the
ribbon saver option. A (or Y) - automatically senses device presence; if undetected,
no error is generated. E - enables the device, where its presence must be detected;
otherwise, a fault is generated. N or D - disables device detection. See <STX>R for
command details.
(RF) Row Adjust Fine Tune – This command shifts the vertical start of print
position in dots (see Appendix K) upward or downward.
81
Page 90
Extended System-Level Command Functions
(RI) RFID Configuration – This command configures the optional RFID interface module, as follows:
ValueUnits / InterpretationRFID Configuration Definition / Function
AIhh
ALn
Bn
DIhh
DLn
En
Lhh
where hh: 2-Chararacter Hex ID Sets the Application Family Identifier (AFI), HF only.
and where n:
E = Enable,
D = Disable
D = Disable
Allows locking the AFI after writing (HF only).
Disables padding or truncating of data (EPC only).
Nulls are represented as “00”.
For Hex EPC data a 96-bit tag size is 24 characters and 64-bit is 16.
For ASCII EPC data a 96-bit tag size is 12 characters and 64-bit is 8.
where n:
1 = Leading
2 = Trailing
If the data is less than the selected EPC tag data size, nulls will be added to the
front (left); or, if too much data is given, the data will be cut.
If the data is less than the selected EPC tag data size, nulls will be added to the
back (right); or, if too much data is given, the data will be cut.
where hh: 2-Chararacter Hex ID Sets the Data Storage Format Identifier (DSFID), HF only.
and where n:
where n:
E = Enable,
D = Disable
E = Enable,
D = Disable
Allows locking the DSFID after writing (HF only).
Allows erasures of the tag on error (HF only).
where hh: 2-Chararacter Hex ID Sets the Lock Code (Alien UHF only).
D = Disable Disables the RFID module. (“N” is also a valid disabler.)
Mn
where n:
H = HF Enables the RFID module for HF (Securakey).
U = UHF Enables the RFID module for UHF Class 1 (Alien).
M = UHF Enables the RFID module for UHF Multiprotocol.
(continued)
82
Page 91
Extended System-Level Command Functions
ValueUnits / InterpretationRFID Configuration Definition / Function
Nn
Pxxx
Rn
Shh
Tn
Un
Vn
where n:
64 = 64-bit
96 = 96-bit
Sets the UHF tag data size (Multiprotocol UHF only).
Sets the tag encoding position: A value of 0.00 causes the print position to be
where xxx: 3-Digit Value
used; or, a value greater than 0 causes the presented position to be used.
(Subject to change.)
where n: 0 – 9 Sets the number of retries for RFID functions.
where hh: 2-Chararacter Hex ID
Sets the Electronic Article Surveillance (EAS) set, representing the
manufacturer’s code (HF only).
0 = ISO 15693,
1 = Texas Instruments,
where n:
2 = Philips,
Establishes the tag type (HF only).
3 = ST Micro LRI 512,
4 = ST Micro LRI 64
0 = EPC 0
1 = EPC 0+ Matrics
2 = EPC 0+ Impinj
where n:
3 = EPC 1
Sets the UHF tag type (Multiprotocol UHF only).
6 = UCODE EPC 1.19
7 = EM 4022/4222
8 = Gen 2
where n: -4 to +4 Adjusts the power, in dBmn (Multiprotocol UHF only).
The above example sets the printer to HF, protect after write AFI 11, protect after write DFSID 22, set EAS Bit (Mfg. Code
0x04), allow 3 tries for each read or write attempt, lock after writing, erase the tag if there is an error, and use a position of
0.00.
83
Page 92
Extended System-Level Command Functions
(RL) Ribbon Low Diameter – This command sets the threshold for a low ribbon
indication, where nnnn is the diameter in hundredths of inches.
(RM) Rewinder Equipped – This command allows the printer to sense the powered
internal rewind option. A (or Y) - automatically senses device presence; if
undetected, no error is generated. E - enables the device, where its presence must
be detected; otherwise, a fault is generated. N or D - disables device detection.
(RO) Row Offset – See Rnnnn (in Label Formatting Command Functions) for
command details.
(RP) Ribbon Low Pause - This command (when enabled) pauses the printer when
a Ribbon Low Diameter warning is declared; the PAUSE Button must be pressed to
continue printing.
(RR) Rewinder Adjust – This command changes the torque applied by the
powered rewinder, in percentage points of the nominal force, to minimize TOF
registration drift (sometimes evident when using small or narrow media).
(RS) Ribbon Low Signal – This command sets the signal output type for the
Ribbon Low Diameter condition when using the optional GPIO (see Appendix J).
(RV) Reflective Paper Value – This command sets the threshold value for the
reflective media sensor’s paper parameter.
(RW) Retract Delay – This command sets a time delay for the retraction of a
presented label, where the time specified is multiplied by ten milliseconds.
84
Page 93
Extended System-Level Command Functions
(SA) SOP Adjust – This command sets the start of print (SOP) location, relative to
the top of form. See <STX>O for command details. The EX2 accepts this command for
backward compatibility only, limited in range (28-228).
(SC) Scalable Cache – This command sets the number of 1K blocks allocated for
the scaleable font engine. Available memory dependent upon model; see Appendix
K.
(SE) SOP Emulation – This command enables the <STX>O and <STX>f print
positioning commands to allow backward compatibility with label formats designed
for other printers.
(SF) Save As Filename – This command, which may be sent separately or included
as the last command in an <STX>Kc command string, saves the effective printer
configuration to a file in Flash memory with a .dcm file extension.
(SG) Sensor Gain Value – This command sets the control of the voltage to the LED
emitter of the Media Sensor.
85
Page 94
Extended System-Level Command Functions
(Sl) Security Lock – This command provides the ability to password-protect the
User Interface, as follows:
Value Security Function
Nxxxx
Yxxxx
Txxxx
Where xxxx is the current password, this disables Menu protection.
Where xxxx is a new password, this enables Menu protection and sets a new
password.
Where xxxx is a new password, this enables Menu protection, disables Test
functions, and sets a new password.
To be activated, the default password (0000) must be changed.
(SL) Stop Location – This command sets the label stopping (and in certain cases
the starting) location, as follows:
Value Stop Location
A
Automatically sets the stop location. Installed options will be “auto-sensed”
and the appropriate stop position will automatically be set. Host commands
are ignored.
Sets stop position according to options installed. If no options are installed the
printer sets stop location to the next label’s start of print. Host commands will
H
P
C
T
N
override. The stop location (present distance) may be controlled dynamically
by the host using the <STX>f or <STX>Kf commands. This selection has the
same effect as <STX>KD Ignore Host Distance bit value 0.
Sets the stop location at approximately two millimeters behind the peel bar
edge, a nominal peel position. The Present Sensor status and this setting are
independent.
Sets the stop location to a nominal cut position. For die-cut media, the
position is just following the end of the label. The cutter status and this setting
are independent.
Sets the stop location at the tear bar.
Sets the stop location to the start of the next label, equivalent to setting the
<STX>KD Ignore Host Distance bit value 1.
86
Page 95
Extended System-Level Command Functions
(SM) Maximum (Label) Length Ignore – This command controls recognition of
the <STX>M command.
(SN) Scanner Configuration – This command configures the linear scanner, as
follows:
Values Scanner Configuration Range / Interpretation
Bar Code Type – Specifies the bar code, using two digits, followed by “Y” (to
enable) or “N” (to disable) the code, where:
The specified distance should not exceed 50% of the measured bar
code height.
Mode – Enables detection of the scanner by the printer, where:
M
A = Auto (automatically senses presence); Y is also a valid enabler.
E = Enabled (if not detected a fault is generated).
D = Disabled (the scanner is disabled); (N is also a valid disabler.)
(continued)
87
Page 96
Extended System-Level Command Functions
Values Scanner Configuration Range / Interpretation
Redundancy Level – An alternative data integrity method, where the selected
level sets the number of consecutive, identical decodes required to pass the
bar code. If differing values are read, the count is restarted, where:
The example above configures Serial Port A to use hardware and software
handshaking, an eight-bit word, with no parity and one stop bit at 19,200 bits per
second.
89
Page 98
Extended System-Level Command Functions
(SS or sS) Feed Speed – This command controls the rate of label movement
between printing areas; see Appendix L.
(ST) Sensor Type – G for edge / gap, R for (reflective / black mark) or C for
continuous.
(SV) Switch Settings – This command controls recognition of the software switch
setting command <STX>V.
(TB) TOF Bias – This command controls the low-level voltage difference level to
recognize a label “gap” or “mark”.
(TD) TOF Delta – This command controls the low-level voltage difference level to
recognize a label “gap” or “mark”.
(TG) TOF Gain – This command controls the voltage to the LED emitter of the
Media Sensor.
(TN) No Paper Min – This command sets the media sensor level for the Out of
Stock (OOS) condition.
(TP) TOF Precedence – This command instructs the firmware to stop printing at
the first top of form mark it detects. The default (“No”) prints all of the data
(traversing the top of form as necessary) then slews to the next TOF.
90
Page 99
Extended System-Level Command Functions
(UD) User Label Mode – This command places the printer in standalone operation,
which provides menu-driven processes to print user defined files, including
.dpl, .prn, .txt formats.
(UM) Units of Measure – See <STX>m (metric) or <STX>n (imperial) for command
details.
(UN) Plug and Play ID Type – This command controls the type of Plug and Play ID
supplied; where Y is for unique and N for static.
(UT) User Terminator – This command allows word wrapping of long character
strings of commands to the next line in a file, for the purposes of readability only. In
the <STX>Kc string, the command UTON must fall somewhere before the first line
terminator. The last command needs to be END, followed by a line terminator (see
the <STX>KcEN command for details).
(VE) Verifier Equipped – This command enables the GPIO for a bar code verifier
(see Appendix J). A (or Y) - automatically senses device presence; if undetected, no
error is generated. E - enables the device, where its presence must be detected;
otherwise, a fault is generated. N or D - disables device detection.
(VT) Verifier Type – This command is reserved for future use.
.dlb,
91
Page 100
Extended System-Level Command Functions
<
z
<CR>
STX KD Database Configuration
This command, stored in Flash memory for future power-ups, controls the printer’s
environment and operates as a pseudo DIP switch. The <STX>Kc command is
recommended for use over <STX>KD.
Syntax:
Where:
Sample:
•
Ignore Host Distance (see below) disregards <STX>O and <STX>f commands (in case
host software sends values that may be inappropriate). Use the <STX>KD command or
the Setup Menu to enable this feature.
STX>KDwxy
w, x, y, and z are binary values with respective bit settings as
defined in the following table. (Bit 0 is least significant.)
<STX>KD@H@@<CR>
The sample above configures 9600 baud, 8-bit words, no parity,
with direct thermal printing, gap sensing, standard control
characters, and a cutter.
<STX>KD
Parameter
w
x
y
z
[1]
Selects the values of the control characters; see Control Code Command Functions.
Bit
Number
0 – 2 BAUD Rate / Set Test Mode
3 Word Length and Parity
4 & 5 Unused Set to 0
6 Always 1 Set to 1
7 Always 0 Set to 0
0 Print Method 0 = direct thermal, 1 = thermal transfer
1 Present Sensor 0 = not equipped, 1 = equipped
2 Control Character
3 Cutter 0 = disabled, 1 = enabled