Термо принтер и JavaScript

от автора

Приобрел я на днях термопринтер (кассовый аппарат, если изволите) жене для магазина и решил что смогу его обуздать как истинный программист и сделать свою веб кассу, вместо того, что-бы использовать платные решения, ведь задача простая, печатать чеки, но это оказалось не так то и просто…


Вот так выглядит сие чудо, было куплено в соседнем магазине, без опознавательных знаков, названия фирмы и без всего интересного.

Из полезной информации есть только название модели «AW-5890C».

Это усложнило весь процесс, но я решил пойти с малого. Первой задачей было синхронизироваться через браузер с USB девайсом, посредством USB API.

И тут меня ждал подвох…
Казалось бы, всем знакомый (тем кто работал с USB в браузере) сниппет кода, для открытия соединения с USB девайсом:

navigator.usb.requestDevice({filters: []}) .then(usbDevice => {          usbDevice.open()     .then(() => console.log('Success'))     .catch(() => console.error('Bye bye'));        });

В первой строке мы запрашиваем все девайсы в браузере, что-бы пользователь мог выбрать девайс. (Свойство «filters» обязательное как аргумент, потому пустой массив)
После того, как пользователь выбрал, мы вызываем у девайса метод «open», что-бы открыть соединение с ним.

В результате:

Видим наше устройство, уже отлично, выбираем его и….

«Это победа!»

На поиск истины у меня ушло более чем несколько часов, и вот она:
Windows 10 — единоличная операционная система…

Оказывается, если вы подключили какое-либо устройство и система определила его периферический тип и установила драйвера, то она тут же добавляет его в свою особенную службу, тем самым, делая устройство «занятым».

Это говорит о том, что вы можете послать файл на распечатку в принтер, который определился системой, но вы не можете воспользоваться USB портом, т.к. он занят принтером, который определила система.

Об этом же и говорит ошибка на скриншоте — «Access denied», т.к. устройство занято другим приложением (правильнее сказать службой операционной системы)

Решение этой проблемы довольно топорное, существует данная тулза, которая позволяет пере прошить драйвер USB, что-бы никакие службы не воровали устройство в свои владения.

Принцип прост, скачиваем, запускаем, выбираем наш порт, к которому подключено устройство, нажимаем «Install Driver»

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


Следующий шаг был понять, как напечатать на принтере хоть что-нибудь…

На страничках гугла, stack overflow и т.п. была найдена информация что данные принтеры работают на 8 битных словах и можно просто отправить буфер 8 битных слов на принтер.
Так и было сделано:

// Encode let encoder = new TextEncoder(); let buffer = encoder.encode('\n\n\nHello world\n\n\n');  // Input endpoint const endpoint = usbDevice.configuration.interfaces[0].alternate.endpoints[0].endpointNumber;  // Print usbDevice.transferOut(endpoint, buffer) .catch(error => { console.warn(error); })

Результат меня знатно заинтриговал тем, что он сработал!

Еще стоит пояснить за то, что я использовал «Input» канал для отправки сообщения в коде свыше: почти каждое USB устройство имеет по крайней мере 2 канала — Ввод и вывод.

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


Радости моей не было конца и края!
Почти…

В наших реалиях, чеки будут печататься на русском языке, и тут меня снова ждал облом…

После такого, я начал задумываться о поиске документации для no name принтера.

Забив его модель в гугл и сопоставив все факты, а именно, что я живу в Украине и этот принтер владельцы соседнего магазина продали мне за гроши (как вероятно его сами и купили), то поиск не заставил себя долго ждать и был найден данный производитель.

У него в наличии есть практически такой же принтер с отличием в названии в 1 букву, а у них на сайте, так же можно найти и PDF с описанием контроллера и команд, которые я мог бы использовать.

Так же, по мимо этого, я нашел и документацию от более известного производителя HP

Но как базу я стал использовать PDF отечественного производителя, т.к. она показалась мне более достоверной в моих условиях.

После быстрого прочтения обеих документаций было найдено несколько интересных особенностей данных принтеров:

  1. Они все работают на 8 битных словах

  2. Они стековые

  3. Если встречается слово «0x1b», то оно распознается как начало команды.

В итоге была найдена данная команда:

Однако у HP список включал в себя на 9 кодировок больше:

Судя по описанию команда выглядит как 3 последовательных слова, которые должны быть отправлены на девайс, а именно:

  • 0x1B, 0x74, charset — в HEX формате.

  • 27, 116, charset — в десятичном формате.

Осталось выбрать кодировку и в путь!
Точкой опоры естественно стали кодировки с первого скриншота, которые относятся к принтерам Украинского производства.
Рассматривались различные кодировки, желательно те, которые участвовали бы в обеих списках, что-бы при изменении принтера на другой, не пришлось переписывать либо же сильно дополнять существующий код.

В качестве нужной кодировки у многих программистов взгляд мог сразу упасть на WPC 1252.

Но не тут то было, чистый обман глаз и никакого мошенничества.

Все помнят Notepad++ и его фишку с кодировками, но та самая что с русскими буквами и многим интересна есть 1251, в тот час как 1252 не содержит ничего интересного, кроме символов «Торговая марка» и нескольких валют, в ней даже знака Евро нет…

По данной причине взгляд пал на «PC866», она есть как в первом PDF так ив PDF от HP, что уже внушает доверие, причем в документе от HP она идет с приписью «Russian»

Что-бы установить кодировку, просто стоит отправить команду на девайс перед отправкой текста, выглядит это так:

// Encode let encoder = new TextEncoder(); let buffer = encoder.encode('\n\n\nHello world\n\n\n');  const endpoint = usbDevice.configuration.interfaces[0].alternate.endpoints[0].endpointNumber;  // Set 866 usbDevice.transferOut(endpoint, new Uint8Array([0x1b, 0x74, 17])) .catch(error => { console.warn(error); })  // Print usbDevice.transferOut(endpoint, data) .catch(error => { console.warn(error); })

Стоит напомнить, что данные принтеры являются стековыми, что дает нам возможность записать предыдущий снипет кода в таком виде:

// Encode let encoder = new TextEncoder(); let buffer = encoder.encode('\n\n\nHello world\n\n\n');  const endpoint = usbDevice.configuration.interfaces[0].alternate.endpoints[0].endpointNumber;  // Set 866 usbDevice.transferOut(endpoint, new Uint8Array([0x1b])) .catch(error => { console.warn(error); })  usbDevice.transferOut(endpoint, new Uint8Array([0x74])) .catch(error => { console.warn(error); })  usbDevice.transferOut(endpoint, new Uint8Array([17])) .catch(error => { console.warn(error); })  // Print usbDevice.transferOut(endpoint, data) .catch(error => { console.warn(error); })

Данный факт является и проблемой в то же время, одна неверно описанная команда в вашем коде, ложит принтер.

Если вы ошиблись с кол-вом аргументов, то вы получите излишние аргументы на печать, а недостающие будут съедены из данных которые вы пошлете после.

Как результат кода приведенного выше, русских букв я так и не увидел…

Стоит напомнить, что данный принтер работает на 8 битных словах.

А буква «П» в фразе «Привет мир» имеет индекс 1055 в юникоде, что не совсем умещается в диапазон 0-255 так ведь?

Мое неумение работать с кодировками продлило мне задачу на несколько часов, но факт в том, что мало выставить кодировку на принтере, нужно еще и присылать ему данные в правильной кодировке.

И тут я потратил еще минут 10 на составление функции для перевода текста из JavaScript в 866 кодировку, я учел в ней только русские буквы, остальные символы в учет не брал:

function utf8_to_866 (aa) {   let c = 0;   let ab = new Uint8Array(aa.length);    for (let i = 0; i < aa.length; i++) {       c = aa.charCodeAt(i);       if (c >= 1040 && c <= 1087) {         ab[i] = c - 912;       } else if (c >= 1088 && c <= 1105) {         ab[i] = c - 864;       } else {         ab[i] = aa.charCodeAt(i);       }   }   return ab; }

И в боевом окружении выглядит это так:

let data = utf8_to_866('\n\nПривет Хабр!\n\n\n\n\n\n\n\n');  const endpoint = usbDevice.configuration.interfaces[0].alternate.endpoints[0].endpointNumber;  // Set 866 usbDevice.transferOut(endpoint, new Uint8Array([0x1b, 0x74, 17])) .catch(error => { console.warn(error); })  // Print usbDevice.transferOut(endpoint, data) .catch(error => { console.warn(error); })

Как результат:


Всем спасибо за внимание!

Список использованной литературы и приложений:
http://h10032.www1.hp.com/ctg/Manual/c06481647.pdf
https://www.xprinter.com.ua/image/data/tovar/download/80XX%20Programmer_Manual(latest%20version).rar
https://tftwiki.ru/wiki/Windows-1252
https://ru.wikipedia.org/wiki/ISO_8859-1
https://ru.wikipedia.org/wiki/CP866


ссылка на оригинал статьи https://habr.com/ru/articles/580086/