ZPL Программирование

Введение

Zebra Programming Language это более новая версия Eltron Programming Language

В 1998 году компании Zebra и Eltron объединились

ZPL FAQ

Описание команд на официальном сайте Zebra: ZPL .

Для наглядности команды я буду выделять жирным шрифтом, параметры постараюсь сделать цветными. Введенный текст и передаваемые переменные оставлю обычными. FT Examples available here , A Examples available here

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

^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 вниз от точки, которую мы определили предыдущей командой.

^A - Определяет шрифт.

В нашем случае ^AD выбран шрифт D. По умолчанию стоит A. Шрифты, которые соответсвуют этим буквам хранятся в EPROM принтера. ZPL II разрешает использовать буквы A - Z и цифры 1 - 9.

^FD - Field Data, объявляет начало поля с данными

WWW.AskQA.RU - обычные данные которые я ввёл. Они будут просто напечатаны на теге.

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

🔝

🔝

🔝

🔝

🔝

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

Объяснение:

^FD у нас идёт не один, а в связке с ^RFW, E и определённым перед ним ^RB96, 8,3,3,24,20,38

То есть нужно рассматривать всю комбинацию команд.

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

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

🔝

🔝

🔝

^FS

^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

^FO250,50

^BY3,3,10

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

^FD{SERIAL}^FS

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

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

Предположим, что серийный номер должен быть напечатан как в память тэга так и на этикетку.

Формат пусть будет GIAI-96 , код компании помещается в 24 бита, для примера возьмём 1234567

Запишем сперва код для этикетки.

^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")