Zebra II Dokumentacja

ZPL II®Programming GuideVolume One: Command Reference for X.10

ZPL II Programming Guide Volume One: Command Reference for X.102

Format: ^COa,b,cParameters:a = cache onAccepted Values: Y (yes) or N (no)Default Value: Yb = amount of additional memory to be added to cache (in K)Ac

Comments: The cache can be resized as often as needed. Any characters in thecache when it is resized are lost. Memory used for the cache reduces the s

^CT ~CTChange TildeDescription: The ^CT and ~CT commands are used to change the control commandprefix. The default prefix is the tilde (~).Format: ^CT

^CVCode ValidationDescription: The ^CV command acts as a switch to turn the code validation functionon and off. When this command is turned on, all ba

Example:The top sample in both columns shows a correctly printed bar code. It is followed byan example of the error messages.Comments: If more than on

^CWFont IdentifierDescription: All built-in fonts have a one-character identifier. The ^CW commandassigns a single alphanumeric character (A through Z

Example:To use MYFONT.FNT stored in DRAM whenever a format calls for Font A:^XA^CWA,R:MYFONT.FNT^XZTo use MYFONT.FNT stored in DRAM as additional Font

~DBDownload Bitmap FontDescription: The ~DB command sets the printer to receive a downloaded bitmapfont, defines native cell size, baseline, space siz

The data structure is:#xxxx.h.w.x.y.i.data#xxxx = character codeh = bitmap height (in dot rows)w = bitmap width (in dot rows)x = x-offset (in dots)y =

~DEDownload EncodingDescription: The standard encoding for TrueType®Windows™ fonts is alwaysUnicode. Therefore, the ZPL field data must be converted f

SECTION ONEZPL II Programming CommandsUsing Section One: ZPL II Command ReferenceThis section contains the complete alphabetical listing of ZPL II com

Example:~DER:JIS.DAT,27848,300021213001...(27848 2-digit hexadecimal values)Comments: For more information on ZTools for Windows, refer to the program

^DFDownload FormatDescription: The ^DF command saves ZPL II format commands as text strings to belater merged using ^XF with variable data. The format

Example:The following is an example of using the ^DF command to download and store ZPLII text strings to non-volatile RAM. The name used to store the

~DGDownload GraphicsDescription: The ~DG (Download Graphic) command performs the followingfunctions:1. Puts the printer into graphics mode.2. Names th

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

Example:The following is an example of using the ~DG command to load a checkerboardpattern into DRAM. The name used to store the graphic is SAMPLE.GRF

~DNAbort Download GraphicDescription: After decoding and printing the number of bytes in parameter t of the^DG command, the printer returns to normal

~DSDownload Scalable FontDescription: The ~DS command is used to set the printer to receive a downloadablescalable font and defines the size of the fo

~DTDownload TrueType FontDescription: The ZTools for Windows program must be used to convert a TrueTypefont to a Zebra-downloadable format. This progr

~DUDownload Unbounded TrueType FontDescription: Some international fonts have more than 256 printable characters.These fonts are supported as “Large T

Example: When the command is best clarified in context, an example of the ZPL IIcode is provided. Text indicating exact code entered by the user is pr

~DYDownload GraphicsDescription: ~DY downloads to the printer graphic objects in any supported format.This command can be used in place of ~DG for mor

~EFErase Stored FormatsDescription: The ~EF command erases all stored formats.Format: ~EFComments: The ~EF command is no longer recommended for use! I

^FBField BlockDescription: The ^FB command allows you to print text into a defined “block type ”format. This command formats an ^FD text string into a

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

Comments on the ^FB CommandThe following scheme can be used to facilitate special functions.“ \& ” = carriage return/line feed“ \(*)” = soft hyphe

^FCField Clock (for Real Time Clock)Description: The ^FC command is used to set the clock-indicators (delimiters) andthe clock mode, for use with the

^FDField DataDescription: The ^FD command defines the data string for the field. The field datacan be any printable character except those used as com

^FHField Hexadecimal IndicatorDescription: The ^FH command allows you to enter the hexadecimal value for anycharacter directly into the ^FD statement.

Example:^FO100,100^AD^FH^FDTilde _7e used for HEX^FS^FO100,100^AD^FH\^FDTilde \7E used for HEX^FSBoth of the lines of code above will print the follow

^FMMultiple Field Origin LocationsDescription: The ^FM command allows you to control the placement of bar codesymbols.It designates field locations fo

^AScalable/Bitmapped FontDescription: The ^A command is used with build-in or TrueType®fonts. ^Adesignates the font for the current ^FD statement or f

Examples:This example assumes a maximum of three bar codes:^FM100,100,200,200,300,300^B7N,5,5,,83,N^FD<data>^FSBar code 1 is at position 100, 10

^FNField NumberDescription: The ^FN command is used to number data fields. This command isused in both Store Format (^DF) and Recall Format (^XF) oper

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:STO

^FOField OriginDescription: The ^FO command sets a field origin, relative to the label home (^LH)position. ^FO sets the upper-left corner of the field

^FPField ParameterDescription: The ^FP command allows vertical formatting of the font field, which iscommonly used for Asian fonts.Format: ^FPd,gParam

^FRField Reverse PrintDescription: The ^FR command allows a field to appear as white over black orblack over white. When printing a field and the ^FR

^FSField SeparatorDescription: The ^FS command denotes the end of the field definition.Alternatively, the field separator command can also be issued a

^FTField TypesetDescription: The ^FT command also sets the field position, relative to the homeposition of the label designated by the ^LH command. Th

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

^FVField VariableDescription: ^FV replaces the ^FD (field data) command in a label format when thefield is variable.Format: ^FVParameters:a = variable

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^XZBitmap Font Comma

^FWField OrientationDescription: The ^FW command sets the default orientation for all command fieldsthat have an orientation (rotation) parameter. Fie

^FXCommentDescription: The ^FX command is useful when you want to add a “non-printing”informational comment or statement within a label format. Any da

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^GB4

^GBGraphic BoxDescription: The ^GB command is used to draw boxes and/or lines as part of a labelformat. Boxes and lines are use to highlight important

Examples:Width: 1.5 inch; Height: 1 inch; Thickness: 10; Color: default; Rounding: default^XA^FO150,100^GB305,203,10^XZWidth: 0 inch; Height: 1 inch;

^GCGraphic CircleDescription: The ^GC command produces a circle on the printed label. Thecommand parameters specify the diameter (width) of the circle

Example: The following code will generate a label image similar to the one seenbelow.^XA^FO100,100^GC250,10,B^FS^XZZPL II Programming Guide Volume One

^GDGraphic Diagonal LineDescription: The ^GD command produces a straight diagonal line connecting onecorner with the opposite corner of a box closing

Example: The following code will generate a label image similar to the one seenbelow.^XA^FO150,100^GB350,203,10^FS^FO155,110^GD330,183,10,,R^FSZPL II

^GEGraphic EllipseDescription: The ^GE command will produce an ellipse in the label format.Format: ^GEw,h,t,cParameters:w = ellipse width (in dots)Acc

^A@Use Font Name to Call FontDescription: The ^A@ command uses the complete name of a font, rather than thecharacter designation used in ^A. Once ^A@

Example: The following code will generate a label image similar to the one seenbelow.^XA^FO100,100^GE300,100,10,B^FS^XZZPL II Programming Guide Volume

^GFGraphic FieldDescription: The ^GF command allows you to download graphic field data directlyinto the bitmap. This command follows the conventions f

data = dataAccepted Values:ASCII hexadecimal data: 00 to FFA string of ASCII hexadecimal numbers, 2 digits per imagebyte. CR and LF can be inserted as

^GSGraphic SymbolDescription: The ^GS command enables you to generate the registered trademark,copyright symbol, and other symbols.Format: ^GSo,h,wPar

~HBBattery StatusDescription: When the ~HB command is sent to the Zebra printer, a data string issent back to the Host. The string starts with an <

^HGHost GraphicDescription: The ^HG command is used to upload graphics to the host. The graphicimage can be stored for future use, or it can be downlo

~HIHost IdentificationDescription: The ~HI command is designed to be sent from the host to the Zebraprinter to retrieve information. Upon receipt, the

~HMHost Memory StatusDescription: Sending the ~HM to the printer immediately returns a memory statusmessage to the host. Use this command whenever you

~HSHost Status ReturnDescription: When ~HS is sent to the printer, three data strings are sent back to theHost. Each string starts with an <STX>

String 2<STX>mmm,n,o,p,q,r,s,t,uuuuuuuu,v,www<ETX><CR><LF>mmm = function settings*n = unusedo = “head up” flag (1 = head in up

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^XZThe first line w

~HUHost UnsolicitedDescription: This command will return the table of configured ZebraNet ALERTsettings to the host.Format: ~HUExample:If the ~HU comm

^HWHost Directory ListDescription: ^HW is used to transmit a directory listing of objects in a specificmemory area (storage device) back to the host d

Format: ^HWd:o.xParameters:d = location to retrieve object listingAccepted Values: E:, B:, R:Default Value: DRAMo = object nameAccepted Values: any 1

^HYUpload GraphicsDescription: The ^HY command is an extension of the ^HG command. ^HY isused to upload graphic objects from the printer in any suppor

^HZADisplay All Description InformationDescription: The ^HZA command is used for returning complete printer descriptioninformation in XML. The printer

^HZFFormat Parameter Setting InformationDescription: This command will return the printer’s format parameter settinginformation in XML. Data returned

^HZLObject Directory Listing InformationDescription: The ^HZL command will return the printer’s object directoryinformation in XML. Refer to Chapter 6

^HZOIndividual Object Data InformationDescription: The ^HZO command will return object data from the printer. Refer toChapter 6 (XML: Super Host Statu

^HZRStatus InformationDescription: The ^HZR command returns status information from the printer. Referto Chapter 6 (XML: Super Host Status) in Volume

^IDObject DeleteDescription: The ^ID command deletes objects, graphics, fonts, and stored formatsfrom storage areas selectively or in groups. This com

^B1Code 11 Bar CodeDescription: The ^B1 command is also known as USD-8 code. In a Code 11 barcode, each character is composed of three bars and two sp

Example:To delete stored formats from DRAM:^XA^IDR:*.ZPL^XZTo delete formats and images named SAMPLE from DRAM, regardless of theextension:^XA^IDR:SAM

^ILImage LoadDescription: The ^IL command is used at the beginning of a label format to load astored image of a format and merge it with additional da

Example:The following example recalls the stored image SAMPLE2.GRF from DRAM andoverlays it with the additional data. The graphic was stored using the

^IMImage MoveDescription: The ^IM command performs a direct move of an image from storagearea into the bitmap. The command is identical to the Recall

^ISImage SaveDescription: The ^IS command is used within a ZPL II label format to save thatformat as a graphic image. This command is used within a la

Example:The following is an example of using the ^IS command to save a label format toDRAM. The name used to store the graphic is SAMPLE2.GRF.^XA^LH10

~JACancel AllDescription: The ~JA command cancels all format commands in the buffer. It alsocancels any batches that may be printing.The printer will

^JBInitialize Flash MemoryDescription: The ^JB command is used to initialize the two types of Flash memoryavailable in the Zebra printers.Format: ^JBa

~JBReset Optional MemoryDescription: The ~JB command is used for the following conditions:•This command must be sent to the printer if the battery sup

^JCSet Media Sensor CalibrationDescription: The ~JC command is used to force a label length measurement andrecalibrate the media and ribbon sensors.Fo

Example:Comments: If additional information about the Code 11 Bar Code is required, referto Appendix H in Volume Two for AIM, Inc. contact information

~JFSet Battery ConditionDescription: There are two low battery voltage levels sensed by the PA/PT400™printers. When battery voltage goes below the fir

~JGGraphing Sensor CalibrationDescription: The ~JG command is used to force a label length measurement,recalibrate the media and ribbon sensors and pr

^JJSet Auxiliary PortDescription: The ^JJ command allows you to control an on-line verifier orapplicator device.Format: ^JJa,b,c,d,e,fParameters:a = o

c = application mode start signal printAccepted Values:p = pulse mode – Start Print signal must be de-asserted before itcan be asserted for the next l

~JLSet Label LengthDescription: The ~JL command is used to set the label length. Depending on size oflabel, the printer will feed one or more blank la

^JMSet Dots per MillimeterDescription: Use the ^JM (Set Dots/Millimeter) command to double the format sizeof the label . Depending on the print head,

~JNHead Test FatalDescription: The ~JN command resets the printhead element error override, actingas a toggle for ~JO. If the Head Test Fatal option i

~JPPause and Cancel FormatDescription: The ~JP command clears the format currently being processed andplaces the printer in the Pause mode.The command

~JRPower On ResetDescription: The ~JR command resets all of the printer’s internal software,performs a power-on self-test (POST), clears the buffer an

~JSChange Backfeed SequenceDescription: The ~JS command is used to control the backfeed sequence. Thiscommand can be used on printers with or without

^B2Interleaved 2 of 5 Bar CodeDescription: The ^B2 command is a high density, self-checking, continuous,numeric symbology.Each data character for the

The value for this command is also reflected in the “Backfeed” parameter on theprinter configuration label.For ~JSN – the “Backfeed” parameter is list

^JTHead Test IntervalDescription: The ^JT command lets you change the printhead test interval from 100to any desired interval. The ^JT command allows

^JUConfiguration UpdateDescription: The ^JU command sets the active configuration for the printer.Format: ^JUaParameters:a = active configurationAccep

~JXCancel Current Partially Input FormatDescription: The ~JX command cancels a format that is currently being sent to theprinter. It does not affect a

~KBKill Battery (Battery Discharge Mode)Description: In order to maintain performance of the rechargeable battery of theportable printers, the battery

^KDDate/Time Format (for Real Time Clock)Description: The ^KD command is used to select the format in which the Real TimeClock’s date and time informa

^KLDefine LanguageDescription: The ^KL command is used to select the language used for the frontpanel display.Format: ^KLaParameters:a = languageAccep

^KNDefine Printer NameDescription: The printer’s network name and description can be set using the ^KNcommand. ^KN is designed to make your Zebra prin

^KPDefine PasswordDescription: The ^KP command is used to define the password that must be enteredto access the front panel switches and LCD set up mo

^LHLabel HomeDescription: The ^LH command sets the label home position.The default home position of a label is the upper-left corner (position 0,0 alo

Proprietary StatementThis manual contains proprietary information of Zebra Technologies Corporation. It is intended solely for theinformation and use

Example: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 numbe

^LLLabel LengthDescription: The ^LL command defines the length of the label. This command isnecessary when using continuous media (i.e. media not divi

^LRLabel Reverse PrintDescription: The ^LR command reverses the printing of all fields in the labelformat. It allows a field to appear as white over b

^LSLabel ShiftDescription: The ^LS command allows for compatibility with Z-130 printer formatsthat are set for less than full label width. It is used

^LTLabel TopDescription: The ^LT command moves the entire label format a maximum of 120dot rows up or down from its current position with respect to t

^MCMap ClearDescription: In normal operation, the bitmap is cleared after the format has beenprinted. The ^MC command is used to retain the current bi

^MDMedia DarknessDescription: This ^MD command adjusts the darkness relative to the currentdarkness setting. The minimum value is -30 and the maximum

^MFMedia FeedDescription: The ^MF command dictates what happens to the media at power-upand at head-close after the error is cleared.Format: ^MFp,hPar

^MLMaximum Label LengthDescription: The ^ML command lets you adjust the maximum label length.Format: ^MLaParameters:a = maximum label length (in dot r

^MMPrint ModeDescription: The ^MM command determines the action the printer takes after alabel or group of labels has been printed. There are four dif

Format: ^MMa,bParameters:a = desired modeAccepted Values:T = tear offP = peel off (not available on S-300)R = rewindA = applicatorC = cutterDefault Va

^B3Code 39 Bar CodeDescription: The Code 39 bar code is the standard for many industries, including theU.S. Department of Defense (DOD). It is one of

^MNMedia TrackingDescription: The ^MN command relays to the printer what type of media is beingused (continuous or non-continuous) for purposes of tra

^MPMode ProtectionDescription: The ^MP command is used to disable the various Mode functions onthe front panel. Once disabled, the settings for the pa

^MTMedia TypeDescription: The ^MT command selects the type of media being used in the printer.There are two choices for this command:1. Thermal Transf

^MUSet Units of MeasurementDescription: This command sets the printer units of measurement. The ^MUcommand works on a field-by-field basis. Once the m

Example 2: Converting DPI Values:Convert a 150 dpi format to a 300 dpi format with a base in dots:^MUd,150,300Convert a 150 dpi format to a 600 dpi fo

~NCNetwork ConnectDescription: The ~NC command is used to connect a particular printer into thenetwork by calling up the printer’s Network ID Number.F

^NINetwork ID NumberDescription: The ^NI command is used to assign a Network ID number to theprinter. This must be done before the printer can be used

~NTSet Currently Connected Printer TransparentDescription: The ~NT command sets the currently connected network printertransparent.Format: ~NTComments

^PFSlew Given Number of Dot RowsDescription: The ^PF command causes the printer to slew labels (move labels at ahigh speed without printing) a specifi

^PH ~PHSlew to Home PositionDescription: The ~PH or ^PH (Slew to Home Position) command causes the printerto feed one blank label.•The ~PH command fee

Example:Comments: Extended ASCII is a function of the scanner, not of the bar code. Yourscanner must have Extended ASCII enabled in order for this fea

^PMPrinting Mirror Image of LabelDescription: The ^PM command prints the entire printable area of the label as amirror image. This command flips the i

^POPrint OrientationDescription: The ^PO command inverts the label format 180 degrees. In essence,the label is printed upside-down. If the original la

Example:The ^POI command moves the Label Home position to the furthest point away fromthe main frame. Therefore, a different ^LH (Label Home) can be u

^PP ~PPProgrammable PauseDescription: The ~PP command stops printing after the current label is printed (ifone is printing) and places the printer in

^PQPrint QuantityDescription: The ^PQ command gives control over several printing operations. Itcontrols the number of labels to print, the number of

^PRPrint RateDescription: The ^PR command determines the media speed during printing and theslew speed (feeding a blank label).The printer will operat

b = backfeed speedAccepted Values:A or 2 50.8 mm/sec. (2 inches/sec.)B or 3 76.2 mm/sec. (3 inches/sec.)C or 4 101.6 mm/sec. (4 inches/sec.)5 127 mm/s

~PRApplicator ReprintDescription: The ~PR command is only supported by the PAX and PAX2-Seriesprinters. If the ~PR command is enabled (refer to ^JJ),

^PWPrint WidthDescription: The ^PW command allows you set the print width.Format: ^PWaParameters:a = label width in dotsComments: The ^PW command is n

^SCSet CommunicationsDescription: The ^SC command allows you to change the communicationsparameters you are using.Format: ^SCa,b,c,d,e,fParameters:a =

Full ASCII Mode for Code 39Code 39 can generate the full 128-character ASCII set using paired characters asshown in Table A and Table B.Table A: Code

~SDSet DarknessDescription: The ~SD command lets you set the darkness of printing via ZPL. It isequivalent to the darkness setting parameter on the fr

^SFSerialization Field (with a Standard ^FD String)Description: The ^SF command allows the user to serialize a standard ^FDstring. Fields serialized w

Example:^FD12A^SFnnA,CThis mask has the first characters as alphanumeric (nn = 12) and the last digit asupper case alphabetic (A). The decimal value o

^SLSet Mode/Language (for Real Time Clock)Description: The ^SL command is used to specify the Real Time Clock’s mode ofoperation and language for prin

^SNSerialization DataDescription: The ^SN command allows the printer to index data fields by a selectedincrement or decrement value (i.e., make the da

Example:Comments: Incrementing and decrementing takes place for each serial-numberedfield when all replicates for each serial number have been printed

Using Leading ZerosIn the ^SN command, the z parameter determines if leading zeros will be printed orsuppressed. The default value for this parameter

^SOSet Offset (for Real Time Clock)Description: The ^SO command is used to set the secondary and the tertiary offsetfrom the primary Real Time Clock.F

^SPStart PrintDescription: The ^SP command allows a label to start printing at a specified pointbefore the entire label has been completely formatted.

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

Table B: Code 39 Full ASCII ModeASCII Code 39@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_%VABCDEFGHIJKLMNOPQRSTUVWXYZ%K%L%M%N%OASCII Code 39‘abcdefghIjklmnopqrstu

^SQHalt ZebraNet ALERTDescription: The ^SQ command is used to stop the ZebraNet ALERT option.Format: ^SQa,b,cParameters:a = condition A through Q or *

^SRSet Printhead ResistanceDescription: The ^SR command allows you set the printhead resistance.Format: ^SR#Parameters:# = resistance value (4-digit n

^SSSet Media SensorsDescription: The ^SS command is used to change the values for media, web, ribbonand label length set during the media calibration

a = mark sensing (3-digit value)Accepted Values: 000 to 100Default Value: The value calculated in the calibration process.b = mark media sensing (3-di

^STSet Time/Date (for Real Time Clock)Description: The ^ST command sets the time and date of the Real Time Clock.Format: ^STa,b,c,d,e,f,gParameters:a

d = hourAccepted Values: 00 to 23Default Value: current houre = minuteAccepted Values: 00 to 59Default Value: current minutef = secondAccepted Values:

^SXSet ZebraNet ALERTDescription: The ^SX command is used to configure the ZebraNet ALERT system.Format:^SXa,b,c,d,e,fParameters:a = condition typeAcc

c = enable “condition set” alert to this destinationAccepted Values: Y (yes) or N (no)Default Value: Y or previously configured valued = enable “condi

^SZSet ZPLDescription: The ^SZ command is used to select the programming language used bythe printer. This command gives you the ability to print labe

~TATear-off Adjust PositionDescription: The ~TA command lets you adjust the rest position of the media after alabel is printed, which changes the posi

^B4Code 49 Bar CodeDescription: The ^B4 command is a multi-row, continuous, variable-lengthsymbology capable of encoding the full 128-character ASCII

^TOTransfer ObjectDescription: The ^TO command is used to copy an object or group of objects fromone storage device to another. It is quite similar to

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 be

Transferring Multiple ObjectsThe asterisk (*) can be used to transfer multiple object files (except *.FNT) from theDRAM to the Memory Card. For exampl

~WCPrint Configuration LabelDescription: The ~WC command is used to generate a printer configuration labelThe printer configuration label contains inf

^WDPrint Directory LabelDescription: The ^WD command is used to print a label listing bar codes, objectsstored in DRAM, or fonts.For bar codes, the li

Example:To print a label listing all objects in DRAM, enter:^XA^WDR:*.*^XZTo print a label listing all the bar codes.^XA^WDZ:*.BAR^XZTo print a label

^XAStart FormatDescription: The ^XA command is used at the beginning of ZPL II code. It is theopening bracket and indicates the start of a new label f

^XBSuppress BackfeedDescription: The ^XB command suppresses forward feed of media to tear-offposition depending on the current printer mode. Since no

^XFRecall FormatDescription: The ^XF command recalls a stored format to be merged with variabledata. There can be multiple ^XF commands and they can b

^XGRecall GraphicDescription: The ^XG command is used to recall one or more graphic images forprinting. This command is used in a label format to merg

m = starting modeAccepted Values:0 = Regular Alphanumeric Mode1 = Multiple Read Alphanumeric2 = Regular Numeric Mode3 = Group Alphanumeric Mode4 = Reg

^XZEnd FormatDescription: The ^XZ command is the ending (closing) bracket. It indicates the endof a label format. When this command is received, a lab

ZPL II Programming Guide Volume One: Command Reference for X.10253

Part # 13903L-001 Rev. A© 2005 ZIH Corp.Zebra Technologies Corporation333 Corporate Woods ParkwayVernon Hills, Illinois 60061.3109 U.S.A.Telephone: +1

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-.SPACE$/++%< (Shift 1)> (Shift 2): (N.A.); (N.A.)? (N.A.)= (Numeric Shift)Field DataSetUnshiftedCharacter S

Code 49 Field Data Character SetThe ^FD data sent to the printer when using starting modes 0 to 5 is based on theCode 49 Internal Character Set. This

^B7PDF417 Bar CodeDescription: The ^B7 command is a two-dimensional, multi-row, continuousstacked symbology. PDF417 is capable of encoding over 1,000

Table of ContentsINTRODUCTION: Volume OneWelcome to ZPL II Programming for X.10 Firmware...1SECTION ON

r = number of rows to encodeAccepted Values: 3to90Default value: 1:2 row-to-column aspect ratio.The user can specify the number of symbol rows giving

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 ro

Special Considerations for ^BY When Using PDF417When used with ^B7, the parameters for the ^BYw,r,t command are:w = module width. Default = 2. Limited

^B8EAN-8 Bar CodeDescription: The ^B8 command is the shortened version of the EAN-13 bar code.EAN is an acronym for European Article Numbering. Each c

Example:Comments: If additional information about the EAN-8 Bar Code is required, refer toAppendix H in Volume Two for AIM, Inc. contact information.E

^B9UPC-E Bar CodeDescription: The ^B9 command is a variation of the UPC symbology used fornumber system 0. It is a shortened version of the UPC-A bar

Example:Four Rules for Proper Product Numbers1. If the last three digits in the manufacturer’s number are 000, 100, or 200,valid Product Code numbers

^BACode 93 Bar CodeDescription: The ^BA command is a variable length, continuous symbology. It isused in many of the same applications as Code 39. It

g = print interpretation line above codeAccepted Values: Y (yes) or N (no)Default Value: Ne = print check digitAccepted Values: Y (yes) or N (no)Defau

Full ASCII Mode for Code 93Code 93 can generate the full 128-character ASCII Set using paired characters asshown in tables A and B.Table A: Code 93 Fu

^BP–PlesseyBarCode...61^BQ–QRCodeBarCode...

Table B: Code 93 Full ASCII ModeASCII Code 93‘abcdefghIjklmnopqrstuvwxyz{|}~DEL‘W)A)BCDEFGHIJKLMNOPQRSTUVWXYZ‘P‘Q‘R‘S‘T))))))))))))))))))))))))ASCII C

^BBCODABLOCK Bar CodeDescription: The ^BB command is a two-dimensional multi-row, stackedsymbology. It is ideally suited for applications that require

r = number of rows to encodeAccepted Values:CODABLOCK A: 1 to 22CODABLOCK E and F: 2 to 4•If values for c and r are not specified, a single row will b

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

Special Considerations for the ^BY Command When Using ^BBThe parameters for the ^BYw,r,h command, when used with a ^BB code, are asfollows:w = Module

^BCCode 128 Bar Code (Subsets A, B, and C)Description: The ^BC command is a high-density, variable length, continuous,alphanumeric symbology. It was d

m = modeAccepted Values:N – no selected modeU – UCC Case ModeA – Automatic Mode. This analyzes the data sent andautomatically determines the best pack

The following tables represent the Code 128 Character Sets.Code ASP!''#$%&'()*++,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTCode

Special Conditions if UCC Case Mode is Selected1. More than 19 digits in ^FD or ^SN will be eliminated.2. Fewer than 19 digits in ^FD or ^SN will add

Example of Code 128 – Subset BSince Code 128 Subset B is the most commonly used subset, ZPL II defaults toSubset B if no start character is specified

^FO–FieldOrigin...125^FP–FieldParameter...

Example of Code 128 – Subsets A and CCode 128, Subsets A and C are programmed as pairs of digits, 00-99, in the fielddata string (refer to the Code 12

^BDUPS MaxiCode Bar CodeDescription: The ^BD command creates a two-dimensional, optically read (notscanned) code. This symbology was developed by UPS

Example:^XA^FO50,50^CVY^BD^FH^FD001840152382802[)>_1E01_1D961Z00004951_1DUPSN_1D_06X610_1D159_1D1234567_1D1/1_1D_1DY_1D634 ALPHA DR_1DPITTSBURGH_1D

Non-U.S. Style Postal Code (Mode 3)<hpm> = aaabbbccccccaaa = three-digit class of servicebbb = three-digit country zip codeccccc = six-digit zip

^BEEAN-13 Bar CodeDescription: The ^BE command is similar to the UPC-A bar code. It is widely usedthroughout Europe and Japan in the retail marketplac

Example:Comments: The EAN-13 bar code uses the Mod 10 check-digit scheme for errorchecking. For more information on Mod 10, refer to Appendix C in Vol

^BFMicro-PDF417 Bar CodeDescription: The ^BF command is a two-dimensional, multi-row, continuous,stacked symbology identical to PDF417, except it repl

Example: The following ZPL II code will generate the bar code printed at left:^XA^BY6^BFN,8,3^FDABCDEFGHIJKLMNOPQRSTUV^FS^XZTo encode data into the Mi

Micro-PDF417 Mode Table8172632445520355267829310514263849679613216720223732496785111155208261313366206121822303814243646566472101826344666901141381622

^BIIndustrial 2 of 5 Bar CodeDescription: The ^BI command is a discrete, self-checking, continuous numericsymbology. Industrial 2 of 5 bar code has be

~JB–ResetOptionalMemory...170^JC–SetMediaSensorCalibration...

Example: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 i

^BJStandard 2 of 5 Bar CodeDescription: The ^BJ command is a discrete, self-checking continuous numericsymbology.With Standard 2 of 5, all of the info

Example: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 inf

^BKANSI CodabarDescription: The ^BK command is currently used in a variety of informationprocessing applications such as libraries, the medical indust

l = designates stop characterAccepted Values: B, C, D, E, N, T, or *Default Value: AExample:Comments: If additional information about the ANSI Codabar

^BLLOGMARS Bar CodeDescription: The ^BL command is a special application of Code 39 used by theDepartment of Defense (DOD). LOGMARS is an acronym for

Example:Comments: The LOGMARS bar code produces a “mandatory” check digit usingMOD 43 calculations. For further information, refer to Appendix D in Vo

^BMMSI Bar CodeDescription: The ^BM command is a pulse-width modulated, continuous, non-selfchecking symbology. It is a variant of the Plessey bar cod

e2 = designates start characterAccepted Values: Y (yes) or N (no)Default Value: NExample:Comments: If additional information about the MSI bar code is

^BPPlessey Bar CodeDescription: The ^BP command is a pulse-width modulated, continuous, non-self-checking symbology.Each character in the Plessey bar

^MD–MediaDarkness...197^MF–MediaFeed...

Example:Comments: If additional information about the Plessy bar code is required, refer toAppendix H in Volume Two for AIM, Inc. contact information.

^BQQR Code Bar CodeDescription: The ^BQ command produces a matrix symbology consisting of anarray of nominally square modules arranged in an overall s

Example:The following ZPL II code will generate the label printed below.^XA^FO20,20^BQN,2,10^FDMM,AAC-42^FS^XZComments: If additional information abou

Considerations for ^FD When Using the QR Code:QR Switches (formatted into the ^FD field data)Mixed mode <D>D = allows mixing of different types

Data input <A, M>A = Automatic input (default). Data character string JIS8 unit,Shift JIS. When the input mode is automatic input, the binarycod

<Error Correction level> H (ultra-high reliability level)<input mode> M (manual input)<character mode> N (numeric data)<data char

Example: QR code, mixed mode with manual data input^XA^FO,20,20^BQ,2,10^FDD03048F,LM,N0123456789,A12AABB,B0006qrcode^FS^XZ<Mixed mode identifier>

^BSUPC/EAN ExtensionsDescription: The ^BS (UPC/EAN extensions) command is the 2- and 5-digit add-onused primarily by publishers to create bar codes fo

UPC/EAN Two-Digit Example:UPC/EAN Five-Digit Example:UPC/EAN Two-digitCharacters0123456789UPC/EAN Five-digitCharacters0123456789ZPL II Programming Gui

Care should be taken in positioning the UPC/EAN extension with respect to theUPC-A or UPC-E code to insure the resultant composite code is within the

^SS–SetMediaSensors...234^ST–SetTime/Date(forRealTimeClock)..

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 o

^BUUPC-A Bar CodeDescription: The ^BU command is a fixed length, numeric symbology. It isprimarily used in the retail industry for labeling packages.

The font style of the interpretation line depends on the modulus (width of narrowbar) selected in ^BY:6 dot/mm printer: A modulus of 2 dots and greate

^BXData Matrix Bar CodeDescription: The ^BX command is a two-dimensional matrix symbology which ismade up of square modules arranged within a perimete

r = rows to encode (9 to 49)Odd values only for quality 0 to 140 (10 to 144); even values only forquality 200.The number of rows and columns in the sy

Example:Effects of ^BY on ^BXw = module (no effect – see dimensions of individual symbol elements)r = ratio (no effect)h = height of symbolIf the dime

The input string escape sequences may be embedded in Quality 200 field data usingthe _ character (ASCII 45, underscore) or the character entered in pa

^BYBar Code Field DefaultDescription: The ^BY command is used to change the default values for the NarrowElement Module (Narrow Bar or Space) Width, t

Comments: Once a ^BY command is entered into a label format, it stays in effectuntil another ^BY command is encountered.123456789102.02.12.22.32.42.52

^BZPOSTNET Bar CodeDescription: The POSTNET bar code is used to automate the handling of mail.POSTNET uses a series of five bars, two tall and three s

INTRODUCTIONVolume OneWelcome to ZPL II Programming for X.10 FirmwareZPL II Programming Guide Volume One: Command Reference for X.10 is designedfor us

Example:Comments: If additional information about the POSTNET Bar Code is required,refer to Appendix H in Volume Two for AIM, Inc. contact information

^CC ~CCChange CaretDescription: The ^CC and ~CC commands are used to change the format commandprefix. The default prefix is the caret (^).Format: ^CCx

^CD ~CDChange DelimiterDescription: The ^CD and ~CD commands are used to change the ZPL II delimitercharacter. This character is used to separate para

^CFChange Alphanumeric Default FontDescription: You can use the ^CF command to keep your programs simple. The^CF command sets the default font used in

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^F

^CIChange International FontDescription: Zebra printers can print all fonts using various international charactersets: USA1, USA2, UK, Holland, Denmar

d1 = destination 1 (new position for the character referred to in s1)Accepted Values: decimals 0 to 255s2 = source 2 (character position to be remappe

^CMChange Memory Letter DesignationDescription: The ^CM command allows the user to reassign a letter designation tothe printer’s memory devices. If a

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^XAThis e

^COCache OnDescription: The ^CO command is used to change the size of the character cache.By definition, a “character cache” (from here on referred to