ZPL 编程指南

分类

条码知识

标签

斑马打印机

ZPLII语言概述

ZPL语言是一种script语言，分为ZPL语言和ZPL II语言
Zebra打印机支持最广泛的一种语言
ZPLII语言支持复杂标签格式，如文字，图片，条形码，序列号打印等等
ZPLII文件可以通过以下两种方式实现：
- 纯文本编辑器
- 标签设计软件，如Zebra Designer、E-Label

ZPLII与ZPL的区别

ZPL II 不是 100% 兼容ZPL
主要差别：
- 对于ZPL II，当指令被接收时，就会立刻被执行，对于ZPL，只有当打印机接收到AXZ (End Format)时，才执行接收的所有指令
- —些ZPL中的指令，在ZPL II中被增强或扩展
- ZPLII支持小写、大写或大小写混合输入的指令
- 增加了一些新的命令

ZPL II语言功能

打印各种标签格式
- 文本、图形、条形码
设置打印机参数
获取打印机配置及状态信息

ZPL II语言相关概念

域(field)
ZPL对象
- 图片
- 标签格式文件

打印机设备名称

打印机存储设备
- 指定ZPL II的目标对象（图像，标签格式，字体）到不同的存储区域
存储设备名称：
- R: Printer DRAM library (read/write)内存
- B: Optional memory：等可选配的存储器PCMCIA卡
- E: Flash memory (read/write)闪存
- Z: Internal ZPL II stored object library (read only)
- A: CF卡(可读写）
- 默认存储器为DRAM
调用对象时，搜索的优先顺序：DRAM，RAM，extra EPROMjnternal ZPL II (R:，B:，E:， Z:，* or ? (All))

指令种类

格式指令（format commands)
- 以八开始
- 用于设定标签格式与数据
- 多条格式指令按顺序执行
控制指令(control commands)
- 以〜开始）Giri.Gom
- 迫使打印机立即执行某一个指定的操作
- 可以中断打印机数据缓冲器中的格式指令

格式指令

ZPL格式指令有以下分类

格式框架指令-format bracket commands
标签定义指令-label definition commands
字段定义指令-field definition commands
字段默认指令-field default commands
格式默认指令-format default commands
格式旋转指令-format rotation commands
打印机控制指令-printer control commands
文字数字字段指令-alphanumeric field commands
条形码字段指令-bar code field commands
图像指令-graphic image commands

更改指令前缀符

符号(^)是ASCII字符，等于5E HEX， 94 Decimal
符号(~）是ASCII字符，等于7E HEX， 126 Decimal
格式指令和控制指令的时缀符可以通过 ZPLII指令进行更改
- ^CT or ~CT (change tilde ~）
- ^CC or ~CC (change caret ^)

ZPL 配置

通过 ZPL 编程管理打印机配置

为快速打印出第一张标签，已将打印机设计为可以动态更改打印机设置。常用的打印机参数将会被保留下来，以供后续格式使用。在后续命令更改这些设置，打印机复位，加电循环或在使用 “ 进纸按钮模式 ” 四 (4) 次闪烁过程恢复出厂默认参数值之前，这些设置始终生效。 ZPL 配置更新命令 (^JU) 可用于保存和恢复打印机配置，以使用预先配置的设置初始化或重新初始化打印机。

要在加电循环或重置打印机后保留设置，应将 ^JUS 命令发送到打印机，以保存当前常用的所有设置。
使用 ^JUR 命令调出值，将最后保存的值恢复到打印机。

如上所述， ZPL 通过一条命令即可存储所有参数。Zebra GK888支持的旧式 EPL 编程语言可以立即更改并保存单独的命令。大多数配置和设置可在 ZPL 与 EPL 之间共享。例如，使用 EPL 命令更改速度设置，也会更改为 ZPL 操作设置的速度。通过两者中任意一种打印机语言发出加电循环或重置命令后，已更改的 EPL 设置仍将保留。

为帮助开发人员，打印机带有一系列操作参数和打印机配置标签。通过打印机 “ 进纸 ”按钮或参见 “ 打印测试（打印机配置）标签 ” 即可使用上述参数和标签。Zebra Setup Utility 和 Zebra™ Windows 驱动程序还可以打印该标签和其他打印机状态标签，以帮助用户管理打印机。

ZPL 打印机配置格式

创建一个打印机配置编程文件，并将其发送到一台或多台打印机，即可实现对多台打印机的管理，也可以使用 ZebraNet™ Bridge 复制打印机设置。下面的图 1 所示为 ZPL 编程配置文件的基本结构。

参阅《ZPL 程序员指南》和 “ZPL 配置状态与命令的对照参考 ””，创建编程文件。使用 Zebra Setup Utility (ZSU) 可将编程文件发送到打印机。 Windows 记事本（文本编辑器）可用于创建编程文件。

配置参数格式结构

^XA — 开始格式命令
格式命令与顺序相关
a) 常规打印和命令设置
b) 介质处理和操作
c) 介质打印尺寸
^JUS 命令可用于保存
^XZ — 结束格式命令

ZPL 配置状态与命令的对照参考

下面显示的 “ 打印机配置标签 ” 列出了可以通过 ZPL 命令设定的大多数配置设置值。一些打印机选配件和差异型号只有装入打印机后才会显示。

图 2 • 配置标签打印输出

配置标签打印输出

表 2 • ZPL 命令和配置收条标注对照参考

ZPL 命令和配置

从 “ 配置收条 ” 列表中的这一位置开始，打印输出中列出了传感器设置，所显示的值用于为传感器和介质操作进行故障排除。这些信息通常用于供 Zebra 技术支持人员进行打印机故障诊断。

此处所列配置设置紧接 “ 取走标签 ” 传感器值。这些列表中包含鲜有更改了默认值的打印机功能，或提供状态信息（例如，固件版本）。

表 3 • ZPL 命令和配置收条标注对照参考

ZPL 命令和配置收条标注对照参考

打印机具有为随后的所有收据或标签设置一条命令或一组命令的能力。在通过后续命令更改此类设置、重置打印机或恢复出厂默认值前，这些设置仍将处于有效状态。

打印机存储器管理和相关状态报告

为帮助用户管理打印机资源，打印机支持通过多种格式命令来管理存储器、在存储区域之间传送对象（导入和导出）和为对象命名，以及提供各种打印机运行状态报告。这些命令与 DIR （目录列表）和 DEL （删除文件）等旧 DOS 命令极为类似。最常见的报告也是 Zebra Setup Utility 和 ZebraDesigner™ Windows 驱动程序的组成部分。

图 3 • 存储器管理格式结构

^XA — 开始格式命令
建议采用单条格式命令，
以便重复使用
^XZ — 结束格式命令

推荐在一种类型的格式（表单）内只处理单条命令。您可以轻松地将单条命令作为维护和开发工具重复使用。

用于传送对象以及管理和报告存储器使用情况的许多命令均是控制 (~) 命令。这些命令无需在格式（样式）中。无论其是否在格式（表单）内，打印机均会在收到后立即处理这些命令。

注意 • 为最大程度使用打印机的存储器，打印机带有存储器自动碎片整理 (defrag) 功能。多个因素都可能会触发碎片整理操作。删除或添加存储器中对象都会触发碎片整理操作。在存储器进行碎片整理过程中，打印机状态指示灯将开始呈红色、琥珀色和绿色闪烁。在状态指示灯闪烁过程中，不要关闭打印机电源。如果存储器的使用率和文件碎片化程度较高，此操作可能会耗时数分钟。

用于存储器管理的 ZPL 编程

ZPL 具有多个打印机存储器位置，分别用于运行打印机、组合打印图像以及储存格式（样式）、图形、字体和配置设置。

ZPL 将格式（样式）、字体和图形视作文件；存储器位置类似于 DOS 操作系统环境中的磁盘驱动器：
- 存储器对象命名：最多使用十六 (16) 个字母数字字符，后面紧跟一个由三(3) 个字母数字字符组成的文件扩展名：
- 例如， 123456789ABCDEF.TTF
- 安装有 V60.13 或更早版本固件的旧式 ZPL 打印机仅可以使用 8.3 文件名格式，而不支持当前的 16.3 文件名格式。
允许在不同存储器位置之间移动对象和删除对象。
支持将 DOS 目录样式文件列表报告作为主机的打印输出或状态。
允许在文件存取过程中使用通配符 (*)。

表 4 • 对象管理与状态报告命令

标签打印机对象管理与状态报告命令

重要提示 • 无法通过重新加载或更新固件将打印机中的一些原厂安装的 ZPL 字体复制、克隆或恢复到打印机中。如果使用明确的 ZPL 对象删除命令将这些受许可证限制的ZPL 字体删除，则必须重新购买并通过字体激活和安装工具重新安装这些字体。 EPL 字体没有此限制。