ZPL II Programming - Excellware

1 zpl ii Programming Guide For Firmware Version and Later 2008 ZIH Corp. The copyrights in this manual and the software and/or firmware in the label printer described therein are owned by ZIH Corp. Unauthorized reproduction of this manual or the software and/or firmware in the label printer may result in imprisonment of up to one year and fines of up to $10,000 (17 ). Copyright violators may be subject to civil liability. This product may contain ZPL , zpl ii , and ZebraLink programs; Element Energy Equalizer Circuit; E3 ; and Monotype Imaging fonts. Software ZIH Corp. All rights reserved worldwide. ZebraLink and all product names and numbers are trademarks, and Zebra, the Zebra logo, ZPL, zpl ii , Element Energy Equalizer Circuit, and E3 Circuit are registered trademarks of ZIH Corp. All rights reserved worldwide. All other brand names, product names, or trademarks belong to their respective holders.

2 For additional trademark information, please see Trademarks on the product CD. Proprietary Statement This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries ( Zebra Technologies ). 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 express, written permission of Zebra Technologies. Product Improvements Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are subject to change without notice. Liability Disclaimer Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

3 Limitation of Liability In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you. Part Number: 13979L-008 Rev. A. Contents Functional Contents .. 17. About This Document .. 23. Who Should Use This Document .. 24. How This Document Is Organized .. 24. Contacts .. 26.

4 Web Site .. 26. The Americas .. 26. Europe, Africa, Middle East, and India .. 26. Asia Pacific .. 26. Document Conventions.. 27. 1 Introduction .. 29. 2 ZPL Commands .. 31. Basic ZPL Exercises and Examples .. 33. Before you begin.. 33. ^A Scalable/Bitmapped Font .. 43. ^A@ Use Font Name to Call Font .. 45. ^B0 Aztec Bar Code Parameters .. 47. ^B1 Code 11 Bar Code .. 49. ^B2 Interleaved 2 of 5 Bar Code .. 51. ^B3 Code 39 Bar Code .. 53. ^B4 Code 49 Bar Code .. 57. ^B5 Planet Code bar code .. 61. ^B7 PDF417 Bar Code .. 62. ^B8 EAN-8 Bar Code .. 66. ^B9 UPC-E Bar Code .. 68. 1/30/08 zpl ii Programming Guide 13979L-008 Rev. A. 4 Contents ^BA Code 93 Bar Code .. 70. ^BB CODABLOCK Bar Code .. 74. ^BC Code 128 Bar Code (Subsets A, B, and C) .. 78. ^BD UPS MaxiCode Bar Code .. 92. ^BE EAN-13 Bar Code .. 95. ^BF MicroPDF417 Bar Code .. 97. ^BI Industrial 2 of 5 Bar Codes .. 100.

5 ^BJ Standard 2 of 5 Bar Code .. 102. ^BK ANSI Codabar Bar Code .. 104. ^BL LOGMARS Bar Code .. 106. ^BM MSI Bar Code .. 108. ^BO Aztec Bar Code Parameters ..110. ^BP Plessey Bar Code ..112. ^BQ QR Code Bar Code ..114. ^BR RSS (Reduced Space Symbology) Bar Code .. 122. ^BS UPC/EAN Extensions .. 124. ^BT TLC39 Bar Code .. 127. ^BU UPC-A Bar Code .. 129. ^BX Data Matrix Bar Code .. 131. ^BY Bar Code Field Default .. 135. ^BZ POSTNET Bar Code .. 137. ^CC ~CC Change Caret .. 139. ^CD ~CD Change Delimiter .. 140. ^CF Change Alphanumeric Default Font .. 141. ^CI Change International Font/Encoding .. 142. ^CM Change Memory Letter Designation .. 146. ^CO Cache On .. 147. ^CT ~CT Change Tilde .. 149. ^CV Code Validation .. 150. ^CW Font Identifier .. 152. ~DB Download Bitmap Font .. 154. ~DE Download Encoding .. 156. ^DF Download Format .. 158. ~DG Download Graphics .. 159. ~DN Abort Download Graphic.

6 162. ~DS Download Intellifont (Scalable Font) .. 163. ~DT Download Bounded TrueType Font .. 164. ~DU Download Unbounded TrueType Font .. 165. ~DY Download Objects .. 166. ~EG Erase Download Graphics .. 170. 13979L-008 Rev. A zpl ii Programming Guide 1/30/08. Contents 5. ^FB Field Block .. 171. ^FC Field Clock .. 174. ^FD Field Data .. 175. ^FH Field Hexadecimal Indicator .. 176. ^FL Font Linking .. 178. ^FM Multiple Field Origin Locations .. 181. ^FN Field Number .. 184. ^FO Field Origin .. 185. ^FP Field Parameter .. 186. ^FR Field Reverse Print .. 187. ^FS Field Separator .. 188. ^FT Field Typeset .. 189. ^FV Field Variable .. 191. ^FW Field Orientation .. 192. ^FX Comment .. 194. ^GB Graphic Box .. 195. ^GC Graphic Circle .. 197. ^GD Graphic Diagonal Line .. 198. ^GE Graphic Ellipse .. 199. ^GF Graphic Field .. 200. ^GS Graphic Symbol .. 202. ~HB Battery Status.

7 204. ~HD Head Diagnostic .. 205. ^HF Host Format .. 206. ^HG Host Graphic .. 207. ^HH Configuration Label Return .. 208. ~HI Host Identification .. 209. ~HM Host RAM Status .. 210. ~HQ Host Query ..211. ~HQ Examples .. 212. ~HS Host Status Return .. 214. ^HT Host Linked Fonts List .. 217. ~HU Return ZebraNet Alert Configuration .. 218. ^HV Host Verification .. 219. ^HW Host Directory List .. 220. ^HY Upload Graphics .. 222. ^HZ Display Description Information .. 223. ^ID Object Delete .. 225. ^IL Image Load .. 227. ^IM Image Move .. 229. 1/30/08 zpl ii Programming Guide 13979L-008 Rev. A. 6 Contents ^IS Image Save .. 230. ~JA Cancel All .. 232. ^JB Initialize Flash Memory .. 233. ~JB Reset Optional Memory .. 234. ~JC Set Media Sensor Calibration .. 235. ~JD Enable Communications Diagnostics .. 236. ~JE Disable Diagnostics .. 237. ~JF Set Battery Condition .. 238. ~JG Graphing Sensor Calibration.

8 239. ^JH Early Warning Settings .. 240. ^JI Start ZBI (Zebra BASIC Interpreter) .. 242. ~JI Start ZBI (Zebra BASIC Interpreter) .. 244. ^JJ Set Auxiliary Port .. 245. ~JL Set Label Length .. 247. ^JM Set Dots per Millimeter .. 248. ~JN Head Test Fatal .. 249. ~JO Head Test Non-Fatal .. 250. ~JP Pause and Cancel Format .. 251. ~JQ Terminate Zebra BASIC Interpreter .. 252. ~JR Power On Reset .. 253. ^JS Sensor Select .. 254. ~JS Change Backfeed Sequence .. 255. ^JT Head Test Interval .. 257. ^JU Configuration Update .. 258. ^JW Set Ribbon Tension .. 259. ~JX Cancel Current Partially Input Format .. 260. ^JZ Reprint After Error .. 261. ~KB Kill Battery (Battery Discharge Mode) .. 262. ^KD Select Date and Time Format (for Real Time Clock) .. 263. ^KL Define Language .. 264. ^KN Define Printer Name .. 265. ^KP Define Password .. 267. ^LF List Font Links .. 268. ^LH Label Home.

9 269. ^LL Label Length .. 270. ^LR Label Reverse Print .. 271. ^LS Label Shift .. 272. ^LT Label Top .. 273. ^MA Set Maintenance Alerts .. 274. ^MC Map Clear .. 276. 13979L-008 Rev. A zpl ii Programming Guide 1/30/08. Contents 7. ^MD Media Darkness .. 277. ^MF Media Feed .. 278. ^MI Set Maintenance Information Message .. 279. ^ML Maximum Label Length .. 280. ^MM Print Mode .. 281. ^MN Media Tracking .. 283. ^MP Mode Protection .. 284. ^MT Media Type .. 286. ^MU Set Units of Measurement .. 287. ^MW Modify Head Cold Warning .. 289. ^NC Select the Primary Network Device .. 290. ~NC Network Connect .. 291. ^ND Change Network Settings .. 292. ^NI Network ID Number .. 294. ~NR Set All Network Printers Transparent .. 295. ^NS Change Wired Networking Settings .. 296. ~NT Set Currently Connected Printer Transparent .. 298. ^PA Advanced Text Properties .. 299. ^PF Slew Given Number of Dot Rows.

10 300. ^PH ~PH Slew to Home Position .. 301. ^PM Printing Mirror Image of Label .. 302. ^PO Print Orientation .. 303. ^PP ~PP Programmable Pause .. 304. ^PQ Print Quantity .. 305. ^PR Print Rate .. 306. ~PR Applicator Reprint .. 308. ~PS Print Start .. 309. ^PW Print Width .. 310. ~RO Reset Advanced Counter ..311. ^SC Set Serial Communications .. 312. ~SD Set Darkness .. 313. ^SE Select Encoding Table .. 314. ^SF Serialization Field (with a Standard ^FD String) .. 315. ^SI Set Sensor Intensity .. 319. ^SL Set Mode and Language (for Real-Time Clock) .. 320. ^SN Serialization Data .. 322. ^SO Set Offset (for Real-Time Clock) .. 324. ^SP Start Print .. 325. ^SQ Halt ZebraNet Alert .. 327. ^SR Set Printhead Resistance .. 329. 1/30/08 zpl ii Programming Guide 13979L-008 Rev. A. 8 Contents ^SS Set Media Sensors .. 330. ^ST Set Date and Time (for Real-Time Clock) .. 332. ^SX Set ZebraNet Alert.