[recovery mode] Термо принтер и JavaScript27.09.2021 00:01

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

4f3259e4e73b5bfae82890fd3db512a0.jpg4d1cf8cc3d86b9e1a1e68815cde888d3.jpg

Вот так выглядит сие чудо, было куплено в соседнем магазине, без опознавательных знаков, названия фирмы и без всего интересного.
Из полезной информации есть только название модели «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», что-бы открыть соединение с ним.

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

ad0a51654add27425fc3b1df2140f0db.jpg

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

8b584c21fc01344c71e8d99f31882f0f.jpg

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

На поиск истины у меня ушло более чем несколько часов, и вот она:
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); })

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

e19207a7f6211891dd0c7ecfaba9e06e.jpg

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

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

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

4b52a21f3432ec708742f7c8affbe30a.jpg

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

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

b446141ff03d05149e522818e298d957.jpg

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

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

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

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

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

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

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

7841902b7b160f853257ec96dd46625d.jpg

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

35871ce56ce083502216bad174604d18.jpg

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

  • 0×1B, 0×74, charset — в HEX формате.

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

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


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

71a74d932bfe26995c229143f6b08465.jpg

По данной причине взгляд пал на «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); })

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

510ca33956d2796426d3ed9d52b01f89.jpg

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


Список использованной литературы и приложений:
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

© Habrahabr.ru