Barcode Scanner Emulator
Escáneres de códigos de barras USB HID y serial
Un escáner en emulación de teclado USB HID teclea el código de barras decodificado en la app que tiene el foco. Un escáner serial USB expone una interfaz serial, a menudo como un puerto COM virtual, y la app tiene que abrir ese puerto y leer los bytes. USB es el cable y el bus. HID y serial son maneras distintas de presentar los datos.
Elige la interfaz que la app sí pueda leer. Un campo de caja que ya acepta lo que se teclea es un problema de emulación de teclado. Un servicio que tiene que recibir escaneos cuando ningún campo de texto está enfocado, o que tiene que mantener los bytes del escáner aparte del teclado, es un problema serial. Muchos escáneres solo ofrecen uno de esos modos. Algunos pueden cambiar. El manual de ese modelo es la lista de modos que puedes probar.
La guía Emulación de teclado HID explica a detalle la ruta de los teclazos. ¿Cómo funcionan los escáneres de códigos de barras? cubre la captura y la decodificación. Esta página compara las dos interfaces de host y las pruebas que le tocan a cada una.
¿Qué es el modo de emulación de teclado USB HID?
En modo de teclado USB HID el escáner se enumera como un teclado. El sistema operativo carga el driver de teclado que ya trae. Después de decodificar, el escáner manda los caracteres como teclazos al control que tiene el foco del teclado. Un formulario web, un campo de artículo del POS o un cuadro de texto de escritorio pueden aceptar esa entrada sin código propio del escáner.
El foco decide el destino. Si el campo previsto no está enfocado, los caracteres caen en otro control o se pierden. El escáner no hace clic y no mueve el puntero.
Un sufijo configurado puede ir después de la carga. Enter envía muchos formularios de un solo campo. Tab mueve el foco al control siguiente. Ninguna de las dos teclas está garantizada. Las opciones de sufijo están en Sufijos ENTER y TAB en los escáneres de códigos de barras.
Los eventos de teclado comunes no traen el fabricante del escáner, el número de serie ni una marca de que las teclas salieron de un escáner. Los navegadores que implementan WebHID igual rechazan las interfaces de teclado, así que una página no puede abrir el equipo en emulación ni leer reportes HID en crudo.
¿Qué es el modo serial USB de un escáner de códigos de barras?
En modo serial USB el escáner no teclea. Expone una interfaz serial por USB. El sistema operativo suele presentar esa interfaz como un puerto COM virtual: un nombre COM en Windows, un dispositivo cu o tty en macOS, o un dispositivo ttyACM o ttyUSB en Linux. El nombre lo asigna el driver y puede cambiar cuando se desconecta el escáner.
Un puerto COM virtual no es un puerto RS-232 físico. RS-232 es una interfaz eléctrica, con su propio conector y sus niveles de voltaje, que una computadora lee por una UART. El serial USB usa un cable USB. La app igual abre un puerto serial y lee bytes, pero la señal en el cable es USB. Algunos productos son un escáner RS-232 de verdad más un adaptador de USB a serial. Otros implementan USB CDC y nunca hablan RS-232. Toma el puerto que te muestra el sistema operativo como el punto de integración y no des por sentado que los detalles eléctricos coinciden.
La app abre el puerto, lee el flujo de bytes y decide dónde empieza y dónde termina un mensaje. Un marco común es el texto del código de barras seguido de CR (0x0D), LF (0x0A), o CR y luego LF. Ese encuadre es un ajuste del equipo, no una regla de USB. También puede haber un byte de prefijo como STX. La guía Prefijo y sufijo del escáner de códigos de barras: guía completa separa esos bytes de la tecla Enter que manda un escáner en emulación.
La tasa de baudios, los bits de datos, la paridad y los bits de paro importan en una UART real y en muchos adaptadores de USB a serial. Una tasa incorrecta produce basura en lugar de un error claro. Algunos dispositivos COM virtuales USB CDC ignoran la tasa de baudios que pide el host y de todos modos entregan los bytes. No existe un ajuste único que le sirva a cada escáner serial virtual. Usa la tasa y el encuadre del manual de ese modelo y confírmalos con un código de barras conocido.
El proceso que tiene el puerto abierto recibe los datos. El foco del teclado no elige el destino. Otro programa que ya tenga el puerto abierto va a bloquear una segunda apertura. Desconectar el escáner quita el puerto. Volver a conectarlo puede crear un nombre nuevo, y la app tiene que abrir ese puerto otra vez.
HID y serial
| Característica | Emulación de teclado HID | Serial USB |
|---|---|---|
| Entrega de datos | Entrada al estilo de un teclado | Flujo de bytes serial |
| Se necesita foco de entrada | Sí. Los teclazos siguen al control enfocado | No. Los bytes van al proceso que abrió el puerto |
| Integración en el navegador | Entrada común y eventos de teclado | Web Serial donde el navegador lo soporta, o software fuera de la página |
| Control de la app | Limitado al comportamiento del teclado, al foco y a los sufijos | La app lee el flujo y lo encuadra |
| Identificación del equipo | No está en los eventos de teclado comunes | El sistema operativo puede mostrar un nombre de puerto. Una identidad estable sigue dependiendo del driver |
| Configuración | Ajustes del escáner, incluido el sufijo y el diseño de teclado | Ajustes del escáner más los ajustes de puerto del host que el equipo usa de verdad |
| Uso típico | Formularios y captura de artículos en un POS | Integraciones dedicadas que son dueñas del equipo |
Estos son los casos de siempre. Un modelo, un sistema operativo y un driver concretos pueden variar. Un escáner Bluetooth en modo de teclado HID sigue la columna de la emulación en la capa de la app. Bluetooth SPP sigue la columna serial.
Cómo funcionan los escáneres HID en las aplicaciones web
Un escaneo en emulación actualiza el elemento enfocado. Los caracteres imprimibles disparan keydown y después input. Enter y Tab disparan keydown y no insertan un carácter en un campo de texto normal. event.key es "Enter" o "Tab" para esas teclas, y una cadena de un carácter para un carácter imprimible. event.code nombra la tecla física y puede quedarse igual cuando un desajuste del diseño de teclado cambia event.key.
El oyente de abajo confirma el campo solo cuando llega Enter. Un escáner sin sufijo Enter deja el texto en el campo.
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 = ''
})
Enfoca #barcode antes del escaneo. preventDefault() evita que un formulario padre se envíe una segunda vez. Si el escáner manda Tab en su lugar, lee el valor en ese keydown y deja que el navegador mueva el foco. Si no manda ninguno de los dos, envía el campo desde un botón u otra acción explícita. Una pausa al teclear es solo una heurística del final de un escaneo.
Nada en esos eventos identifica el dispositivo USB. Una persona, una macro o el emulador pueden producir la misma secuencia. La validación le toca a la carga. El flujo en el navegador, incluido Tab y una entrada vacía, está en Cómo probar escáneres de códigos de barras en aplicaciones web.
Cómo funcionan los escáneres seriales en las aplicaciones
Una integración serial abre un puerto, lee bytes, los parte en mensajes y atiende que el puerto desaparezca. En el escritorio, eso es la API serial del sistema operativo o una biblioteca del fabricante. En un navegador, la única opción integrada es la Web Serial API, y solo en los navegadores que la implementan.
Web Serial está disponible en los navegadores basados en Chromium. Firefox y Safari no la traen. La página tiene que ser un contexto seguro, o sea HTTPS o localhost. requestPort() tiene que correr desde un gesto del usuario, y el usuario debe elegir el puerto en el aviso del navegador. Un escáner en emulación de teclado no aparece en esa lista, porque no es un dispositivo serial. Web Serial tampoco puede ver un puerto serial que el sistema operativo no haya expuesto.
La tasa de baudios del ejemplo es un punto de partida que reemplazas con el valor del manual. El ciclo trata CR o LF como el final de un mensaje y consume un par CRLF como un solo terminador. Si tu escáner usa otro marco, esta división está mal aunque el puerto esté abierto.
<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 ciclo de lectura sigue hasta que el flujo termina o la lectura falla. Desconectar el escáner por lo general rechaza la lectura. releaseLock() y close() corren en finally. Los puertos ya aprobados para este origen se pueden listar con navigator.serial.getPorts() sin volver a mostrar el aviso. La primera aprobación sigue pidiendo al usuario.
Una app de escritorio sigue la misma idea con la API serial de la plataforma: abrir, leer, encuadrar y volver a abrir cuando el equipo regresa. Esta página no inventa comandos del fabricante. Si el escáner espera un protocolo propietario, ese protocolo está en la documentación del fabricante.
¿Cuál conviene más: HID o serial?
Ningún modo conviene más para todos los productos. Usa el modo que el escáner ofrece de verdad y el modo que la app puede leer.
Elige HID cuando
- La app ya acepta entrada de teclado en un campo enfocado.
- Quieres que un formulario o una pantalla de POS funcione sin código del equipo.
- El flujo puede garantizar el foco antes de cada escaneo.
- Enter o Tab coincide con la forma en que ese formulario confirma o avanza.
Considera el serial cuando
- Los escaneos tienen que llegar con el foco en un cuadro de diálogo, en un botón o en ninguna parte.
- Los bytes del escáner tienen que quedarse aparte de lo que se teclea.
- La app puede abrir un puerto, encuadrar mensajes y recuperarse cuando se desconecta el equipo.
- El host puede dar permiso a ese puerto y ningún otro proceso lo necesita al mismo tiempo.
Un escáner que solo se enumera como teclado no se puede pasar a serial con software en el host. Confirma los modos en el manual antes de diseñar la integración.
Cambiar entre HID y serial
Algunos escáneres cambian de modo cuando escaneas un código de barras de configuración del manual de ese fabricante, o cuando escribes un perfil con la utilidad del fabricante. Otros están armados como una sola interfaz y no tienen nada que cambiar.
No hay un código de barras de configuración que cambie todas las marcas. Una secuencia impresa para otro modelo puede no hacer nada, o dejar el escáner en un modo inesperado. Después de cualquier cambio, revisa qué muestra el sistema operativo: un teclado, un puerto COM o los dos. Después prueba la ruta que usa tu app. La Guía de configuración del escáner de códigos de barras describe los grupos de ajustes de siempre. No reemplaza al manual.
Probar un escáner HID
- Conecta el escáner y confirma que está en emulación de teclado. Un editor de texto debe recibir caracteres cuando un campo de ese editor está enfocado.
- Abre el Verificador de entrada de códigos de barras.
- Haz clic en Start Test o en el área de escaneo. Se pone azul cuando está listo. La página no toma el foco sola.
- Escanea un código de barras cuya carga ya conoces.
- Compara el valor capturado y la cantidad de caracteres con esa carga.
- Lee el sufijo: ENTER, TAB o None. Enter y Tab no forman parte de la cadena del código de barras.
El verificador registra los eventos de teclado que el navegador puede ver. No puede leer un puerto serial y no puede identificar el dispositivo USB. Cuando el hueco medio entre caracteres queda por debajo de 100 ms, reporta ese tiempo. El tiempo no es una identificación del hardware. Para cada keydown, incluidos key y code, usa el Inspector de eventos de teclado. Un repaso de QA más amplio está en Cómo probar la entrada de un escáner de códigos de barras.
Probar un escáner serial
El Verificador de entrada de códigos de barras no abre un puerto COM. Una prueba serial necesita un programa que pueda abrir el puerto que expone el escáner.
- Confirma que el escáner está en un modo serial y que el sistema operativo lista un puerto cuando está conectado. Desconéctalo y revisa que el puerto desaparezca.
- Anota el nombre del puerto. Es propio del sistema operativo y puede cambiar en la siguiente conexión.
- Abre el puerto desde una app compatible: un terminal serial, tu app de escritorio o el ejemplo de Web Serial de arriba en un navegador Chromium con HTTPS o localhost.
- Ajusta la tasa de baudios, los bits de datos, la paridad y los bits de paro cuando el manual los indique. No inventes valores.
- Escanea un código de barras conocido.
- Compara los bytes o el texto decodificado con esa carga.
- Revisa el encuadre. Busca un prefijo y CR, LF o CRLF después de los datos, solo si eso fue lo que configuró el manual.
Si la apertura del puerto falla porque está ocupado, cierra el otro programa que lo tiene. Si el texto es basura, los ajustes de línea no coinciden con el equipo. Si el puerto nunca aparece, el escáner puede seguir en modo teclado, puede faltar el driver o el usuario del sistema puede no tener permiso para abrir dispositivos seriales.
Problemas comunes
El escáner funciona en un editor de texto y no en la app de destino. El equipo está tecleando. El destino no tiene el foco, o un oyente de keydown descarta las teclas. Empieza por El escáner funciona en Notepad pero no en el POS.
El escáner no teclea en ningún campo de texto. Puede estar en modo serial, apagado o sin leer el símbolo. Un escáner en modo serial no teclea. Busca un puerto COM antes de depurar el campo. El escáner de códigos de barras no funciona separa un escáner muerto de la interfaz equivocada.
Falta el puerto serial. El modo teclado no crea un puerto COM. Un driver que falta, un cable solo de carga o un escáner sin modo serial producen el mismo síntoma. Mira la lista de equipos del sistema mientras conectas el escáner.
El puerto serial ya está en uso. Solo un proceso puede leerlo. Cierra el terminal o la otra copia de la app y ábrelo de nuevo.
Los ajustes de comunicación están mal. Una tasa de baudios, una paridad o unos bits de paro que no coinciden parecen caracteres al azar. Pon los valores del manual de ese modelo y vuelve a escanear un código conocido.
ENTER o TAB nunca llegan. Es un ajuste de sufijo de la emulación. El verificador de entrada reporta None. Consulta Al escáner de códigos de barras le falta ENTER y la guía de sufijos enlazada arriba. Un escáner serial no manda la tecla Enter. Puede mandar bytes CR o LF en su lugar.
Los caracteres salen mal en un escáner en emulación. El diseño de teclado del escáner y el del sistema operativo pueden no coincidir. Los bytes seriales no se reasignan con ese diseño. Consulta Diseño de teclado incorrecto en el escáner de códigos de barras.
El navegador no puede llegar al escáner. Un escáner en emulación no va a aparecer en el aviso de Web Serial. Firefox y Safari no tienen Web Serial API. Una página que no sea HTTPS o localhost no puede usarla. El usuario también puede cerrar el aviso del puerto.
La app pierde el escáner después de desconectarlo. Un escáner en emulación regresa como teclado, y el siguiente escaneo sigue pidiendo foco. Un puerto serial desaparece hasta que la app abre el puerto nuevo. El nombre puede no coincidir con el anterior.
Escenarios de integración
Aplicaciones web
La emulación de teclado le queda a una entrada enfocada y a los eventos DOM comunes. El acceso serial dentro de la página significa Web Serial en un navegador que lo soporte, un contexto seguro y un puerto que elija el usuario. Una página que tenga que soportar Firefox, Safari y kioscos sin operador no puede depender solo de Web Serial. Un ayudante local puede ser dueño del puerto COM y reenviar los códigos de barras completos a la página. Ese ayudante es software aparte. La página no debería esperar que una prueba de emulación lo ejercite.
Sistemas POS
Un POS que pone el foco en el campo de artículo y confirma con Enter es una integración por emulación. Un POS que tiene que escanear con un modal abierto, o que tiene que ignorar el teclado, es una integración serial. Mezclarlos manda escaneos al campo equivocado o produce escaneos que nunca llegan. Iguala el modo del escáner con la pantalla que de verdad está en turno.
Aplicaciones de escritorio
Una app de escritorio puede aceptar la entrada por emulación en el control que tenga el foco, o abrir el puerto COM virtual y sostener una sesión durante la vida del proceso. La propiedad del puerto, la reconexión y el encuadre forman parte de esa sesión. El foco no.
Automatización de control de calidad
El Barcode Scanner Emulator teclea un valor que eliges en la app con el foco y puede mandar ENTER, TAB o ningún sufijo. Eso cubre las regresiones de la emulación de teclado: foco, validación y manejo del sufijo. No crea un puerto COM virtual, no enumera dispositivos USB ni reproduce la tasa de baudios ni el encuadre. Las pruebas seriales siguen necesitando un puerto serial y un lector, o un doble de prueba que escriba el mismo encuadre de bytes que analiza tu app.
Aplicaciones de kiosco
Un kiosco que usa entrada por emulación tiene que mantener el campo de escaneo enfocado a través de cuadros de diálogo, protectores de pantalla y mensajes de error. Se pierde el foco una vez y el siguiente escaneo pega en un atajo o en nada. Un kiosco que usa serial puede leer el puerto sin ese foco, y tiene que conservar el permiso sobre el equipo y volver a abrir el puerto después de un corte de energía o de un jalón del cable.
Dónde entra Barcode Scanner Emulator
El Barcode Scanner Emulator es una app de escritorio para Windows, macOS y Linux. Reproduce la ruta de teclado que usa un escáner en emulación. Escribes el texto, eliges un retraso de tecleo y eliges un sufijo entre ninguno, ENTER o TAB. Un atajo global teclea ese texto en la app con el foco.
Úsalo para desarrollar formularios al estilo HID y correr sus regresiones cuando el escáner no está en el escritorio. Combínalo con el Verificador de entrada de códigos de barras para ver el valor, las teclas de prefijo y el sufijo que recibió el navegador.
No emula un dispositivo serial USB, un puerto COM virtual, una enumeración USB ni una decodificación óptica. Esos comportamientos siguen siendo del hardware, o de un doble de prueba serial que tú controlas.