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-а ни оптичко декодирање. То понашање и даље припада хардверу или серијском тестном двојнику којим управљате.