Barcode Scanner Emulator
Escàners de codis de barres USB HID i sèrie
Un escàner amb falca de teclat USB HID escriu el codi de barres descodificat a l'aplicació que té el focus. Un escàner sèrie USB exposa una interfície sèrie, sovint com un port COM virtual, i l'aplicació ha d'obrir aquest port i llegir els octets. USB és el cable i el bus. HID i sèrie són maneres diferents de presentar les dades.
Trieu la interfície que l'aplicació pot llegir de veritat. Un camp de caixa que ja accepta tecleig és un problema de falca de teclat. Un servei que ha de rebre lectures mentre cap camp de text no té el focus, o que ha de mantenir els octets de l'escàner separats del teclat, és un problema sèrie. Molts escàners només ofereixen un d'aquests modes. Alguns es poden commutar. El manual d'aquell model és la llista de modes que podeu provar.
La guia de la falca de teclat HID explica el camí de les pulsacions amb detall. Com funcionen els escàners de codis de barres? cobreix la captura i la descodificació. Aquesta pàgina compara les dues interfícies d'amfitrió i les proves que pertanyen a cadascuna.
Què és el mode de falca de teclat USB HID?
En mode de teclat USB HID l'escàner s'enumera com un teclat. El sistema operatiu carrega el controlador de teclat habitual. Després d'una descodificació, l'escàner envia els caràcters com a pulsacions al control que té el focus del teclat. Un formulari web, un camp d'article d'un POS o un quadre de text d'escriptori pot acceptar aquesta entrada sense codi específic de l'escàner.
El focus decideix la destinació. Si el camp previst no té el focus, els caràcters cauen en un altre control o es perden. L'escàner no fa clic i no mou el punter.
Un sufix configurat pot seguir la càrrega. Enter envia molts formularis d'un sol camp. Tab desplaça el focus al control següent. Cap de les dues tecles no està garantida. Les opcions de sufix es tracten als Sufixos ENTER i TAB.
Els esdeveniments de teclat ordinaris no inclouen el fabricant de l'escàner, el número de sèrie ni una marca que digui que les tecles venien d'un escàner. Els navegadors que implementen WebHID continuen refusant les interfícies de teclat, de manera que una pàgina no pot obrir el dispositiu de falca ni llegir informes HID en brut.
Què és el mode sèrie USB d'un escàner de codis de barres?
En mode sèrie USB l'escàner no escriu. Exposa una interfície sèrie per USB. El sistema operatiu sol presentar aquesta interfície com un port COM virtual: un nom COM a Windows, un dispositiu cu o tty a macOS, o un dispositiu ttyACM o ttyUSB a Linux. El nom l'assigna el controlador i pot canviar després de desconnectar l'escàner.
Un port COM virtual no és un port RS-232 físic. RS-232 és una interfície elèctrica, amb el seu connector i els seus nivells de tensió, que un ordinador llegeix a través d'un UART. El sèrie USB fa servir un cable USB. L'aplicació obre igualment un port sèrie i llegeix octets, però el senyal al fil és USB. Alguns productes són un escàner RS-232 real més un adaptador USB a sèrie. D'altres implementen USB CDC i no parlen mai RS-232. Tracteu el port que mostra el sistema operatiu com el punt d'integració i no suposeu que els detalls elèctrics coincideixen.
L'aplicació obre el port, llegeix el flux d'octets i decideix on comença i on acaba un missatge. Un marc habitual és el text del codi de barres seguit de CR (0x0D), LF (0x0A) o CR i després LF. Aquest emmarcament és un ajust del dispositiu, no una regla d'USB. També és possible un octet de prefix com STX. La guia de prefix i sufix separa aquests octets de la tecla Enter que envia un escàner de falca.
La velocitat en bauds, els bits de dades, la paritat i els bits de parada importen en un UART real i en molts adaptadors USB a sèrie. Una velocitat equivocada produeix brossa en lloc d'un error net. Alguns dispositius COM virtuals amb USB CDC ignoren la velocitat en bauds que demana l'amfitrió i tot i així lliuren octets. No hi ha un sol ajust que serveixi per a cada escàner sèrie virtual. Feu servir la velocitat i l'emmarcament del manual d'aquell model i confirmeu-los amb un codi de barres conegut.
El procés que manté el port obert rep les dades. El focus del teclat no tria la destinació. Un altre programa que ja té el port obert bloqueja una segona obertura. Desconnectar l'escàner elimina el port. Tornar-lo a connectar pot crear un nom nou, i l'aplicació ha d'obrir aquell port una altra vegada.
HID i sèrie
| Característica | Falca de teclat HID | USB sèrie |
|---|---|---|
| Lliurament de dades | Entrada a l'estil del teclat | Flux d'octets sèrie |
| Cal focus d'entrada | Sí. Les pulsacions segueixen el control amb focus | No. Els octets van al procés que ha obert el port |
| Integració al navegador | Entrada ordinària i esdeveniments de teclat | Web Serial on el navegador ho admet, o programari fora de la pàgina |
| Control de l'aplicació | Limitat al comportament del teclat, el focus i els sufixos | L'aplicació llegeix i emmarca el flux |
| Identificació del dispositiu | No disponible des d'esdeveniments de teclat ordinaris | El sistema operatiu pot mostrar un nom de port. La identitat estable continua depenent del controlador |
| Configuració | Ajustos de l'escàner, incloent-hi el sufix i la distribució del teclat | Ajustos de l'escàner més els ajustos del port de l'amfitrió que el dispositiu fa servir de veritat |
| Ús típic | Formularis i entrada d'articles al POS | Integracions dedicades que són propietàries del dispositiu |
Aquests són els casos habituals. Un model concret, un sistema operatiu i un controlador poden diferir. Un escàner Bluetooth en mode de teclat HID segueix la columna de la falca a la capa d'aplicació. Bluetooth SPP segueix la columna sèrie.
Com funcionen els escàners HID a les aplicacions web
Una lectura de falca actualitza l'element amb focus. Els caràcters imprimibles disparen keydown i després input. Enter i Tab disparen keydown i no insereixen un caràcter en una entrada de text normal. event.key és "Enter" o "Tab" per a aquestes tecles, i una cadena d'un caràcter per a un caràcter imprimible. event.code anomena la tecla física i pot quedar igual quan una distribució de teclat que no coincideix canvia event.key.
L'escolta de sota confirma el camp només quan arriba Enter. Un escàner sense sufix Enter deixa el text al camp.
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 = ''
})
Doneu focus a #barcode abans de la lectura. preventDefault() impedeix que un formulari pare s'enviï una segona vegada. Si l'escàner envia Tab en lloc d'això, llegiu el valor en aquell keydown i deixeu que el navegador mogui el focus. Si no n'envia cap, envieu el camp des d'un botó o des d'una altra acció explícita. Una pausa en el tecleig és només una pista del final de la lectura.
Res en aquests esdeveniments no identifica el dispositiu USB. Una persona, una macro o l'emulador poden produir la mateixa seqüència. La validació pertany a la càrrega. El flux de treball del navegador, incloent-hi Tab i l'entrada buida, és a Com provar escàners de codis de barres en aplicacions web.
Com funcionen els escàners sèrie a les aplicacions
Una integració sèrie obre un port, llegeix octets, els parteix en missatges i gestiona que el port desaparegui. A l'escriptori, això és l'API sèrie del sistema operatiu o una biblioteca del fabricant. En un navegador, l'única opció integrada és la Web Serial API, i només als navegadors que la implementen.
Web Serial està disponible als navegadors basats en Chromium. Firefox i Safari no el proporcionen. La pàgina ha de ser un context segur, és a dir HTTPS o localhost. requestPort() s'ha d'executar des d'un gest de l'usuari, i l'usuari ha de triar el port a la pregunta del navegador. Un escàner de falca de teclat no apareix en aquesta llista, perquè no és un dispositiu sèrie. Web Serial tampoc no pot veure un port sèrie que el sistema operatiu no hagi exposat.
La velocitat en bauds de l'exemple és un punt de partida que substituïu pel valor del manual. El bucle tracta CR o LF com el final d'un missatge i consumeix un parell CRLF com un sol terminador. Si el vostre escàner fa servir un marc diferent, aquesta partició és incorrecta fins i tot amb el port obert.
<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>
El bucle de lectura corre fins que el flux s'acaba o la lectura falla. Desconnectar l'escàner sol rebutjar la lectura. releaseLock() i close() s'executen a finally. Els ports aprovats abans per a aquest origen es poden llistar amb navigator.serial.getPorts() sense tornar a mostrar la pregunta. La primera aprovació continua exigint l'usuari.
Una aplicació d'escriptori segueix la mateixa idea amb l'API sèrie de la plataforma: obrir, llegir, emmarcar i tornar a obrir quan el dispositiu torna. Aquesta pàgina no inventa ordres del fabricant. Si l'escàner espera un protocol propietari, aquest protocol és a la documentació del fabricant.
Què és millor: HID o sèrie?
Cap mode no és millor per a cada producte. Feu servir el mode que l'escàner ofereix de veritat i el mode que l'aplicació pot llegir.
Trieu HID quan
- L'aplicació ja accepta entrada de teclat en un camp amb focus.
- Voleu que un formulari o una pantalla de POS funcioni sense codi de dispositiu.
- El flux de treball pot garantir el focus abans de cada lectura.
- Enter o Tab coincideix amb la manera com aquell formulari confirma o avança.
Penseu en sèrie quan
- Les lectures han d'arribar mentre el focus és en un diàleg, en un botó o enlloc.
- Els octets de l'escàner s'han de mantenir separats del tecleig.
- L'aplicació pot obrir un port, emmarcar missatges i recuperar-se quan es desconnecta el dispositiu.
- L'amfitrió pot concedir permís a aquell port i cap altre procés no el necessita alhora.
Un escàner que només s'enumera com a teclat no es pot passar a sèrie amb programari a l'amfitrió. Confirmeu els modes al manual abans de dissenyar la integració.
Canvi entre HID i sèrie
Alguns escàners canvien de mode quan llegiu un codi de barres de configuració del manual d'aquell fabricant, o quan escriviu un perfil amb la utilitat del fabricant. D'altres estan construïts com una sola interfície i no tenen res per commutar.
No hi ha un codi de barres de configuració que canviï cada marca. Una seqüència impresa per a un altre model pot no fer res, o pot deixar l'escàner en un mode inesperat. Després de qualsevol canvi, mireu què mostra el sistema operatiu: un teclat, un port COM o tots dos. Després proveu el camí que fa servir la vostra aplicació. La guia de configuració descriu els grups d'ajust habituals. No substitueix el manual.
Prova d'un escàner HID
- Connecteu l'escàner i confirmeu que és en mode de falca de teclat. Un editor de text ha de rebre caràcters quan un camp d'aquell editor té el focus.
- Obriu el Provador d'entrada de codis de barres.
- Feu clic a Inicieu la prova o feu clic a la zona de lectura. Es torna blava quan està a punt. La pàgina no agafa el focus per si sola.
- Llegiu un codi de barres la càrrega del qual ja coneixeu.
- Compareu el valor capturat i el nombre de caràcters amb aquella càrrega.
- Llegiu el sufix: ENTER, TAB o Cap. Enter i Tab no formen part de la cadena del codi de barres.
El provador registra els esdeveniments de teclat que el navegador pot veure. No pot llegir un port sèrie i no pot identificar el dispositiu USB. Quan la separació mitjana entre caràcters és inferior a 100 ms, informa d'aquest temps. El temps no és una identificació del maquinari. Per a cada keydown, incloent-hi key i code, feu servir el Provador d'esdeveniments de teclat. Una passada de QA més àmplia és a Com provar l'entrada d'un escàner de codis de barres.
Prova d'un escàner sèrie
El Provador d'entrada de codis de barres no obre un port COM. Una prova sèrie necessita un programa que pugui obrir el port que exposa l'escàner.
- Confirmeu que l'escàner és en un mode sèrie i que el sistema operatiu llista un port quan està connectat. Desconnecteu-lo i comproveu que el port desapareix.
- Anoteu el nom del port. És específic del sistema operatiu i pot canviar a la connexió següent.
- Obriu el port des d'una aplicació compatible: un terminal sèrie, la vostra aplicació d'escriptori o l'exemple de Web Serial de dalt en un navegador Chromium amb HTTPS o localhost.
- Establiu la velocitat en bauds, els bits de dades, la paritat i els bits de parada quan el manual els especifica. Ometeu els valors inventats.
- Llegiu un codi de barres conegut.
- Compareu els octets o el text descodificat amb aquella càrrega.
- Comproveu l'emmarcament. Busqueu un prefix, i CR, LF o CRLF després de les dades, només si això és el que va configurar el manual.
Si l'obertura del port falla perquè està ocupat, tanqueu l'altre programa que el reté. Si el text és brossa, els ajustos de línia no coincideixen amb el dispositiu. Si el port no apareix mai, l'escàner pot continuar en mode de teclat, el controlador pot faltar, o l'usuari del sistema operatiu pot no tenir permís per obrir dispositius sèrie.
Problemes habituals
L'escàner funciona en un editor de text i no a l'aplicació de destinació. El dispositiu escriu. La destinació no té el focus, o un escoltador keydown descarta les tecles. Comenceu per L'escàner funciona al Notepad però no al POS.
L'escàner no escriu en cap camp de text. Pot ser en mode sèrie, apagat, o no llegeix el símbol. Un escàner en mode sèrie no escriurà. Busqueu un port COM abans de depurar el camp. L'escàner de codis de barres no funciona separa un escàner mort de la interfície equivocada.
Falta el port sèrie. El mode de teclat no crea un port COM. Un controlador absent, un cable només de càrrega o un escàner sense mode sèrie produeixen el mateix símptoma. Mireu la llista de dispositius del sistema operatiu mentre connecteu l'escàner.
El port sèrie ja està en ús. Només un procés el pot llegir. Tanqueu el terminal o l'altra còpia de l'aplicació i torneu-lo a obrir.
Els ajustos de comunicació són incorrectes. Una velocitat en bauds, una paritat o uns bits de parada que no coincideixen semblen caràcters a l'atzar. Poseu els valors del manual d'aquell model i llegiu de nou un codi conegut.
ENTER o TAB no arriben mai. Això és un ajust de sufix de la falca. El provador d'entrada informa Cap. Vegeu A l'escàner de codis de barres li falta ENTER i la guia de sufix enllaçada més amunt. Un escàner sèrie no envia la tecla Enter. Pot enviar octets CR o LF en lloc d'això.
Els caràcters són incorrectes en un escàner de falca. La distribució de teclat de l'escàner i la del sistema operatiu poden no coincidir. Els octets sèrie no es reassignen amb aquella distribució. Vegeu Distribució de teclat incorrecta a l'escàner de codis de barres.
El navegador no pot accedir a l'escàner. Un escàner de falca no apareixerà a la pregunta de Web Serial. Firefox i Safari no tenen Web Serial API. Una pàgina que no és HTTPS ni localhost no el pot fer servir. L'usuari també pot descartar la pregunta del port.
L'aplicació perd l'escàner després de desconnectar-lo. Un escàner de falca torna com un teclat, i la lectura següent continua exigint focus. Un port sèrie ha desaparegut fins que l'aplicació obre el port nou. El nom pot no coincidir amb l'anterior.
Escenaris d'integració
Aplicacions web
La falca de teclat encaixa en una entrada amb focus i en esdeveniments DOM ordinaris. L'accés sèrie dins de la pàgina vol dir Web Serial en un navegador compatible, un context segur i un port triat per l'usuari. Una pàgina que ha de donar suport a Firefox, Safari i quioscos sense vigilància no pot dependre només de Web Serial. Un auxiliar local pot ser propietari del port COM i reenviar codis de barres complets a la pàgina. Aquest auxiliar és programari separat. La pàgina no ha d'esperar que una prova de falca l'exerciti.
Sistemes POS
Un POS que posa el focus al camp d'article i confirma amb Enter és una integració de falca. Un POS que ha de llegir mentre un modal és obert, o que ha d'ignorar el teclat, és una integració sèrie. Barrejar-los produeix lectures al camp equivocat o lectures que no arriben mai. Feu coincidir el mode de l'escàner amb la pantalla que és realment de servei.
Aplicacions d'escriptori
Una aplicació d'escriptori pot acceptar entrada de falca al control que té el focus, o obrir el port COM virtual i mantenir una sessió durant la vida del procés. La propietat del port, la reconnexió i l'emmarcament formen part d'aquesta sessió. El focus no.
Automatització de QA
El Barcode Scanner Emulator escriu un valor que trieu a l'aplicació amb focus i pot enviar ENTER, TAB o cap sufix. Això cobreix les regressions de la falca de teclat: focus, validació i tractament del sufix. No crea un port COM virtual, no enumera dispositius USB i no reprodueix la velocitat en bauds ni l'emmarcament. Les proves sèrie encara necessiten un port sèrie i un lector, o un doble de prova que escrigui el mateix emmarcament d'octets que analitza la vostra aplicació.
Aplicacions de quiosc
Un quiosc que fa servir entrada de falca ha de mantenir el camp de lectura amb focus a través de diàlegs, estalvis de pantalla i missatges d'error. Un focus perdut i la lectura següent encerta una drecera o res. Un quiosc que fa servir sèrie pot llegir el port sense aquell focus, i ha de conservar el permís del dispositiu i tornar a obrir el port després d'una pèrdua d'alimentació o d'una estirada de cable.
On encaixa el Barcode Scanner Emulator
El Barcode Scanner Emulator és una aplicació d'escriptori per a Windows, macOS i Linux. Reprodueix el camí de teclat que fa servir un escàner de falca. Introduïu el text, trieu un retard de tecleig i trieu un sufix de cap, ENTER o TAB. Una drecera global escriu aquest text a l'aplicació amb focus.
Feu-lo servir per desenvolupar i regressar formularis d'estil HID quan l'escàner no és a la taula. Aparelleu-lo amb el Provador d'entrada de codis de barres per veure el valor, les tecles de prefix i el sufix que ha rebut el navegador.
No emula un dispositiu sèrie USB, un port COM virtual, una enumeració USB ni una descodificació òptica. Aquests comportaments continuen pertanyent al maquinari, o a un doble de prova sèrie que controleu.