ZPL II® Programming Guide Volume One: Command Reference for X.
Proprietary Statement This manual contains proprietary information of Zebra Technologies Corporation. It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the expressed written permission of Zebra Technologies Corporation.
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 Table of Contents INTRODUCTION: Volume One Welcome to ZPL II Programming for X.10 Firmware...................................................1 SECTION ONE: ZPL II Programming Commands Using Section One: ZPL II Command Reference ..........................................................3 ^A – Scalable/Bitmapped Font................................................................
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 ^BP – Plessey Bar Code ...............................................................................................61 ^BQ – QR Code Bar Code ...........................................................................................63 ^BS – UPC/EAN Extensions .......................................................................................69 ^BU – UPC-A Bar Code ........
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 ^FO – Field Origin .....................................................................................................125 ^FP – Field Parameter ................................................................................................126 ^FR – Field Reverse Print ..........................................................................................
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 ~JB – Reset Optional Memory...................................................................................170 ^JC – Set Media Sensor Calibration...........................................................................171 ~JD – Enable Communications Diagnostics ..............................................................171 ~JE – Disable Diagnostics........................
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 ^MD – Media Darkness .............................................................................................197 ^MF – Media Feed .....................................................................................................198 ^ML – Maximum Label Length .................................................................................199 ^MM – Print Mode..............
ZPL II Programming Guide Volume One: Command Reference for X.10 ZPL II Programming Guide Volume One: Command Reference for X.10 ^SS – Set Media Sensors............................................................................................234 ^ST – Set Time/Date (for Real Time Clock) .............................................................236 ^SX – Set ZebraNet ALERT......................................................................................238 ^SZ – Set ZPL ............................
ZPL II Programming Guide Volume One: Command Reference for X.10 INTRODUCTION Volume One Welcome to ZPL II Programming for X.10 Firmware ZPL II Programming Guide Volume One: Command Reference for X.10 is designed for users who already have an understanding of how to create labels and formats using the Zebra Programming Language (ZPL II). Volume One is the unabridged, alphabetical reference of programming commands supported in the X.10 release of Zebra Printer firmware.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 SECTION ONE ZPL II Programming Commands Using Section One: ZPL II Command Reference This section contains the complete alphabetical listing of ZPL II commands supported by the X.10 firmware release. The text in Section One is arranged using the following headings and conventions: Description: Under this heading you will find an explanation of how the command is used, what it is capable of, and any defining characteristics it may have.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: When the command is best clarified in context, an example of the ZPL II code is provided. Text indicating exact code entered by the user is printed in an easily recognizable Courier font. An example of code using the ^B8 command would look like this: ^XA ^FO50,50 ^B8N,100,Y,N ^FD1234567^FS ^XZ Notice that the ^B8 parameter letters have been replaced with real values that apply to the command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^A Scalable/Bitmapped Font Description: The ^A command is used with build-in or TrueType® fonts. ^A designates the font for the current ^FD statement or field. The font specified in ^A will be used only once for that ^FD entry. If ^A is not specified again, the default ^CF font will be used for the next ^FD entry. Format: ^Af,o,h,w Parameters: f = font name Accepted Values: letters A through Z, and numbers 1 to 9.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Scalable Font Command ^XA ^FO50,50^A0,32,25^FDZEBRA^FS ^FO50,150^A0,32,25^FDPROGRAMMING^FS ^FO50,250^A0,32,25^FDLANGUAGE II^FS ^XZ Bitmap Font Command ^XA ^FO50,50^ADN,36,20^FDZEBRA^FS ^FO50,100^ADN,36,20^FDPROGRAMMING^FS ^FO50,150^ADN,36,20^FDLANGUAGE II^FS ^XZ Comments: Fonts are built using a matrix that defines standard height-to-width ratios.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^A@ Use Font Name to Call Font Description: The ^A@ command uses the complete name of a font, rather than the character designation used in ^A. Once ^A@ is defined, it will represent that font until a new font name is specified by ^A@.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: ^XA^A@N,25,25,B:Cyrillic.FNT^FO100,20^FS ^FDThis is a test^FS ^A@N,50,50^FO200,40^FS ^FDThis string uses the B:Cyrillic.FNT^FS^XZ The first line will search the non-volatile memory of the printer (e.g. B:) looking for the “Cyrillic.FNT” font name. When the font is found, the command will set the character size, the field origin, and print the field data “This is a test” on a label (line 2).
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B1 Code 11 Bar Code Description: The ^B1 command is also known as USD-8 code. In a Code 11 bar code, each character is composed of three bars and two spaces, and the character set includes 10 digits plus a dash. • • ^B1 supports print ratios of 2.0:1 to 3.0:1. Field data (^FD) is limited to the width (or length, if rotated) of the label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Characters 0 1 2 3 4 5 6 7 8 9 Internal Start/Stop Characters @ When used as a stop character @ is used with 1 check digit @ is used with 2 check digits Comments: If additional information about the Code 11 Bar Code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B2 Interleaved 2 of 5 Bar Code Description: The ^B2 command is a high density, self-checking, continuous, numeric symbology. Each data character for the Interleaved 2 of 5 Bar Code is composed of five elements: five bars or five spaces. Of the five elements, two are wide and three are narrow. The bar code is formed by interleaving characters formed with all spaces into characters formed with all bars. • • ^B2 supports print ratios of 2.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Interleaved 2 of 5 Characters 0 1 2 3 4 5 6 7 8 9 Start Stop (internal) Comments: The total number of digits in an Interleaved Bar Code must be even. The printer automatically adds a leading 0 (zero) if an odd number of digits is received. The Interleaved 2 of 5 bar code uses the Mod 10 check-digit scheme for error checking. For more information on Mod 10 check digits, refer to Appendix C in Volume Two.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B3 Code 39 Bar Code Description: The Code 39 bar code is the standard for many industries, including the U.S. Department of Defense (DOD). It is one of three symbologies identified in the American National Standards Institute (ANSI) standard MH10.8M-1983. Code 39 is also known as “USD-3 Code” and “3 of 9 Code.” Each character in a Code 39 bar code is composed of nine elements: five bars, four spaces, and an inter-character gap.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Code 39 Characters Code 39 Bar Code 1 A K U - 2 B L V . 3 C M W $ 4 D N X / 5 E O Y + 6 F P Z % 7 G Q 8 H R 9 I S 0 J T Comments: Extended ASCII is a function of the scanner, not of the bar code. Your scanner must have Extended ASCII enabled in order for this feature to work. To turn on (enable) Extended ASCII in the Code 39, you must first encode “+$” in your ^FD statement.
ZPL II Programming Guide Volume One: Command Reference for X.10 Full ASCII Mode for Code 39 Code 39 can generate the full 128-character ASCII set using paired characters as shown in Table A and Table B. Table A: Code 39 Full ASCII Mode ASCII SOH STX ETX EOT ENQ ACK BEL BS HT LF VT FF CR SO SI DLE DC1 DC2 DC3 DC4 NAK SYN ETB CAN EM SUB ESC FS FS RS US ASCII Code 39 SP ! “ # $ % & ‘ ( ) * ++ ‘ .
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B4 Code 49 Bar Code Description: The ^B4 command is a multi-row, continuous, variable-length symbology capable of encoding the full 128-character ASCII set. It is ideally suited for applications where large amounts of data are required in a small space. The code consists of two to eight rows. A row consists of a leading quiet zone, four symbol characters encoding eight code characters, a stop pattern, and a trailing quiet zone.
ZPL II Programming Guide Volume One: Command Reference for X.10 m = starting mode Accepted Values: 0 = Regular Alphanumeric Mode 1 = Multiple Read Alphanumeric 2 = Regular Numeric Mode 3 = Group Alphanumeric Mode 4 = Regular Alphanumeric Shift 1 5 = Regular Alphanumeric Shift 2 A = Automatic mode. The printer determines starting mode by analyzing field data.
ZPL II Programming Guide Volume One: Command Reference for X.10 Field Data Set Unshifted Character Set Shift 1 Character Set Shift 2 Character Set 0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z . SPACE $ / ++ % < (Shift 1) > (Shift 2) : (N.A.) ; (N.A.) ? (N.A.) = (Numeric Shift) 0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z .
ZPL II Programming Guide Volume One: Command Reference for X.10 Code 49 Field Data Character Set The ^FD data sent to the printer when using starting modes 0 to 5 is based on the Code 49 Internal Character Set. This is shown in the first column of the Code 49 table on the previous page. The characters : ; < = > ? are special Code 49 control characters. Valid field data must be supplied when using modes 0 to 5.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B7 PDF417 Bar Code Description: The ^B7 command is a two-dimensional, multi-row, continuous stacked symbology. PDF417 is capable of encoding over 1,000 characters per bar code. It is ideally suited for applications where large amounts of information are required at the time the bar code is read. The code consists of 3 to 90 stacked rows. Each row consists of start and stop patterns and symbol characters called “code-words.
ZPL II Programming Guide Volume One: Command Reference for X.10 r = number of rows to encode Accepted Values: 3 to 90 Default value: 1:2 row-to-column aspect ratio. The user can specify the number of symbol rows giving control over the height of the symbol. For example, with no row or column values entered, 72 code-words would be encoded into a symbol of 6 columns and 12 rows. Depending on code-words, the aspect ratio will not always be exact.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example 2: Comments: • • • • • If both columns and rows are specified, their product must be less than 928. No symbol is printed if the product of columns and rows is greater than 928. No symbol is printed if total code-words is greater than the product of columns and rows. Serialization is not allowed with this bar code. The truncation feature can be used in situations where label damage is not likely.
ZPL II Programming Guide Volume One: Command Reference for X.10 Special Considerations for ^BY When Using PDF417 When used with ^B7, the parameters for the ^BYw,r,t command are: w = r = h = module width. Default = 2. Limited to 10. ratio. Default = 3. Ratio is fixed and does not effect PDF417. height of bars (overall symbol height). PDF417 uses this only when row height is not specified in the ^B7 h parameter.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B8 EAN-8 Bar Code Description: The ^B8 command is the shortened version of the EAN-13 bar code. EAN is an acronym for European Article Numbering. Each character in the EAN-8 bar code is composed of four elements: two bars and two spaces. • • • ^B8 supports a fixed ratio. Field data (^FD) is limited to exactly seven characters. ZPL II automatically pads or truncates on the left with zeros to achieve the required number of characters.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: EAN-8 Characters 0 1 2 3 4 5 6 7 8 9 Comments: If additional information about the EAN-8 Bar Code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^B9 UPC-E Bar Code Description: The ^B9 command is a variation of the UPC symbology used for number system 0. It is a shortened version of the UPC-A bar code in which zeros are suppressed, resulting in codes that require less printing space. The 6 dot/mm, 12 dot/mm, and 24 dot/mm printheads produce the UPC/EAN symbologies at 100 percent of the size.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: UPC-E Characters 0 1 2 3 4 5 6 7 8 9 Four Rules for Proper Product Numbers 1. If the last three digits in the manufacturer’s number are 000, 100, or 200, valid Product Code numbers are 00000 to 00999. 2. If the last three digits in the manufacturer’s number are 300, 400 , 500, 600, 700, 800, or 900, valid Product Code numbers are 00000 to 00099. 3.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BA Code 93 Bar Code Description: The ^BA command is a variable length, continuous symbology. It is used in many of the same applications as Code 39. It uses the full 128-character ASCII Code. ZPL II, however, does not support ASCII control codes or escape sequences. It uses the substitute characters shown below.
ZPL II Programming Guide Volume One: Command Reference for X.10 g = print interpretation line above code Accepted Values: Y (yes) or N (no) Default Value: N e = print check digit Accepted Values: Y (yes) or N (no) Default Value: N Example: Code 93 Characters 1 2 3 4 5 6 7 8 9 0 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z - . $ / + % & ’ ( ) SPACE Denotes an internal start/stop character that must precede and follow every bar code message.
ZPL II Programming Guide Volume One: Command Reference for X.10 Full ASCII Mode for Code 93 Code 93 can generate the full 128-character ASCII Set using paired characters as shown in tables A and B. Table A: Code 93 Full ASCII Mode ASCII NUL SOH STX ETX EOT ENQ ACK BEL BS HT LF VT FF CR SO SI DLE DC1 DC2 DC3 DC4 NAK SYN ETB CAN EM SUB ESC FS FS RS US Code 93 ASCII ‘U &A &B &C &D &E &F &G &H &I &J &K &L &M &N &O &P &Q &R &S &T &U &V &W &X &Y &Z ‘A ‘B ‘C ‘D ‘E SP ! “ # $ % & ‘ ( ) * ++ ‘ .
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BB CODABLOCK Bar Code Description: The ^BB command is a two-dimensional multi-row, stacked symbology. It is ideally suited for applications that require large amounts of information. Depending on the mode selected, the code consists of 1 to 44 stacked rows. Each row begins and ends with a start/stop pattern. • • CODABLOCK A supports variable print ratios. CODABLOCK E and F support only fixed print ratios.
ZPL II Programming Guide Volume One: Command Reference for X.10 r = number of rows to encode Accepted Values: CODABLOCK A: 1 to 22 CODABLOCK E and F: 2 to 4 • • • • • m = If values for c and r are not specified, a single row will be produced. If a value for r is not specified, and c exceeds the maximum range, a single row equal to the field data length will be produced. If a value for c is not specified, the number of characters per row is derived by dividing the field data by the value of r.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The code below prints the following CODABLOCK bar code. ^XA^LH10,10^FS ^BY2,3^FO50,50^BBN,30,,30,44,E ^FD Zebra Technologies Corporation strives to be the expert supplier of innovative solutions to specialty demand labeling and ticketing problems of business and government.
ZPL II Programming Guide Volume One: Command Reference for X.10 Special Considerations for the ^BY Command When Using ^BB The parameters for the ^BYw,r,h command, when used with a ^BB code, are as follows: w = Module width. Default Value: 2 Maximum Value: 10. (CODABLOCK A only). r = Ratio. Default Value: 3 (fixed value; this has no effect on CODABLOCK E or F). h = Height of bars. CODABLOCK uses this as the overall symbol height only when the row height is not specified in the ^BB h parameter.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BC Code 128 Bar Code (Subsets A, B, and C) Description: The ^BC command is a high-density, variable length, continuous, alphanumeric symbology. It was designed for complexly encoded product identification. Code 128 has three subsets of characters. There are 106 encoded printing characters in each set, and each character can have up to three different meanings, depending on the character subset being used.
ZPL II Programming Guide Volume One: Command Reference for X.10 m = mode Accepted Values: N – no selected mode U – UCC Case Mode A – Automatic Mode. This analyzes the data sent and automatically determines the best packing method. The full ASCII character set can be used in the ^FD statement. The printer will determine when to shift subsets. A string of four or more numeric digits will cause an automatic shift to subset C.
ZPL II Programming Guide Volume One: Command Reference for X.10 The following tables represent the Code 128 Character Sets. Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 Code A SP ! '' # $ % & ' ( ) * ++ , . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T Code B SP ! '' # $ % & ' ( ) * ++ , .
ZPL II Programming Guide Volume One: Command Reference for X.10 Special Conditions if UCC Case Mode is Selected 1. More than 19 digits in ^FD or ^SN will be eliminated. 2. Fewer than 19 digits in ^FD or ^SN will add zeros to the right to bring count to 19. This produces an invalid interpretation line. Code 128 Subsets The three Code 128 character subsets are referred to as Subset A, Subset B, and Subset C. A subset may be selected in one of two ways: 1.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example of Code 128 – Subset B Since Code 128 Subset B is the most commonly used subset, ZPL II defaults to Subset B if no start character is specified in the data string. This is illustrated in the following two samples. The bar codes in the following two samples are identical.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example of Code 128 – Subsets A and C Code 128, Subsets A and C are programmed as pairs of digits, 00-99, in the field data string (refer to the Code 128 character chart on page 40). In Subset A, each pair of digits results in a single character being encoded in the bar code; in Subset C, they are printed as entered. Figure E below is an example of Subset A. (The “>9” is the Start Code for Subset A.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BD UPS MaxiCode Bar Code Description: The ^BD command creates a two-dimensional, optically read (not scanned) code. This symbology was developed by UPS (United Parcel Service). The code is generated from the information in the ^FD statement which is described below. Notice that there are no additional parameters for this code and it does not generate an interpretation line. The ^BY command has no affect on the UPS MaxiCode Bar Code.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: ^XA ^FO50,50 ^CVY ^BD^FH^FD001840152382802[)>_1E01_1D961Z00004951_1DUPS N_1D_06X610_1D 159_1D1234567_1D1/1_1D_1DY_1D 634 ALPHA DR_1DPITTSBURGH_1DPA_1E_04^FS ^FO30,300^A0,30,30^FDMode2^FS ^XZ Special Considerations for ^FD when Using ^BD The ^FD statement is divided into two parts: a High Priority Message (hpm) and a Low Priority Message (lpm). There are two types of High Priority Messages. One is for a U.S.
ZPL II Programming Guide Volume One: Command Reference for X.10 Non-U.S. Style Postal Code (Mode 3) = aaabbbcccccc aaa = three-digit class of service bbb = three-digit country zip code ccccc = six-digit zip code (0-9 or A-Z) = low priority message (only applicable in Modes 2 and 3) Gs is used to separate fields in a message (0x1D). Rs is used to separate format types (0x1E). Eot is the end of transmission character.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BE EAN-13 Bar Code Description: The ^BE command is similar to the UPC-A bar code. It is widely used throughout Europe and Japan in the retail marketplace. The EAN-13 bar code has 12 data characters, one more data character than the UPC-A code. An EAN-13 symbol contains the same number of bars as the UPC-A, but encodes a 13th digit into a parity pattern of the left-hand six digits.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: UPC/EAN Characters 0 1 2 3 4 5 6 7 8 9 Comments: The EAN-13 bar code uses the Mod 10 check-digit scheme for error checking. For more information on Mod 10, refer to Appendix C in Volume Two. If additional information about the EAN-13 bar code is required, refer to Appendix H in Volume Two for AIM, Inc.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BF Micro-PDF417 Bar Code Description: The ^BF command is a two-dimensional, multi-row, continuous, stacked symbology identical to PDF417, except it replaces the 17-module-wide start/stop patterns and left/right row indicators with a unique set of 10-module-wide row address patterns designed to reduce overall symbol width and to allow linear scanning at row heights as low as 2X.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following ZPL II code will generate the bar code printed at left: ^XA^BY6^BFN,8,3 ^FDABCDEFGHIJKLMNOPQRSTUV^FS ^XZ To encode data into the Micro-PDF417 bar code, follow the procedure below. Encoding Data into a Micro-PDF417 Bar Code 1. Determine the type of data that will be encoded (e.g., ASCII characters, numbers, 8-bit data, or a combination). 2.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BI Industrial 2 of 5 Bar Code Description: The ^BI command is a discrete, self-checking, continuous numeric symbology. Industrial 2 of 5 bar code has been in use the longest of the 2 of 5 family of bar codes. Of that family, the Standard 2 of 5 and Interleaved 2 of 5 bar codes are also available in ZPL II. With Industrial 2 of 5, all of the information is contained in the bars.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Industrial 2 of 5 Bar Code Characters 0 1 2 3 4 5 6 7 8 9 Start (internal) Stop (internal) Comments: If additional information about the Industrial 2 of 5 bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BJ Standard 2 of 5 Bar Code Description: The ^BJ command is a discrete, self-checking continuous numeric symbology. With Standard 2 of 5, all of the information is contained in the bars. Two bar widths are employed in this code, the wide bar measuring three times the width of the narrow bar. • • ^BI supports a print ratio of 2.0:1 to 3.0:1. Field data (^FD) is limited to the width (or length, if rotated) of the label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Standard 2 of 5 Bar Code Characters 0 1 2 3 4 5 6 7 8 9 Start (automatic) Stop (automatic) Comments: If additional information about the Standard 2 of 5 bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BK ANSI Codabar Description: The ^BK command is currently used in a variety of information processing applications such as libraries, the medical industry, and overnight package delivery companies. This bar code is also known as USD-4 code, NW-7 and 2 of 7 code. It was originally developed for retail price-labeling use. Each character in this code is composed of seven elements: four bars and three spaces.
ZPL II Programming Guide Volume One: Command Reference for X.10 l = designates stop character Accepted Values: B, C, D, E, N, T, or * Default Value: A Example: ANSI Codabar Characters 0 2 4 6 8 1 3 5 7 9 Control Characters : . $ / + Start/Stop Characters A B C D T N * E Comments: If additional information about the ANSI Codabar bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BL LOGMARS Bar Code Description: The ^BL command is a special application of Code 39 used by the Department of Defense (DOD). LOGMARS is an acronym for Logistics Applications of Automated Marking and Reading Symbols. • • ^BI supports a print ratio of 2.0:1 to 3.0:1. Field data (^FD) is limited to the width (or length, if rotated) of the label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: LOGMARS Characters 1 2 3 4 5 6 7 8 9 0 A B J K S C L T U - . D E F G H I M N O P Q R V W X Y * $ / + % Z SPACE Comments: The LOGMARS bar code produces a “mandatory” check digit using MOD 43 calculations. For further information, refer to Appendix D in Volume Two. If additional information about the ANSI Codabar bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BM MSI Bar Code Description: The ^BM command is a pulse-width modulated, continuous, non-self checking symbology. It is a variant of the Plessey bar code. Each character in the MSI bar code is composed of eight elements: four bars and four adjacent spaces. • • ^BI supports a print ratio of 2.0:1 to 3.0:1. Field data (^FD) is limited to 1 to 14 digits when parameter e is B, C, or D.
ZPL II Programming Guide Volume One: Command Reference for X.10 e2 = designates start character Accepted Values: Y (yes) or N (no) Default Value: N Example: MSI Characters 1 2 3 4 5 6 7 8 9 Comments: If additional information about the MSI bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BP Plessey Bar Code Description: The ^BP command is a pulse-width modulated, continuous, non-selfchecking symbology. Each character in the Plessey bar code is composed of eight elements: four bars and four adjacent spaces. • • ^BI supports a print ratio of 2.0:1 to 3.0:1. Field data (^FD) is limited to the width (or length, if rotated) of the label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Plessy Characters 0 8 1 9 2 A 3 B 4 C 5 D 6 E 7 F Comments: If additional information about the Plessy bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BQ QR Code Bar Code Description: The ^BQ command produces a matrix symbology consisting of an array of nominally square modules arranged in an overall square pattern. A unique pattern at three of the symbol’s four corners assists in determining bar code size, position, and inclination. A wide range of symbol sizes is possible along with four levels of error correction.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following ZPL II code will generate the label printed below. ^XA ^FO20,20^BQN,2,10^FDMM,AAC-42^FS ^XZ Comments: If additional information about the QR Code bar code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information. On the following pages are specific commands for formatting the ^BQ command with the ^FD statements that contain the information to be coded.
ZPL II Programming Guide Volume One: Command Reference for X.10 Considerations for ^FD When Using the QR Code: QR Switches (formatted into the ^FD field data) Mixed mode D = allows mixing of different types of character modes in one code. Code No. <01 16> Value = subtracted from the Nth number of the divided code (must be 2 digits). No. of divisions <02 16> No. of divisions (must be 2 digits).
ZPL II Programming Guide Volume One: Command Reference for X.10 Data input A = Automatic input (default). Data character string JIS8 unit, Shift JIS. When the input mode is automatic input, the binary codes of 0x80 to 0x9F and 0xE0 to 0xFF cannot be set. M = Manual input Two types of data input mode exist: Automatic (A) and Manual (M). If A is specified, the character mode does not need to be specified. If M is specified, the character mode must be specified.
ZPL II Programming Guide Volume One: Command Reference for X.10 H M N (ultra-high reliability level) (manual input) (numeric data) 123456789012345 Example: QR code, normal mode with standard reliability and manual data input.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: QR code, mixed mode with manual data input ^XA ^FO,20,20^BQ,2,10^FDD03048F,LM,N0123456789,A12AABB,B0 006qrcode^FS ^XZ
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BS UPC/EAN Extensions Description: The ^BS (UPC/EAN extensions) command is the 2- and 5-digit add-on used primarily by publishers to create bar codes for ISBN’s (International Standard Book Numbers). These extensions are handled as separate bar codes. The ^BS command is designed to be used with ^BU (UPC-A Bar Code) and ^B9 (UPC-E Bar Code). • • ^BI supports a fixed print ratio. Field data (^FD) is limited to exactly 2 or 5 characters.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 Care should be taken in positioning the UPC/EAN extension with respect to the UPC-A or UPC-E code to insure the resultant composite code is within the UPC specification.
ZPL II Programming Guide Volume One: Command Reference for X.10 Additionally, the bar code height for the extension should be 27 dots (0.135 inches) shorter than that of the Primary code. A Primary UPC code height of 183 dots (0.900 inches) would require a extension height of 155 dots (0.765). The figure below shows an example of how to create a normal UPC-A code for the value 7000002198 with an extension equal to 04414.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BU UPC-A Bar Code Description: The ^BU command is a fixed length, numeric symbology. It is primarily used in the retail industry for labeling packages. The UPC-A bar code has 11 data characters. The 6 dot/mm, 12 dot/mm, and 24 dot/mm printheads produce the UPC-A bar code (UPC/EAN symbologies) at 100 percent size. However, an 8 dot/mm printhead will produce the UPC/EAN symbologies at a magnification factor of 77 percent.
ZPL II Programming Guide Volume One: Command Reference for X.10 The font style of the interpretation line depends on the modulus (width of narrow bar) selected in ^BY: 6 dot/mm printer: A modulus of 2 dots and greater will print with an OCR-B interpretation line; a modulus of 1 dot will print font A. 8 dot/mm printer: A modulus of 3 dots and greater will print with an OCR-B interpretation line; a modulus of 1 or 2 dots will print font A.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BX Data Matrix Bar Code Description: The ^BX command is a two-dimensional matrix symbology which is made up of square modules arranged within a perimeter finder pattern.
ZPL II Programming Guide Volume One: Command Reference for X.10 r = rows to encode (9 to 49) Odd values only for quality 0 to 140 (10 to 144); even values only for quality 200. The number of rows and columns in the symbol will be automatically determined. The user may wish to force the number of rows and columns to a larger value to achieve uniform symbol size.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 The input string escape sequences may be embedded in Quality 200 field data using the _ character (ASCII 45, underscore) or the character entered in parameter g: • • • • • • _X is the shift character for control characters (e.g.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BY Bar Code Field Default Description: The ^BY command is used to change the default values for the Narrow Element Module (Narrow Bar or Space) Width, the Wide Bar to Narrow Bar Width Ratio and the Bar Height. It can be used as often as necessary within a label format.
ZPL II Programming Guide Volume One: Command Reference for X.10 Ratio Module Width in Dots (w) Selected (r) 1 2 3 4 5 6 7 8 9 10 2.0 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2.1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2:1 2.1:1 2.2 2:1 2:1 2:1 2:1 2.2:1 2.16:1 2.1:1 2.12:1 2.1:1 2.2:1 2.3 2:1 2:1 2.3:1 2.25:1 2.2:1 2.16:1 2.28:1 2.25:1 2.2:1 2.3:1 2.4 2:1 2:1 2.3:1 2.25:1 2.4:1 2.3:1 2.28:1 2.37:1 2.3:1 2.4:1 2.5 2:1 2.5:1 2.3:1 2.5:1 2.4:1 2.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^BZ POSTNET Bar Code Description: The POSTNET bar code is used to automate the handling of mail. POSTNET uses a series of five bars, two tall and three short, to represent the digits 0 to 9. • • ^BI supports a print ratio of 2.0:1 to 3.0:1. Field data (^FD) is limited to the width (or length, if rotated) of the label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: POSTNET Characters 0 1 2 3 4 5 6 7 8 9 Comments: If additional information about the POSTNET Bar Code is required, refer to Appendix H in Volume Two for AIM, Inc. contact information, or contact the United States Postal Service and ask for Publication 25 – Designing Letter Mail, which includes a full specification for POSTNET. You can also download Publication 25 from the URL below: http://pe.usps.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CC ~CC Change Caret Description: The ^CC and ~CC commands are used to change the format command prefix. The default prefix is the caret (^). Format: ^CCx or ~CCx Parameters: x = caret character change Accepted Values: any ASCII character Default Value: a parameter is required. If no parameter is entered, the next character received will be the new prefix character.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CD ~CD Change Delimiter Description: The ^CD and ~CD commands are used to change the ZPL II delimiter character. This character is used to separate parameter values associated with several ZPL II commands. The default delimiter is a comma (,). Format: ^CDa or ~CDa Parameters: a = delimiter character change Accepted Values: any ASCII character Default Value: a parameter is required.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CF Change Alphanumeric Default Font Description: You can use the ^CF command to keep your programs simple. The ^CF command sets the default font used in your printer. Format: ^CFf,h,w Parameters: f = specified default font Accepted Values: A through H, and numerals 0 to 9.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: This example specifies the desired font information once using the ^CF command. ^XA ^CF0,89 ^FO120,50^FDA Guide to^FS ^FO120,150^FDthe ZPL II^FS ^FO120,250^FDProgramming^FS ^FO120,350^FDLanguage ^XZ Comments: Any font in the printer, including downloaded fonts, EPROM stored fonts, and fonts A through Z and 1 to 9 can also be selected with ^CW.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CI Change International Font Description: Zebra printers can print all fonts using various international character sets: USA1, USA2, UK, Holland, Denmark/Norway, Sweden/Finland, Germany, France 1, France 2, Italy, Spain, and miscellaneous. ZPL II follows the ISO standards for international characters. The ^CI command enables you to call up the international character set you want to use for printing. You can mix character sets on a label.
ZPL II Programming Guide Volume One: Command Reference for X.10 d1 = destination 1 (new position for the character referred to in s1) Accepted Values: decimals 0 to 255 s2 = source 2 (character position to be remapped) Accepted Values: decimals 0 to 255 d2 = destination 2 (new position for the character referred to in s2) Accepted Values: decimals 0 to 255 … = continuation of pattern Up to 256 source and destination pairs can be entered in this command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CM Change Memory Letter Designation Description: The ^CM command allows the user to reassign a letter designation to the printer’s memory devices. If a format already exists, you can reassign the memory device to the corresponding letter without being forced to alter or recreate the format itself. Using this command will impact every subsequent command that refers to specific memory locations.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: This example designates letter E: to point to the B: memory device, and the letter B: to point to the E: memory device. ^XA^CME,B,R^JUS^XA This example resets all letter designations to point to themselves. ^XA^CME,B,B^JUS^XA This example sets all letter designation to point to themselves. ^XA^CM,,R^JUS^XZ Comments: It is recommended that after entering the ^CM command, ^JUS is entered to save changes to EEPROM.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CO Cache On Description: The ^CO command is used to change the size of the character cache. By definition, a “character cache” (from here on referred to as cache) is a portion of the DRAM reserved for storing scalable characters. All printers have a default 22K cache that is always turned on. The maximum single character size that can be stored, without changing the size of the cache, is 450 dots by 450 dots.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 Comments: The cache can be resized as often as needed. Any characters in the cache when it is resized are lost. Memory used for the cache reduces the space available for label bitmaps, graphic, downloaded fonts, etc. Some Asian fonts require an internal working buffer which is much larger than the normal cache. Since most fonts do not require this larger buffer, it is now a selectable configuration option.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CT ~CT Change Tilde Description: The ^CT and ~CT commands are used to change the control command prefix. The default prefix is the tilde (~). Format: ^CTa or ~CTa Parameters: a = change control command character Accepted Values: any ASCII character Default Value: Parameter is required. If no value is entered, the next character received will be the new prefix character. Example: ^XA ^CT+ +DGR:GRAPHIC.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CV Code Validation Description: The ^CV command acts as a switch to turn the code validation function on and off.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The top sample in both columns shows a correctly printed bar code. It is followed by an example of the error messages. Comments: If more than one error exists, the first error detected will be the one displayed. The ^CV command tests the integrity of the data encoded into the bar code. It is not used for (or to be confused with) testing the scan-integrity of an image or bar code.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^CW Font Identifier Description: All built-in fonts have a one-character identifier. The ^CW command assigns a single alphanumeric character (A through Z and 0 to 9) to a font stored in DRAM, memory card, EPROM or Flash. If the assigned character is the same as that of a built-in font, the downloaded font is used in place of the built-in font. The new font will be printed on the label wherever the format calls for the built-in font.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: To use MYFONT.FNT stored in DRAM whenever a format calls for Font A: ^XA^CWA,R:MYFONT.FNT^XZ To use MYFONT.FNT stored in DRAM as additional Font Q: ^XA^CWQ,R:MYFONT.FNT^XZ To use NEWFONT.FNT stored in DRAM whenever a format calls for font F: ^XA^CWF,R:NEWFONT.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DB Download Bitmap Font Description: The ~DB command sets the printer to receive a downloaded bitmap font, defines native cell size, baseline, space size, and copyright. This command consists of two portions, a ZPL II command which defines the font and a structured data segment which defines each character of the font. Format: ~DBd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 The data structure is: #xxxx.h.w.x.y.i.data #xxxx = character code h = bitmap height (in dot rows) w = bitmap width (in dot rows) x = x-offset (in dots) y = y-offset (in dots) i = typesetting motion displacement (width including inter-character gap of a particular character in the font) data = hexadecimal bitmap description Example: The following is an example of how to use the ~DB command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DE Download Encoding Description: The standard encoding for TrueType® Windows™ fonts is always Unicode. Therefore, the ZPL field data must be converted from some other encoding to Unicode. The required translation table is downloaded with the ~DE command. These tables are provided with ZTools for Windows.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: ~DER:JIS.DAT,27848,300021213001... (27848 2-digit hexadecimal values) Comments: For more information on ZTools for Windows, refer to the program documentation included with the software.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^DF Download Format Description: The ^DF command saves ZPL II format commands as text strings to be later merged using ^XF with variable data. The format to be stored may contain Field Number (^FN) commands to be referenced when recalled. While use of stored formats will reduce transmission time, no formatting time is saved – this command saves ZPL II as text strings formatted at print time.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following is an example of using the ^DF command to download and store ZPL II text strings to non-volatile RAM. The name used to store the text strings is STOREFMT.ZPL. ^XA ^DFR:STOREFMT.ZPL^FS ^FO25,25^AD,36,20^FN1^FS ^FO165,25^AD,36,20^FN2^FS ^FO25,75^AB,22,14^FDBUILT BY^FS ^FO25,125^AE,28,15^FN1^FS ^XZ The sample shown below is generated by using the ^XF (Recall Format) command to recall this format.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DG Download Graphics Description: The ~DG (Download Graphic) command performs the following functions: 1. Puts the printer into graphics mode. 2. Names the graphic (this name is used to recall it into a label). 3. Defines the size of the graphic. 4. Downloads the hexadecimal string to the printer. Format: ~DGd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 The t parameter can be determined by using the following formula: where x is the width of the graphic in millimeters, y is the height of the graphic in millimeters and dots/mm is the print density of the printer being programmed. For example, to determine the correct t parameter for a graphic 8mm wide, 16mm high and a print density of 8 dots/mm, the formula works this way: Raise any portion of a byte to the next whole byte.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following is an example of using the ~DG command to load a checkerboard pattern into DRAM. The name used to store the graphic is SAMPLE.GRF. ~DGR:SAMPLE.GRF,00080,010, FFFFFFFFFFFFFFFFFFFF 8000FFFF0000FFFF0001 8000FFFF0000FFFF0001 8000FFFF0000FFFF0001 FFFF0000FFFF0000FFFF FFFF0000FFFF0000FFFF FFFF0000FFFF0000FFFF FFFFFFFFFFFFFFFFFFFF Comments: Do not use spaces or periods when naming your graphics.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DN Abort Download Graphic Description: After decoding and printing the number of bytes in parameter t of the ^DG command, the printer returns to normal print mode. Graphics Mode can be aborted and normal printer operation resumed by using the ~DN (Abort Download Graphic) command. Format: ~DN Comments: If you need to stop a graphic from downloading, you should abort the transmission from the host device.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DS Download Scalable Font Description: The ~DS command is used to set the printer to receive a downloadable scalable font and defines the size of the font in bytes. The ~DS command, and its associated parameters, are the result of converting a vendor supplied font for use on a Zebra printer. The conversion is done using the Zebra utility program ZTools for Windows. The program is available from Zebra Technologies Corporation.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DT Download TrueType Font Description: The ZTools for Windows program must be used to convert a TrueType font to a Zebra-downloadable format. This program creates a downloadable file that includes a ~DT command. Once downloaded, the font will function just like the earlier Intelifont software.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DU Download Unbounded TrueType Font Description: Some international fonts have more than 256 printable characters. These fonts are supported as “Large TrueType Fonts” such as Asian fonts, and are downloaded to the printer with the ~DU command. The ZTools for Windows program must be used to convert the “Large TrueType Fonts” to a Zebradownloadable format. The Field Block (^FB) command cannot support the large TrueType fonts.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~DY Download Graphics Description: ~DY downloads to the printer graphic objects in any supported format. This command can be used in place of ~DG for more saving and loading options. Format: ~DYf,b,x,t,w,data Parameters: f = font name b = format downloaded in data field (f) a = uncompressed bitmap (.GRF, ASCII) b = uncompressed bitmap (.GRF, binary) c = AR-compressed bitmap (.GRF, compressed binary) p = PNG image (.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~EF Erase Stored Formats Description: The ~EF command erases all stored formats. Format: ~EF Comments: The ~EF command is no longer recommended for use! It is recommended that the ^ID (Object Delete) command is used to selectively delete stored formats. ~EG Erase Download Graphics Description: The ~EG command is used to delete all graphic images (label format images and hexadecimal images) from DRAM.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FB Field Block Description: The ^FB command allows you to print text into a defined “block type ” format. This command formats an ^FD text string into a block of text using the origin, font, and rotation specified for the text string. This command also contains an automatic word-wrap function.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following are examples of how the ^FB command affects the field data. ^XA^CF0,30,30^FO25,50 ^FB250,4,, ^FD“FD” statement that IS preceded by an “FB” command.^FS ^XZ “FD” statement that IS preceded by an “FB” command. ^XA^CF0,30,30^FO25,50 ^FD“FD” statement that IS NOT preceded by an “FB” command.
ZPL II Programming Guide Volume One: Command Reference for X.10 Comments on the ^FB Command The following scheme can be used to facilitate special functions. “ \& ” = carriage return/line feed “ \(*)” = soft hyphen (word break with a dash) “ \\ ” = \ (See Item 1 below) Item 1: ^CI13 must be selected in order to print a \. Item 2: If a soft hyphen is placed near the end of a line, the hyphen will be printed. If it is not placed near the end of the line, it will be ignored. (*) = Any alphanumeric character.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FC Field Clock (for Real Time Clock) Description: The ^FC command is used to set the clock-indicators (delimiters) and the clock mode, for use with the Real Time Clock hardware. This command must be included within each label field command string each time the Real Time Clock values are required within the field.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FD Field Data Description: The ^FD command defines the data string for the field. The field data can be any printable character except those used as command prefixes (^ and ~). Format: ^FDa Parameters: a = data to be printed Accepted Values: any ASCII string up to 3072 characters. Default Value: none – a string of characters must be entered.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FH Field Hexadecimal Indicator Description: The ^FH command allows you to enter the hexadecimal value for any character directly into the ^FD statement. The ^FH command must precede each ^FD command in which it will be used. Within the ^FD statement, the HEX indicator must precede each hexadecimal value. The default hexadecimal indicator is _ (underscore). There must be a minimum of two characters designated to follow the underscore.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FM Multiple Field Origin Locations Description: The ^FM command allows you to control the placement of bar code symbols. It designates field locations for the PDF417 (^B7) and Micro-PDF417 (^BF) bar codes when the structured append capabilities are utilized. This allows printing multiple bar codes from the same set of text information. The structured append capability is a way of extending the text printing capacity of both bar codes.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FN Field Number Description: The ^FN command is used to number data fields. This command is used in both Store Format (^DF) and Recall Format (^XF) operations. Refer to the example on the following page to see how ^FN is used with ^DF. In a stored format, the ^FN command is used where you would normally use the ^FD (Field Data) command. In recalling the stored format, use ^FN in conjunction with the ^FD (Field Data) command.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: ^XA ^DFR:STOREFMT.ZPL^FS ^FO25,25^AD,36,20^FN1^FS ^FO165,25^AD,36,20^FN2^FS ^FO25,75^AB,22,14^FDBUILT BY^FS ^FO25,125^AE,28,15^FN1^FS ^XZ ^XA ^XFR:STOREFMT.ZPL^FS ^FN1^FDZEBRA^FS ^FN2^FDLABEL^FS ^XZ Comments: • • The same ^FN value can be stored with several different fields.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FO Field Origin Description: The ^FO command sets a field origin, relative to the label home (^LH) position. ^FO sets the upper-left corner of the field area by defining points along the x-axis and y-axis independent of the rotation.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FP Field Parameter Description: The ^FP command allows vertical formatting of the font field, which is commonly used for Asian fonts.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FR Field Reverse Print Description: The ^FR command allows a field to appear as white over black or black over white. When printing a field and the ^FR command has been used, the color of the output is the reverse of its background. Format: ^FR Parameters: ^FR = field reverse print Example: Comments: The ^FR command applies to only one field and has to be specified each time.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FS Field Separator Description: The ^FS command denotes the end of the field definition. Alternatively, the field separator command can also be issued as a single ASCII control code SI (Control-O, HEX 0F).
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FT Field Typeset Description: The ^FT command also sets the field position, relative to the home position of the label designated by the ^LH command. The typesetting origin of the field is fixed with respect to the contents of the field and does not change with rotation.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The example below shows the differences in font orientation when using ^FT and ^FO relative to their ^LH position. The origin point of the font when using the ^FT command is always at the left of the baseline position of the first element or character in the field. In normal orientation, all characters rest on the baseline. In rotated orientation, all characters are drawn to the right of the label from the baseline.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FV Field Variable Description: ^FV replaces the ^FD (field data) command in a label format when the field is variable. Format: ^FV Parameters: a = variable field data to be printed Accepted Values: 0 to 3072 character string Default Value: if no data is entered, the command is ignored. Example: The following is an example of how to use the ^MC and ^FV command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FW Field Orientation Description: The ^FW command sets the default orientation for all command fields that have an orientation (rotation) parameter. Fields can be rotated 0, 90, 180, 270 degrees clockwise by using this command. The ^FW command only affects fields that follow it. Once you have issued a ^FW command, the setting is retained until you turn off the printer or send a new ^FW command to the printer.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^FX Comment Description: The ^FX command is useful when you want to add a “non-printing” informational comment or statement within a label format. Any data after the ^FX command up to the next caret (^) or tilde (~) command will not have any effect on the label format. Therefore, you should avoid using the caret (^) or tilde (~) commands within the ^FX statement.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following is an example of how effectively to use the ^FX command. ^XA ^LH100,100^FS ^FXSHIPPING LABEL^FS ^FO10,10^GB470,280,4^FS ^FO10,190^GB470,4,4^FS ^FO10,80^GB240,2,2^FS ^FO250,10^GB2,100,2^FS ^FO250,110^GB226,2,2^FS ^FO250,60^GB226,2,2^FS ^FO156,190^GB2,95,2^FS ^FO312,190^GB2,95,2^FS ^XZ Comments: Proper usage of the ^FX command includes following it with the ^FS command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GB Graphic Box Description: The ^GB command is used to draw boxes and/or lines as part of a label format. Boxes and lines are use to highlight important information, divide labels into distinct areas, or just dress up the way the label looks. The same format command is used for drawing either boxes or lines.
ZPL II Programming Guide Volume One: Command Reference for X.10 Examples: Width: 1.5 inch; Height: 1 inch; Thickness: 10; Color: default; Rounding: default ^XA ^FO150,100 ^GB305,203,10 ^XZ Width: 0 inch; Height: 1 inch; Thickness: 20; Color: default; Rounding: default ^XA ^FO150,100 ^GB0,203,20 ^XZ Width: 1 inch; Height: 0 inch; Thickness: 30; Color: default; Rounding: default ^XA ^FO150,100 ^GB203,0,30 ^XZ Width: 1.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GC Graphic Circle Description: The ^GC command produces a circle on the printed label. The command parameters specify the diameter (width) of the circle, outline thickness, and color. Thickness extends inward from the outline.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following code will generate a label image similar to the one seen below.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GD Graphic Diagonal Line Description: The ^GD command produces a straight diagonal line connecting one corner with the opposite corner of a box closing this line.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following code will generate a label image similar to the one seen below.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GE Graphic Ellipse Description: The ^GE command will produce an ellipse in the label format.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following code will generate a label image similar to the one seen below.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GF Graphic Field Description: The ^GF command allows you to download graphic field data directly into the bitmap. This command follows the conventions for any other field, meaning a field orientation is included. The graphic field data can be placed at any location within the bitmap space.
ZPL II Programming Guide Volume One: Command Reference for X.10 data = data Accepted Values: ASCII hexadecimal data: 00 to FF A string of ASCII hexadecimal numbers, 2 digits per image byte. CR and LF can be inserted as needed for readability. The number of 2-digit number pairs must match the above count. Any numbers sent after count is satisfied are ignored. A comma in the data will pad the current line with “00” (white space), thereby allowing minimization of data sent.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^GS Graphic Symbol Description: The ^GS command enables you to generate the registered trademark, copyright symbol, and other symbols.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~HB Battery Status Description: When the ~HB command is sent to the Zebra printer, a data string is sent back to the Host. The string starts with an control code sequence and is terminated by an control code sequence. Format: ~HB Parameters: when the printer receives the command it will return: bb.bb,hh.hh,bt bb.bb hh.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HG Host Graphic Description: The ^HG command is used to upload graphics to the host. The graphic image can be stored for future use, or it can be downloaded to any Zebra printer. Format: ^HGn Parameters: n = name of the graphic Comments: For more information on uploading graphics, refer to the ^HY command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~HI Host Identification Description: The ~HI command is designed to be sent from the host to the Zebra printer to retrieve information. Upon receipt, the printer will respond with information on the model, software version, dots-per-millimeter setting, memory size, and any detected objects. Format: ~HI Parameters: when the printer receives this command it will return: XXXXXX,V1.0.0,12,512KB,X XXXXXX = model of Zebra printer V1.0.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~HM Host Memory Status Description: Sending the ~HM to the printer immediately returns a memory status message to the host. Use this command whenever you need to know the status of the memory. When ~HM is sent to the Zebra printer, a line of data containing information on the total amount, maximum amount, and available amount of memory is sent back to the host.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~HS Host Status Return Description: When ~HS is sent to the printer, three data strings are sent back to the Host. Each string starts with an control code and is terminated by an control code sequence. To avoid confusion, each string will be printed on a separate line by the host.
ZPL II Programming Guide Volume One: Command Reference for X.10 String 2 mmm,n,o,p,q,r,s,t,uuuuuuuu,v,www mmm n o p q r = = = = = = s t uuuuuuuu v www = = = = = function settings* unused “head up” flag (1 = head in up position) “ribbon out” flag (1 = ribbon out) “thermal transfer mode” flag (1 = thermal trans.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~HU Host Unsolicited Description: This command will return the table of configured ZebraNet ALERT settings to the host. Format: ~HU Example: If the ~HU command is sent to the printer with existing ALERT messages set to go to e-mail and SNMP traps, the data returned would look something like the information below. Refer to ^SX for complete information on parameter settings. B,C,Y,Y,ADMIN@COMPANY.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HW Host Directory List Description: ^HW is used to transmit a directory listing of objects in a specific memory area (storage device) back to the host device. This command will return a formatted ASCII string of object names to the host. Each object is listed on a line and has a fixed length. The total length of a line is also fixed. Each line listing an object begins with the asterisk (*) followed by a blank space.
ZPL II Programming Guide Volume One: Command Reference for X.10 Format: ^HWd:o.x Parameters: d = location to retrieve object listing Accepted Values: E:, B:, R: Default Value: DRAM o = object name Accepted Values: any 1 to 8 character name Default Value: asterisk (*). A question mark (?) can also be used. x = extension Accepted Values: any valid 3-letter extension Default Value: asterisk (*). A question mark (?) can also be used.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HY Upload Graphics Description: The ^HY command is an extension of the ^HG command. ^HY is used to upload graphic objects from the printer in any supported format. Format: ^HYd:o.x Parameters: d = location of object Accepted Values: E:, R:, B: Default Value: search priority o = object name Accepted Values: any existing object Default Value: an object name must be specified x = extension Accepted Values: G = .GRF (raw bitmap format) P = .
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HZA Display All Description Information Description: The ^HZA command is used for returning complete printer description information in XML. The printer will return information on format parameters, object directories, and print status. Refer to Chapter 6 (XML: Super Host Status) in Volume Two for more information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HZF Format Parameter Setting Information Description: This command will return the printer’s format parameter setting information in XML. Data returned displays the current settings in XML format. Refer to Chapter 6 (XML: Super Host Status) in Volume Two for more information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HZL Object Directory Listing Information Description: The ^HZL command will return the printer’s object directory information in XML. Refer to Chapter 6 (XML: Super Host Status) in Volume Two for more information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HZO Individual Object Data Information Description: The ^HZO command will return object data from the printer. Refer to Chapter 6 (XML: Super Host Status) in Volume Two for more information. Format: ^HZO,n Parameters: n = name of the object to be recalled Objects can be recalled from R:, B: or E:. The object name and extension follow the standard Zebra naming convention.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^HZR Status Information Description: The ^HZR command returns status information from the printer. Refer to Chapter 6 (XML: Super Host Status) in Volume Two for more information.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^ID Object Delete Description: The ^ID command deletes objects, graphics, fonts, and stored formats from storage areas selectively or in groups. This command can be used within a printing format to delete objects prior to saving new ones, or it can be used in a stand-alone format to delete objects. The image name and extension support the use of the asterisk (*) as a wildcard. This allows for easy deletion of selected groups of objects.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: To delete stored formats from DRAM: ^XA^IDR:*.ZPL^XZ To delete formats and images named SAMPLE from DRAM, regardless of the extension: ^XA^IDR:SAMPLE.*^XZ To delete the image SAMPLE1.GRF prior to storing SAMPLE2.GRF: ^XA ^FO25,25^AD,18,10^FDDelete^FS ^FO25,45^AD,18,10^FDthen Save^FS ^IDR:SAMPLE1.GRF^FS ^ISR:SAMPLE2.GRF^FS ^XZ In this example, the * is a wild card, indicating that all objects with the .GRF extension will be deleted.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^IL Image Load Description: The ^IL command is used at the beginning of a label format to load a stored image of a format and merge it with additional data. The image is always positioned at ^FO0,0. Using this technique to overlay the image of constant information with the variable data greatly increases the throughput of the label format. Format:^ILd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following example recalls the stored image SAMPLE2.GRF from DRAM and overlays it with the additional data. The graphic was stored using the ^IS command. Refer to the ^IS command for the stored label format. ^XA ^ILR:SAMPLE2.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^IM Image Move Description: The ^IM command performs a direct move of an image from storage area into the bitmap. The command is identical to the Recall Graphic command except there are no sizing parameters. Format: ^IMd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^IS Image Save Description: The ^IS command is used within a ZPL II label format to save that format as a graphic image. This command is used within a label format, typically at the end. It instructs the printer to save that label format as a graphic image rather than a ZPL II script file. The image can later be recalled with virtually no formatting time and overlaid with variable data to form a complete label.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The following is an example of using the ^IS command to save a label format to DRAM. The name used to store the graphic is SAMPLE2.GRF.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JA Cancel All Description: The ~JA command cancels all format commands in the buffer. It also cancels any batches that may be printing. The printer will stop printing after the current label (if one is printing) is finished printing. All internal buffers will be cleared of data. The “DATA” LED will turn off.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JB Initialize Flash Memory Description: The ^JB command is used to initialize the two types of Flash memory available in the Zebra printers. Format: ^JBa Parameters: a = device to initialize B = Flash card (PCMCIA) E = Flash memory Example: ^JBB – initializes the optional Flash card when installed in the printer. ^JBE – initializes the optional Flash memory when installed in the printer.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JB Reset Optional Memory Description: The ~JB command is used for the following conditions: • • This command must be sent to the printer if the battery supplying power to the battery powered memory card fails and is replaced. A bad battery would show a “battery dead” condition on the Printer Configuration Label. To intentionally clear (reinitialize) the memory card (the card must not be write protected).
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JC Set Media Sensor Calibration Description: The ~JC command is used to force a label length measurement and recalibrate the media and ribbon sensors. Format: ^JC Comments: In continuous mode, only the media and ribbon sensors will be calibrated.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JF Set Battery Condition Description: There are two low battery voltage levels sensed by the PA/PT400™ printers. When battery voltage goes below the first level, the green LED begins flashing as a warning but printing will continue. When this warning occurs, it is good practice to recharge the battery. As printing continues, a second low voltage level will be reached.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JG Graphing Sensor Calibration Description: The ~JG command is used to force a label length measurement, recalibrate the media and ribbon sensors and print a graph (media sensor profile) of the sensor values.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JJ Set Auxiliary Port Description: The ^JJ command allows you to control an on-line verifier or applicator device. Format: ^JJa,b,c,d,e,f Parameters: a = operational mode for auxiliary port Accepted Values: 0 = off 1 = reprint on error – The printer stops on a label with a verification error. When the pause key is pressed this label is reprinted (if ^JZ is set to reprint).
ZPL II Programming Guide Volume One: Command Reference for X.10 c = application mode start signal print Accepted Values: p = pulse mode – Start Print signal must be de-asserted before it can be asserted for the next label. l = level mode – Start Print signal does not need to be de-asserted to print the next label. As long as the Start Print signal is low and a label is formatted, the printer will print a label.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JL Set Label Length Description: The ~JL command is used to set the label length. Depending on size of label, the printer will feed one or more blank labels.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JM Set Dots per Millimeter Description: Use the ^JM (Set Dots/Millimeter) command to double the format size of the label . Depending on the print head, normal dots per millimeter on a Zebra Printer are 12-dots/mm (304-dots/inch), 8-dots/mm (203-dots/inch) or 6-dots/mm (153-dots/inch). This command lowers the density of the print – 24 dots/mm would become 12, 12 dots/mm would become 6 dots/mm, 8 dots/mm would become 4, and 6 would become 3.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JN Head Test Fatal Description: The ~JN command resets the printhead element error override, acting as a toggle for ~JO. If the Head Test Fatal option is activated, it will cause the printer to halt when a head test failure is encountered. Format: ~JN ~JO Head Test Non-fatal Description: The ~JO command is the default printhead test condition and overrides a failure of printhead element status check.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JP Pause and Cancel Format Description: The ~JP command clears the format currently being processed and places the printer in the Pause mode. The command clears the next format that would print, or the oldest format from the buffer. Each subsequent ~JP command clears the next buffered format until the buffer is empty. The DATA indicator turns off when the buffer is empty and no data is being transmitted.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JR Power On Reset Description: The ~JR command resets all of the printer’s internal software, performs a power-on self-test (POST), clears the buffer and DRAM, and resets communication parameters and default values. ~JR performs the same function as a manual power-on reset.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JS Change Backfeed Sequence Description: The ~JS command is used to control the backfeed sequence. This command can be used on printers with or without built-in cutters. The primary applications are: 1. to allow programming of the “rest point” of the cut edge of continuous media. 2. provide immediate backfeed after peel-off when the printer is used in a print/apply application configuration.
ZPL II Programming Guide Volume One: Command Reference for X.10 The value for this command is also reflected in the “Backfeed” parameter on the printer configuration label.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JT Head Test Interval Description: The ^JT command lets you change the printhead test interval from 100 to any desired interval. The ^JT command allows the printer to run the test after printing a label. When a parameter is defined, the printer will run the test after printing a set amount of labels. The printer’s default head test state is off. Parameters for running the printhead test are defined by the user.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^JU Configuration Update Description: The ^JU command sets the active configuration for the printer. Format: ^JUa Parameters: a = active configuration Accepted Values: F = reload factory values. These values will be lost at power-off if not saved with ^JUS. R = recall last saved values S = save current settings. These will be used at power-on. ^JW Set Ribbon Tension Description: ^JW sets the ribbon tension for the printer it is sent to.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~JX Cancel Current Partially Input Format Description: The ~JX command cancels a format that is currently being sent to the printer. It does not affect any formats currently being printed, or any subsequent formats that may be sent. Format: ~JX ^JZ Reprint After Error Description: The ^JZ command is used to reprint a partially printed label caused by a Ribbon Out, Media Out or Head Open error condition.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~KB Kill Battery (Battery Discharge Mode) Description: In order to maintain performance of the rechargeable battery of the portable printers, the battery must be fully discharged and recharged regularly. The ~KB command places the printer in battery discharge mode to allow for draining the battery without actually printing. Format: ~KB Comments: While the printer is in discharge mode, the green power LED will flash in groups of three flashes.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^KD Date/Time Format (for Real Time Clock) Description: The ^KD command is used to select the format in which the Real Time Clock’s date and time information is printed on a configuration label, displayed on the “Printer Idle” LCD front panel display, and displayed while setting the date and time.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^KL Define Language Description: The ^KL command is used to select the language used for the front panel display.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^KN Define Printer Name Description: The printer’s network name and description can be set using the ^KN command. ^KN is designed to make your Zebra printer easy for users to identify. The name the administrator designates will be listed on the configuration label and on the Web page generated by the printer.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^KP Define Password Description: The ^KP command is used to define the password that must be entered to access the front panel switches and LCD set up mode. Format: ^KP#### Parameters: #### = mandatory four-digit password Accepted Values: any four digit numeric sequence Default Value: 1234 Comments: If the password is forgotten, the printer can be returned to a default setup mode in which the default password of 1234 will be entered.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^LH Label Home Description: The ^LH command sets the label home position. The default home position of a label is the upper-left corner (position 0,0 along the x-axis and y-axis). This is the axis reference point for labels. Any area below and to the right of this point is available for printing. The ^LH command changes this reference point.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^LL Label Length Description: The ^LL command defines the length of the label. This command is necessary when using continuous media (i.e. media not divided into separate labels by gaps, spaces, notches, slots or holes). To affect the current label and be compatible with existing printers, this command must come before the first ^FS command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^LR Label Reverse Print Description: The ^LR command reverses the printing of all fields in the label format. It allows a field to appear as white over black or black over white. Using the ^LR is identical to placing a ^FR in all current and subsequent fields.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^LS Label Shift Description: The ^LS command allows for compatibility with Z-130 printer formats that are set for less than full label width. It is used to shift all field positions to the left so that the same commands used on a Z-130 or Z-220 Printer can be used on other Zebra printers. To determine the value for the ^LS command use the following formula.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^LT Label Top Description: The ^LT command moves the entire label format a maximum of 120 dot rows up or down from its current position with respect to the top edge of the label. A negative value moves the format towards the top of the label; a positive number moves the format away from the top of the label. This command can be used to fine-tune the position of the finished label without having to change any of the existing parameters.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MC Map Clear Description: In normal operation, the bitmap is cleared after the format has been printed. The ^MC command is used to retain the current bitmap. This applies to current and subsequent labels until cleared with a second ^MCY command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MD Media Darkness Description: This ^MD command adjusts the darkness relative to the current darkness setting. The minimum value is -30 and the maximum value is 30. Format: ^MDa Parameters: a = media darkness level Accepted Values: -30 to 30, depending on current value. Initial Value at Power-up: 0 If no value is entered, this command is ignored.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MF Media Feed Description: The ^MF command dictates what happens to the media at power-up and at head-close after the error is cleared.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^ML Maximum Label Length Description: The ^ML command lets you adjust the maximum label length. Format: ^MLa Parameters: a = maximum label length (in dot rows) Accepted Values: 0 to maximum length of label Default Value: last permanently saved value Comments: In order for calibration to work properly, you must set the maximum label length equal to or greater than your actual label length.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MM Print Mode Description: The ^MM command determines the action the printer takes after a label or group of labels has been printed. There are four different modes of operation: 1. Tear-Off – After printing, the label is advanced so that the web is over the tear bar. Label, with backing attached, can then be torn off manually. 2. Rewind – The label and backing are rewound on an (optional) external rewind device.
ZPL II Programming Guide Volume One: Command Reference for X.10 Format: ^MMa,b Parameters: a = desired mode Accepted Values: T = tear off P = peel off (not available on S-300) R = rewind A = applicator C = cutter Default Value: T b = pre-peel select Accepted Values: Y (yes) or N (no) Default Value: Y The command will be ignored if parameters are missing or invalid. The current value of the command will remain unchanged.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MN Media Tracking Description: The ^MN command relays to the printer what type of media is being used (continuous or non-continuous) for purposes of tracking. There are two choices for this command: 1. Continuous Media – This media has no physical characteristic (web, notch, perforation, mark, etc.) to separate labels. Label Length is determined by the ^LL command. 2.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MP Mode Protection Description: The ^MP command is used to disable the various Mode functions on the front panel. Once disabled, the settings for the particular mode function can no longer be changed and the LED associated with the function will not light. Since this command has only one parameter, each mode will have to be disabled with an individual ^MP command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MT Media Type Description: The ^MT command selects the type of media being used in the printer. There are two choices for this command: 1. Thermal Transfer Media – This media uses a high carbon black or colored ribbon. The ink on the ribbon is bonded to the media. 2. Direct Thermal Media – The media is heat sensitive and requires no ribbon.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^MU Set Units of Measurement Description: This command sets the printer units of measurement. The ^MU command works on a field-by-field basis. Once the mode units is set, it carries over from field to field until a new mode units is entered. ^MU also allows for printing at lower resolutions – 600 dpi printers are capable of printing at 300, 200, and 150 dpi; 300 dpi printers are capable of printing at 150 dpi.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~NC Network Connect Description: The ~NC command is used to connect a particular printer into the network by calling up the printer’s Network ID Number. Format:~NC# Parameters: # = network ID number assigned Accepted Values: 001 to 999 Default Values: 000 (none) Comments: Use this command at the beginning of any label format to specify which printer on the network is to be used.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^NI Network ID Number Description: The ^NI command is used to assign a Network ID number to the printer. This must be done before the printer can be used in a network. Format: ^NI# Parameters: # = network ID number assigned Accepted Values: 001 to 999 Default Values: 000 (none) Comments: The last Network ID Number set will be the one recognized by the system. This value must be three digits in length or it will not be recognized.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~NT Set Currently Connected Printer Transparent Description: The ~NT command sets the currently connected network printer transparent. Format: ~NT Comments: With Z Series™ printers, the ~NT command functions the same as the ~NR command. All Z-Series printers on a network will receive the transmission. The commands ~NC, ^NI, ~NR, and ~NT are only used with ZNET RS-485 printer networking.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PF Slew Given Number of Dot Rows Description: The ^PF command causes the printer to slew labels (move labels at a high speed without printing) a specified number of dot rows from the bottom of the label. This allows faster printing when the bottom portion of a label is blank. Format:^PF# Parameters: # = number of dots rows to slew Accepted Values: 0 to 32000 Default Value: None.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PH ~PH Slew to Home Position Description: The ~PH or ^PH (Slew to Home Position) command causes the printer to feed one blank label. • • The ~PH command feeds one label after the format currently being printing is done or when the printer is placed in pause. The ^PH command feeds one blank label after the format it is in prints.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PM Printing Mirror Image of Label Description: The ^PM command prints the entire printable area of the label as a mirror image. This command flips the image from left to right. Format: ^PMa Parameters: a = print mirror image of entire label Accepted Values: Y (yes) or N (no) Default Value: N Example: Comments: If the parameter is missing or invalid, the command will be ignored.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PO Print Orientation Description: The ^PO command inverts the label format 180 degrees. In essence, the label is printed upside-down. If the original label contains commands such as ^LL, ^LS, ^LT and ^PF, the inverted label output will be effected differently.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: The ^POI command moves the Label Home position to the furthest point away from the main frame. Therefore, a different ^LH (Label Home) can be used to move the print back onto the label. Defining Field Orientation Parameters Comments: If multiple ^PO commands are issued in the same label format, only the last command sent to the printer is used.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PP ~PP Programmable Pause Description: The ~PP command stops printing after the current label is printed (if one is printing) and places the printer in the Pause mode. The ^PP command is not immediate. Therefore, several labels may be printed before a pause is performed. This command will pause the printer after the current format prints. The operation is identical to pressing the PAUSE button on the front panel of the printer.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PQ Print Quantity Description: The ^PQ command gives control over several printing operations. It controls the number of labels to print, the number of labels printed before printer pauses, and the number of replications of each serial number.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PR Print Rate Description: The ^PR command determines the media speed during printing and the slew speed (feeding a blank label). The printer will operate with the selected speeds until the setting is reissued or the printer is turned off. The print speed is application-specific. Since print quality is affected by media and ribbon, printing speeds and printer operating modes, it is very important to run tests for your applications.
ZPL II Programming Guide Volume One: Command Reference for X.10 b = backfeed speed Accepted Values: A or 2 50.8 mm/sec. B or 3 76.2 mm/sec. C or 4 101.6 mm/sec. 5 127 mm/sec. D or 6 152.4 mm/sec. E or 8 203.2 mm/sec. 9 220.5 mm/sec. 10 245 mm/sec. 11 269.5 mm/sec. 12 304.8 mm/sec. Default Value: A (2 inches/sec.) (3 inches/sec.) (4 inches/sec.) (5 inches/sec.) (6 inches/sec.) (8 inches/sec.) (9 inches/sec.) (10 inches/sec.) (11 inches/sec.) (12 inches/sec.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~PR Applicator Reprint Description: The ~PR command is only supported by the PAX and PAX2-Series printers. If the ~PR command is enabled (refer to ^JJ), the last label printed will be reprinted, similar to the applicator asserting the Reprint signal on the applicator port. Format: ~PR Comments: The ~PR command is only available on the PAX and PAX2-Series printers.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^PW Print Width Description: The ^PW command allows you set the print width. Format: ^PWa Parameters: a = label width in dots Comments: The ^PW command is not available to all Zebra printers, specifically the Zebra 160S, 105S, 105Se and the S300 and S500 printers. ~RO Reset Advanced Counter Description: The ~RO command resets the advanced counters used by the printer to monitor label generation in inches, centimeters, and number of labels.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SC Set Communications Description: The ^SC command allows you to change the communications parameters you are using. Format: ^SCa,b,c,d,e,f Parameters: a = baud rate Accepted Values: 110, 130, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, or 57600.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~SD Set Darkness Description: The ~SD command lets you set the darkness of printing via ZPL. It is equivalent to the darkness setting parameter on the front panel display Format: ~SD# Parameters: # = desired darkness setting (2-digit number) Accepted Values: 00 to 30 Default Value: last permanently saved value Comments: The ^MD command value, if applicable, is added to the ~SD command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SF Serialization Field (with a Standard ^FD String) Description: The ^SF command allows the user to serialize a standard ^FD string. Fields serialized with this command will be right justified or would end with the last character of the string. The increment string is aligned with the mask starting with the right-most position. The maximum size of the mask and increment string is 3K combined.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: ^FD12A^SFnnA,C This mask has the first characters as alphanumeric (nn = 12) and the last digit as upper case alphabetic (A). The decimal value of the increment number is equivalent to 2 (C). The print sequence on a series of labels would be: 12A, 12C, 12E, 12G... ^FDBL0000^SFAAdddd,1 The print sequence on a series of labels would be: BL0000, BL0001,...BL0009, BL0010,... BL0099, BL0100,...BL9999, BM0000...
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SL Set Mode/Language (for Real Time Clock) Description: The ^SL command is used to specify the Real Time Clock’s mode of operation and language for printing information. Format: ^SLa,b Parameters: a = mode Accepted Values: S = “Start Time” mode. This is the time that is read from the real time clock when label formatting begins (when ^XA is received). The first label will have the same time placed on it as the last label.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SN Serialization Data Description: The ^SN command allows the printer to index data fields by a selected increment or decrement value (i.e., make the data fields increase or decrease by a specified value) each time a label is printed. This can be performed on up to 100 to 150 fields in a given format and can be performed on both alphanumeric and bar code fields. A maximum of 12 of the rightmost integers are subject to indexing.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: Comments: Incrementing and decrementing takes place for each serial-numbered field when all replicates for each serial number have been printed, as specified in parameter r of the ^PQ (print quality) command.
ZPL II Programming Guide Volume One: Command Reference for X.10 Using Leading Zeros In the ^SN command, the z parameter determines if leading zeros will be printed or suppressed. The default value for this parameter is to not print the leading zeros. Depending on which value is used (Y = Yes, print leading zeros; N = No, do not print leading zeros) the printer will either print or suppress the leading zeros. Print Leading Zeros The starting value consists of the right most consecutive sequence of digits.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SO Set Offset (for Real Time Clock) Description: The ^SO command is used to set the secondary and the tertiary offset from the primary Real Time Clock.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SP Start Print Description: The ^SP command allows a label to start printing at a specified point before the entire label has been completely formatted. On extremely complex labels, this command can increase the overall throughput of the print. The command works as follows. You specify the dot row at which the ^SP command is to take affect. This then creates a label “segment.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: In the following illustration, a label 800 dot rows in length has a ^SP500 command. Segment 1 will print while commands in Segment 2 are being received and formatted.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SQ Halt ZebraNet ALERT Description: The ^SQ command is used to stop the ZebraNet ALERT option.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SR Set Printhead Resistance Description: The ^SR command allows you set the printhead resistance. Format: ^SR# Parameters: # = resistance value (4-digit numeric value) Accepted Value: 488 to 1175 Default Value: last permanently saved value Comments: To avoid damaging the printhead, this value should be less than or equal to the value shown on the printhead being used. Setting a higher value may damage the printhead.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SS Set Media Sensors Description: The ^SS command is used to change the values for media, web, ribbon and label length set during the media calibration process. The media calibration process is described in your specific printer’s user’s guide. Format: ^SSw,m,r,l,m2,r2,a,b,c Parameters: w = web (3-digit value) Accepted Values: 000 to 100 Default Value: The value shown on the media sensor profile or configuration label.
ZPL II Programming Guide Volume One: Command Reference for X.10 a = mark sensing (3-digit value) Accepted Values: 000 to 100 Default Value: The value calculated in the calibration process. b = mark media sensing (3-digit value) Accepted Values: 000 to 100 Default Value: The value calculated in the calibration process. c = mark LED sensing (3-digit value) Accepted Values: 000 to 100 Default Value: The value calculated in the calibration process.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^ST Set Time/Date (for Real Time Clock) Description: The ^ST command sets the time and date of the Real Time Clock.
ZPL II Programming Guide Volume One: Command Reference for X.10 d = hour Accepted Values: 00 to 23 Default Value: current hour e = minute Accepted Values: 00 to 59 Default Value: current minute f = second Accepted Values: 00 to 59 Default Value: current second g = format Accepted Values: A = a.m. P = p.m.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SX Set ZebraNet ALERT Description: The ^SX command is used to configure the ZebraNet ALERT system.
ZPL II Programming Guide Volume One: Command Reference for X.10 c = enable “condition set” alert to this destination Accepted Values: Y (yes) or N (no) Default Value: Y or previously configured value d = enable “condition clear” alert to this destination Accepted Values: Y (yes) or N (no) Default Value: N or previously configured value Parameters e and f are sub-options based on destination. If the sub-options are missing or invalid, these parameters will be ignored.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^SZ Set ZPL Description: The ^SZ command is used to select the programming language used by the printer. This command gives you the ability to print labels formatted in both ZPL or ZPL II. This command will remain active until another ^SZ command is sent to the printer or the printer is turned off.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~TA Tear-off Adjust Position Description: The ~TA command lets you adjust the rest position of the media after a label is printed, which changes the position at which the label is torn or cut. Format: ~TA### Parameters: ### = change in media rest position (3-digit value in dot rows) Accepted Values: -120 to 120 Default Value: last permanent value saved Comments: If the parameter is missing or invalid, the command is ignored.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^TO Transfer Object Description: The ^TO command is used to copy an object or group of objects from one storage device to another. It is quite similar to the copy function used in PC’s. Source and destination devices must be supplied and must be different and valid for the action specified. Invalid parameters will cause the command to be ignored. There are no defaults associated with this command.
ZPL II Programming Guide Volume One: Command Reference for X.10 Comments: Parameters o, x, and s support the use of the wild card (*). If the destination device does not have enough free space to store the object being copied, the command will be abandon. Zebra files (Z:*.*) cannot be transferred. These files are copyrighted by Zebra Technologies Corporation. Transferring Objects The following are some examples of using the ^TO command. To copy the object ZLOGO.
ZPL II Programming Guide Volume One: Command Reference for X.10 Transferring Multiple Objects The asterisk (*) can be used to transfer multiple object files (except *.FNT) from the DRAM to the Memory Card. For example, you have several object files that contain logos. These files are named LOGO1.GRF, LOGO2.GRF, and LOGO3.GRF.
ZPL II Programming Guide Volume One: Command Reference for X.10 ~WC Print Configuration Label Description: The ~WC command is used to generate a printer configuration label The printer configuration label contains information about the printer set up, such as sensor type, network ID, ZPL mode, firmware version, and descriptive data on the R:, B: and E: devices. Format: ~WC Comments: This command only works when the printer is idle.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^WD Print Directory Label Description: The ^WD command is used to print a label listing bar codes, objects stored in DRAM, or fonts. For bar codes, the list will show the name of the bar code. For fonts, the list shows the name of the font, number to use with ^Af command, and size. For objects stored in DRAM, the list shows the name of the object, extension, size and option flags. All lists are enclosed in a double line box. Format: ~WDd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 Example: To print a label listing all objects in DRAM, enter: ^XA ^WDR:*.* ^XZ To print a label listing all the bar codes. ^XA ^WDZ:*.BAR ^XZ To print a label listing all fonts.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^XA Start Format Description: The ^XA command is used at the beginning of ZPL II code. It is the opening bracket and indicates the start of a new label format. This command is substituted with a single ASCII control character STX (control-B, Hexadecimal 02). Format: ^XZ Comments: Label formats should start with the ^XA command and end with the ^XZ command to be in valid ^ZPL format.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^XB Suppress Backfeed Description: The ^XB command suppresses forward feed of media to tear-off position depending on the current printer mode. Since no forward feed is done, a backfeed before printing of the next label is not necessary, therefore, throughput will be improved. When printing a batch of labels, the last label should not contain this command.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^XF Recall Format Description: The ^XF command recalls a stored format to be merged with variable data. There can be multiple ^XF commands and they can be located anywhere in the label format. When recalling a stored format and merging data utilizing the ^FN (Field Number) function, the calling format must contain the ^FN command to properly merge the data.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^XG Recall Graphic Description: The ^XG command is used to recall one or more graphic images for printing. This command is used in a label format to merge pictures such as company logos and piece parts, with text data to form a complete label. An image may be recalled and resized as many times per format as needed. Other images and data may be added to the format. Format:^XGd:o.
ZPL II Programming Guide Volume One: Command Reference for X.10 ^XZ End Format Description: The ^XZ command is the ending (closing) bracket. It indicates the end of a label format. When this command is received, a label will be printed. This command can also be issued as a single ASCII control character ETX (Control-C, Hex 03). Format: ^XZ Comments: Label formats must start with the ^XA command and end with the ^XZ command to be in valid ZPL II format.
ZPL II Programming Guide Volume One: Command Reference for X.
ZPL II Programming Guide Volume One: Command Reference for X.10 Zebra Technologies Corporation 333 Corporate Woods Parkway Vernon Hills, Illinois 60061.3109 U.S.A. Telephone: +1 847.634.6700 Facsimile: +1 847.913.8766 Zebra Technologies Europe Limited Zebra House The Valley Centre, Gordon Road High Wycombe Buckinghamshire HP13 6EQ, UK Telephone: +44 (0) 1494 472872 Facsimile: +44 (0) 1494 450103 Part # 13903L-001 Rev. A © 2005 ZIH Corp.