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

Согласен, писать драйвер принтера на JavaScript звучит нелепо. И я действительно не из тех, кто занимается низкоуровневым программированием ради развлечения. Обычно я предпочитаю разрабатывать и создавать полноценные продукты с использованием языков высокого уровня. Но я купил этот принтер этикеток Polono на Amazon примерно за 140 долларов, что было кражей по сравнению с моделями Zebra, которые стоят около 500 долларов. Zebra является отраслевым стандартом, и их принтеры поставляются с собственным языком программирования, который поддерживается программным обеспечением крупных перевозчиков, таких как UPS, FedEx и т. д. Этот язык называется ZPL (язык программирования Zebra) ., это просто строки текста ASCII, отправляемые по последовательному соединению, которые содержат инструкции о том, как распечатать этикетку. Безумно просто. Основываясь на положительных отзывах других клиентов Amazon, использующих его со своим программным обеспечением для доставки, я возлагал большие надежды на то, что этот дешевый принтер этикеток также будет поддерживать ZPL.

Пробуем драйвер из коробки

Когда принтер прибыл, я подключил его к запасному Raspberry Pi и… успех! Linux распознал его как принтер, и он отображается как /dev/usb/lp0. Он не отображается как принтер в графическом интерфейсе Linux, но это нормально — печать в Linux всегда немного сложна. В конце концов я вспомнил, что в Linux используется система печати под названием CUPS , и я решил, что ее нужно сначала настроить. Я не вижу его в списке доступных принтеров, поэтому я пытаюсь установить драйвер Linux для PL60. Достаточно просто, это архив со installскриптом. я получаю предупреждение о

strip: Unable to recognize the format of the input file '/usr/lib/cups/filter/raster-tspl'`

но затем несколько строк ниже см.

Install Complete

Ура! Теперь я вижу PL60 в списке в административном интерфейсе CUPS. Это кажется многообещающим!

Что ж, щелкнув интерфейс CUPS, чтобы добавить принтер, и попытавшись распечатать тестовую страницу, мы видим неудачное задание. Теперь принтер имеет статус Idle - "File "/usr/lib/cups/filter/raster-tspl" not available: No such file or directory". Облом, возможно, это предупреждение от сценария установки было не тем, что мы могли игнорировать.

Привет ТСПЛ

Я просмотрел все файлы в архиве драйвера и увидел, что там есть каталог filterand . ppdПосле некоторого поиска в Google я узнаю, что файлы PPD описывают возможности каждого принтера, такие как размер бумаги, цветовое пространство и т. д. Фильтры — это исполняемые файлы, которые преобразуют один формат документа в другой, например, превращая изображение PNG в ASCII ZPL. файл, который можно отправить на принтер. Но в filterкаталоге этого архива есть только фильтры x64 и x86.

Я действительно хочу превратить этот Raspberry Pi в постоянную станцию ​​доставки, поэтому на данный момент я очень расстроен тем, что эти «драйверы Linux» являются просто предварительно скомпилированными двоичными файлами x64 и x86, поэтому я запускаю процесс возврата Amazon и направляюсь к обед. В конце концов, мне скоро нужно отправить наши PiBox , так что я просто стисну зубы и потрачу деньги на Zebra. Но у меня есть 2 дня до приезда Зебры, так что после обеда мой разум все еще задается вопросом, есть ли способ скомпилировать эти драйвера для arm64. Такие термины, как Google, raster tspl pl60возвращают очень мало ценности. Я даже копался в файле PPD выше в поисках подсказок.

*Manufacturer: "POLONO"
*ModelName: "POLONO PL60"
*ShortNickName: "HPRT N41"

Действительно подсказки! Как оказалось, этот принтер на самом деле является переименованным клоном HPRT N41 или даже его братом HPRT SL42 ! Если вы дочитали до этого места, то, вероятно, поняли, что эти принтеры не поддерживают ZPL. На странице поддержки принтера HPRT гораздо больше технических подробностей, чем на сайте Polono, и она подсказывает мне, что вместо этого эти принтеры поддерживают TSPL, язык программирования принтеров, очень похожий на ZPL. Только этот язык от производителя принтеров под названием TSC , который базируется в Тайване .

Наконец-то я наткнулся на PHP-код для общения с принтерами TSPL, и это вселяет в меня надежду! Множество звездочек и несколько интересных заметок о записи непосредственно на принтер, например php hello-world.php > /dev/usb/lp0. Это заставило мой принтер выплюнуть бумагу, но страницы были пустыми 😢. Но, наконец, я наткнулся на Linux SDK TSPL для SL42 и даже нашел Руководство по программированию TSPL/TSPL2 !

Решил написать свой драйвер

Несмотря на то, что я нашел SDK, libsпапка внутри все еще была предварительно скомпилирована для x86 или x64. Этот SDK казался таким многообещающим, но почему бы не выдать полный исходный код?! Хорошо, пришло время запачкать руки и начать читать 204-страничное Руководство по программированию TSPL. Когда я начал читать, я понял, что единственным filterвключенным в приведенный выше драйвером был файл raster-tspl. «Растровая» часть этого имени говорит мне, что они использовали ярлык и написали только драйверы для печати растровых изображений, таких как растровые изображения, PNG и т. д.

Для доставки наших PiBox мы решили использовать EasyPost , у которого есть фантастический API для сравнения стоимости доставки разными перевозчиками. Когда вы покупаете у них транспортную этикетку, они выдают вам результат в формате PDF, PNG или ZPL. ZPL был бы идеальным, так как это просто текст ASCII, который можно легко изменить или даже сохранить в базе данных вместе с каждым заказом. Но для этого потребуется какой-то скрипт конвертера ZPL в TSPL , которого, по словам Google, похоже, не существует. По крайней мере, пока — оставьте комментарий или отправьте мне сообщение, если хотите помочь написать его!

Мне пришлось сделать выбор: хочу ли я воспользоваться тем же ярлыком «только растр» или мне следует попытаться написать этот скрипт конвертера. Это потребует обработки каждой функции ZPL и реализации как минимум достаточного количества функций TSPL (таких как рендеринг QR-кодов, штрих-кодов, различных шрифтов ASCII и т. д.) для печати сканируемой транспортной этикетки. У меня есть целый бизнес, и мы не занимаемся транспортной этикеткой — очевидно, я выбрал более короткий путь.

Растр в TSPL в Javascript

Хорошо, теперь, когда у меня была четкая цель, я хотел посмотреть, смогу ли я получить эталонный выходной файл TSPL из известного входного файла PNG. К счастью, Mac также используют CUPS (в конце концов, Apple поддерживает его), и я смог установить драйвер принтера Polono на свой Mac (довольно забавно, мой Mac — это чип ARM M1, поэтому он эмулирует драйвер x64 в Rosetta). CUPS имеет полезную утилиту командной строки, cupsfilterкоторая позволяет вам запускать сценарий фильтрации и сохранять вывод в файл, а не прямо на принтер.

cupsfilter test.png -p /Library/Printers/PPDs/Contents/Resources/PL60.tspl.ppd -m printer/foo -e > out.tspl

Потрясающий! Я смог принять мой test.pngвход и вернуть out.tsplфайл. Я даже скопировал этот файл на Raspberry Pi и попытался записать его через via, cat out.tspl > /dev/usb/lp0и о чудо… он напечатал изображение! 🎉🎉🎉

Взглянув на файл .tspl в текстовом редакторе, мы видим файл, состоящий в основном из текстовых строк, с одной гигантской двоичной строкой. Я даже пытался изменить некоторые вещи, например добавить SPEED 2строку, и смог заставить ее печатать немного быстрее или медленнее, в зависимости от числа. Это потрясающе… теперь мы напрямую общаемся с принтером!

SIZE 99.8 mm, 149.9 mm
SET TEAR ON
SET CUTTER OFF
SET PEEL OFF
CLS
BITMAP 0,0,100,1198,1,���...���
PRINT 1,1

Теперь мой единственный вопрос: как фильтр превращает изображение PNG в строку BITMAP, полную двоичных данных? Это действительно не похоже на стандартный формат растрового изображения . Я посмотрел в руководстве по программированию TSPL функцию «BITMAP», и на самом деле это не казалось таким уж сложным! Это термопринтер, поэтому каждый пиксель либо черный, либо белый, без оттенков серого или цветов, о которых нужно беспокоиться. И каждый пиксель представлен одним битом.

Из нашей BITMAP 0,0,100,1198,1,���...���строки выше мы видим, что двоичные данные начинаются с координаты X 0, координаты Y 0, содержат 100байты данных по ширине и 1198точки по длине. Это согласуется с тем, что мы знаем, поскольку в байте 8 бит, что в общей сложности составляет 800 точек в ширину, а в спецификациях указано 203 dpi (8 dots/mm), что ширина ~ 4 дюйма. То же самое с длиной 1196 точек — получается изображение размером 4 x 6 дюймов или стандартный размер транспортировочной этикетки. Превосходно.

Преобразование изображения в команду BITMAP

Я не смог найти никаких скриптов, которые превращают необработанные изображения в растровые изображения TSPL, поэтому я решил написать свой собственный. Это не может быть так сложно, верно? Ну, если не считать нескольких случайных ошибок в моей логике во время тестирования, на самом деле это не так! Вот мой полный код . У него есть только одна зависимость, JIMP (JavaScript Image Manipulation Program) , которая представляет собой пакет, который может загружать изображения изначально в JavaScript и имеет метод для чтения значения пикселя в любой конкретной координате X, Y. Таким образом, все, что требуется, — это пройтись по каждому пикселю в строке (направление X) и определить, должен ли этот пиксель быть добавлен к байту как 1 (белый пиксель) или 0 (черный пиксель), обязательно добавляя текущий байт в буфер каждые 8 ​​пикселей (или бит). Затем запустите это в цикле для всех строк пикселей в изображении (направление Y).

В конце у вас есть буфер байтов, содержащий данные пикселей, которые вы можете добавить в конец своей BITMAPстроки. Чтобы проверить свои результаты, я воссоздал образ, аналогичный примеру из руководства. Я начинаю с того же изображения 16×16, но рисую его на холсте размером 800×1198, так же, как и наша выходная метка, чтобы мы могли получить отображение 1 к 1 пикселю при печати.

Теперь, независимо от того, запускаем ли мы это изображение с помощью нашего сценария node print.js test.pngили драйвера производителя, используя приведенную cupsfilterвыше команду, мы получаем один и тот же двоичный файл для отправки на принтер. Мы можем проверить его с помощью шестнадцатеричного редактора:

И действительно, мы получаем 16 бит (2 байта) нулей ( 00 00в шестнадцатеричном формате), за которыми следуют 98 байтов единиц ( FF FF FF FF FF ...). Каждая область, выделенная синим цветом, является началом новой строки пикселей (100 байт). Давайте преобразуем эти первые несколько строк шестнадцатеричного обратно в двоичный формат и посмотрим, похоже ли это на изображение, которое мы ожидаем.

Черт возьми, это похоже на наше тестовое изображение! В конце нашего JS-скрипта мы даже можем отправить полученный файл прямо на принтер

fs.writeFileSync("/dev/usb/lp0", label);

и выходит этикетка. Теперь у меня есть только сценарий-оболочка, который запрашивает у EasyPost ярлыки PNG , сохраняет изображение на диск и запускает сценарий принтера. Весь скрипт занимает около 2 секунд на Raspberry Pi, что не так быстро, как скомпилированный код, но достаточно быстро для наших нужд.

Что дальше?

Приложив немного больше усилий, я считаю, что кто-то может превратить это в жизнеспособный стартап. Попробовав Stamps.com, Dymo, PirateShip и несколько других, я убедился, что хороших комбинаций аппаратного и программного обеспечения для доставки не существует. Все это кажется чрезмерно проприетарным, и ничто из этого не может быть взломано или взаимодействует с базой данных, которая у меня уже есть. Я бы хотел, чтобы кто-то продавал набор с:

• Raspberry Pi за 35 долларов для печати по Wi-Fi в любом месте на складе
• Дешевый принтер Polono / HPRT стоимостью ~ 100 долларов.
• Беспроводной сканер штрих -кода стоимостью около $60 для сопоставления серийных номеров и автоматической печати транспортных этикеток .
• Веб-интерфейс, обслуживаемый Raspberry Pi, поэтому я могу печатать этикетки со своего телефона/ноутбука.
• Способ печати этикетки для быстрой доставки с автозаполнением адреса (для разовых заказов)
• Простой API для отправки адресов/этикеток, которые необходимо распечатать из нашей системы заказов

Вот моя отгрузочная станция, которая проверяет все эти коробки. Многие из них — это внутренние скрипты, собранные вместе, поэтому я не тратил время на то, чтобы отполировать их и сделать их достаточно универсальными для выпуска. Если вы хотите увидеть более подробную информацию в будущем сообщении в блоге, пожалуйста, дайте мне знать!

бессовестная вилка

Если вы хотите, чтобы ваша собственная этикетка работала на этой станции доставки (ну, вместе с действительно классным продуктом!), вы можете предварительно заказать PiBox . Он загружен всем, что вам нужно для самостоятельного размещения приложений дома. Ожидается, что новые заказы будут отправлены в июле.

Оригинал статьи находится по ЭТОЙ ссылке