Barcode Scanner Emulator
Čtečky čárových kódů USB HID a sériové
Čtečka USB HID v režimu klávesnicového klínu zapíše dekódovaný čárový kód do aplikace s fokusem. Sériová čtečka USB vystaví sériové rozhraní, často jako virtuální port COM, a aplikace musí tento port otevřít a přečíst bajty. USB je kabel a sběrnice. HID a sériový režim jsou různé způsoby, jak data předložit.
Vyberte rozhraní, které aplikace skutečně umí přečíst. Pokladní pole, které už přijímá psaní, je úloha pro klávesnicový klín. Služba, která musí dostat sken, když žádné textové pole nemá fokus, nebo která musí držet bajty čtečky odděleně od klávesnice, je sériová úloha. Mnoho čteček nabízí jen jeden z těchto režimů. Některé umí přepnout. Návod k tomuto modelu je seznam režimů, které lze ověřit.
Příručka Klávesnicový klín HID podrobně vysvětluje cestu stisků. Jak fungují čtečky čárových kódů? probírá zachycení a dekódování. Tato stránka porovnává dvě rozhraní na straně počítače a testy, které patří ke každému z nich.
Co je režim klávesnicového klínu USB HID?
V režimu klávesnice USB HID se čtečka hlásí jako klávesnice. Operační systém načte svůj běžný ovladač klávesnice. Po dekódování čtečka pošle znaky jako stisky kláves do prvku, který má fokus klávesnice. Webový formulář, pole položky v POS nebo textové pole na ploše ten vstup přijme bez kódu napsaného zvlášť pro čtečku.
Fokus rozhoduje o cíli. Když zamýšlené pole fokus nemá, znaky skončí v jiném prvku, nebo se ztratí. Čtečka nekliká a nehýbe ukazatelem.
Za obsahem může následovat nastavená přípona. Enter odešle mnoho formulářů s jedním polem. Tab přesune fokus na další prvek. Ani jedna z těchto kláves není zaručená. Volbu přípony probírá příručka Přípony ENTER a TAB u čteček čárových kódů.
Běžné události klávesnice neobsahují výrobce čtečky, sériové číslo ani příznak, že klávesy přišly z čtečky. Prohlížeče s WebHID rozhraní klávesnice stejně odmítají, takže stránka nemůže otevřít zařízení klínu a přečíst surové zprávy HID.
Co je sériový režim čtečky čárových kódů USB?
V sériovém režimu USB čtečka nepíše. Vystaví sériové rozhraní přes USB. Operační systém toto rozhraní obvykle ukáže jako virtuální port COM: název COM ve Windows, zařízení cu nebo tty v macOS, nebo zařízení ttyACM nebo ttyUSB v Linuxu. Název přiděluje ovladač a po odpojení čtečky se může změnit.
Virtuální port COM není fyzický port RS-232. RS-232 je elektrické rozhraní s vlastním konektorem a napěťovými úrovněmi, které počítač čte přes UART. Sériové USB používá kabel USB. Aplikace pořád otevírá sériový port a čte bajty, ale signál na vodiči je USB. Některé výrobky jsou skutečná čtečka RS-232 plus převodník z USB na sériový port. Jiné implementují USB CDC a RS-232 vůbec nemluví. Za integrační bod berte port, který ukazuje operační systém, a nepředpokládejte, že elektrické podrobnosti sedí.
Aplikace port otevře, čte proud bajtů a rozhodne, kde zpráva začíná a končí. Obvyklý rámec je text čárového kódu, za kterým následuje CR (0x0D), LF (0x0A) nebo nejdřív CR a potom LF. Tento rámec je nastavení zařízení, ne pravidlo USB. Možný je i bajt předpony, například STX. Příručka Předpona a přípona u čteček čárových kódů: úplná příručka odděluje tyto bajty od klávesy Enter, kterou posílá čtečka v režimu klínu.
Rychlost, datové bity, parita a stop bity záleží na skutečném UART a na mnoha převodnících z USB na sériový port. Špatná rychlost dá smetí, ne čistou chybu. Některá virtuální zařízení COM s USB CDC rychlost, o kterou host žádá, ignorují a bajty stejně doručí. Neexistuje jedno nastavení pro každou virtuální sériovou čtečku. Vezměte rychlost a rámec z návodu k tomuto modelu a potom je potvrďte známým čárovým kódem.
Data dostane proces, který drží port otevřený. Fokus klávesnice příjemce nevybírá. Jiný program, který port už otevřel, druhé otevření zablokuje. Odpojení čtečky port odstraní. Opětovné připojení může vytvořit nový název a aplikace musí tento port otevřít znovu.
HID a sériový režim
| Vlastnost | Klávesnicový klín HID | Sériové USB |
|---|---|---|
| Doručení dat | Vstup ve stylu klávesnice | Sériový proud bajtů |
| Vyžadován fokus vstupu | Ano. Stisky sledují prvek s fokusem | Ne. Bajty jdou do procesu, který port otevřel |
| Napojení na prohlížeč | Běžný vstup a události klávesnice | Web Serial tam, kde ho prohlížeč podporuje, nebo software mimo stránku |
| Řízení v aplikaci | Omezené na chování klávesnice, fokus a přípony | Aplikace proud čte a skládá z něj zprávy |
| Identifikace zařízení | Z běžných událostí klávesnice nedostupná | Operační systém může ukázat název portu. Stabilní totožnost pořád závisí na ovladači |
| Nastavení | Nastavení čtečky, včetně přípony a rozložení klávesnice | Nastavení čtečky plus ta nastavení portu na hostiteli, která zařízení skutečně používá |
| Obvyklé použití | Formuláře a zadávání položek v POS | Samostatné integrace, které zařízení vlastní |
To jsou obvyklé případy. Daný model, operační systém a ovladač se mohou lišit. Čtečka Bluetooth v režimu klávesnice HID jde na vrstvě aplikace sloupcem klínu. Bluetooth SPP jde sériovým sloupcem.
Jak čtečky HID pracují ve webových aplikacích
Sken klínem aktualizuje prvek s fokusem. Tisknutelné znaky spustí keydown a potom input. Enter a Tab spustí keydown a do běžného textového pole znak nevloží. U těchto kláves je event.key rovno "Enter" nebo "Tab" a u tisknutelného znaku je to řetězec o jednom znaku. event.code pojmenuje fyzickou klávesu a může zůstat stejné, když neshoda rozložení změní event.key.
Obsluha níže pole potvrdí, teprve když přijde Enter. Čtečka bez přípony Enter nechá text v poli.
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 = ''
})
Před skenem dejte fokus #barcode. preventDefault() zabrání nadřazenému formuláři, aby se odeslal podruhé. Když čtečka posílá Tab, přečtěte hodnotu v tomto keydown a nechte prohlížeč přesunout fokus. Když neposílá ani Enter, ani Tab, odešlete pole tlačítkem nebo jinou výslovnou akcí. Pauza v psaní je jen heuristika konce skenu.
V těchto událostech není nic, co by poznalo zařízení USB. Stejnou posloupnost může vytvořit člověk, makro nebo emulátor. Ověření patří obsahu. Postup v prohlížeči, včetně Tab a prázdného vstupu, je v příručce Jak testovat čtečky čárových kódů ve webových aplikacích.
Jak sériové čtečky pracují v aplikacích
Sériová integrace otevře port, čte bajty, rozdělí je na zprávy a ošetří zmizení portu. Na ploše je to sériové API operačního systému nebo knihovna výrobce. V prohlížeči je jedinou vestavěnou možností Web Serial API, a jen v prohlížečích, které ho implementují.
Web Serial je v prohlížečích založených na Chromium. Firefox a Safari ho neposkytují. Stránka musí být v zabezpečeném kontextu, tedy HTTPS nebo localhost. requestPort() se musí spustit z gesta uživatele a uživatel musí port vybrat ve výzvě prohlížeče. Čtečka v režimu klávesnicového klínu se v tom seznamu neobjeví, protože to není sériové zařízení. Web Serial také nevidí sériový port, který operační systém nevystavil.
Rychlost v příkladu je výchozí bod, který nahradíte hodnotou z návodu. Smyčka bere CR nebo LF jako konec zprávy a pár CRLF spotřebuje jako jeden ukončovač. Když čtečka používá jiný rámec, je toto dělení špatně, i když je port otevřený.
<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>
Smyčka čtení běží, dokud proud neskončí nebo čtení neselže. Odpojení čtečky čtení obvykle odmítne. releaseLock() a close() proběhnou v finally. Porty dříve schválené pro tento původ lze vypsat přes navigator.serial.getPorts() bez další výzvy. První souhlas uživatele pořád vyžaduje.
Desktopová aplikace jde stejnou myšlenkou se sériovým API platformy: otevřít, číst, složit rámec a otevřít znovu, až se zařízení vrátí. Tato stránka nevymýšlí příkazy výrobce. Když čtečka čeká vlastní protokol, je tento protokol v dokumentaci výrobce.
Co je lepší: HID, nebo sériový režim?
Žádný režim není lepší pro každý produkt. Použijte režim, který čtečka skutečně nabízí, a režim, který aplikace umí přečíst.
Zvolte HID, když
- Aplikace už přijímá vstup z klávesnice v poli s fokusem.
- Formulář nebo obrazovka POS mají fungovat bez kódu pro zařízení.
- Postup dokáže zaručit fokus před každým skenem.
- Enter nebo Tab odpovídá tomu, jak tento formulář hodnotu potvrdí nebo postoupí dál.
Zvažte sériový režim, když
- Skeny musí přicházet, zatímco je fokus v dialogu, na tlačítku nebo nikde.
- Bajty čtečky mají zůstat oddělené od psaní.
- Aplikace umí otevřít port, složit zprávy a zotavit se, když se zařízení odpojí.
- Hostitel může udělit oprávnění k tomuto portu a žádný jiný proces ho ve stejnou chvíli nepotřebuje.
Čtečku, která se hlásí jen jako klávesnice, nelze na hostiteli přepnout do sériového režimu softwarem. Režimy potvrďte v návodu, než integraci navrhnete.
Přepínání mezi HID a sériovým režimem
Některé čtečky změní režim, když naskenujete konfigurační čárový kód z návodu tohoto výrobce, nebo když zapíšete profil nástrojem výrobce. Jiné jsou postavené jako jedno rozhraní a není co přepínat.
Neexistuje konfigurační čárový kód, který změní režim u všech značek. Posloupnost vytištěná pro jiný model nemusí udělat nic, nebo může čtečku nechat v neočekávaném režimu. Po každé změně se podívejte, co ukazuje operační systém: klávesnici, port COM, nebo obojí. Potom vyzkoušejte cestu, kterou používá aplikace. Příručka nastavení čtečky čárových kódů popisuje obvyklé skupiny nastavení. Nenahrazuje návod k modelu.
Testování čtečky HID
- Připojte čtečku a ověřte, že je v režimu klávesnicového klínu. Textový editor má dostat znaky, když má pole v tomto editoru fokus.
- Otevřete tester vstupu čárového kódu.
- Klepněte na Spustit test, nebo klepněte na oblast skenování. Zmodrá, když je připravena. Stránka si fokus sama nebere.
- Naskenujte čárový kód, jehož obsah už znáte.
- Porovnejte zachycenou hodnotu a počet znaků s tímto obsahem.
- Přečtěte příponu: ENTER, TAB nebo None. Enter a Tab nejsou součástí řetězce čárového kódu.
Tester zaznamenává události klávesnice, které prohlížeč vidí. Sériový port číst neumí a zařízení USB nepozná. Když je průměrná mezera mezi znaky kratší než 100 ms, ohlásí tento čas. Čas není identifikace hardwaru. Pro každé keydown, včetně key a code, použijte tester událostí klávesnice. Širší průchod je v příručce Jak testovat vstup z čtečky čárových kódů.
Testování sériové čtečky
Tester vstupu čárového kódu port COM neotevírá. Sériový test potřebuje program, který umí otevřít port vystavený čtečkou.
- Ověřte, že čtečka je v sériovém režimu a že operační systém ukáže port, když je čtečka připojená. Odpojte ji a zkontrolujte, že port zmizí.
- Poznamenejte si název portu. Závisí na operačním systému a při dalším připojení se může změnit.
- Otevřete port ze slučitelné aplikace: sériového terminálu, vaší desktopové aplikace nebo příkladu Web Serial výše v prohlížeči založeném na Chromium přes HTTPS nebo localhost.
- Nastavte rychlost, datové bity, paritu a stop bity, když je návod uvádí. Hodnoty, které v návodu nejsou, nevymýšlejte.
- Naskenujte známý čárový kód.
- Porovnejte bajty nebo dekódovaný text s tímto obsahem.
- Zkontrolujte rámec. Hledejte předponu a CR, LF nebo CRLF za daty, jen když právě to návod nastavil.
Když se port neotevře, protože je obsazený, zavřete druhý program, který ho drží. Když je text smetí, parametry linky se zařízením nesedí. Když se port vůbec neobjeví, čtečka může pořád být v režimu klávesnice, ovladač může chybět, nebo uživatel operačního systému nemusí smět otevírat sériová zařízení.
Časté potíže
Čtečka funguje v textovém editoru a ne v cílové aplikaci. Zařízení píše. Cíl nemá fokus, nebo obsluha keydown klávesy zahazuje. Začněte článkem Čtečka funguje v Notepad, ale ne v POS.
Čtečka nepíše do žádného textového pole. Může být v sériovém režimu, vypnutá, nebo symbol nečte. Čtečka v sériovém režimu psát nebude. Než budete ladit pole, podívejte se po portu COM. Článek Čtečka čárových kódů nefunguje odděluje nefunkční čtečku od špatného rozhraní.
Sériový port chybí. Režim klávesnice port COM nevytvoří. Chybějící ovladač, kabel jen na nabíjení nebo čtečka bez sériového režimu dají stejný příznak. Sledujte seznam zařízení systému, zatímco čtečku připojujete.
Sériový port je už obsazený. Číst ho může jen jeden proces. Zavřete terminál nebo druhou kopii aplikace a port otevřete znovu.
Nastavení komunikace jsou špatně. Neshoda rychlosti, parity nebo stop bitů vypadá jako náhodné znaky. Nastavte hodnoty z návodu k tomuto modelu a potom znovu naskenujte známý kód.
ENTER nebo TAB nikdy nepřijde. To je nastavení přípony klínu. Tester vstupu hlásí None. Viz Čtečce čárových kódů chybí ENTER a příručka o příponách výše. Sériová čtečka klávesu Enter neposílá. Může poslat bajty CR nebo LF.
Znaky na čtečce v režimu klínu jsou špatně. Rozložení klávesnice čtečky a rozložení operačního systému se mohou rozcházet. Sériové bajty toto rozložení nepřemapuje. Viz Špatné rozložení klávesnice u čtečky čárových kódů.
Prohlížeč se ke čtečce nedostane. Čtečka v režimu klínu se ve výzvě Web Serial neobjeví. Firefox a Safari nemají Web Serial API. Stránka, která není na HTTPS ani na localhost, ho použít nemůže. Uživatel může výzvu k portu také zavřít.
Aplikace čtečku po odpojení ztratí. Čtečka v režimu klínu se vrátí jako klávesnice a další sken pořád potřebuje fokus. Sériový port není, dokud aplikace neotevře nový port. Název se s předchozím nemusí shodovat.
Scénáře integrace
Webové aplikace
Klávesnicový klín sedí poli s fokusem a běžným událostem DOM. Sériový přístup uvnitř stránky znamená Web Serial v prohlížeči, který ho podporuje, zabezpečený kontext a port vybraný uživatelem. Stránka, která musí podporovat Firefox, Safari a kiosky bez obsluhy, se nemůže spoléhat jen na Web Serial. Místní pomocník může vlastnit port COM a předávat hotové čárové kódy na stránku. Tento pomocník je samostatný software. Test klínu ten program necvičí.
Systémy POS
POS, který dá fokus do pole položky a hodnotu potvrdí klávesou Enter, je integrace klínu. POS, který musí skenovat, zatímco je otevřený modální dialog, nebo který musí klávesnici ignorovat, je sériová integrace. Mísení dá skeny ve špatném poli nebo skeny, které nedorazí. Režim čtečky slaďte s obrazovkou, která je skutečně ve službě.
Desktopové aplikace
Desktopová aplikace může přijmout vstup klínu v prvku, který má fokus, nebo otevřít virtuální port COM a držet relaci po dobu života procesu. Vlastnictví portu, opětovné připojení a rámec jsou součástí této relace. Fokus k ní nepatří.
Automatizace QA
Barcode Scanner Emulator zapíše vámi zvolenou hodnotu do aplikace s fokusem a může poslat ENTER, TAB, nebo se obejít bez přípony. Tím pokryje regrese klávesnicového klínu: fokus, ověření a zpracování přípony. Nevytvoří virtuální port COM, nevyjmenuje zařízení USB a neobnoví rychlost ani rámec. Sériové testy pořád potřebují sériový port a čtecí program, nebo testovací dvojníka, který zapíše stejný bajtový rámec, jaký aplikace rozebírá.
Kiosek
Kiosek se vstupem klínu musí držet pole skenu ve fokusu přes dialogy, spořiče obrazovky a chybové zprávy. Jednou ztracený fokus a další sken trefí zkratku, nebo nic. Kiosek se sériovým režimem může port číst bez tohoto fokusu a musí držet oprávnění k zařízení a port znovu otevřít po výpadku napájení nebo vytržení kabelu.
Kam se hodí Barcode Scanner Emulator
Barcode Scanner Emulator je desktopová aplikace pro Windows, macOS a Linux. Obnovuje klávesnicovou cestu, kterou používá čtečka v režimu klínu. Zadáte text, zvolíte prodlevu psaní a zvolíte příponu: žádná, ENTER nebo TAB. Globální zkratka tento text zapíše do aplikace s fokusem.
Použijte ho k vývoji formulářů ve stylu HID a k chytání jejich regresí, když čtečka není na stole. Spojte ho s testerem vstupu čárového kódu, abyste viděli hodnotu, klávesy předpony a příponu, které prohlížeč dostal.
Neemuluje sériové zařízení USB, virtuální port COM, výčet USB ani optické dekódování. Toto chování pořád patří hardwaru, nebo sériovému testovacímu dvojníkovi, který ovládáte.