Barcode Scanner Emulator
USB HID over for serielle stregkodescannere
En scanner med USB HID-tastaturkile skriver den afkodede stregkode i det program, der har fokus. En USB-seriel scanner stiller en seriel grænseflade til rådighed, ofte som en virtuel COM-port, og programmet skal åbne den port og læse bytene. USB er kablet og bussen. HID og seriel er to forskellige måder at vise data på.
Tag den grænseflade, programmet reelt kan læse. Et kassefelt, der allerede tager imod indtastning, er et tastaturkile-problem. En tjeneste, der skal modtage scanninger, mens intet tekstfelt har fokus, eller som skal holde scannerens byte adskilt fra tastaturet, er et serielt problem. Mange scannere tilbyder kun den ene tilstand. Nogle kan skiftes. Manualen til netop den model er listen over tilstande, du kan afprøve.
Guiden om HID-tastaturkile gennemgår tastevejen i detaljer. Hvordan virker stregkodescannere dækker optagelse og afkodning. Denne side stiller de to værtsgrænseflader op mod hinanden og de prøver, der hører til hver af dem.
Hvad er USB HID-tastaturkile?
I USB HID-tastaturtilstand melder scanneren sig som et tastatur. Operativsystemet indlæser sin almindelige tastaturdriver. Efter en afkodning sender scanneren tegnene som tastetryk til den kontrol, der har tastaturfokus. En webformular, et varefelt i et POS eller en tekstboks på skrivebordet kan tage imod det input uden scanner-specifik kode.
Fokus bestemmer, hvor tegnene havner. Hvis det tiltænkte felt ikke har fokus, lander tegnene i en anden kontrol, eller de går tabt. Scanneren klikker ikke, og den flytter ikke markøren.
Et konfigureret suffiks kan følge efter nyttelasten. Enter sender mange formularer med ét felt. Tab flytter fokus til næste kontrol. Ingen af tasterne er garanteret. Suffiksvalgene er beskrevet i ENTER- og TAB-suffikser.
Almindelige tastaturhændelser indeholder ikke scannerens producent, serienummer eller et flag, der siger, at tasterne kom fra en scanner. Browsere, der implementerer WebHID, afviser stadig tastaturgrænseflader, så en side kan ikke åbne kile-enheden og læse rå HID-rapporter.
Hvad er USB-seriel tilstand for en stregkodescanner?
I USB-seriel tilstand taster scanneren ikke. Den stiller en seriel grænseflade til rådighed over USB. Operativsystemet viser som regel den grænseflade som en virtuel COM-port: et COM-navn i Windows, en cu- eller tty-enhed i macOS eller en ttyACM- eller ttyUSB-enhed i Linux. Navnet tildeles af driveren og kan skifte, efter at scanneren er trukket ud.
En virtuel COM-port er ikke en fysisk RS-232-port. RS-232 er en elektrisk grænseflade med sit eget stik og sine egne spændingsniveauer, som en computer læser gennem en UART. USB-seriel bruger et USB-kabel. Programmet åbner stadig en seriel port og læser byte, men signaleringen på ledningen er USB. Nogle produkter er en rigtig RS-232-scanner plus en USB-til-seriel-adapter. Andre implementerer USB CDC og taler slet ikke RS-232. Brug den port, operativsystemet viser, som integrationspunktet, og gå ikke ud fra, at de elektriske detaljer stemmer overens.
Programmet åbner porten, læser bytestrømmen og afgør, hvor en meddelelse begynder og slutter. En udbredt ramme er stregkodeteksten efterfulgt af CR (0x0D), LF (0x0A) eller CR og derefter LF. Den indramning er en enhedsindstilling, ikke en regel i USB. En præfiksbyte som STX er også mulig. Guiden om præfiks og suffiks adskiller de byte fra Enter-tasten, som en kile-scanner sender.
Baudrate, databits, paritet og stopbits betyder noget på en rigtig UART og på mange USB-til-seriel-adaptere. En forkert rate giver vrøvl i stedet for en tydelig fejl. Nogle virtuelle COM-enheder med USB CDC ignorerer den baudrate, værten beder om, og leverer alligevel byte. Der findes ikke én indstilling, der passer til enhver virtuel seriel scanner. Brug raten og indramningen fra modellens manual, og bekræft dem bagefter med en kendt stregkode.
Den proces, der holder porten åben, modtager data. Tastaturfokus vælger ikke modtageren. Et andet program, der allerede har porten åben, spærrer for et andet åbningsforsøg. Når scanneren trækkes ud, forsvinder porten. Når den sættes i igen, kan der opstå et nyt navn, og programmet skal åbne den port på ny.
HID over for seriel
| Egenskab | HID-tastaturkile | USB-seriel |
|---|---|---|
| Datalevering | Input i tastaturstil | Seriel bytestrøm |
| Kræver inputfokus | Ja. Tastetrykkene følger den fokuserede kontrol | Nej. Bytene går til den proces, der åbnede porten |
| Integration i browseren | Almindeligt input og tastaturhændelser | Web Serial, hvor browseren understøtter det, eller software uden for siden |
| Programmets kontrol | Begrænset til tastaturadfærd, fokus og suffikser | Programmet læser og indrammer strømmen |
| Identifikation af enheden | Ikke tilgængelig fra almindelige tastaturhændelser | Operativsystemet kan vise et portnavn. Stabil identitet afhænger stadig af driveren |
| Konfiguration | Scannerindstillinger, herunder suffiks og tastaturlayout | Scannerindstillinger plus de værtsportindstillinger, enheden faktisk bruger |
| Typisk brug | Formularer og vareindtastning i POS | Dedikerede integrationer, der ejer enheden |
Det er de sædvanlige tilfælde. En bestemt model, et operativsystem og en driver kan afvige. En Bluetooth-scanner i HID-tastaturtilstand følger kile-kolonnen i applikationslaget. Bluetooth SPP følger den serielle kolonne.
Sådan virker HID-scannere i webapplikationer
En kile-scanning opdaterer elementet med fokus. Tegn, der kan udskrives, udløser keydown og derefter input. Enter og Tab udløser keydown og indsætter ikke et tegn i et almindeligt tekstfelt. event.key er "Enter" eller "Tab" for de taster og en streng på ét tegn for et tegn, der kan udskrives. event.code navngiver den fysiske tast og kan blive stående, når et forkert tastaturlayout ændrer event.key.
Lytteren nedenfor bekræfter feltet kun, når Enter ankommer. En scanner uden Enter-suffiks lader teksten blive i feltet.
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 = ''
})
Giv #barcode fokus, før der scannes. preventDefault() hindrer en overordnet formular i at blive sendt en gang til. Hvis scanneren sender Tab i stedet, så læs værdien i den keydown, og lad browseren flytte fokus. Hvis den ikke sender nogen af dem, så send feltet fra en knap eller en anden udtrykkelig handling. En pause i indtastningen er kun et gæt på, at scanningen er slut.
Intet i de hændelser identificerer USB-enheden. En person, en makro eller emulatoren kan frembringe den samme rækkefølge. Valideringen hører til på nyttelasten. Browserforløbet, inklusive Tab og tomt input, står i Sådan tester du stregkodescannere i webapplikationer.
Sådan virker serielle scannere i programmer
En seriel integration åbner en port, læser byte, deler dem op i meddelelser og håndterer, at porten forsvinder. På skrivebordet er det operativsystemets serielle API eller et bibliotek fra leverandøren. I en browser er den eneste indbyggede mulighed Web Serial API, og kun i browsere, der implementerer den.
Web Serial findes i Chromium-baserede browsere. Firefox og Safari stiller det ikke til rådighed. Siden skal være en sikker kontekst, altså HTTPS eller localhost. requestPort() skal køres fra en brugergestus, og brugeren skal vælge porten i browserens prompt. En tastaturkile-scanner optræder ikke på den liste, fordi den ikke er en seriel enhed. Web Serial kan heller ikke se en seriel port, som operativsystemet ikke har eksponeret.
Baudraten i eksemplet er et udgangspunkt, som du udskifter med værdien fra manualen. Løkken behandler CR eller LF som slutningen på en meddelelse og forbruger et CRLF-par som én afslutter. Hvis din scanner bruger en anden ramme, er denne opdeling forkert, også når porten er åben.
<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>
Læseløkken kører, indtil strømmen slutter, eller læsningen fejler. Når scanneren trækkes ud, afvises læsningen typisk. releaseLock() og close() kører i finally. Porte, der allerede er godkendt for denne oprindelse, kan vises med navigator.serial.getPorts() uden at prompten kommer frem igen. Den første godkendelse kræver stadig brugeren.
Et skrivebordsprogram følger den samme idé med platformens serielle API: åbn, læs, indram, og åbn igen, når enheden vender tilbage. Denne side finder ikke på leverandørkommandoer. Hvis scanneren forventer en proprietær protokol, står protokollen i producentens dokumentation.
Hvilken er bedst: HID eller seriel?
Ingen tilstand er bedst for ethvert produkt. Brug den tilstand, scanneren faktisk tilbyder, og den tilstand, programmet kan læse.
Vælg HID når
- Programmet allerede tager imod tastaturinput i et felt med fokus.
- Du vil have en formular eller en POS-skærm til at virke uden enhedskode.
- Arbejdsgangen kan sikre fokus før hver scanning.
- Enter eller Tab passer til den måde, formularen bekræfter eller går videre på.
Overvej seriel når
- Scanninger skal ankomme, mens fokus ligger i en dialog, på en knap eller ingen steder.
- Scannerens byte skal holdes adskilt fra indtastning.
- Programmet kan åbne en port, indramme meddelelser og komme sig, når enheden trækkes ud.
- Værten kan give tilladelse til den port, og ingen anden proces har brug for den på samme tid.
En scanner, der kun melder sig som tastatur, kan ikke skiftes til seriel i software på værten. Bekræft tilstandene i manualen, før du tegner integrationen.
Skift mellem HID og seriel
Nogle scannere skifter tilstand, når du scanner en konfigurationsstregkode fra den producents manual, eller når du skriver en profil med leverandørens værktøj. Andre er bygget som én grænseflade og har intet at skifte.
Der findes ingen konfigurationsstregkode, der ændrer ethvert mærke. En sekvens, der er trykt til en anden model, kan gøre ingenting, eller den kan efterlade scanneren i en uventet tilstand. Efter enhver ændring skal du se, hvad operativsystemet viser: et tastatur, en COM-port eller begge dele. Test derefter den vej, dit program bruger. Konfigurationsvejledningen beskriver de sædvanlige indstillingsgrupper. Den erstatter ikke manualen.
Test af en HID-scanner
- Tilslut scanneren, og bekræft, at den er i tastaturkile-tilstand. Et tekstprogram skal modtage tegn, når et felt i det program har fokus.
- Åbn Stregkodeinput-testeren.
- Klik på Start test, eller klik i scanningsområdet. Det bliver blåt, når det er klar. Siden tager ikke selv fokus.
- Scan en stregkode, hvis nyttelast du allerede kender.
- Sammenlign den registrerede værdi og antallet af tegn med den nyttelast.
- Læs suffikset: ENTER, TAB eller Ingen. Enter og Tab indgår ikke i stregkodestrengen.
Testeren registrerer de tastaturhændelser, browseren kan se. Den kan ikke læse en seriel port, og den kan ikke identificere USB-enheden. Når det gennemsnitlige mellemrum mellem tegn er under 100 ms, rapporterer den den tidsmåling. Tidsmålingen er ikke en identifikation af hardwaren. For hvert keydown, inklusive key og code, så brug Tastaturhændelsestesteren. En bredere QA-gennemgang står i Sådan tester du input fra en stregkodescanner.
Test af en seriel scanner
Stregkodeinput-testeren åbner ikke en COM-port. En seriel test kræver et program, der kan åbne den port, scanneren stiller til rådighed.
- Bekræft, at scanneren er i en seriel tilstand, og at operativsystemet viser en port, når den er tilsluttet. Træk den ud, og kontrollér, at porten forsvinder.
- Notér portnavnet. Det er specifikt for operativsystemet og kan ændre sig ved næste tilslutning.
- Åbn porten fra et kompatibelt program: en seriel terminal, dit skrivebordsprogram eller Web Serial-eksemplet ovenfor i en Chromium-browser på HTTPS eller localhost.
- Indstil baudrate, databits, paritet og stopbits, når manualen angiver dem. Spring opfundne værdier over.
- Scan en kendt stregkode.
- Sammenlign bytene eller den afkodede tekst med den nyttelast.
- Kontrollér indramningen. Se efter et præfiks og efter CR, LF eller CRLF efter data, kun hvis det er det, manualen har konfigureret.
Hvis porten ikke kan åbnes, fordi den er optaget, så luk det andet program, der holder den. Hvis teksten er vrøvl, passer linjeindstillingerne ikke til enheden. Hvis porten aldrig dukker op, kan scanneren stadig være i tastaturtilstand, driveren kan mangle, eller OS-brugeren har måske ikke lov til at åbne serielle enheder.
Almindelige problemer
Scanneren virker i et tekstprogram, men ikke i målprogrammet. Enheden taster. Målet har ikke fokus, eller en keydown-lytter kasserer tasterne. Begynd med Scanneren virker i Notepad men ikke i POS.
Scanneren taster ikke i noget tekstfelt. Den kan være i seriel tilstand, slukket eller ude af stand til at læse symbolet. En scanner i seriel tilstand taster ikke. Se efter en COM-port, før du fejlsøger feltet. Stregkodescanneren virker ikke skiller en død scanner fra den forkerte grænseflade.
Den serielle port mangler. Tastaturtilstand opretter ingen COM-port. En manglende driver, et kabel der kun lader, eller en scanner uden seriel tilstand giver det samme symptom. Hold øje med enhedslisten i operativsystemet, mens du sætter scanneren i.
Den serielle port er allerede i brug. Kun én proces kan læse den. Luk terminalen eller den anden kopi af programmet, og åbn den derefter igen.
Kommunikationsindstillingerne er forkerte. Baud, paritet eller stopbits, der ikke stemmer, ligner tilfældige tegn. Sæt værdierne fra manualen til den model, og scan derefter en kendt kode igen.
ENTER eller TAB ankommer aldrig. Det er en suffiksindstilling for kilen. Inputtesteren rapporterer Ingen. Se Stregkodescanneren mangler ENTER og suffiksguiden, der er linket ovenfor. En seriel scanner sender ikke Enter-tasten. Den kan sende CR- eller LF-byte i stedet.
Tegnene er forkerte på en kile-scanner. Scannerens tastaturlayout og operativsystemets layout kan være uenige. Serielle byte bliver ikke ommappet af det layout. Se Forkert tastaturlayout på stregkodescanneren.
Browseren kan ikke få adgang til scanneren. En kile-scanner vises ikke i prompten fra Web Serial. Firefox og Safari har intet Web Serial API. En side, der ikke er HTTPS eller localhost, kan ikke bruge det. Brugeren kan også afvise portprompten.
Programmet mister scanneren, efter at den er trukket ud. En kile-scanner vender tilbage som et tastatur, og den næste scanning kræver stadig fokus. En seriel port er væk, indtil programmet åbner den nye port. Navnet behøver ikke at matche det forrige.
Scenarier for integration
Webapplikationer
Tastaturkile passer til et fokuseret felt og almindelige DOM-hændelser. Seriel adgang inde på siden betyder Web Serial i en browser, der understøtter det, en sikker kontekst og en port, brugeren har valgt. En side, der skal understøtte Firefox, Safari og ubemandede kiosker, kan ikke stole på Web Serial alene. En lokal hjælper kan eje COM-porten og videresende færdige stregkoder til siden. Den hjælper er separat software. Siden skal stadig ikke forvente, at en kile-test øver den.
POS-systemer
Et POS, der lægger fokus i varefeltet og bekræfter på Enter, er en kile-integration. Et POS, der skal scanne, mens en modal er åben, eller som skal ignorere tastaturet, er en seriel integration. At blande dem giver scanninger i det forkerte felt eller scanninger, der aldrig ankommer. Lad scannerens tilstand passe til den skærm, der faktisk er i brug.
Skrivebordsprogrammer
Et skrivebordsprogram kan tage imod kile-input i den kontrol, der har fokus, eller åbne den virtuelle COM-port og holde en session i processens levetid. Ejerskab af porten, genforbindelse og indramning hører til den session. Fokus gør det ikke.
Automatisering af QA
Barcode Scanner Emulator skriver en værdi, du vælger, ind i programmet med fokus og kan sende ENTER, TAB eller intet suffiks. Det dækker regressioner for tastaturkile: fokus, validering og suffikshåndtering. Den opretter ikke en virtuel COM-port, opregner ikke USB-enheder og genskaber ikke baud og indramning. Serielle tests har stadig brug for en seriel port og en læser, eller en testdoublet, der skriver den samme byteindramning, som dit program fortolker.
Kioskprogrammer
En kiosk, der bruger kile-input, skal holde scanningsfeltet i fokus på tværs af dialoger, pauseskærme og fejlmeddelelser. Ét tabt fokus, og den næste scanning rammer en genvej eller ingenting. En kiosk, der bruger seriel, kan læse porten uden det fokus, og den skal beholde tilladelse til enheden og åbne porten igen efter strømsvigt eller et trukket kabel.
Hvor Barcode Scanner Emulator hører til
Barcode Scanner Emulator er et skrivebordsprogram til Windows, macOS og Linux. Det genskaber den tastaturvej, en kile-scanner bruger. Du indtaster teksten, vælger en tasteforsinkelse og vælger et suffiks, der er intet, ENTER eller TAB. En global genvej skriver den tekst ind i programmet med fokus.
Brug det til at udvikle og regressere formularer i HID-stil, når scanneren ikke står på bordet. Par det med stregkodeinput-testeren for at se værdien, præfikstegnene og suffikset, som browseren modtog.
Det emulerer ikke en USB-seriel enhed, en virtuel COM-port, USB-opregning eller en optisk afkodning. De adfærd hører stadig til hardwaren eller til en seriel testdoublet, du styrer.