Printer Protocol Interpreter (PPI) ZGL™ Programmer’s Reference Manual for ZGL, a Zebra® ZPL® Printer Protocol Interpreter Thermal Series Printers
Printer Protocol Interpreter (PPI) ZGL Programmer’s Reference Manual for ZGL, a Zebra ZPL Printer Protocol Interpreter Thermal Series Printers
Trademark Acknowledgments ZPL, ZPL II, and Zebra are registered trademarks of Zebra Technologies Corporation. PPI is a trademark of Printronix, Inc. Printronix and PSA are registered trademarks of Printronix, Inc. COPYRIGHT © 2002, 2006 PRINTRONIX, INC. All rights reserved.
Table of Contents 1 Introduction ........................................................... 9 About This Manual................................................................................. 9 Coax/Twinax Interface Requirements ............................................. 9 PPI/ZGL SETUP Menu ........................................................................ 10 PPI/ZGL SETUP Submenus ......................................................... 11 ZPL Compatible ......................................
Table of Contents ~DU - Download Unbounded TrueType Font ......................... 18 ~EF / ^EF - Erase Format....................................................... 19 ~EG / ^EG - Erase Downloaded Images ................................ 19 ^FA - Field Allocate................................................................. 19 ^FC - Field Clock .................................................................... 19 ^FD - Field Data......................................................................
Table of Contents ~NR - Set All Network Printers Transparent ........................... 22 ~NT - Set Currently Connected Printer Transparent .............. 23 ^PM - Print Mirror Image of Label ........................................... 23 ^PW - Print Width.................................................................... 23 ^SF - Serialization Field .......................................................... 23 ^SL - Set Mode/Language ......................................................
Table of Contents ^MC - Mp Clear....................................................................... 34 ^MD - Media Darkness ........................................................... 34 ^MN - Media tracking .............................................................. 34 ^PF - Slew Dot Rows .............................................................. 34 ~PH / ^PH - Slew to Home ..................................................... 34 ^PO - Print Orientation..........................................
1 Introduction About This Manual This manual explains the differences between the Printer Protocol Interpreter Zebra Graphic Language (ZGL) Utility and the Zebra® ZPL® language. Use this manual with your SL500r/T5000r User’s Manual for complete printerprotocol operation. NOTE: When substituting a Zebra Xi III model printer with a SL5000r/T5000r printer, refer to ZGL Menu Conversions on page 37. Coax/Twinax Interface Requirements ZGL uses a forms prefix of EBCDIC 0xB0.
Chapter 1 PPI/ZGL SETUP Menu PPI/ZGL SETUP Menu PPI/ZGL SETUP 1 ZPL Compatible ZPL-II* ZPL-I Command Prefix 126* 1-255 Label Prefix 94* 1-255 Delimiter 44* 1-255 LP+ Text Mode Absorb* Auto Pass-thru Preparser Command HS Command* ZGL Quiet JA Command Preparser Port Disable* MC Label Fmt List Format* Bitmap Format PQ Label Fmt List Format* Bitmap Format Label Buf Size 560K Bytes* 160-3600K Bytes Host Form Length Enable* Left Position 0* Top Position Ignore Half Vertical
PPI/ZGL SETUP Submenus PPI/ZGL SETUP Con’t FB Width Adjust 0 dots* FB Width Adjust Network ID 0* 0 - 999 Character Group 4 Standard Sets* Greek Set Standard Sets 4 USA 1* Denmark/Norway Arabic Set -100 - 100 dots Cyrillic Set Hebrew Set European Set Turkish Set USA 2 UK Sweden/Finaland Holland German France 1 France 2 Italy Miscellaneous Japan IBM CP 850 Spain UTF-8 Notes: * = Default. Italicized items are available when you enable Admin User (in the PRINTER CONTROL menu).
Chapter 1 PPI/ZGL SETUP Menu Command Prefix This item allows you to select the prefix for the control instructions command. The range is 1-255, and the default is 126. Label Prefix This item allows you to select the prefix for the format instructions command. The range is 1-255, and the default is 94. Delimiter This item allows you to select the delimiter used to separate the parameter of a command. The range is 1-255, and the default is 44.
PPI/ZGL SETUP Submenus MC Label Fmt The ^MC command determines whether the printed label image should be retained for use in the immediately following label definition. The MC Label Fmt option determines the internal format to be used for storing the label image: list format or bitmap format. • List Format (default). Works for most applications and should be used for applications where memory is sufficient. • Bitmap Format. Should be used in applications where a large amount of data is sent.
Chapter 1 PPI/ZGL SETUP Menu Left Position The ^LS command specifies a horizontal offset to be added to all label element positions. The Left Position option displays the value specified by the ^LS command and provides an alternative method for specifying the horizontal offset. The default is 0. Top Position The value of this option specifies a vertical offset to be added to all label element positions in dots per inch.
PPI/ZGL SETUP Submenus IS Label Format The ^IS command saves the printed label image by name for later recall as part of a label definition. The IS Label Fmt option determines the internal format to be used for storing the label image: list format or bit format. • List Format (default). Should be used for most applications due to its greater efficiency of data process. • Bitmap Format.
Chapter 1 PPI/ZGL SETUP Menu Character Group And Character Sets This menu item selects the character set used by the printer. The available character sets are shown below.
2 Fully Supported Commands ^Bx - Barcodes This command selects various barcodes. PPI supports the following ZPL barcodes: ^B1 ^B2 ^B3 ^B5 ^B7 ^B8 ^B9 ^BA ^BC ^BD ^BE ^BI ^BK ^BL ^BM ^BP ^BR ^BS ^BU ^BV ^BX ^BZ Code 11 Interleaved 2 of 5 Code 39 Planet PDF417 EAN-8 UPCE Code 93 Code 128 UPS Maxicode EAN-13 Industrial 2 of 5 Codabar Logmars MSI Plessey RSS UPC/EAN Extensions UPCA BC412 Data Matrix Postnet NOTE: ^BP Plessey does not support optional printing of checkdigit in PDFs.
Chapter 2 When barcodes are generated on printers with unique print densities, the dot ratio of the wide/narrow bar/space does not match the ZPL printer. Match the exact number of dots shifted for each density through trial and error. ^BY - Barcode Defaults This command changes default settings associated with barcodes, including the narrow bar width, the ratio of the wide bar to the narrow bar, and the barcode height.
~EF / ^EF - Erase Format This command deletes all label formats stored with the ^DF Download Format command. ~EG / ^EG - Erase Downloaded Images This command deletes all graphics images previously stored in RAM with various commands (^IS, ~DG, etc.). ^FA - Field Allocate This command allocates space for a dynamic field. ^FC - Field Clock This command sets the clock indicators and the clock mode when used with the Real TIme Clock hardware.
Chapter 2 ^FT - Field Type Set This command sets the x/y coordinate (relative to the “home” position) of a subsequent field. It differs from the ^FO command in that the coordinate is always for the left end of the “baseline” of a field regardless of rotation. ^FW - Field Orientation This command sets the default rotation for commands that have a rotation parameter that is left blank. ^FX - Comment This command allows comments that do not print to be placed in the label definitions.
^HY - Upload Graphic This command uploads different graphic image formats from RAM or Flash to the host. ^IL - Image Load This command recalls an entire label graphic image previously stored in RAM for overlaying with other label data which follows this command. ^IM - Image Move This command recalls the stored graphic bit-image and places it on the label (without magnification).
Chapter 2 ^LL - Label Length This command defines the length of a label in printer dots. Any label printed on continuous media causes the defined length of media to be moved. ^LR - Label Reverse This command provides the ability to reverse print ALL fields following the ^LR in a label (in contrast with the ^FR command which reverse prints only an individual field). ^LS - Label Shift This command shifts the “home” position to the left by a defined number of dots.
~NT - Set Currently Connected Printer Transparent This command sets the currently connected network printer to transparent. ^PM - Print Mirror Image of Label This command prints the entire label as a “mirror image.” ^PW - Print Width This command sets the print width. ^SF - Serialization Field This command allows the user to serialize a standard ^FD string.
Chapter 2 ^XF - Recall Format This command recalls a label definition previously stored with the ^DF Download Format command and merges ^FN dynamic fields to produce a label. ^XG - Recall Graphic This command recalls a stored graphic bit-image and places it on the label. ^XZ - Label End This command denotes the end of a label definition.
3 Command Enhancements And Differences ^A@ - Select Font by Name This command only applies to built-in fonts or bitmap fonts downloaded via the ~DB command. ^Ax - Select Alphanumeric Font PPI uses scalable fonts rather than bitmapped fonts.
Chapter 3 ^B$B - UPCSHIP Command Format: ^B$B fp, hgt, rdt, pos b: UPCSHIP barcode command fp: Barcode orientation N = No Rotation (Default) R = Rotate 90 degrees, clockwise I = Rotate 180 degrees, inverted B = Rotate 90 degrees, counter-clockwise hgt: Barcode Height Value entered in dots at the printer dpi. The default is 10 dots or the height set by the ^BY command. If the height exceeds the label length, then the barcode is cut off at the bottom of the label.
^B$D - FIM Command Format: ^B$D fp, type, height d: FIM barcode command fp: Barcode orientation N = No Rotation (Default) R = Rotate 90 degrees, clockwise I = Rotate 180 degrees, inverted B = Rotate 90 degrees, counter-clockwise type: Type of FIM barcode. Only four choices are valid: A (default), B, C, and D.
Chapter 3 Standard Sets (cont.
European Sets Greek Sets Hebrew Sets Turkish Sets Latin 2 8859-2 300 Code Page 852 301 Mazovia 302 Kamenicky 303 Roman 8 304 PC-437 Slavic 305 Slavic 1250 306 Code Page 865 307 Code Page 860 308 Latin 1 8859-1 309 Latin 5 8859-9 310 Latin 9 8859-15 311 Polish POL1 312 CP 858 EURO 313 DEC 256 Greek 400 ELOT 928 Greek 401 Greek 3 402 ABY Greek 403 ABG Greek 404 ELOT 927 Greek 405 Greek 851 406 Hebrew Old 500 Hebrew New 501 Hebrew DEC 502 Latin-1 Hebrew 503
Chapter 3 Turkish Sets (cont.) Bull Turkish 606 AS400 Turkish 607 Unisys Turkish 608 NCR Turkish 609 PST Turkish 610 UNIS-1 Turkish 611 Code Page 853 612 INFO Turkish 613 ^CW - Font Identifier PPI uses scalable fonts rather than bitmapped fonts.
~DG - Download Graphics The device naming convention differs as follows: ZPL device specifiers: R: DRAM B: Optional Memory E: Extra EPROM Z: Standard EPROM PPI device specifiers: R: DRAM B: FLASH Z: Standard Fonts ~DY - Download Graphic The device naming convention is the same as ~DG. The command does not currently support AR - compressed bitmap font. ^FB - Field Block PPI scalable fonts use proportional character spacing and may have different inter-character gaps.
Chapter 3 ^HR - Calibrate RFID Transponder Position This command initiates an RFID transponder calibration for a specific RFID label and returns the results to the host computer. ~HS - Host Status Return The ~HS command returns various printer status information to the host. The status information is returned in three separate strings, each of which contains several sub-fields.
^JE - Disable Diagnostics This command disables Hex Dump mode. ~JP - Pause & Cancel The PPI ONLINE light is illuminated when the printer is online. ^JU - Configuration Update This command controls whether the printer reprints a label after a fault condition clears. ^JU op, num op = Configuration update operation to perform.
Chapter 3 When LP+ Text Mode is set to “Auto Pass-thru,” non-PPI data is automatically detected and passed through to the LP+ emulation (PPI data is processed normally). If the hex commands 0x02 or 0x03 are received, they are treated as binary data and passed through to the LP+ emulation; they are not treated as the equivalent ^XA and ^XZ commands.
~PP / ^PP - Programmable Pause The ~PP command takes the printer offline as soon as the current label being printed is completed. The exact moment at which this occurs in the label stream may not match exactly. The ^PP command takes the printer offline after the label definition in which the command appears is finished printing.
Chapter 3 ^RZ - Set RFID Tag Password This command lets you define the password for the tag during writing. ~SD - Set Darkness Identical darkness values may not produce the same relative darkness on your printer as ZPL. This command overrides the current value of the darkness setting front panel option. ^SP - Start Print With ZPL I selected, this command is ignored. With ZPL II selected, printing does not start until ^XZ is received.
A ZGL Menu Conversions When substituting a Zebra Xi III model printer with a SL5000r/T5000r printer, refer to the ZGL conversion table below. Table 2: ZGL Menu Zebra Xi lll Series SL5000r/T5000r with ZGL Emulation Darkness - (0 to +30) +10*. Darkness of image on label. QUICK SETUP Menu, Print Intensity - (-15 to +15) -3* Tear Off - (-120 to +120) +0*. Adjusts Tear Off, Peel-Off and Cut position in Dot Rows. QUICK SETUP Menu, Paper Feed Shift - (-0.50 to+12.8) 0.00 Inch*.
Appendix A Table 2: ZGL Menu (continued) Zebra Xilll Series SL5000r/T5000r with ZGL Emulation Print Width - Width of image to be printed in Inches, MM or Dots. Printer width dependent. QUICK SETUP Menu, Label Width - Width of image to be printed in Inches or MM. Printer width dependent. Label Length - Printable length of label in Inches or MM. QUICK SETUP Menu, Label Length - Printable length of label in Inches or MM. Maximum Length - Used to assist in media calibration only.
Table 2: ZGL Menu (continued) Zebra Xilll Series Media Power Up - Media action when the printer is powered up. Feed* - Feeds a label to1st web. Calibration - Recalibrates media when printer is powered up. Length - Determines length of label. No Motion - Media does not move. Head Close - Media action after the printhead is closed. Feed* - Feeds a label to1st web. Calibration - Recalibrates media. Length - Determines length of label. No Motion - Media does not move.
Appendix A Table 2: ZGL Menu (continued) Zebra Xilll Series SL5000r/T5000r with ZGL Emulation Head Resistor - Must be updated when printhead changed. NOTE: Head Resistance detected & updated automatically by SW. Verifier Port - How printer reacts to Optional On-Line Verifier. Off* - Verifier port is off. Off - Default if no validator installed. VALIDATOR Menu (Opt), Validator Funct. - Enable*, Disable. Automatically Enabled when opt installed. Disable = Validator turned off.
Table 2: ZGL Menu (continued) Zebra Xilll Series Save Settings Permanent* - Saves changes even after power is turned off. Temporary - Saves until changed again or until power is turned off. Cancel - Cancels all changes since entering Config mode. Load defaults - Loads Factory defaults. N/A N/A N/A N/A SL5000r/T5000r with ZGL Emulation CONFIG CONTROL Menu, Save Config. - Saves changes to 8 cust. Configs. (same as Zebra Permanent). NOTE: Changes to all configs.
Appendix A Table 2: ZGL Menu (continued) Zebra Xilll Series SL5000r/T5000r with ZGL Emulation Subnet Mask (opt) Dynamic - User may set, but server can assign. Permanent* - User must set. ETHERNET ADDRESS Menu, (opt) Subnet Mask - User sets Subnet Mask for TCP/IP protocol un less it is Dynamic, then read-only. Default Gateway (opt) -Sets Gateway Address. ETHERNET ADDRESS Menu, (opt) Gateway Address - Sets Gateway Address. Print Speed - N/A in menu. Selected via software sent from host.
B ZGL-DBCS Overview This appendix describes the additional and unique commands for • T5000 ThermaLine ZGL-DBCS Series The T5000 ThermaLine ZGL-DBCS include the ZGL-Hangul, ZGL-HanziGB, and ZGL-JAP emulation software ZGL-DBCS is an extension to the existing ZGL (ASCII) emulation supporting Korean KSC, Chinese GB, and Japanese Shift-JIS character printing.
Appendix B ZGL-DBCS Series ZGL-DBCS Series The ZGL-DBCS series include ZGL-Hangul, ZGL-HanziGB, and ZGL-JAP emulation software. High Byte Menu The menu selection “HIGH BYTE” on the Front Panel under MENU MODE -> PGL/ZGL SETUP turns the most significant bit on or off. When “HIGH BYTE” is set to “Disable”, the most significant bit will be turned off and the code point exceeding 0x7F will be skipped. For example, the input code point “0x3061” will be mapped to “0xB0E1” automatically.
Command Syntax Orit Font orientation: N - No rotation (Default) R - Rotate 90 degrees clockwise I - Inverted B - Rotate 270 degrees clockwise For Scalable fonts: Height Individual character height in printer dots Default value: 10 dots Acceptable value: 10 to 1500 Width Individual character width in printer dots Default value: 10 dots Acceptable value: 10 to 1500 NOTE: If ^CI14 or ^CI15 or ^CI22 is not received, even though the font identifier maps to a DBCS font, the functionality of ^Ax will also
Appendix B ZGL-DBCS Series (C) Font Identifier Command Purpose This command assigns a one-character identifier to a built-in or downloaded font. Syntax ^ CWfont_id,{src:}fname ^CW Font Identifier command. font_id The internal character (0-9, A-Z) to be used to identify a font to be substituted or the new font to be added. No default; one character is required for this parameter. {src:} Device source where the font is stored or to be stored.
C Contact Information Printronix Customer Support Center IMPORTANT Please have the following information available prior to calling the Printronix Customer Support Center: • • • • Model number Serial number (located on the back of the printer) Installed options (i.e., interface and host type if applicable to the problem) Configuration printout: Thermal Printer See “Printing A Configuration” in the Quick Setup Guide. Line Matrix Printer Press PRT CONFIG on the control panel, then press Enter.
Appendix C Corporate Offices Corporate Offices Printronix, Inc. 14600 Myford Road P.O. Box 19559 Irvine, CA 92623-9559 Phone: (714) 368-2300 Fax: (714) 368-2600 Printronix, Inc. Nederland BV P.O. Box 163, Nieuweweg 283 NL-6600 Ad Wijchen The Netherlands Phone: (31) 24 6489489 Fax: (31) 24 6489499 Printronix Schweiz GmbH 42 Changi South Street 1 Changi South Industrial Estate Singapore 486763 Phone: (65) 6542 0110 Fax: (65) 6546 1588 Visit the Printronix web site at www.printronix.
*174779-001* 174779-001G
