Barcode Scanner Emulator
USB HID і послідовні сканери штрихкодів
Сканер USB HID у режимі клавіатурного клина набирає декодований штрихкод у застосунок, який має фокус. Послідовний сканер USB відкриває послідовний інтерфейс, часто як віртуальний порт COM, і застосунок мусить сам відкрити цей порт і прочитати байти. USB — це кабель і шина. HID і послідовний режим — різні способи віддати ті самі дані.
Беріть той інтерфейс, який застосунок справді вміє прочитати. Поле на касі, що вже приймає набір, — це задача клавіатурного клина. Служба, якій сканування мають надходити, коли жодне текстове поле не у фокусі, або яка мусить тримати байти сканера окремо від клавіатури, — це послідовна задача. Багато сканерів мають лише один із цих режимів. Деякі вміють перемикатися. Посібник саме цієї моделі — перелік режимів, які можна перевірити.
Посібник Клавіатурний клин HID докладно пояснює шлях натискань. Як працюють сканери штрихкодів? розбирає захоплення й декодування. Ця сторінка зіставляє два інтерфейси з боку комп’ютера і перевірки, які належать кожному з них.
Що таке режим клавіатурного клина USB HID?
У режимі клавіатури USB HID сканер перелічується як клавіатура. Операційна система завантажує свій звичайний драйвер клавіатури. Після декодування сканер надсилає символи натисканнями клавіш у той елемент керування, який має фокус клавіатури. Вебформа, поле позиції в POS або текстове поле на робочому столі приймають це введення без коду, написаного спеціально для сканера.
Куди ляжуть символи, вирішує фокус. Якщо потрібне поле не у фокусі, символи потрапляють в інший елемент або губляться. Сканер не клацає і не рухає вказівник.
За корисним навантаженням може йти налаштований суфікс. Enter надсилає багато форм з одним полем. Tab переносить фокус на наступний елемент. Жодна з цих клавіш не гарантована. Вибір суфікса розібрано в посібнику Суфікси ENTER і TAB у сканерах штрихкодів.
Звичайні події клавіатури не містять виробника сканера, серійного номера й ознаки того, що клавіші надійшли від сканера. Браузери з WebHID усе одно відмовляють інтерфейсам клавіатури, тож сторінка не може відкрити пристрій клина й прочитати сирі звіти HID.
Що таке послідовний режим сканера штрихкодів USB?
У послідовному режимі USB сканер не набирає текст. Він відкриває послідовний інтерфейс поверх USB. Операційна система зазвичай показує цей інтерфейс як віртуальний порт COM: ім’я COM у Windows, пристрій cu або tty у macOS чи пристрій ttyACM або ttyUSB у Linux. Ім’я призначає драйвер, і воно може змінитися після від’єднання сканера.
Віртуальний порт COM — не фізичний порт RS-232. RS-232 — електричний інтерфейс із власним роз’ємом і рівнями напруги, який комп’ютер читає через UART. Послідовний USB користується кабелем USB. Застосунок усе одно відкриває послідовний порт і читає байти, але сигнал на дроті — це USB. Одні вироби — це справжній сканер RS-232 плюс перехідник з USB на послідовний порт. Інші реалізують USB CDC і взагалі не розмовляють RS-232. Точкою інтеграції вважайте порт, який показує операційна система, і не припускайте, що електричні подробиці збігаються.
Застосунок відкриває порт, читає потік байтів і сам вирішує, де повідомлення починається й закінчується. Звичайна рамка — текст штрихкода, після якого йде CR (0x0D), LF (0x0A) або спершу CR, а потім LF. Ця рамка — налаштування пристрою, а не правило USB. Можливий і байт префікса, наприклад STX. Посібник Префікс і суфікс сканера штрихкодів: повний посібник відділяє ці байти від клавіші Enter, яку надсилає сканер-клин.
Швидкість, біти даних, парність і стопові біти важливі на справжньому UART і на багатьох перехідниках з USB на послідовний порт. Хибна швидкість дає сміття, а не чисту помилку. Деякі віртуальні пристрої COM з USB CDC ігнорують швидкість, яку запитує хост, і все одно віддають байти. Немає одного налаштування на кожен віртуальний послідовний сканер. Візьміть швидкість і рамку з посібника цієї моделі, а потім підтвердьте їх відомим штрихкодом.
Дані отримує процес, який тримає порт відкритим. Фокус клавіатури одержувача не обирає. Інша програма, яка вже відкрила порт, заблокує друге відкриття. Від’єднання сканера прибирає порт. Повторне під’єднання може створити нове ім’я, і застосунок має відкрити цей порт знову.
HID і послідовний режим
| Можливість | Клавіатурний клин HID | Послідовний USB |
|---|---|---|
| Доставка даних | Введення на кшталт клавіатури | Послідовний потік байтів |
| Потрібен фокус введення | Так. Натискання йдуть за елементом із фокусом | Ні. Байти йдуть у процес, який відкрив порт |
| Вбудовування в браузер | Звичайне введення і події клавіатури | Web Serial там, де браузер його підтримує, або програма поза сторінкою |
| Керування в застосунку | Обмежене поведінкою клавіатури, фокусом і суфіксами | Застосунок читає потік і збирає з нього повідомлення |
| Розпізнавання пристрою | Недоступне зі звичайних подій клавіатури | Операційна система може показати ім’я порта. Стала ідентичність усе одно залежить від драйвера |
| Налаштування | Налаштування сканера, зокрема суфікс і розкладка клавіатури | Налаштування сканера плюс ті параметри порта на хості, якими пристрій справді користується |
| Типове застосування | Форми і введення позицій у POS | Окремі інтеграції, яким належить пристрій |
Це звичні випадки. Конкретна модель, операційна система і драйвер можуть відрізнятися. Сканер Bluetooth у режимі клавіатури HID на рівні застосунку йде стовпцем клина. Bluetooth SPP іде послідовним стовпцем.
Як сканери HID працюють у вебзастосунках
Сканування клином оновлює елемент із фокусом. Друковані символи викликають keydown, а потім input. Enter і Tab викликають keydown і не вставляють символ у звичайне текстове поле. Для цих клавіш event.key дорівнює "Enter" або "Tab", а для друкованого символа — рядку з одного символу. event.code називає фізичну клавішу і може лишитися тим самим, коли розбіжність розкладки змінює event.key.
Слухач нижче фіксує поле лише тоді, коли надходить Enter. Сканер без суфікса Enter лишає текст у полі.
const field = document.querySelector('#barcode')
if (!(field instanceof HTMLInputElement)) {
throw new Error('Barcode field was not found.')
}
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Перед скануванням дайте фокус #barcode. preventDefault() не дає батьківській формі надіслатися вдруге. Якщо сканер надсилає Tab, прочитайте значення в цьому keydown і дозвольте браузеру перенести фокус. Якщо він не надсилає ні Enter, ні Tab, надішліть поле кнопкою або іншою явною дією. Пауза в наборі — лише евристика кінця сканування.
У цих подіях немає нічого, що розпізнає пристрій USB. Той самий ряд може створити людина, макрос або емулятор. Перевірка стосується корисного навантаження. Браузерний сценарій, зокрема Tab і порожнє введення, є в посібнику Як тестувати сканери штрихкодів у вебзастосунках.
Як послідовні сканери працюють у застосунках
Послідовна інтеграція відкриває порт, читає байти, ріже їх на повідомлення й обробляє зникнення порта. На робочому столі це послідовний API операційної системи або бібліотека виробника. У браузері єдиний вбудований варіант — Web Serial API, і лише в браузерах, які його реалізують.
Web Serial є в браузерах на основі Chromium. Firefox і Safari його не надають. Сторінка має бути в безпечному контексті, тобто HTTPS або localhost. requestPort() мусить викликатися з жесту користувача, і користувач має обрати порт у запиті браузера. Сканер у режимі клавіатурного клина в цьому списку не з’являється, бо це не послідовний пристрій. Web Serial також не бачить послідовний порт, якого операційна система не показала.
Швидкість у прикладі — відправна точка, яку ви замінюєте значенням із посібника. Цикл вважає CR або LF кінцем повідомлення і поглинає пару CRLF як один завершувач. Якщо у сканера інша рамка, це розбиття хибне, навіть коли порт відкрито.
<button id="open-serial" type="button">Open scanner port</button>
<p id="status" role="status"></p>
<script>
const button = document.querySelector('#open-serial')
const status = document.querySelector('#status')
function takeLine(buffer) {
const cr = buffer.indexOf('\r')
const lf = buffer.indexOf('\n')
const end = cr < 0 ? lf : lf < 0 ? cr : Math.min(cr, lf)
if (end < 0) {
return null
}
const line = buffer.slice(0, end).trim()
let rest = buffer.slice(end + 1)
if (buffer[end] === '\r' && rest.startsWith('\n')) {
rest = rest.slice(1)
}
return { line, rest }
}
button.addEventListener('click', async () => {
if (!('serial' in navigator)) {
status.textContent = 'This browser does not provide Web Serial.'
return
}
let port
try {
port = await navigator.serial.requestPort()
await port.open({ baudRate: 9600 })
} catch (error) {
status.textContent = 'The port was not opened.'
return
}
const reader = port.readable.getReader()
const decoder = new TextDecoder()
let buffer = ''
try {
while (true) {
const { value, done } = await reader.read()
if (done) {
break
}
buffer += decoder.decode(value, { stream: true })
let next = takeLine(buffer)
while (next) {
if (next.line) {
status.textContent = next.line
}
buffer = next.rest
next = takeLine(buffer)
}
}
} catch (error) {
status.textContent = 'The serial read stopped.'
} finally {
reader.releaseLock()
await port.close()
}
})
</script>
Цикл читання триває, доки потік не закінчиться або читання не зірветься. Від’єднання сканера зазвичай відхиляє читання. releaseLock() і close() виконуються в finally. Порти, уже дозволені для цього джерела, можна перелічити через navigator.serial.getPorts(), і запит більше не показується. Перший дозвіл усе одно потребує користувача.
Настільний застосунок іде тією самою ідеєю з послідовним API платформи: відкрити, прочитати, зібрати рамку й відкрити знову, коли пристрій повернеться. Ця сторінка не вигадує команд виробника. Якщо сканер чекає на власний протокол, цей протокол є в документації виробника.
Що краще: HID чи послідовний режим?
Жоден режим не кращий для будь-якого продукту. Користуйтеся режимом, який сканер справді пропонує, і режимом, який застосунок уміє прочитати.
Обирайте HID, коли
- Застосунок уже приймає введення з клавіатури в полі з фокусом.
- Форма або екран POS мають працювати без коду для пристрою.
- Процес може гарантувати фокус перед кожним скануванням.
- Enter або Tab збігається з тим, як ця форма фіксує значення чи переходить далі.
Розглядайте послідовний режим, коли
- Сканування мають надходити, поки фокус у діалозі, на кнопці або ніде.
- Байти сканера мають лишатися окремо від набору.
- Застосунок може відкрити порт, зібрати повідомлення й відновитися, коли пристрій від’єднують.
- Хост може надати дозвіл на цей порт, і жоден інший процес не потребує його водночас.
Сканер, який перелічується лише як клавіатура, не можна перемкнути в послідовний режим програмою на хості. Підтвердьте режими в посібнику, перш ніж проєктувати інтеграцію.
Перемикання між HID і послідовним режимом
Деякі сканери змінюють режим, коли ви зчитуєте конфігураційний штрихкод із посібника цього виробника або записуєте профіль службовою програмою виробника. Інші зроблені як один інтерфейс, і перемикати нічого.
Немає конфігураційного штрихкода, який змінює режим у всіх марок. Послідовність, надрукована для іншої моделі, може нічого не зробити або лишити сканер у несподіваному режимі. Після будь-якої зміни подивіться, що показує операційна система: клавіатуру, порт COM чи те й те. Потім перевірте шлях, яким користується застосунок. Посібник із налаштування сканера штрихкодів описує звичайні групи налаштувань. Він не замінює посібник моделі.
Перевірка сканера HID
- Підключіть сканер і переконайтеся, що він у режимі клавіатурного клина. Текстовий редактор має отримувати символи, коли поле в цьому редакторі у фокусі.
- Відкрийте тестер введення штрихкода.
- Клацніть Почати тест або клацніть область сканування. Вона стає синьою, коли готова. Сторінка сама фокус не забирає.
- Зчитайте штрихкод, корисне навантаження якого ви вже знаєте.
- Порівняйте захоплене значення і кількість символів із цим корисним навантаженням.
- Прочитайте суфікс: ENTER, TAB або None. Enter і Tab не входять у рядок штрихкода.
Тестер записує події клавіатури, які бачить браузер. Він не може читати послідовний порт і не може розпізнати пристрій USB. Коли середній проміжок між символами менший за 100 ms, він повідомляє цей час. Час — не розпізнавання обладнання. Для кожного keydown, зокрема key і code, скористайтеся тестером подій клавіатури. Ширший прохід є в посібнику Як тестувати введення зі сканера штрихкодів.
Перевірка послідовного сканера
Тестер введення штрихкода не відкриває порт COM. Послідовній перевірці потрібна програма, яка може відкрити порт, показаний сканером.
- Переконайтеся, що сканер у послідовному режимі і що операційна система показує порт, коли сканер підключено. Від’єднайте його і перевірте, що порт зник.
- Запишіть ім’я порта. Воно залежить від операційної системи і може змінитися під час наступного під’єднання.
- Відкрийте порт із сумісного застосунку: послідовного термінала, вашого настільного застосунку або прикладу Web Serial вище в браузері на основі Chromium через HTTPS або localhost.
- Задайте швидкість, біти даних, парність і стопові біти, коли посібник їх називає. Значення, яких у посібнику немає, не вигадуйте.
- Зчитайте відомий штрихкод.
- Порівняйте байти або декодований текст із цим корисним навантаженням.
- Перевірте рамку. Шукайте префікс і CR, LF або CRLF після даних, лише якщо саме це задано в посібнику.
Якщо відкриття порта не вдається, бо він зайнятий, закрийте іншу програму, яка його тримає. Якщо текст — сміття, параметри лінії не збігаються з пристроєм. Якщо порт так і не з’являється, сканер може досі бути в режимі клавіатури, драйвер може бути відсутній, або користувачеві ОС може бути заборонено відкривати послідовні пристрої.
Типові проблеми
Сканер працює в текстовому редакторі й не працює в цільовому застосунку. Пристрій набирає текст. У цілі немає фокуса, або слухач keydown відкидає клавіші. Почніть зі статті Сканер працює в Notepad, але не в POS.
Сканер не набирає текст у жодне текстове поле. Він може бути в послідовному режимі, вимкнений або не читає символ. Сканер у послідовному режимі набирати не буде. Перевірте порт COM, перш ніж зневаджувати поле. Стаття Сканер штрихкодів не працює відділяє неробочий сканер від хибного інтерфейсу.
Послідовного порта немає. Режим клавіатури не створює порт COM. Відсутній драйвер, кабель лише для заряджання або сканер без послідовного режиму дають той самий симптом. Дивіться список пристроїв ОС, поки підключаєте сканер.
Послідовний порт уже зайнятий. Читати його може лише один процес. Закрийте термінал або іншу копію застосунку, а потім відкрийте порт знову.
Параметри зв’язку хибні. Розбіжність швидкості, парності або стопових бітів виглядає як випадкові символи. Задайте значення з посібника цієї моделі, а потім знову зчитайте відомий код.
ENTER або TAB так і не надходять. Це налаштування суфікса клина. Тестер введення повідомляє None. Див. У сканера штрихкодів немає ENTER і посібник про суфікси вище. Послідовний сканер не надсилає клавішу Enter. Він може надіслати байти CR або LF.
На сканері-клині хибні символи. Розкладка клавіатури сканера і розкладка операційної системи можуть не збігатися. Послідовні байти ця розкладка не перепризначує. Див. Хибна розкладка клавіатури сканера штрихкодів.
Браузер не може звернутися до сканера. Сканер-клин не з’явиться в запиті Web Serial. У Firefox і Safari немає Web Serial API. Сторінка не на HTTPS і не на localhost скористатися ним не може. Користувач також може закрити запит порта.
Застосунок втрачає сканер після від’єднання. Сканер-клин повертається як клавіатура, і наступному скануванню все одно потрібен фокус. Послідовного порта немає, доки застосунок не відкриє новий порт. Ім’я може не збігтися з попереднім.
Сценарії інтеграції
Вебзастосунки
Клавіатурний клин пасує полю з фокусом і звичайним подіям DOM. Послідовний доступ усередині сторінки означає Web Serial у браузері, який його підтримує, безпечний контекст і порт, обраний користувачем. Сторінка, яка має підтримувати Firefox, Safari і кіоски без оператора, не може спиратися лише на Web Serial. Локальний помічник може володіти портом COM і пересилати готові штрихкоди на сторінку. Цей помічник — окрема програма. Перевірка клина цю програму не вправляє.
Системи POS
POS, який ставить фокус у поле позиції і фіксує значення за Enter, — інтеграція клина. POS, який має сканувати, поки відкрите модальне вікно, або який має ігнорувати клавіатуру, — послідовна інтеграція. Змішування дає сканування не в те поле або сканування, які не надходять. Узгодьте режим сканера з екраном, який справді на зміні.
Настільні застосунки
Настільний застосунок може приймати введення клина в тому елементі, який у фокусі, або відкрити віртуальний порт COM і тримати сеанс упродовж життя процесу. Володіння портом, повторне під’єднання і рамка — частина цього сеансу. Фокус до нього не належить.
Автоматизація QA
Barcode Scanner Emulator набирає обране вами значення в застосунок із фокусом і може надіслати ENTER, TAB або обійтися без суфікса. Це покриває регресії клавіатурного клина: фокус, перевірку й обробку суфікса. Він не створює віртуальний порт COM, не перелічує пристрої USB і не відтворює швидкість та рамку. Послідовним перевіркам усе одно потрібні послідовний порт і програма читання або тестовий двійник, який пише ту саму байтову рамку, яку розбирає застосунок.
Кіоски
Кіоск із введенням клина має утримувати поле сканування у фокусі крізь діалоги, заставки й повідомлення про помилки. Один втрачений фокус — і наступне сканування потрапляє в сполучення клавіш або в нікуди. Кіоск із послідовним режимом може читати порт без цього фокуса, і він має тримати дозвіл на пристрій і наново відкривати порт після втрати живлення або висмикування кабелю.
Де доречний Barcode Scanner Emulator
Barcode Scanner Emulator — настільний застосунок для Windows, macOS і Linux. Він відтворює клавіатурний шлях, яким користується сканер-клин. Ви вводите текст, обираєте затримку набору й обираєте суфікс: немає, ENTER або TAB. Глобальне сполучення набирає цей текст у застосунок із фокусом.
Користуйтеся ним, щоб розробляти форми в стилі HID і ловити їхні регресії, коли сканера немає на столі. Поєднайте його з тестером введення штрихкода, щоб побачити значення, клавіші префікса і суфікс, які отримав браузер.
Він не емулює послідовний пристрій USB, віртуальний порт COM, перелічення USB чи оптичне декодування. Ця поведінка й далі належить обладнанню або послідовному тестовому двійнику, яким ви керуєте.