epl programming language
TRANSCRIPT
-
8/12/2019 EPL Programming Language
1/331
EPL Programming
Guide
-
8/12/2019 EPL Programming Language
2/331
2007 ZIH Corp. The copyrights in this manual and the software and/or firmware in the label printer describedtherein are owned by ZIH Corp. Unauthorized reproduction of this manual or the software and/or firmware in thelabel printer may result in imprisonment of up to one year and fines of up to $10,000 (17 U.S.C.506). Copyrightviolators may be subject to civil liability.
This product may contain EPL, EPL2, ZPL, ZPL II, and ZebraLink programs; Element Energy Equalizer
Circuit; E3
; and Monotype Imaging fonts. Software ZIH Corp. All rights reserved worldwide.
ZebraLink and all product names and numbers are trademarks, and Zebra, the Zebra logo, ZPL, ZPL II, ElementEnergy Equalizer Circuit, and E3Circuit are registered trademarks of ZIH Corp. All rights reserved worldwide.
All other brand names, product names, or trademarks belong to their respective holders. For additional trademarkinformation, please see Trademarks on the product CD.
Proprietary Statement This manual contains proprietary information of Zebra Technologies Corporation and itssubsidiaries (Zebra Technologies). It is intended solely for the information and use of parties operating andmaintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosedto any other parties for any other purpose without the express, written permission of Zebra Technologies Corporation.
Product Improvements Continuous improvement of products is a policy of Zebra Technologies Corporation.All specifications and designs are subject to change without notice.
Liability Disclaimer Zebra Technologies Corporation takes steps to ensure that its published Engineeringspecifications and manuals are correct; however, errors do occur. Zebra Technologies Corporation reserves the rightto correct any such errors and disclaims liability resulting therefrom.
Limitation of Liability In no event shall Zebra Technologies Corporation or anyone else involved in the creation,production, or delivery of the accompanying product (including hardware and software) be liable for any damageswhatsoever (including, without limitation, consequential damages including loss of business profits, businessinterruption, or loss of business information) arising out of the use of, the results of use of, or inability to use suchproduct, even if Zebra Technologies Corporation has been advised of the possibility of such damages. Somejurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation
or exclusion may not apply to you.
Part Number: 14245L-001 A
-
8/12/2019 EPL Programming Language
3/331
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Contents
About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Contacts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
The Americas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Europe, Africa, Middle East, and India . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Asia Pacific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Document Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Whats New in this Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Command Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Basic Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Command Editor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Sending Commands Directly to the Printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Sending Command Programming Files to the Printer . . . . . . . . . . . . . . . . . . . . . . . . 23
Transferring files with the Firmware Downloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Downloading a File in the DOS Enviroment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Placing Elements in the Print Image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Text (Fonts) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Language Character Sets (Fonts 1-5) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Asian Character Sets (Fonts 8 & 9) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chinese Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chinese Fonts 8 & 9 Double-Byte Ideographic Characters . . . . . . . . . . . . . . . . . . . . 30
Japanese Character Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Japanese Fonts 8 & 9 Double-Byte Ideographic Characters . . . . . . . . . . . . . . . . . . . 30
Korean Character Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Korean Font 8 Double-Byte Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
-
8/12/2019 EPL Programming Language
4/331
Contents4
14245L-001 Rev. A EPL Programming Guide 5/30/07
Bar Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
QR Code Bar Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Programming Sequences Affect Graphic Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2 Printer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Explanation of the Status Printout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Determining Printer Firmware Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Programming Mode Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Manually Setting Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Media Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3 EPL Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Memory and Command Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Command Description Memory Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
A ASCII Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Variable Data and Counter Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Data with the RTC Time & Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
A Simple Expressions in Data Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Asian Character Font Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
AUTOFR Automatic Form Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
B Bar Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
B RSS-14 Bar Code Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Data with the RTC Time & Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
b 2D Bar Code Aztec Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
b 2D Bar Code Aztec Mesa Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
b 2D Bar Code Data Matrix Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Automatic Data Matrix Bar Code Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
b 2D Bar Code MaxiCode Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Using AIM Specified MaxiCode Data Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
b 2D Bar Code PDF417 Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74PDF 417: General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
PDF 417 Symbol Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Automatic PDF 417 Bar Code Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
b 2D Bar Code QR Code Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
C Counter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
C Cut Immediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85D Density . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
dump Enable Dump Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
EI Print Soft Font Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
EK Delete Soft Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
eR User Defined Error/Status Character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
ES Store Soft Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
-
8/12/2019 EPL Programming Language
5/331
5Contents
5/30/07 EPL Programming Guide 14245L-001 Rev. A
f Cut Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
fB Adjust Backup Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
FE End Form Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
FI Print Form Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
FK Delete Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100FR Retrieve Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
FS Store Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
GG Print Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
GI Print Graphics Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
GK Delete Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
GM Store Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
GW Direct Graphic Write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
i Asian Character Spacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
I Character Set Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
JB Disable Top Of Form Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
JC Disable Top Of Form Backup- All Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
JF Enable Top Of Form Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
LE Line Draw Exclusive OR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
LO Line Draw Black . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
LS Line Draw Diagonal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
LW Line Draw White . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
M Memory Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
N Clear Image Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
o Cancel Software Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
oB Cancel Auto Bar Code Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
oE Line Mode Font Substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
oH Macro PDF Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
oM Disable Initial Esc Sequence Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
oR Character Substitution (Euro) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
oW Customize Bar Code Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
O Hardware Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
OEPL1 Set Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Returning to Page Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132P Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
PA Print Automatic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
q Set Label Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Q Set Form Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
r Set Double Buffer Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
R Set Reference Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
S Speed Select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
-
8/12/2019 EPL Programming Language
6/331
Contents6
14245L-001 Rev. A EPL Programming Guide 5/30/07
TD Date Recall & Format Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
TS Set Real Time Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
TT Time Recall & Format Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
U Print Configuration (General) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
UA Enable Clear Label Counter Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147UB Reset Label Counter Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
UE External Font Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
UF Form Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
UG Graphics Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
UI Host Prompts/Codepage Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
UM Codepage & Memory Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
UN Disable Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
UP Codepage & Memory Inquiry/Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
UQ Configuration Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
US Enable Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
UT Enable Alternate Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
U% Host Prompts/Motor Temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
U$ Host Prompts/Battery Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
V Define Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
W Windows Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
xa AutoSense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
X Box Draw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Y Serial Port Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Z Print Direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
? Download Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
^@ Reset Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
^default Set Printer to Factory Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
^ee Error Report - Immediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
; Code Comment Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
4 SGD Printer Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
setvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
getvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
do Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Command Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
How to Send Multiple SGD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
appl.bootblock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
appl.name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
device.languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
ip.active_network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
-
8/12/2019 EPL Programming Language
7/331
7Contents
5/30/07 EPL Programming Guide 14245L-001 Rev. A
ip.ftp.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
ip.http.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
ip.lpd.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
ip.pop3.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
ip.pop3.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
ip.pop3.poll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
ip.pop3.server_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
ip.pop3.username . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
ip.primary_network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
ip.smtp.domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
ip.smtp.enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
ip.smtp.server_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
ip.snmp.get_community_name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
ip.snmp.set_community_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
ip.telnet.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
ip.snmp.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198ip.tcp.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
ip.udp.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
media.printmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
odometer.headclean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
odometer.headnew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
odometer.label_dot_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
odometer.media_marker_count1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
odometer.media_marker_count2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
odometer.total_print_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
5 SGD Wired Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
setvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
getvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
do Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
Command Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
How to Send Multiple SGD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
external_wired.ip.addr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
external_wired.ip.arp_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
external_wired.ip.default_addr.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
external_wired.ip.dhcp.cid_all. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
external_wired.ip.dhcp.cid_enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
external_wired.ip.dhcp.cid_prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
external_wired.ip.dhcp.cid_suffix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
external_wired.ip.dhcp.cid_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
external_wired.ip.gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
external_wired.ip.netmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
external_wired.ip.port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
-
8/12/2019 EPL Programming Language
8/331
Contents8
14245L-001 Rev. A EPL Programming Guide 5/30/07
external_wired.ip.protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
external_wired.ip.timeout.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
external_wired.ip.timeout.value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
external_wired.mac_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
internal_wired.ip.addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
internal_wired.ip.arp_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
internal_wired.ip.default_addr.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
internal_wired.ip.dhcp.cid_all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
internal_wired.ip.dhcp.cid_enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
internal_wired.ip.dhcp.cid_prefix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
internal_wired.ip.dhcp.cid_suffix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
internal_wired.ip.dhcp.cid_type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
internal_wired.ip.gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
internal_wired.ip.netmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
internal_wired.ip.port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
internal_wired.ip.protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239internal_wired.ip.timeout.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
internal_wired.ip.timeout.value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
internal_wired.mac_addr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
6 SGD Wireless Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
setvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
getvar Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
do Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Command Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
How to Send Multiple SGD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
card.inserted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
card.mac_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
ip.addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
ip.arp_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
ip.bootp.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
ip.dhcp.cid_all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
ip.dhcp.cid_enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
ip.dhcp.cid_prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
ip.dhcp.cid_suffix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
ip.dhcp.cid_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
ip.dhcp.enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
ip.gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
ip.netmask. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
ip.port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
wlan.adhocautomode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
wlan.adhocchannel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
wlan.associated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
-
8/12/2019 EPL Programming Language
9/331
9Contents
5/30/07 EPL Programming Guide 14245L-001 Rev. A
wlan.channel_mask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
wlan.essid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
wlan.firmware_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
wlan.ip.addr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
wlan.ip.arp_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
wlan.ip.default_addr.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
wlan.ip.dhcp.cid_all. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
wlan.ip.dhcp.cid_enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
wlan.ip.dhcp.cid_prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
wlan.ip.dhcp.cid_suffix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
wlan.ip.dhcp.cid_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
wlan.ip.gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
wlan.ip.netmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
wlan.ip.port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
wlan.ip.protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
wlan.ip.timeout.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279wlan.ip.timeout.value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
wlan.keep_alive.enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
wlan.keep_alive.timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
wlan.kerberos.kdc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
wlan.kerberos.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
wlan.kerberos.realm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
wlan.kerberos.username. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
wlan.mac_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
wlan.operating_mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
wlan.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289wlan.preamble. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
wlan.private_key_password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
wlan.roam.interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
wlan.roam.signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
wlan.security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
wlan.signal_noise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
wlan.signal_quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
wlan.signal_strength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
wlan.station_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
wlan.tx_power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300wlan.tx_rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
wlan.username . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
wlan.wep.auth_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
wlan.wep.index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
wlan.wep.key1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
wlan.wep.key2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
wlan.wep.key3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
wlan.wep.key4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
-
8/12/2019 EPL Programming Language
10/331
Contents10
14245L-001 Rev. A EPL Programming Guide 5/30/07
wlan.wep.key_format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
wlan.wpa.psk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
A SGD Command Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Printer and Firmware Compatibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
B Character References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Default Character Map Code Page 437 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Euro Character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Dump Mode Character Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
C 2746e Print Odometer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
ELP2 Odometer Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
oL Print Head Life Reminder Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
oLn Disable Print Head Life Reminder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
oLy Enable Print Head Life Reminder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
URH Print Head History Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
URL Read Print Odometers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
URR Print Odometer Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
http://-/?-http://-/?- -
8/12/2019 EPL Programming Language
11/331
5/30/07 EPL Programming Guide 13979L-002 Rev. A
Functional Table of
Contents for EPLCommands
2D Bar Code Aztec Mesa Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2D Bar Code Aztec Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
2D Bar Code Data Matrix Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2D Bar Code MaxiCode Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2D Bar Code PDF417 Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2D Bar Code QR Code Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Adjust Backup Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
ASCII Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Asian Character Spacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Automatic Form Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
AutoSense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Bar Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Box Draw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Cancel Auto Bar Code Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Cancel Software Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Character Set Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Character Substitution (Euro) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Clear Image Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Code Comment Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Codepage & Memory Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Codepage & Memory Inquiry/Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Configuration Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Counter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Customize Bar Code Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Cut Immediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Cut Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Date Recall & Format Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Define Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Delete Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
http://-/?- -
8/12/2019 EPL Programming Language
12/331
Functional Table of Contents for EPL Commands12
13979L-002 Rev. A EPL Programming Guide 5/30/07
Delete Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Delete Soft Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Density . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Direct Graphic Write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Disable Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Disable Initial Esc Sequence Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Disable Print Head Life Reminder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Disable Top Of Form Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Disable Top Of Form Backup- All Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Download Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Enable Alternate Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Enable Clear Label Counter Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Enable Dump Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Enable Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Enable Print Head Life Reminder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Enable Top Of Form Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114End Form Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Error Report - Immediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
External Font Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Form Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Graphics Information Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Hardware Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Host Prompts/Battery Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Host Prompts/Codepage Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Host Prompts/Motor Temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Line Draw Black . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Line Draw Diagonal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Line Draw Exclusive OR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Line Draw White . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Line Mode Font Substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Macro PDF Offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Memory Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Print Automatic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Print Configuration (General) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Print Direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Print Form Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Print Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Print Graphics Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Print Head History Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Print Head Life Reminder Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Print Odometer Status Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Print Soft Font Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Read Print Odometers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
-
8/12/2019 EPL Programming Language
13/331
13Functional Table of Contents for EPL Commands
5/30/07 EPL Programming Guide 13979L-002 Rev. A
Reset Label Counter Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Reset Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Retrieve Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
RSS-14 Bar Code Specific Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Serial Port Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Set Double Buffer Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Set Form Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Set Label Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Set Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Set Printer to Factory Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Set Real Time Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Set Reference Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Simple Expressions in Data Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Speed Select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Store Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Store Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Store Soft Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Time Recall & Format Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
User Defined Error/Status Character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Windows Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
-
8/12/2019 EPL Programming Language
14/331
Functional Table of Contents for EPL Commands14
13979L-002 Rev. A EPL Programming Guide 5/30/07
Notes ___________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
-
8/12/2019 EPL Programming Language
15/331
5/30/07 EPL Programming Guide 14245L-001 Rev. A
About This Document
This section provides you with contact information, document structure and organization, andadditional reference documents.
Contents
Who Should Use This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
-
8/12/2019 EPL Programming Language
16/331
About This Document
Who Should Use This Document16
14245L-001 Rev. A EPL Programming Guide 5/30/07
Who Should Use This Document
This Guide is for programmers who are familiar working with programming languages.
How This Document Is OrganizedThe Guide is set up as follows:
Section Description
Introduction Provides a high-level overview about this guideand EPL.
Printer Configuration Covers interpreting your printers configurationsetup and setting basic modes.
EPL Commands Contains the complete alphabetical listing of EPL
commands.SGD Printer Setting Commands Provides a high-level overview of printer setting
Set / Get / Do (SGD) commands.
SGD Wired Commands Provides a high-level overview of the wiredSet / Get / Do (SGD) commands.
SGD Wireless Commands Provides a high-level overview of the wirelessSet / Get / Do (SGD) commands.
Appendixes The appendixes include:
Character References
2746e Print Odometer
SGD Command Support
-
8/12/2019 EPL Programming Language
17/331
17About This DocumentContacts
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Contacts
You can contact Zebra Technologies at the following:
Web Site
http://www.zebra.com
Technical Support via the Internet is available 24 hours per day, 365 days per year. Go tohttp://www.zebra.com/support.
The Americas
Europe, Africa, Middle East, and India
Asia Pacific
Regional Headquarters Technical Support Customer Service Dept.
Zebra Technologies International,
LLC
333 Corporate Woods ParkwayVernon Hills, Illinois 60061.3109
U.S.A
T: +1 847 793 2600
Toll-free +1 800 423 0422
F: +1 847 913 8766
T: +1 847 913 2259
F: +1 847 913 2578
Hardware: [email protected]
Software: [email protected]
For printers, parts, media, and ribbon,
please call your distributor, or
contact us.
T: +1 877 ASK ZEBRA (275 9327)
Regional Headquarters Technical Support Internal Sales Dept.
Zebra Technologies Europe Limited
Zebra House
The Valley Centre, Gordon Road
High Wycombe, HP13 6EQ, UK
Buckinghamshire
T: +44 (0)1494 472872
F: +44 (0) 1494 450103
T: +44 (0) 1494 768298
F: +44 (0) 1494 768210
Germany: [email protected]
France: [email protected]
Spain/Portugal: [email protected]
All other areas: [email protected]
For printers, parts, media, and ribbon,
please call your distributor, or
contact us.
T: +44 (0) 1494 768316
F: +44 (0) 1494 768244
Regional Headquarters Technical Support Customer Service
Zebra Technologies Asia Pacific, LLC
120 Robinson Road
#06-01 Parakou BuildingSingapore 068913
T: +65 6858 0722
F: +65 6885 0838
T: +65 6858 0722
F: +65 6885 0838
E: China: [email protected] other areas:
For printers, parts, media, and ribbon,
please call your distributor, or
contact us.T: +65 6858 0722
F: +65 6858 0836
http://www.zebra.com/http://www.zebra.com/supporthttp://www.zebra.com/supporthttp://www.zebra.com/ -
8/12/2019 EPL Programming Language
18/331
About This Document
Document Conventions18
14245L-001 Rev. A EPL Programming Guide 5/30/07
Document Conventions
The following conventions are used throughout this document to convey certain information.
Alternate Color (online only) Cross-references contain hot links to other sections in thisguide. If you are viewing this guide online in .pdf format, you can click the cross-reference(blue text) to jump directly to its location.
Command Line Examples Command line examples appear in CourierNew font. Forexample, type ZToolsto get to the Post-Install scripts in the bindirectory.
Files and Directories File names and directories appear in Courier Newfont. Forexample, the Zebra.tarfile and the /root directory.
Icons Used
Important Advises you of information that is essential to complete a task.
Note Indicates neutral or positive information that emphasizes or supplements importantpoints of the main text.
Example Provides an example, often a scenario, to better clarify a section of text.
-
8/12/2019 EPL Programming Language
19/331
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Introduction
This section contains information about the basic features, command syntax, and terminologyof the EPL2 programming language for Zebra's desktop printers with flash memoryarchitecture. These printers incorporate common programming code sets and architecturalfeatures.
The primary operating mode for the printer is EPL2, a page description language. EPL2 is anideal language for your labeling and bar code requirements. To speed printing, it is designed toassemble all of the elements of the label prior to printing. EPL2 is versatile and capable ofprinting graphics, a wide range media, and bar codes.
Some direct thermal printer models also include a legacy printer compatibility mode, LineMode. Line Mode supports our early model EPL programming language - ELP1. A separate
manual is provided for Line Mode printing. See the printer s Software and Documentation CDfor the programmers manual that applies to your printer, or visit our web site at:www.zebra.com
Whats New in this Document
Newly added to this programming guide are Set/Get/Do (SGD) commands. SGD commandsare commands that allow you to configure printers and have the printer perform the specifiedfunction immediately after receiving the command.
See SGD Command Supporton page 311to determine if these commands are compatible withyour printer/firmware combination.
-
8/12/2019 EPL Programming Language
20/331
Introduction20
14245L-001 Rev. A EPL Programming Guide 5/30/07
Command Conventions
The manual uses the following typographic conventions to describe commands.
Basic Command Syntax
Each command consists of one or two ASCII (case sensitive) alpha characters to identify thespecific command desired. Some commands require one or more additional parameters tosupply the printer with sufficient information to complete the command. Refer to Figure 1- forthe basic command syntax.
Figure 1 Basic Command Syntax
Example Description
A Commands (case sensitive)p1,p2,p3 Required parameters
[p,p,p] Optional parameters
{Choice 1|Choice2} Indicates a mandatory choice between two or more items. Youmust include one of the items unless all of the items are alsoenclosed in square brackets.
NAME The name of a form or graphic in double quote marks.
DATA The text or bar code data in double quote marks. Thebackslash (\) character designates the following character is aliteral and will encode into the data field.
PROMPT An ASCII text field that will be transmitted to the host (via theserial interface) each time this command is executed.
Important All commands and alpha character command parameters are case sensitive!
To Print Enter into data field
"
Company
\
\code\
\"
\Company\
\\
\\code\\
A p ,p ,p ,p ,p ,p ,p ,"DATA"1 2 3 4 5 6 7
Command Parameters CommandSpecific
Data
WRITE TEXT
Command Name
http://www.zebra.com/http://www.zebra.com/ -
8/12/2019 EPL Programming Language
21/331
21Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Each command line must be terminated with a Line Feed (LF) character (Dec. 10). Most PCbased systems send CR/LF when the Enter key is pressed. The Carriage Return (CR) characteris ignored by the printer and cannot be used in place of LF.
Command Editor
One method to create command files is through an ASCII-based text editor. In the DOSenvironment, MS-DOS EDIT or BRIEF are good choices. In the Windows environment,TextPad for Windows is a good choice and is available for download of a free evaluationcopy at: www.textpad.com
Sending Commands Directly to the Printer
The easiest method available in the Microsoft Windows environment is to use the ZebraUniversal Printer Driver (ZUD) for sending single EPL Page Mode commands to the printer.This method supports all of the printer interfaces. If you have successfully installed the printer
and its printer driver, you can use the following procedure:
1. Find and open your printer in the Windows Start > Settings > Printers and Faxes selection.
2. In the newly opened Printers and Faxes window, left click a single time to select yourprinter and then right click to open a menu window.
3. Click on the Properties menu selection.
http://www.textpad.com/http://www.textpad.com/ -
8/12/2019 EPL Programming Language
22/331
Introduction22
14245L-001 Rev. A EPL Programming Guide 5/30/07
4. Click on the Printer Tab.
5. Click on the plus sign in front of Advanced to expand the selections available.
6. Click on the Tools button.
7. Click in Direct Command for Printer and begin typing EPL Page Mode printer commands.Press the Send button to send a single command. Do not use the Enter key on the keyboard; it is the same thing as pressing the OK button (to exit the Tools window).
Printer Tab
Click to expand(Advanced)
-
8/12/2019 EPL Programming Language
23/331
23Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Sending Command Programming Files to the Printer
Page Mode programming files can be sent to the printer from Windows operating systems byusing the Zebra Firmware Downloader (found on the users CD or at www.zebra.com. In theDOS enviroment, use the Copy command at the command prompt. The easiest method is to
use the Zebra Firmware Downloader to transfer files to the printer.
Transferring files with the Firmware Downloader
1. Install the printer. Verify communication is working properly by printing a PrinterConfiguration or Test using the printer's driver properties window. See SendingCommands Directly to the Printeron page 21for more details.
2. Install the Zebra Firmware Downloader on your system by selecting Start > Programs >Zebra > Firmware Downloader.
3. From the Printer menu, select Auto-Detect.
http://www.zebra.com/http://www.zebra.com/ -
8/12/2019 EPL Programming Language
24/331
-
8/12/2019 EPL Programming Language
25/331
25Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Placing Elements in the Print Image
Image elements are located in the image print buffer on an X-Y grid expressed in dots. The Xvalue represents the width and the Y value represents the height of the grid.
The point of origin (the starting point) for a non-rotated object is the upper left corner. As anobject rotates, the point of origin rotates with the object.
These image buffer properties are depicted graphically in the following illustration.
Figure 2 Sample Format
The minimum non-printing margin on all edges of the label is 1 mm. Printing closer than 1mm to the top or bottom edge of the label may cause the printer to advance unwanted labels orcause the printer to go into error condition.
-
8/12/2019 EPL Programming Language
26/331
Introduction26
14245L-001 Rev. A EPL Programming Guide 5/30/07
Text (Fonts)
The standard EPL2 printer has five (1-5) resident mono-spaced dot fonts. Fonts A-Z and a-z(upper and lower case alpha characters) are reserved for downloading soft fonts.
Figure 3 Character spacing
Control text height (in horizontal dots) and width (in vertical dots) with the horizontal andvertical multipliers. The text is oriented first and then the A commands font multipliers andfont rotation are applied.
Note The reference point of the first character in a text string is not affected by the font sizemultiplier values.
First Character of Text String Reference Point
8 Dots
Character Width
Inter-character Space
(actually white dots)
12
D
ot
s
-
8/12/2019 EPL Programming Language
27/331
27Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
The standard Latin font (1-5) and soft font characters are dot mapped differently than theAsian font (8 & 9) characters. The Asian character does not have a built-in inter-character gap.The Latin characters include a single dot border around each character.
With the (A) commands horizontal multiplier (p5) set to 2, the inter-character spacing willlook like the following example.
Inter-character Space(actually white dots)
8 Dots
24 Dots
Character Width
12
Dots
24
Dots
Total Character Width
Total Character Width
Fonts 1 (8 x 12 dots) Font 8 (24 x 24 dots)
Note: 203 dpi characters shown as example
2 times
2 times 2 times
2 times
-
8/12/2019 EPL Programming Language
28/331
Introduction28
14245L-001 Rev. A EPL Programming Guide 5/30/07
Text is placed into the image buffer. See the following example.
The Asian fonts (8-9) can print character strings oriented from top to bottom (p3values 47),as well as the standard Latin word orientation from left to right (p3values 03). The characterswill print in the sequence that they are entered into the (A) commands data field.
Vertical
Dots
x axis
y axis
Direction Of Feed
(0,0)
Point ofOrigin for
Text Object
Point ofOrigin for
Text Object
Point ofOrigin for
Text Object
Point ofOrigin forText ObjectRotated 90
Point of Originfor Text ObjectRotated 270
Horizontal Dots
Text - No Size Multipliers
2x Horizontal Multiplier
2x Vertical Multiplier
Vertical
Dot
s
x axis
y axis
Direction Of Feed
(0,0)
Point ofOrigin for
Text Object( )p =5
Point ofOrigin for
Text Object( )p =5
Point ofOrigin for
Text Object( )p =5
Point ofOrigin forText ObjectRotated 90( )p =6
Point of Originfor Text ObjectRotated 270
( )p =4
Horizontal Dots
Text - No Size Multipliers
2x Horizontal Multiplier
2x Vertical Multiplier
-
8/12/2019 EPL Programming Language
29/331
29Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Language Character Sets (Fonts 1-5)
The Latin-based language and Greek character support is controlled and enabled with the Icommand on page 110. The default language set is the English DOS codepage 437.Characters, such as the Euro symbol, can be substituted using the oRcommand on page 127.
Asian Character Sets (Fonts 8 & 9)
The Page Mode EPL2 programming language supports up to two (2) font sets of a single Asianlanguage as well as the standard EPL2 Latin (Multilingual) fonts 1-5 and downloadable softfonts (A-Z and a-z).
Asian language support is an optional feature and requires a special version of the printer(PCBA) to support the large Asian character sets. The flash-based printers support up to fivedifferent Asian language character (ideogram) sets. See theAcommand on page 41for thedetailed list of of fonts.
For Asian language firmware updates, publications, and support options, see www.zebra.com.
All fonts can be expanded both horizontally and vertically. The Asian fonts can also be printedfrom top to bottom or in the Latin character orientation from left to right. The Asian printerssupport the standard Latin fonts with the single character map code page 437 for all five (5)fonts.
The Asian characters are 16 bit (or double-byte) mapped characters. The printed Asiancharacter is dependent on the double-byte ASCII values. The Latin (English, etc.) font sets are8 bits per (or single-byte) ASCII character maps.
Chinese Character Set
The printer automatically recognizes single-byte characters and double-byte characters.
The single-byte font characters are mapped to hexadecimal address range 00 to 7F hex (0-127decimal) for 203 dpi printers and 00 to FF hex (0-255 decimal) for 300 dpi printers.
The double-byte font characters are mapped to hexadecimal address range A1A0 to F7FF hex.
First byte, 161 (A1h) and second byte 160 (A0h) to first byte, 247 (F7h) and second byte, 255(FFh) is the decimal, grouped byte range.
Note Only one (1) Asian language is supported by a printer. Each Asian language(character set) is a separate printer firmware version.
Asian printers with flash firmware can be reprogrammed for a different Asian language, butwe do not recommend this for normal use.
http://www.zebra.com/http://www.zebra.com/ -
8/12/2019 EPL Programming Language
30/331
Introduction30
14245L-001 Rev. A EPL Programming Guide 5/30/07
Chinese Fonts 8 & 9 Double-Byte Ideographic Characters
The Chinese ideographic font characters are mapped to double-byte hexadecimal addressrange A1A0 to F7FFhex.
See the following pages for the codepage character mappings.
Simplified 203 dpi printers
Simplified 300 dpi printers
Traditional 300 dpi printers
Japanese Character Sets
The printer automatically recognizes single-byte characters and double-byte characters in theShift-JIS codepage. The single-byte font characters are mapped to hexadecimal address range00 to 7F hex (0-127 decimal) for 203 dpi printers and 00 to FF hex (0-255 decimal) for 300 dpiprinters.
The double-byte font characters are mapped to the hexadecimal address ranges in thefollowing table.
Japanese Fonts 8 & 9 Double-Byte Ideographic Characters
The Japanese ideographic font characters are mapped to double-byte hexadecimal addresses.See the following electronic document (Acrobat format) pages for codepage character maps.
203 dpi printers JIS
203 dpi printers Shift JIS
300 dpi printers JIS
300 dpi printers Shift JIS
Codepage
ReferenceRange
From To
1st byte 2nd byte 1st byte 2nd byte
JIS 2120-7424 33 (21h) 32 (20h) 116 (74h) 36 (24h)
Shift-JIS 8140-9FFC 129(81h) 64 (40h) 159 (9Fh) 252 (FCh)
E040-EAA4 224 (E0h) 64 (40h) 234 (EAh) 164 (A4h)
-
8/12/2019 EPL Programming Language
31/331
31Introduction
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Korean Character Sets
The printer automatically recognizes single-byte characters and double-byte characters.
The single-byte font characters are mapped to hexadecimal address range 00 to 7F hex (0-127decimal).
The double-byte font characters are mapped to hexadecimal address range A1A0 to F0FF hex.First byte, 161 (A1h) and second byte 160 (A0h) to first byte, 253 (FDh) and second byte, 255(FFh) is the decimal, grouped byte range.
Korean Font 8 Double-Byte Characters
The Korean font characters are mapped to double-byte hexadecimal address range A1A0 toFDFF hex. See the following pages for the character maps.
203 dpi printers
300 dpi printers
Bar Codes
All bar codes supported by the EPL2 language have associated industry specifications that theprogrammer should be aware of and adhere to. The programmer needs to consider bar codefeatures and requirements when choosing and using a bar code for different applications. Someof the features and requirements that need consideration are listed below:
Data used by the application are per the bar code specification (numbers only,alphanumeric, alphanumeric and special characters, etc.).
Minimum and maximum number of characters allowed or required per bar code.
Density or magnification of a given bar code type.
White area required around bar codes (the Quiet Zone).
The bar code must print within the image buffer (printable area of the label).
-
8/12/2019 EPL Programming Language
32/331
Introduction32
14245L-001 Rev. A EPL Programming Guide 5/30/07
QR Code Bar Code
The QR Code bar code is only offered with Japanese Character bar code printerconfigurations.
Programming Sequences Affect Graphic Results
Graphic elements can interact and the resultant image can be affected by other commands.Structure command sequences to reduce the chances of unexpected print results. The printerwill process lines, text, boxes, and most bar codes in command sequence. The printer thenprocesses the printer control processes, counters, variable data, Postnet, and then graphics last.
Note Bar Code Orientation Tip: To help ensure that generated bar codes are readable by thewidest variety of bar code readers, print bar codes in the Picket Fence orientation versusthe Ladder orientation.
-
8/12/2019 EPL Programming Language
33/331
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Printer Configuration
This section covers interpreting your printers configuration setup and setting basic modes. Todetermine your printers configuration and operating mode, do one of the following:
Print a configuration label using the control panel.
Print a configuration label by sending the Ucommand to the printer.
Use the AutoSense feature.
The primary functions that AutoSense provides are:
adjustment of the Media Sensor in the printer to the media in use
the programming mode page (EPL2) or line (EPL1 emulation) mode.
the printers serial interface settings the printers configuration status including printer options
Note The AutoSense feature and Line Mode are not available for all printer models.Refer to your printers user guide for specific feature information.
-
8/12/2019 EPL Programming Language
34/331
Printer Configuration34
14245L-001 Rev. A EPL Programming Guide 5/30/07
Explanation of the Status Printout
Depending on your printer model, your dump mode label will look similar to one of thoseshown below. See Figure 9 on page 319for additional information.
Figure 4 Dump Mode Print Samples
A
B
C.
D.
E
F
G
H
I
N
O
P
Q
. Printer I.D. code number and firmware version.
. Serial port configuration.
Programming Mode
Print head resolution
Print head test pattern.
. Amount of memory available for the Image buffer.
.
Form storage.
.
Graphics storage.
.
. Total free memory available for Forms, Fonts,
or Graphics
Currently selected Character Set ( ) and ImageBuffer mode setting ( ).
= Double Buffering Enabled
= Double Buffering Disabled
Currently selected Print Speed ( ),
Heat Density ( ), Reference Point ( ),
Print Orientation ( ) and Error Status ( ).
.
. Head Up (Open) Sensor settings
.
.
Ir
rY
rN
S
D R
Z U
Currently selected Form Width ( )
and Length ( ).
Current Hardware and Software Option status.
q
Q
Amount of memory used and memory available
for
Amount of memory used and memory available
for
Amount of memory used and memory available
for Soft fonts.
.
.
.
.
Current AutoSense Through (Web/Gap) Sensor
values. The three numbers represent;
1. Backing Transparent point
2. Set point
3. Label Transparent point.
Current Date and Time set in Real Time Clock.
Thess values will only be displayed if your printer
is equipped with the Real Time Clock feature.
Current Dump Mode Status.
J
K
L
M
UKQ1935 V4.59
Serial port:96,N,8,1
Page Mode
Image buffer size:0245K
Fmem:0 (bytes)
Gmem:0
Emem:29600
Available: 100959
I8,0,001 rY JF WY
S4 D00 R0,0 ZT UN
q832 Q1022,029
Option:d,Ff
oEw,x,y,z
16 23 31
Cover: T=143, C=166
Date: 10-05-94
Time:01:00:00
Now in DUMP MODE
Press Feed to exit
Dump Mode Print Sample
-
8/12/2019 EPL Programming Language
35/331
35Printer Configuration
5/30/07 EPL Programming Guide 14245L-001 Rev. A
Determining Printer Firmware Version
The printer version numbers are a code used to document product function and the featuresupport level of the printer. The latest firmware version and updates can be obtained from ourweb site.
Programming Mode Configuration
Flash based printers are, by default, configured for Page (EPL2) mode operations. Theoperator must convert the printer to Line Mode prior to the initial use of Line Mode. This isdone via a hardware select procedure with the Feed button during printer power-up. See theOEPL1command on page 132for details on switching between line and page modes viaprogramming.
The following direct thermal printers support Line Mode (EPL1 emulation):
LP2824
LP2844
Manually Setting Line Mode
The Line Mode capable printer utilizes the Feedbutton during printer power-up to togglebetween the printer personality modes, Line and Page (EPL2).
1. With printer power off, press and hold the Feedbutton while turning on the printer, and
then release the button when the LED starts blinking red.
2. When the indicator LED starts flashing green, immediately press and hold the Feedbutton.
3. Release the Feedbutton when the LED turns a steady amber (orange) color.
4. Verify printer personality with Dump Mode printout: Line Mode or Page Mode (EPL2).
5. Press the Feedbutton to exit the Dump Mode.
Note The Line Mode (and Page Mode) configuration setting is retained after reset has beenissued or power has been cycled.
-
8/12/2019 EPL Programming Language
36/331
Printer Configuration36
14245L-001 Rev. A EPL Programming Guide 5/30/07
Media Detection
Media detection in EPL2 printers is a combination of programming and printer media sensing.The Q (Set Form Length) and O (Option) commands program the media detection method.The user must configure the printer for the media type and the (programmed) form or label in
use.The printer can detect the beginning and end of the printable area on the media by one of threemethods: gap, notch (hole), or black line. The gap method detects the difference in opticaldensity of a label on a liner from the liner only with the transmissive (gap) sensor. The notchmethod uses the transmissive sensor to detect a hole in the media (gap-less labels or tag stock).The black line method uses the reflective sensor to detect a preprinted black line on the mediaback (for gap-less labels or tag stock).
Printing on continuous media requires programming to control media positioning.
EPL2 printers also support a Label Dispense mode as a printer configuration option (formost models). The printers use a Label Taken sensor to detect the removal of a label.
One or more of these sensors may require user adjustment or configuration for properoperation. All EPL2 printers have an AutoSense feature to optimize label and label gapdetection by the transmissive (gap) sensor. See the printers user manual for printer specificsensor adjustment control.
-
8/12/2019 EPL Programming Language
37/331
5/30/07 EPL Programming Guide 14245L-001 Rev. A
3
EPL Commands
This section contains a complete alphabetical listing of all EPL commands.
Memory and Command Usage
The printer stores configuration settings, fonts, graphics (logos) and label form files intoprinter memory. The Command Reference includes a Memory column with the followingterms:
Image commands are use to assemble the printed label image in the print image buffer.
Formcommands are only used within forms.
Sessioncommands place the configuration setting in temporary RAM memory. Thesetting reverts to the printer default when the printer has power cycled or is reset.
Stored memorycommands will check for differences with the existing command settingprior to validating a memory write operation. The printer's non-volatile "flash" memoryhas a limited number of write cycles (100,000 plus).
Writes to memorycommands are commands that do not check to see if a setting, file,font, character or graphic is already present or if that condition is already set. Thesecommands are rarely used in forms except as a printer initialization and function orientedconfiguration.
-
8/12/2019 EPL Programming Language
38/331
EPL Commands
Command Description Memory Page38
14245L-001 Rev. A EPL Programming Guide 5/30/07
Command Description Memory Page
Command Description Memory Page
A ASCII Text Image 41
AUTOFR Automatic Form Printing Form 48
B Bar Code Image 50
B RSS-14 Bar Code Image 56
b Aztec Image 60
Aztec Mesa Image 64
Data Matrix Image 66
MaxiCode Image 70
PDF417 Image 74
QR Code Image 81
C Counter Form 83
C Cut Immediate 85
D Density Stored 86
dump Enable Dump Mode 87
EI Print Soft Font Info. 88
EK Delete Soft Font Writes 89
eR User Definable Error Response Writes 90
ES Store Soft Font Writes 91
f Cut Position Stored 96
fB Adjust Backup Position Writes 97
FE End Form Store Writes 98
FI Print Form Info. 99
FK Delete Form Writes 100
FR Retrieve Form 101
FS Store Form Writes 102
GG Retrieve Graphics Image 103
GI Print Graphics Info. 104
GK Delete Graphic Writes 105GM Store Graphic Writes 106
GW Direct Graphic Write Image 108
i Asian Character Spacing Stored 109
I Character Set Selection Stored 110
JB Disable Top Of Form Backup Stored 112
JC Disable Top Of Form Backup - All Cases Stored 113
-
8/12/2019 EPL Programming Language
39/331
39EPL CommandsCommand Description Memory Page
5/30/07 EPL Programming Guide 14245L-001 Rev. A
JF Enable Top Of Form Backup Stored 114
LE Line Draw Exclusive OR Image 115
LO Line Draw Black Image 116
LS Line Draw Diagonal Image 117
LW Line Draw White Image 118
M Memory Allocation Writes 119
N Clear Image Buffer Image 120
o Cancel Customized Settings Writes 121
oB Cancel Customize Bar Code Writes 122
oE Line Mode Font Substitution Writes 123
oH Macro PDF Offset Image 124
oM Disable Initial Esc Sequence Feed Stored 126oR Character Substitution (Euro) Writes 127
oW Customize Bar Code Parameters Writes 128
O Options Select Stored 130
OEPL1 Set Line Mode Writes 132
P Print 133
PA Print Automatic Form 134
q Set Form Width Stored 135
Q Set Form Length
Transmissive (Gap) SensorBlack Line Sensor|
Continuous Stock
Stored 137
r Set Double Buffer Mode Stored 140
R Set Reference Point Stored 141
S Speed Select Stored 142
T Define Date Layout (& Print Date) Writes 143
TS Set Real Time Clock Stored 144
TT Define Time Layout (& Print Time) Writes 145
U Print Configuration 146UA Enable Clear Label Counter Mode Session 147
UB Reset Label Counter Mode Writes 148
UE External Font Information Inquiry 149
UF Form Information Inquiry 150
UG Graphic Information Inquiry 151
UI Host Prompts/Codepage Inquiry Session 152
Command Description Memory Page
-
8/12/2019 EPL Programming Language
40/331
EPL Commands
Command Description Memory Page40
14245L-001 Rev. A EPL Programming Guide 5/30/07
UM Codepage & Memory Inquiry Session 153
UN Disable Error Reporting Stored 154
UP Codepage & Memory Inquiry/Print 155
UQ Configuration Inquiry 156
US Enable Error Reporting Stored 157
UT Enable Alternate Error Reporting Stored 159
U% Host Prompts/Battery Inquiry 160
U$ Host Prompts/Motor Temperature Inquiry 161
V Define Variable Form 162
W Windows Mode Stored 164
xa Sense Media Writes 165
X Box Draw Image 166Y Serial Port Setup Stored 167
Z Print Dir