Zpl руководство по программированию

Время на прочтение
5 мин

Количество просмотров 66K

Добрый день, Хабрахабр.

Благодаря тепло принятой прошлой публикации, я могу опубликовать здесь эту статью. Спасибо всем, кто ставил плюсы.
По долгу службы мне частенько приходится формировать отчеты для этикеточных принтеров семейства Zebra.

Зебры они такие
Механизм формирования этикеток выглядит следующим образом: сначала с машины пользователя (компьютер, терминал сбора данных) на принтер отправляется специальным образом оформленная строка, затем внутренний процессор принтера обрабатывает эту строку, и выводит ее на печать.Но язык, на котором формируется строка для принтера (называется ZPL) на первый взгляд вызывает у непосвящённых нервную икоту и мандраж.
Прошу под кат, всех кто хочет разобраться в данном вопросе.

Пример:

^XA
^FO 0,10
^GB632,0,2^FS
^FO0,25
^FB632,1,0,C,0
^ASN,70,70
^FDWAR INC.^FS
^FO0,100
^GB632,0,2^FS
^FO0,120
^FB632,1,0,C,0
^ASN,60,60
^FDGoose^FS
^FO0,180
^FB632,1,0,C,0
^ASN,60,60
^FDWild^FS
^FO0,240
^GB632,0,2^FS
^FO120,260
^BY2
^BCN,70,N,N,N
^FDSECRECTCODE^FS - 
^XZ

А на печать выводится такой аккуратный бейджик:

Давайте разберемся, что же написано в этом коде, и рассмотрим основные элементы.
Первую часть своего выступления я посвящу разбору синтаксиса этого языка, в объеме достаточном для создания этикеток удовлетворительного качества. Во-второй части, приведу примеры кода на Java и VisualBasic, для того, чтобы отправить этикетку на печать самостоятельно. На основе этих примеров, вы сможете самостоятельно построить свою програму, для печати.

Часть 1. Синтаксис ZPL

Во первых, все измерения в ZPL указываются в точках (points). Поэтому, для более ясного представления вы должны посмотреть в документации на принтер, какая у вас плотность точек на единицу измерения длины.
Сначала кратко пробежимся по основным командам, затем рассмотрим их более подробно в связке.
1. Начало и конец ZPL-кода:
^XA – начало кода, ^XZ – конец кода;

2.Отступы для последующего содержимого:
^FO x,y где: x – отступ от левого края, y – отступ сверху;

3.Разделитель полей:
^FS — обозначает конец определения поля. Буквально можно считать его сигналом конца строки;

4.Масштабируемый текст. Состоит из двух частей, выбор шрифта и ввод текста:
4.1. Выбор шрифта:
^A<название шрифта><ориентация текста>,<высота шрифта в точках>,<ширина в точках>:
<название шрифта> – по-умолчанию стоит A. Точнее ее даже не надо вводить, другие шрифты можно взять из официальной документации:

<ориентация текста>:
N – нормальная ориентация; R – повернуто на 90 градусов по часовой стрелке;
I – перевернуто на 180 градусов; B – повернуто на 270 градусов;

4.2. Вывод текста с параметрами указанными в предыдущем пункте:
^FD<текст>

Примеры:

^XA
^FO20,20  - отступ по 20 точек от верхнего и левого края этикетки
^ASN,70,70 - нормальная ориентация, шрифт S, высота и ширина 70 точек
^FDWAR INC.^FS – содержание текста WAR INC.
^XZ

Повернем, и изменим шрифт:

^XA
^FO20,20  - отступ по 20 точек от верхнего и левого края этикетки
^ABB,30,30 - повернуто на 270 градусов, шрифт B, высота и ширина 30 точек
^FDWAR INC.^FS – содержание текста WAR INC.
^XZ

Изменим шрифт на S:

^XA
^FO20,20  - отступ по 20 точек от верхнего и левого края этикетки
^ASB,30,30 - повернуто на 270 градусов, шрифт S, высота и ширина 30 точек 
^FDWAR INC.^FS – содержание текста WAR INC.
^XZ

Обязательно запомните, что разные шрифты могут выглядеть по разному, в отношении размеров, как можно видеть выше. Я чаще всего использую шрифт S.

5.Блок текста:

^FB<ширина>,<количество строк>,<пробелы между строками>,<выравнивание текста>,< отступ для второй или последующей строки>
<положение текста> — может принимать значения: L(по левому краю), R (по правому краю), C (по центру), J (растянуть текст по ширине поля);
Обычно я использовал данную команду для центрирования текста, или если необходимо разместить текст в несколько строчек. Если текст не умещается в строку, он начинает накладываться сам на себя. И получается так:

^XA
^FO 20,20
^FB400,1,0,C,0
^AVN,70,70
^FDWAR INC WILD GOOSE^FS
^XZ

Изменим код, чтобы было две строки, и расстояние между строчками сделаем в 10 точек:

^XA
^FO 20,20
^FB400,2,10,C,0
^AVN,70,70
^FDWAR INC WILD GOOSE^FS
^XZ

А теперь сделаем отступ для второй строки в 30 точек влево:

^XA
^FO 20,20
^FB400,2,10,L,30
^AVN,70,70
^FDWAR INC WILD GOOSE^FS
^XZ

6. Рисование прямоугольников:

^GB<ширина>,<высота>,<толщина линии>, (<цвет линии>, <скругление углов>)
В скобках указаны не обязательные параметры.
Цвет линии: B (черный) или W (белый)
Скругление углов указывается цифрой от 0, до 8 (сильное скругление)
Примеры:
С сильным скруглением:

^XA
^FO20,20 
^GB300,100,2,B,8^FS
^XZ

Без скругления:

^XA
^FO20,20 
^GB300,100,2^FS
^XZ

Если хотим нарисовать просто линию, то рисуем прямоугольник с высотой равной 0:

^XA
^FO20,20 
^GB300,0,2^FS
^XZ

7.Штрихкод состоит из трех команд – первая задает его размеры, вторая настройки и третья — содержание:

7.1.Размеры штрихкода:
^BY<ширина>, (<cоотношение толщин линий>, <высота штрихкода>)

7.2. Настройки штрихкода:
^BC<ориентация>,<высота штрихкода в точках>, <печатать ли расшифровку кода>, <расшифровка кода над штрихкодом>, <режим>
<ориентация> — N – нормальная ориентация; R – повернуто на 90 градусов по часовой стрелке; I – перевернуто на 180 градусов; B – повернуто на 270 градусов;
<печатать ли расшифровку кода>, <расшифровка кода над штрихкодом> — принимают значения Y (да) или N (нет);
<режим> — с этим полем я не разобрался, по умолчанию N;

^BC – штрихкод в стандарте 128 (подробнее Code_128); Есть также еще несколько форматов, но ввиду того, что мне не приходилось ими пользоваться, в данной статье они рассматриваться не будут, и рекомендую посмотреть информацию по ним в официальной документации поставляемой к принтерам Zebra;

7.3. Вывод штрихкода на печать:
^FD<кодируемая информация>

К сожалению, штрихкод нельзя поместить в «коробку», как текст, чтобы отцентрировать по ширине этикетки, и поэтому приходится шаманить с полями и отступами.

Примеры:

^XA
^FO 20,20
^BY3
^BCN,100,Y,N,N 
^FD123456789^FS 
^XZ

Перевернем, и укажем печатать расшифровку сверху (сейчас получилось снизу):

^XA
^FO 20,20
^BY3
^BCI,100,Y,Y,N 
^FD123456789^FS 
^XZ

На этом остановимся на рассмотрении основных элементов ZPL, и перейдем к части второй, в которой вкратце рассмотрим механизм отправки информации на принтер.

Часть 2. Печать

Механизм передачи проще некуда. Для этого, мы должны знать IP, где находится принтер, и порт. Далее, формируем поток, который отправляем по указанному адресу, и получаем на выходе этикетку.
Пример на Visual Basic:

Dim i As Double
        Dim SSCC As String
        Dim ipAddress As String = "127.0.0.1"
        Dim port As Integer = 1234
        Dim ZPLString As String
      
        Try
         'Открываем соединение
        Dim client As New System.Net.Sockets.TcpClient    
        client.Connect(ipAddress, port)
        Dim writer As New System.IO.StreamWriter(client.GetStream())
       'Формируем ZPL-строку         
        ZPLString=  
        "^XA" &
	"^BY2" & 
	"^FO0,200" &
	"^FB632,2,0,C,0" &
	"^ASN,60,60" &
	"^FDHELLO HABRAHABR!!!^FS" &
	"^XZ"

      writer.Write(ZPLString)
      writer.Flush()
      'закрываем соединение
      writer.Close()
      client.Close()

Catch ex As Exception
End Try  
 

Пример на Java:

import java.io.IOException;
import java.io.OutputStream;
import java.io.PrintWriter;
import java.net.Socket;

public class PrintToZebra {

	public static void main(String[] args) throws IOException {
		System.out.println("Готовлю к печати");
		try(Socket s = new Socket("127.0.0.1", 1234)){
		OutputStream out = s.getOutputStream();
		PrintWriter writer = new PrintWriter(out, true);
	      String ZPLString=  
	                "^XA" +
	                "^BY2" +              
	                "^FO0,200" +
	                "^FB632,2,0,C,0" +
	                "^ASN,60,60" +
	                "^FDHELLO HABRAHABR!!!^FS" +
	                "^XZ";
	        writer.println(ZPLString);
	        writer.flush();
	        System.out.println("Отправил на печать");
		}
	}
}

Как видите, ничего сложного. Надеюсь, что моя статья, облегчит путь отважным укротителям Зебр.
Засим позвольте откланяться. Жду советов, критики и поддержки.

Содержание

	Введение
	Простейший пример
	Реальный пример
	XA
	PW
	CI
	RW
	RS
	RB
	RF
	FD
	FN
	HV
	Python скрипты для печати ZPL
	Похожие статьи

Введение

Простейший пример

^XA
^LH30,
100
^FO20,10
^AD^FDWWW.AskQA.RU^FS
^FO20,
60^B3^FDWWW.URN.SU^FS
^XZ

Пояснения

^XA — Начало этикетки

^LH30,
100 — Задаёт начальную позицию 30 точек вправо и 100
точек вниз

^FO20,
10 — Field Origin, отступает ещё на 20 точек вправо и 10 вниз от точки,
которую мы определили предыдущей командой.

^FS — Field Separator

^FO20,
60 — Отступаем по-прежнему 20 точек вправо, но теперь, чтобы
надписи не наложились друг на друга — 60 точек вниз.

^B3 — Этой командой мы показываем, что хотим распечатать баркод в формате
Code 39 (USD-3 Code, Code 3 of 9).

^FDWWW.URN.SU^FS — здесь всё как в предыдущем примере, но мы помним,
что теперь данные из поля будут не только распечатаны, но и изображены в виде баркода.

^XZ — Обозначает конец этикетки.

Результат

Пример файла для печати

На каждый параметр можно кликнуть чтобы перейти к подробному описанию. Любо просто пролистать вниз.

^XA
^PW366
^CI28
^RW24,24,A2
^FS
^RS8,B10,200,3,E
^FS
^RB96,8,3,3,24,20,38
^FS
^RFW,E
^FD48,0,5,6438092,0,#Serial#
^FS
^FN3^RFR,H
^FS
^HV3
^FT8,24^A0N,26,26^FD#ProductCode#
^FS
^FO8,36^A0N,26,26^FB300,10,,100^FD#ProductName#
^FS
^FT8,105^A0N,26,26^FD#Quantity#
^FS
^FT130,105^A0N,26,26^FD#UnitOfQuantity#
^FS
^FT8,128^A0N,26,26^FDASK.QA
^FS
^FT134,128^A0N,26,26^FD#Serial#
^FS
^XZ

Пояснения

1) Параметры, помещённые между символами решётки # — это переменные, которые
передаются с сервера. Для печати статичного изображения они не нужны, но на практике
теги печатаются большими сериями и серийный номер меняется автоматически.

#Serial#

2)

🔝

^XA

^PW366

	Print Width

^CI28

	Change International Font

^RW24,
23,
A2

Read and Write Power Levels 24 — Read Power 24 — Write Power A2 — (a) — RFID antenna element selection. Note — This parameter is valid only on the R110Xi4 printer. This parameter selects an antenna element from the printer’s antenna array. Допустимые значения: A1, A2, A3, A4, B1, B2, B3, B4, C1, C2, C3, C4, D2, D3, D4, E2, E3, E4, F2, F3, F4 (combinations D1, E1 and F1 are invalid) A1 — это нижний (ближний если смотреть на принтер) левый угол. F4 — верхний (дальний) правый угол. Чтобы узнать правильное положение антенны и бэкфида, нужно выполнить RFID калибровку

🔝

^RS
8,
B10,
200,
3,
E
^FS

^RS — Задаёт RFID параметры 8 — (t) tag type тип тега. Gen 2 это единственный тип, поддерживаемый Zebra R110Xi4, RZ400, RZ600 и RP4T принтерами. UHF Принтеры Допустимые значения: 0 = None 1 = EPC Class 0 2 = EPC Class 0 Plus 3 = EPC Class 1 64-bit 4 = EPC Class 1 96-bit 5 = UCODE EPC 1.19 6 = Impinj Class 0 Plus 7 = ISO 18000-06A 8 = EPC Class 1, Generation 2 (Gen 2) 9 = ISO 18000-06B Значение по умолчанию: 4 Because some countries restric the frequencies that can be used for RFID, not all tag types listed may be supported by your RFID printer. If you specify a tag type that is not supported, the printer will use the Значение по умолчанию. B10 — (p) Sets the read/write position of the transponder in the vertical (Y axis) in dot rows from the top of the label. Set to 0 (no movement) if the transponder is already in the effective area without moving the media. This parameter sets the read/write position of the transponder in one of two ways: absolute mode or relative mode. For more information about these modes, see Setting the Programming Position Manually on page 19 of RFID Programming Guide 2 Manual. Important: If a label format specifies a value for the programming position, this value will be used for the programming position for all labels untill a new position is specified or until the transponder calibration procedure is run. Допустимые значения: Absolute Mode: xxxx = 0 to label lenght (in dot rows). Move the media to the specified position xxxx on the label, measured in dot rows from the label top, before encoding. Set to 0 (no movement) if the transponder is already in the effective area without moving the media. Relative Mode Forward: Fxxx = F0 to Fxxx (where xxx is the label length in millimeters or 999), whichever is less). Move media forward, printing bitmap, for xxx millimeters before reading or encoding. Relative Mode Backward: Byy = B0 to B30 (in millimeters, 30 mm maximum). Move media backward for yy millimeters before reading or encoding. (Does not apply to the RP4T printer.) Note: When using a backward program position, allow enough media or liner to ensure that the printer can back up the media wihout the leading edge disappearing under the printhead mechanism. Значение по умолчанию: F0 (which moves the leading edge of the label to the print line) 200 — (v) — length of void printout — не рекомендуется использовать 0, т.к. испорченный тэг в таком случае сложнее заметить. Если оставить поле пустым ,, длина void будет равняться длине label 3 — (n) — number of labels — The number of labels that will be attempted in case of read/encode failure. Допустимые значения: 1 to 10. Значение по умолчанию: 3 E — (e) — error handling — If an error persists after the specified number of labels are tried, perform this error handling action. Допустимые значения: N = No action (printer drops the label format causing the error and moves to the next queued label). P = Place printer in Pause mode (label format stays in the queue until the user cancels). E = Place printer in Error mode (label format stays in the queue until the user cancels). Значение по умолчанию: N

🔝

^RB96,
8,3,3,24,20,38

^RB — Define EPC Data Structure 96 — (n) total bit size of the field. Допустимые значения: 1 to n, where n is the bit size of the tag. Значение по умолчанию: 96 8,3,3,24,20,38 (p1 … p15) — partition sizes — Specify each partition size. These must add up to the total bit size. Допустимые значения: 1 to 64 bit total bit size. Значение по умолчанию: 1. Таким образом мы показали, что 96 бита раделены на шесть полей содержащих 8, 3, 3, 24, 20, 38 Разделение на поля происходит, естественно, не произвольным образом. В данном примере идёт печать тега в соответствии со стандартом SGTIN-96. 96 — длина EPC блока. 8 — Header. 3 — Filter. 3 — Partition. 24 — Company Prefix. 20 — Indicator / Item Reference. 38 — Serial Number.

🔝

^RFW,
E

	^RF — Read or Write RFID Format. W — (o) — operation — The action to be performed. Accepted values: W = write to the tag. L = write with LOCK (if supported by tag type). R = read the tag. Значение по умолчанию: W. E — (t) — type — Допустимые значения: A = ASCII, H = Hexadecimal, E = EPC (ensure proper setup with the ^RB command). Значение по умолчанию: H.

🔝

^FD

48,0,5,6438092,0,#Serial#

Что означают параметры 48,0,5,6438092,0,#Serial# после
^FD с первого взгляда непонятно. В описании у ^FD всего один параметр

(a) — data to be printed. Допустимые значения: any ASCII string up to 3072
characters

Значение по умолчанию: none — a string of characters must be entered.

Объяснение:

^RB96,8,3,3,24,20,38
^RFW,E^FD48,0,5,6438092,0,#Serial#

И при этом не забывать, что мы записываем теги в соответствии со стандартом
SGTIN-96

Название поля→	Общая длина	Header	Filter	Partition	Company Prefix	Indicator / Item Reference	Серийный номер
Длина в битах →	96	8	3	3	24	20	38
Что мы туда записываем →	N/A	48	0	5	6438092	0	#Serial#

🔝

^FN3
^RFR,
H^FS

^FN — Field Number Description the ^FN command numbers the data fields. This command is used in both ^DF (Store Format) and ^XF (Recall Format) commands. In a stored format, use the ^FN command where you would normally use the ^FD (Field Data) command. In recalling the stored fromat, use ^FN in conjunction with the ^FD command. Format ^FN# Parameters Details # = number to be assigned to the field. Допустимые значения: 0 to 9999 Значение по умолчанию: 0 «a» = optional parameter* Values: 255 alphanumeric characters maximum (a-z, A-Z,1-9 and space) Default: optional parameter Comments The same ^FN value can be stored with several different fields. If a label format contains a field with ^FN and ^FD, the data in that field prints for any other field containing the same ^FN value For the «a» parameter to function as a prompt the characters used in the «a» parameter must be surrounded by double quotes (see example). Example: The ^FN1«Name» would result in «Name» being used as the prompt on the KDU unit. 3 — Это номер блока памяти в самом принтере. Мы можем записывать данные в один из 10 000 блоков и затем вызывать из них данные обратно. В нашем примере, вместо 3 могло стоять любое число. Главное потом указать тот же блок памяти в команде ^HV ^RF — Read or Write RFID Format. R — значит, что мы читаем тег. This command allows you to read or write to an RFID tag. Note: When using this command to read a tag, you may use a field variable to print the tag data on the label or to return the data to the host. Printers That Support This Command: RXi, R110PAX4 Format ^RFo, t, b o = operation — The action to be performed. Допустимые значения: W = write to the tag, L = write with LOCK (if supported by tag type), R = read the tag Значение по умолчанию: W t = type — Допустимые значения: A = ASCII, H = Hexadecimal, E = EPC (ensure proper setup with the ^RB command) Значение по умолчанию: H b = starting block number — Допустимые значения: 0 to n, where n is the maximum number of blocks for the tag. Значение по умолчанию: 0

🔝

^HV3

^HV — Host Verification Description — This command is used to return data from specified fields, along with an optional ASCII header, to the host computer. The command can be used with any field that has been assigned a number with the ^RT command or the ^FN and ^RF commands. Format ^HV#,n, h # = field number specified with another command. The value assigned to this parameter should be the same as the one used in another command. Допустимые значения: 0 to 9999 Значение по умолчанию: 0 В предыдущей команде (^FN3) у нас было значение 3. Поэтому и здесь у нас 3 (^HV3). Т.е. мы отсылаем обратно на сервер, то, что прочитали до этого с помощью ^RF n = number of bytes to be returned Допустимые значения: 1 to 256 Значение по умолчанию: 64 h = header — Header (in uppercase ASCII characters) to be returned with the data. Acceptable values: 0 to 3072 characters Значение по умолчанию: no header

🔝

^FT8
,24^A0N,26,26^FD#ProductCode#

^FT — Field Typeset The ^FT command sets the field position, relative to the home position of the label designated by the ^LH. The typesetting origin of the field is fixed with respect to the contents of the field and does not change with rotation. Note: The ^FT command is capable of concantination of fields. Format: ^FTx,y, z Parameters Details x = x-axis location (in dots) Values: 0 to 32000 Default: position after last formatted text field y = y-axis location (in dots) Values: 0 to 32000 Default: position after last formatted text field z = justification The z parameter is only supported in firmware version V60.14.x, V50.14.x, or later Values: 0 = left justification 1 = right justification 2 = auto justification (script dependent) Default: last accepted ^FW value or ^FW default The auto justification option may cause unexpected results if variable fields or bidirectional text are used with ^FT. For best results with bidirectional text and/or variable fields, use either the left or right justification options.

^FT8,
24^A
0N,
26,
26^FD#ProductCode#

^FT8,24 8 — отступ слева 24 — отступ сверху 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. Format ^FTx,y Parameters Details x = x-axis location (in dots) Допустимые значения: 0 to 32000 Значение по умолчанию: positiono after last formatted text field y = y-axis location (in dots) Допустимые значения: 0 to 32000 Значение по умолчанию: position after last formatted text field Text The origin is at the start of the character string, at the baseline of the font. Normally the baseline is the bottom of most characters, except for those with descenders, such as g, y et cetera. Bar Codes The origin is at the base of the bar code, even when an interpretation is present below the bar code, or if the bar code has guard bars. Graphic Boxes The origin is at the bottom-left corener of the box. Images The origin is at the bottom-left corner of the rectangular image area. Examples available here When a coordinate is missing, the position following the last formatted field is assumed. This remembering simplifies field positioning with respect to other fields. Once the firest field is positioned, other fields follow automatically. There are several instances where using the ^FT command without specifying x and y parameters is not recommended: when positioning the first field in a label format at any time with the ^FN (Field Number) command following an ^SN (Serialization Data) command ^A0N,26,26^FD#ProductCode# ^A — Определяет шрифт. В нашем случае ^A0 выбран шрифт 0 — parameter (f) — font name. По умолчанию стоит A. Шрифты, которые соответсвуют этим буквам хранятся в EPROM принтера. ZPL II разрешает использовать буквы A — Z и цифры 1 — 9. N — parameter o = font orientation. Допустимые значения: N = normal, R = rotated 90 degrees (clockwise), I = Inverted 180 degrees, B = read from bottom up, 270 degrees Значение по умолчанию: the last accepted ^FW value or the ^FW default 26,26 — это высота (h) и ширина (w), заданные в точках. Examples available here

^FS

^FO8,36^A0N,26,26
^FB300,10,,100^FD#ProductName#

^FO8, 36 — Field Origin, отступает ещё на 8 точек вправо и 36 вниз от точки, которую мы определили командой ^LH (а точнее не определили). ^FB300,10, ,100 ^FB — Field Block Description The ^FB command allows you to print text into a defined block type format. This command formats an ^FD or ^SN string into a block of text using the origin, font, and rotation specified for the text string. The ^FB command also contains an automatic word-wrap function. Format ^FBa,b, c,d, e Параметры Подробности a = width of text block line (in dots) Допустимые значения: 0 to the width of the label (or 9999) Значение по умолчанию: 0 If this value is less than font width or not specified, text does not print b = maximum number of lines in text block Допустимые значения: 1 to 9999 Значение по умолчанию: 1 Text exceeding the maximum number of lines overwrites the last line. Changing the font size automatically increases or decreases the size of the block c = add or delete space between lines (in dots) Допустимые значения: -9999 to 9999 Значение по умолчанию: 0 Numbers are considered to be positive unless preceded by a minus sign. Positive values add space, negative values delete space. d = text justification Допустимые значения: L (left), C (center), R (right), J (justified) Значение по умолчанию: L Last line is left-justified if J is used e = hanging indent (in dots) of the second and remaining lines Допустимые значения: 0 to 9999 Значение по умолчанию: 0

^FS
^FT8,105^A0N,26,26^FD#Quantity#^FS
^FT130,105^A0N,26,26^FD#UnitOfQuantity#^FS
^FT8,128^A0N,26,26^FDASK.QA^FS
^FT9,128^A0N,26,26^FDASK.QA^FS
^FT134,128^A0N,26,26^FD#Serial#^FS
^FT134,128^A0N,26,26^FD#Serial#^FS
^XZ

Основные команды

RFID калибровка

^XA
^HR
^XZ

start

position=B9 MM,A2,25,25

leading edge

B20, , ,A2,29,29

B19, , ,A2,29,29

B18,R, ,A2,29,29

B17, , ,A2,29,29

B16, , ,A2,29,29

B15,R,W,A2,17,21

B14,R,W,A2,11,15

B13,R,W,A2,7,11

B12,R,W,A2,5,9

B11,R,W,A2,5,7

B10,R,W,A2,5,9

B9,R,W,A2,5,11<—**** B9 MM,A2,25,25

B8,R,W,A2,11,15

B7,R,W,A2,23,23

B6, , ,A2,29,29

B5,R,W,A2,25,25

B4,R,W,A2,25,25

B3,R,W,A2,27,29

B2, , ,A2,29,29

trailing edge

end

Предпросмотр ZPL

ZPL симулятор для просмотра layout файлов

Создание штрихкодов

sscc-18

^BY
3,3,10

^BY — Bar Code Field Default The ^BY command is used to change the Значение по умолчаниюs for the module width (in dots), the wide bar to narrow bar width ratio and the bar code height (in dots). It can be used as often as necessary within a label format. Format: ^BYw ,r,h Parameters Details w = module width (in dots) Values: 1 to 10 Initial Value at Power Up: 2 r = wide bar to narrow bar width ratio Values: 2.0 to 3.0, in 0.1 increments This parameter has no effect on fixed-ratio bar codes. Default: 3.0 h = bar code height (in dots) Initial Value at Power Up: 10 For parameter r, the actual ratio generated is a function of the number of dots in parameter w, module width. See Table 12 on page 126. Module width and height (w and h) can be changed at anytime with the ^BY command, regardless of the symbology selected. Example: Set module width (w) to 9 and the ratio (r) to 2.4. The width of the narrow bar is 9 dots wide and the wide bar is 9 by 2.4, or 21.6 dots. However, since the printer rounds out to the nearest dot, the wide bar is actually printed at 22 dots. This produces a bar code with a ratio of 2.44 (22 divided by 9). This ratio is as close to 2.4 as possible, since only full dots are printed.

^BCN
,110,N
,N
,N, N

The ^BC command creates the Code 128 bar code, 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. Each Code 128 character consists of six elements: three bars and three spaces. ^BC supports a fixed print ratio. Field data (^FD) is limited to the width (or length, if rotated) of the label. Format: ^BCo,h,f,g,e,m Important • If additional information about the Code 128 bar code is required, go to Format: ^BCo ,h,f,g ,e, m Parameters Details o = orientation Values: N = normal R = rotated 90 degrees (clockwise) I = inverted 180 degrees B = read from bottom up, 270 degrees Default: current ^FW value h = bar code height (in dots) ratio Values: 1 to 32000 Default: value set by ^BY f = print interpretation line Values: Y (yes) or N (no) Default: Y The interpretation line can be printed in any font by placing the font command before the bar code command. g = print interpretation line above code Values: Y (yes) or N (no) Default: N e = UCC check digit Values: Y (turns on) or N (turns off) Mod 103 check digit is always there. It cannot be turned on or off. Mod 10 and 103 appear together with e turned on. Default: N m = mode Values: N = no selected mode U = UCC Case Mode ⋅ More than 19 digits in ^FD or ^SN are eliminated. ⋅ Fewer than 19 digits in ^FD or ^SN add zeros to the right to bring the count to 19. This produces an invalid interpretation line. 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 determines when to shift subsets. A string of four or more numeric digits causes an automatic shift to Subset C. D = UCC/EAN Mode (x.11.x and newer firmware) This allows dealing with UCC/EAN with and without chained application identifiers. The code starts in the appropriate subset followed by FNC1 to indicate a UCC/EAN 128 bar code. The printer automatically strips out parentheses and spaces for encoding, but prints them in the human-readable section. The printer automatically determines if a check digit is required, calculate it, and print it. Automatically sizes the human readable. Default: N

Python скрипты для печати ZPL

^XA
^CI28
^PW500^FS
^RW24,26,A2^FS
^RS8,B13,100,1,E^FS
^RB96,8,3,3,24,58^FS
^RFW,E^FD52,0,5,1234567,${userID},^FS
^FN3^RFR,H^FS
^HV3
^FWN^FO90, 15^AD,90,22^FDTVS^FS
^FT90,110^A0N,25,25^FH^FDUSER:${userID}
^FS
^XZ

Для создания скрипта нужно познакомиться с основами языка

Python

а также с

сокетами

, которые нужны для работы с сетью

import socket
mysocket = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
host = "10.6.1.123"
port = 9100

try:
mysocket.connect((host, port)) #connecting to host
for i in range(100073,100100):
userId = str(i)
mysocket.send(b"^XA^CI28^PW500^FS")
mysocket.send(b"^RW24,26,A2^FS")
mysocket.send(b"^RS8,B13,100,1,E^FS")
mysocket.send(b"^RB96,8,3,3,24,58^FS")
mysocket.send(b"^RFW,E^FD52,0,5,1234567,")
mysocket.send(bytes(userId,"utf-8"))
mysocket.send(b",^FS")
mysocket.send(b"^FN3^RFR,H^FS")
mysocket.send(b"^HV3")
mysocket.send(b"^FWN^FO90, 15^AD,90,22^FDCompanyName^FS")
mysocket.send(b"^FT90,110^A0N,25,25^FH^FDUSER:")
mysocket.send(bytes(userId,"utf-8"))
mysocket.send(b"^FS^XZ")
mysocket.close () #closing connection
except:
print("Error with the connection")

Можно не писать в каждой строчке mysocket.send , а использовать Heredoc и Python f-string

import socket
mysocket = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
host = "10.6.1.123"
port = 9100

try:
mysocket.connect((host, port)) #connecting to host
for i in range(100073,100100):
userId = str(i)
layout = (f"""
^XA^CI28^PW500^FS
^RW24,26,A2^FS
^RS8,B13,100,1,E^FS
^RB96,8,3,3,24,58^FS
^RFW,E^FD52,0,5,1234567,{userId},^FS
^FN3^RFR,H^FS
^HV3
^FWN^FO90, 15^AD,90,22^FDCompanyName^FS
^FT90,110^A0N,25,25^FH^FDUSER:{userId},^FS
^FS^XZ
""")
mysocket.send(bytes(layout,"utf-8"))
mysocket.close () #closing connection
except:
print("Error with the connection")

Похожие статьи

	RFID
	ZPL FAQ
	A пример
	FT примеры

ZPL Commands

Command	Format	Description
^A	^Afo,h,w,d:f.x	Use Scalable/Bitmapped Font
^A@	^A@o,h,w,d:f.x	Use Font Name to Call Font
^B0	^B0a,b,c,d,e,f,g	Aztec Bar Code Parameters
^B1	^B1o,e,h,f,g	Code 11 Bar Code
^B2	^B2o,h,f,g,e,j	Interleaved 2 of 5 Bar Code
^B3	^B3o,e,h,f,g	Code 39 Bar Code
^B4	^B4o,h,f,m	Code 49 Bar Code
^B5	^B5o,h,f,g	Planet Code bar code
^B7	^B7o,h,s,c,r,t	PDF417 Bar Code
^B8	^B8o,h,f,g	EAN-8 Bar Code
^B9	^B9,h,f,g,e	UPC-E Bar Code
^BA	^BAo,h,f,g,e	Code 93 Bar Code
^BB	^BBo,h,s,c,r,m	CODABLOCK Bar Code
^BC	^BCo,h,f,g,e,m	Code 128 Bar Code (Subsets A, B, and C)
^BD	^BDm,n,t	UPS MaxiCode Bar Code
^BE	^BEo,h,f,g	EAN-13 Bar Code
^BF	^BFo,h,m	MicroPDF417 Bar Code
^BI	^BIo,h,f,g	Industrial 2 of 5 Bar Codes
^BJ	^BJo,h,f,g	Standard 2 of 5 Bar Code
^BK	^BKo,e,h,f,g,k,l	ANSI Codabar Bar Code
^BL	^BLo,h,g	LOGMARS Bar Code
^BM	^BMo,e,h,f,g,e2	MSI Bar Code
^BO	^BOa,b,c,d,e,f,g	Aztec Bar Code Parameters
^BP	^BPo,e,h,f,g	Plessey Bar Code
^BQ	^BQa,b,c,d,e	QR Code Bar Code
^BR	^BRa,b,c,d,e,f	GS1 Databar
^BS	^BSo,h,f,g	UPC/EAN Extensions
^BT	^BTo,w1,r1,h1,w2,h2	TLC39 Bar Code
^BU	^BUo,h,f,g,e	UPC-A Bar Code
^BX	^BXo,h,s,c,r,f,g,a	Data Matrix Bar Code
^BY	^BYw,r,h	Bar Code Field Default
^BZ	^BZo,h,f,g,t	POSTAL Bar Code
^CC	^CCx or ~CCx	Change Caret (Alt. ~CC)
^CD	^CDa or ~CDa	Change Delimiter (Alt. ~CD)
^CF	^CFf,h,w	Change Alphanumeric Default Font
^CI	^CIa,s1,d1,s2,d2,…	Change International Font/Encoding
^CM	^CMa,b,c,d	Change Memory Letter Designation
^CN	^CNa	Cut Now
^CO	^COa,b,c	Cache On
^CP	^CPa	Remove Label
^CT	^CTa or ~CTa	Change Tilde (Alt. ~CT)
^CV	^CVa	Code Validation
^CW	^CWa,d:o.x	Font Identifier
~DB	~DBd:o.x,a,h,w,base,space,#char,©,data	Download Bitmap Font
~DE	~DEd:o.x,s,data	Download Encoding
^DF	^DFd:o.x	Download Format
~DG	~DGd:o.x,t,w,data	Download Graphics
~DN	~DN	Abort Download Graphic
~DS	~DSd:o.x,s,data	Download Intellifont (Scalable Font)
~DT	~DTd:o.x,s,data	Download Bounded TrueType Font
~DU	~DUd:o.x,s,data	Download Unbounded TrueType Font
~DY	~DYd:f,b,x,t,w,data	Download Objects
~EG	~EG or ^EG	Erase All Graphics (Alt. ^EG)
^FB	^FBa,b,c,d,e	Field Block
^FC	^FCa,b,c	Field Clock
^FD	^FDa	Field Data
^FH	^FHa	Field Hexadecimal Indicator
^FL	^FL,,	Font Linking
^FM	^FMx1,y1,x2,y2,…	Multiple Field Origin Locations
^FN	^FN#»a»	Field Number
^FO	^FOx,y,z	Field Origin
^FP	^FPd,g	Field Parameter
^FR	^FR	Field Reverse Print
^FS	^FS	Field Separator
^FT	^FTx,y,z	Field Typeset
^FV	^FVa	Field Variable
^FW	^FWr,z	Field Orientation
^FX	^FXc	Comment
^GB	^GBw,h,t,c,r	Graphic Box
^GC	^GCd,t,c	Graphic Circle
^GD	^GDw,h,t,c,o	Graphic Diagonal Line
^GE	^GEw,h,t,c	Graphic Ellipse
^GF	^GFa,b,c,d,data	Graphic Field
^GS	^GSo,h,w	Graphic Symbol
~HB	~HB	Return Battery Status
~HD	~HD	Return Head Diagnostic
^HF	^HFd,o,x	Return Host Format
^HG	^HGd:o.x	Return Host Graphic
^HH	^HH	Return Configuration Label
~HI	~HI	Return Host Identification
~HM	~HM	Return Host RAM Status
~HQ	~HQquery-type	Return Host Query
~HS	~HS	Return Host Status
~HU	~HU	Return ZebraNet Alert Configuration
^HV	^HV#,n,h,t,a	Return Host Verification
^HW	^HWd:o.x	Return Host Directory List
^HY	^HYd:o.x	Upload Graphics
^HZ	^HZb	Display Description Information
^HZ	^HZO,d:o.x,l	Display Description Information
^ID	^IDd:o.x	Object Delete
^IL	^ILd:o.x	Image Load
^IM	^IMd:o.x	Image Move
^IS	^ISd:o.x,p	Image Save
~JA	~JA	Cancel All
^JB	^JBa	Initialize Flash Memory
~JB	~JB	Reset Optional Memory
~JC	~JC	Set Media Sensor Calibration
~JD	~JD	Enable Communications Diagnostics
~JE	~JE	Disable Diagnostics
~JF	~JFp	Set Battery Condition
~JG	~JG	Graphing Sensor Calibration
^JH	^JHa,b,c,d,e,f,g,h,i,j	Early Warning Settings
^JI	^JId:o.x,b,c,d	Start Zebra BASIC Interpreter
~JI	~JI	Start Zebra BASIC Interpreter
^JJ	^JJa,b,c,d,e,f	Set Auxiliary Port
~JL	~JL	Set Label Length
^JM	^JMn	Set Dots per Millimeter
~JN	~JN	Head Test Fatal
~JO	~JO	Head Test Non-Fatal
~JP	~JP	Pause and Cancel Format
~JQ	~JQ	Terminate Zebra BASIC Interpreter
~JR	~JR	Power On Reset
^JS	^JSa	Sensor Select
~JS	~JSb	Change Backfeed Sequence
^JT	^JT####,a,b,c	Head Test Interval
^JU	^JUa	Configuration Update
^JW	^JWt	Set Ribbon Tension
~JX	~JX	Cancel Current Partially Input Format
^JZ	^JZa	Reprint After Error
~KB	~KB	Kill Battery (Battery Discharge Mode)
^KD	^KDa	Select Date and Time Format (for Real Time
^KL	^KLa	Define Language
^KN	^KNa,b	Define Printer Name
^KP	^KPa,b	Define Password
^KV	^KVa,b,c,d,e	Kiosk Values
^LF	^LF	Print Font Links
^LH	^LHx,y	Label Home
^LL	^LLy	Label Length
^LR	^LRa	Label Reverse Print
^LS	^LSa	Label Shift
^LT	^LTx	Label Top
^MA	^MAtype,print,threshold,frequency,units	Set Maintenance Alerts
^MC	^MCa	Map Clear
^MD	^MDa	Media Darkness
^MF	^MFp,h	Media Feed
^MI	^MItype,message	Set Maintenance Information Message
^ML	^MLa	Maximum Label Length
^MM	^MMa,b	Print Mode
^MN	^MNa,b	Media Tracking
^MP	^MPa	Mode Protection
^MT	^MTa	Media Type
^MU	^MUa,b,c	Set Units of Measurement
^MW	^MWa	Modify Head Cold Warning
^NC	^NCa	Select the Primary Network Device
~NC	~NC###	Network Connect
^ND	^NDa,b,c,d,e,f,g,h,i,j	Change Network Settings
^NI	^NI###	Network ID Number
~NR	~NR	Set All Network Printers Transparent
^NS	^NSa,b,c,d,e,f,g,h,i	Change Wired Networking Settings
~NT	~NT	Set Currently Connected Printer Transparent
^PA	^PAa,b,c,d	Advanced Text Properties
^PF	^PF#	Slew Given Number of Dot Rows
^PH	^PH or ~PH	Slew to Home Position (Alt. ~PH)
~PL	~PLa	Present Length Addition
^PM	^PMa	Printing Mirror Image of Label
^PN	^PNa	Present Now
^PO	^POa	Print Orientation
^PP	^PP or ~PP	Programmable Pause (Alt. ~PP)
^PQ	^PQq,p,r,o,e	Print Quantity
~PR	~PR	Applicator Reprint
^PR	^PRp,s,b	Print Rate
~PS	~PS	Print Start
^PW	^PWa	Print Width
~RO	~ROc	Reset Advanced Counters
^SC	^SCa,b,c,d,e,f	Set Serial Communications
~SD	~SD##	Set Darkness
^SE	^SEd:o.x	Select Encoding Table
^SF	^SFa,b	Serialization Field (with a Standard ^FD
^SI	^SIa,b	Set Sensor Intensity
^SL	^SLa,b	Set Mode and Language (for Real-Time Clock)
^SN	^SNv,n,z	Serialization Data
^SO	^SOa,b,c,d,e,f,g	Set Offset (for Real-Time Clock)
^SP	^SP#	Start Print
^SQ	^SQa,b,c	Halt ZebraNet Alert
^SR	^SR####	Set Printhead Resistance
^SS	^SSw,m,r,l,m2,r2,a,b,c	Set Media Sensors
^ST	^STa,b,c,d,e,f,g	Set Date and Time (for Real-Time Clock)
^SX	^SXa,b,c,d,e,f	Set ZebraNet Alert
^SZ	^SZa	Set ZPL Mode
~TA	~TA###	Tear-off Adjust Position
^TB	^TBa,b,c	Text Blocks
^TO	^TOs:o.x,d:o.x	Transfer Object
~WC	~WC	Print Configuration Label
^WD	^WDd:o.x	Print Directory Label
~WQ	~WQquery-type	Write Query
^XA	^XA	Start Format
^XB	^XB	Suppress Backfeed
^XF	^XFd:o.x	Recall Format
^XG	^XGd:o.x,mx,my	Recall Graphic
^XS	^XSlength,threshold	Set Dynamic Media Calibration
^XZ	^XZ	End Format
^ZZ	^ZZt,b	Printer Sleep

ZPL RFID Commands

Command	Format	Description
^HL	^HL or ~HL	Return RFID Data Log to Host (Alt. ~HL)
^HR	^HRa,b,c,d,e	Calibrate RFID Tag Position
^RA	^RA#,f,r,m,b	Read AFI or DSFID Byte
^RB	^RBn,p0,p1,p2, …, p15	Define EPC Data Structure
^RE	^REt,r	Enable/Disable E.A.S. Bit
^RF	^RFo,f,b,n,m	Read or Write RFID Format
^RI	^RIa,b,c,d	Get RFID Tag ID
^RL	^RLM,k,a,e,u	Lock/Unlock RFID Tag Memory
^RL	^RLB,s,n	Lock/Unlock RFID Tag Memory
^RM	^RMe	Enable RFID Motion
^RN	^RNe	Detect Multiple RFID Tags in Encoding Field
^RQ	^RQf,c,o[data]	Quick Write EPC Data and Passwords
^RR	^RRn,a	Specify RFID Retries for a Block or Enable
^RS	^RSt,p,v,n,e,a,c,s	Set Up RFID Parameters
^RT	^RT#,b,n,f,r,m,s	Read RFID Tag
^RU	^RUa,b	Read Unique RFID Chip Serialization
~RV	~RVa	Report RFID Encoding Results
^RW	^RWr,w,a	Set RF Power Levels for Read and Write
^RZ	^RZp,m,l	Set RFID Tag Password and Lock Tag
^WF	^WFr,m,w,f,b	Encode AFI or DSFID Byte
^WT	^WTb,r,m,w,f,v	Write (Encode) Tag
^WV	^WVe	Verify RFID Encoding Operation

ZPL Wireless Commands

Command	Format	Description
^KC	^KCa,b,c,d	Set Client Identifier (Option 61)
^NB	^NBa	Search for Wired Print Server during
^NN	^NNa,b,c,d,e,f	Set SNMP
^NP	^NPa	Set Primary/Secondary Device
^NT	^NTa,b	Set SMTP
^NW	^NWa	Set Web Authentication Timeout Value
^WA	^WAa,b	Set Antenna Parameters
^WE	^WEa,b,c,d,e,f,g,h	Set WEP Mode
^WI	^WIa,b,c,d,e,f,g,h,i	Change Wireless Network Settings
^WL	^WLa,b,c	Set LEAP Parameters
~WL	~WL	Print Network Configuration Label
^WP	^WPa,b	Set Wireless Password
^WR	^WRa,b,c,d,e	Set Transmit Rate
~WR	~WR	Reset Wireless Radio Card and Print Server
^WS	^WSe,o,p,h,i,j,k	Set Wireless Radio Card Values
^WX	^WXa,…	Configure Wireless Securities
^WX	^WX01	Configure Wireless Securities
^WX	^WX02,b,c,d,e,f,g,h	Configure Wireless Securities
^WX	^WX03,b,c,d,e,f,g,h	Configure Wireless Securities
^WX	^WX04,k	Configure Wireless Securities
^WX	^WX05,i,j	Configure Wireless Securities
^WX	^WX06,i,j,k	Configure Wireless Securities
^WX	^WX07,i,j	Configure Wireless Securities
^WX	^WX08,i,j	Configure Wireless Securities
^WX	^WX09,n	Configure Wireless Securities
^WX	^WX10,k	Configure Wireless Securities
^WX	^WX11,i,j	Configure Wireless Securities
^WX	^WX12,i,j,k	Configure Wireless Securities
^WX	^WX13,i,j	Configure Wireless Securities
^WX	^WX14,i,j	Configure Wireless Securities
^WX	^WX15,i,j,l,m	Configure Wireless Securities

187

Характеристики

Функции

02.05.2013

Xi4™/RXi4™ Руководство пользователя

P1009874-153

Язык программирования Zebra (ZPL)

Функции ZPL II включают:

• Загружаемые изображения, масштабируемые

и растровые шрифты, а также форматы
этикеток

• Управление осуществляется с помощью

мейнфрейма, миникомпьютера, ПК,
портативного терминала ввода данных

• Копирование объектов в областях памяти

• Программируемое количество, а также

функции управления печатью, паузой
и обрезкой

• (ОЗУ, карта памяти и внутренняя флэш-память) • Обмен данными с помощью печатаемых

символов ASCII

• Набор данных кодовой страницы 850

• Протокол проверки ошибок

• Сжатие данных

• Передача сообщения о состоянии

в управляющий компьютер по запросу

• Автоматическое управление буфером

виртуального ввода

• Упорядоченные поля

• Обратное преобразование форматов

• Отвечающие техническим условиям шрифты

OCR-A и OCR-B

• Печать зеркального изображения

• Универсальный товарный код (UPC)/

Европейский товарный код (EAN)

• Четырехпозиционное вращение поля

(0°, 90°, 180°, 270°)

• Программируемый пользователем пароль

• Команда вращения

Автор:
Eugene Taylor

Дата создания:
11 Август 2021

Дата обновления:
15 Апрель 2023

Содержание

• Синтаксис команды
• Внешний вид этикетки
• Коробка и рисование линий
• Штрих-коды

Язык программирования Zebra (ZPL) — это проприетарный язык сценариев для принтеров этикеток, производимый Zebra Technologies. Язык позволяет вам контролировать внешний вид напечатанных этикеток. Например, вы можете добавить штрих-коды к этикеткам вместе с названием и адресом компании.

Синтаксис команды

Синтаксис ZPL: «^ XA», который запускает каждую команду форматирования, «^ FO», которая является командой источника поля; «^ FS» — команда разделителя полей; «^ FD», которая является командой поля данных, и «^ XZ», которая завершает каждую команду форматирования.

Внешний вид этикетки

Различные команды позволяют настраивать шрифты и другие аспекты внешнего вида этикеток, особенно текста. Например, команда «^ A» указывает шрифт для использования в текстовом поле, а команда «^ FD» определяет информационную строку для поля.

Коробка и рисование линий

Команда «^ GB» позволяет рисовать прямоугольники и линии, например, для разделения надписей на разные области. Параметры команды «^ GB» позволяют форматировать кадры и строки. Например, вы можете указать толщину границы или степень закругления углов.

Штрих-коды

Команда «^ B» позволяет печатать штрих-коды на этикетках, включая коды отраслевых стандартов 11 и 39. Вы можете изменить определенные аспекты штрих-кодов, включая ориентацию и высоту.