Passer au contenu

Barcode Scanner Emulator

Scanneurs de codes à barres USB HID et sériel

Un scanneur en mode en coin de clavier USB HID tape le code à barres décodé dans l'application qui a le focus. Un scanneur USB sériel expose une interface sérielle, souvent comme un port COM virtuel, et l'application doit ouvrir ce port puis lire les octets. USB, c'est le câble et le bus. HID et sériel sont deux manières distinctes de présenter les données.

Choisissez l'interface que l'application peut réellement lire. Une zone de caisse qui accepte déjà la frappe est un problème de mode en coin de clavier. Un service qui doit recevoir des lectures alors qu'aucune zone de texte n'a le focus, ou qui doit tenir les octets du scanneur à l'écart du clavier, est un problème sériel. Bien des scanneurs n'offrent qu'un de ces modes. Certains peuvent basculer. Le manuel de ce modèle est la liste des modes que vous pouvez mettre à l'essai.

Le guide Mode en coin de clavier HID explique en détail le chemin des frappes. Comment fonctionnent les scanneurs de codes à barres ? traite la capture et le décodage. Cette page compare les deux interfaces hôte et les essais qui reviennent à chacune.

Qu'est-ce que le mode en coin de clavier USB HID ?

En mode clavier USB HID, le scanneur s'énumère comme un clavier. Le système d'exploitation charge son pilote de clavier habituel. Après un décodage, le scanneur envoie les caractères comme des frappes vers le contrôle qui a le focus du clavier. Un formulaire web, une zone d'article au POS ou une zone de texte de bureau peut accepter cette saisie sans code propre au scanneur.

Le focus décide de la destination. Si la zone prévue n'a pas le focus, les caractères aboutissent dans un autre contrôle, ou ils sont perdus. Le scanneur ne clique pas et ne déplace pas le pointeur.

Un suffixe réglé peut suivre le contenu. Enter soumet bien des formulaires à une seule zone. Tab déplace le focus vers le contrôle suivant. Ni l'une ni l'autre de ces touches n'est garantie. Les choix de suffixe sont traités dans Suffixes ENTER et TAB des scanneurs de codes à barres.

Les événements clavier ordinaires ne comprennent ni le fabricant du scanneur, ni le numéro de série, ni un indicateur qui dirait que les touches viennent d'un scanneur. Les navigateurs qui mettent en œuvre WebHID refusent tout de même les interfaces clavier, alors une page ne peut pas ouvrir l'appareil en coin de clavier ni lire les rapports HID bruts.

Qu'est-ce que le mode USB sériel d'un scanneur de codes à barres ?

En mode USB sériel, le scanneur ne tape pas. Il expose une interface sérielle par USB. Le système d'exploitation présente habituellement cette interface comme un port COM virtuel : un nom COM sous Windows, un périphérique cu ou tty sous macOS, ou un périphérique ttyACM ou ttyUSB sous Linux. Le nom est attribué par le pilote et peut changer après le débranchement du scanneur.

Un port COM virtuel n'est pas un port RS-232 physique. RS-232 est une interface électrique, avec son connecteur et ses niveaux de tension, qu'un ordinateur lit au moyen d'une UART. L'USB sériel utilise un câble USB. L'application ouvre quand même un port sériel et lit des octets, mais le signal sur le fil est de l'USB. Certains produits sont un vrai scanneur RS-232 plus un adaptateur USB vers sériel. D'autres mettent en œuvre USB CDC et ne parlent jamais RS-232. Tenez le port que le système d'exploitation vous montre pour le point d'intégration, et ne présumez pas que les détails électriques concordent.

L'application ouvre le port, lit le flux d'octets et décide où un message commence et où il finit. Un cadre courant est le texte du code à barres suivi de CR (0x0D), de LF (0x0A), ou de CR puis de LF. Ce cadrage est un réglage de l'appareil, pas une règle de l'USB. Un octet de préfixe comme STX est aussi possible. Le guide Préfixe et suffixe du scanneur de codes à barres : guide complet sépare ces octets de la touche Enter qu'envoie un scanneur en coin de clavier.

Le débit en bauds, les bits de données, la parité et les bits d'arrêt comptent sur une vraie UART et sur bien des adaptateurs USB vers sériel. Un mauvais débit produit des caractères incohérents plutôt qu'une erreur claire. Certains périphériques COM virtuels USB CDC ignorent le débit demandé par l'hôte et livrent quand même les octets. Il n'y a pas un seul réglage qui convienne à chaque scanneur sériel virtuel. Utilisez le débit et le cadrage du manuel de ce modèle, puis confirmez-les avec un code à barres connu.

Le processus qui garde le port ouvert reçoit les données. Le focus du clavier ne choisit pas la destination. Un autre programme qui a déjà le port ouvert bloque une deuxième ouverture. Débrancher le scanneur retire le port. Le rebrancher peut créer un nouveau nom, et l'application doit ouvrir ce port de nouveau.

HID et sériel

Caractéristique Mode en coin de clavier HID USB sériel
Livraison des données Saisie de style clavier Flux d'octets sériel
Focus de saisie exigé Oui. Les frappes suivent le contrôle qui a le focus Non. Les octets vont au processus qui a ouvert le port
Intégration au navigateur Saisie ordinaire et événements clavier Web Serial là où le navigateur le prend en charge, ou un logiciel à l'extérieur de la page
Maîtrise par l'application Limitée au comportement du clavier, au focus et aux suffixes L'application lit le flux et le cadre
Identification de l'appareil Absente des événements clavier ordinaires Le système d'exploitation peut afficher un nom de port. Une identité stable dépend encore du pilote
Configuration Réglages du scanneur, y compris le suffixe et la disposition du clavier Réglages du scanneur plus les réglages de port de l'hôte que l'appareil utilise vraiment
Usage typique Formulaires et saisie d'articles au POS Intégrations réservées qui possèdent l'appareil

Ce sont les cas habituels. Un modèle, un système d'exploitation et un pilote donnés peuvent s'écarter. Un scanneur Bluetooth en mode clavier HID suit la colonne du coin de clavier au niveau de l'application. Bluetooth SPP suit la colonne sérielle.

Comment les scanneurs HID fonctionnent dans les applications web

Une lecture en coin de clavier met à jour l'élément qui a le focus. Les caractères imprimables déclenchent keydown, puis input. Enter et Tab déclenchent keydown et n'insèrent pas de caractère dans une zone de texte normale. event.key vaut "Enter" ou "Tab" pour ces touches, et une chaîne d'un seul caractère pour un caractère imprimable. event.code nomme la touche physique et peut rester le même lorsqu'un écart de disposition du clavier change event.key.

L'écouteur ci-dessous ne valide la zone que lorsque Enter arrive. Un scanneur sans suffixe Enter laisse le texte dans la zone.

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 = ''
})

Donnez le focus à #barcode avant la lecture. preventDefault() empêche un formulaire parent de se soumettre une deuxième fois. Si le scanneur envoie Tab à la place, lisez la valeur dans ce keydown et laissez le navigateur déplacer le focus. S'il n'envoie ni l'un ni l'autre, soumettez la zone à partir d'un bouton ou d'une autre action explicite. Une pause dans la frappe n'est qu'une heuristique de fin de lecture.

Rien dans ces événements n'identifie le périphérique USB. Une personne, une macro ou l'émulateur peut produire la même séquence. La validation porte sur le contenu. Le parcours dans le navigateur, y compris Tab et une saisie vide, est dans Comment mettre à l'essai les scanneurs de codes à barres dans les applications web.

Comment les scanneurs sériels fonctionnent dans les applications

Une intégration sérielle ouvre un port, lit des octets, les découpe en messages et gère la disparition du port. Sur le bureau, c'est l'API sérielle du système d'exploitation ou une bibliothèque du fabricant. Dans un navigateur, la seule option intégrée est la Web Serial API, et seulement dans les navigateurs qui la mettent en œuvre.

Web Serial est offert dans les navigateurs fondés sur Chromium. Firefox et Safari ne le fournissent pas. La page doit être un contexte sécurisé, ce qui veut dire HTTPS ou localhost. requestPort() doit s'exécuter à partir d'un geste de l'utilisateur, et l'utilisateur doit choisir le port dans l'invite du navigateur. Un scanneur en coin de clavier n'apparaît pas dans cette liste, parce que ce n'est pas un périphérique sériel. Web Serial ne peut pas non plus voir un port sériel que le système d'exploitation n'a pas exposé.

Le débit en bauds de l'exemple est un point de départ que vous remplacez par la valeur du manuel. La boucle traite CR ou LF comme la fin d'un message et consomme une paire CRLF comme un seul terminateur. Si votre scanneur utilise un autre cadre, ce découpage est faux même lorsque le port est ouvert.

<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>

La boucle de lecture tourne jusqu'à ce que le flux se termine ou que la lecture échoue. Débrancher le scanneur rejette habituellement la lecture. releaseLock() et close() s'exécutent dans finally. Les ports déjà approuvés pour cette origine peuvent être énumérés avec navigator.serial.getPorts() sans montrer de nouveau l'invite. La première approbation exige encore l'utilisateur.

Une application de bureau suit la même idée avec l'API sérielle de la plateforme : ouvrir, lire, cadrer et rouvrir après le retour de l'appareil. Cette page n'invente pas de commandes du fabricant. Si le scanneur attend un protocole propriétaire, ce protocole se trouve dans la documentation du fabricant.

Lequel est le meilleur : HID ou sériel ?

Aucun mode n'est meilleur pour chaque produit. Utilisez le mode que le scanneur offre vraiment et le mode que l'application peut lire.

Choisissez HID lorsque

  • L'application accepte déjà la saisie clavier dans une zone qui a le focus.
  • Vous voulez qu'un formulaire ou un écran de POS fonctionne sans code d'appareil.
  • Le flux de travail peut garantir le focus avant chaque lecture.
  • Enter ou Tab correspond à la façon dont ce formulaire valide ou avance.

Envisagez le sériel lorsque

  • Les lectures doivent arriver alors que le focus est dans une boîte de dialogue, sur un bouton, ou nulle part.
  • Les octets du scanneur doivent rester à part de la frappe.
  • L'application peut ouvrir un port, cadrer les messages et se rétablir lorsque l'appareil est débranché.
  • L'hôte peut accorder l'autorisation sur ce port et aucun autre processus n'en a besoin en même temps.

Un scanneur qui ne s'énumère que comme un clavier ne peut pas passer au sériel par un logiciel sur l'hôte. Confirmez les modes dans le manuel avant de concevoir l'intégration.

Passer de HID au sériel

Certains scanneurs changent de mode lorsque vous lisez un code à barres de configuration tiré du manuel de ce fabricant, ou lorsque vous écrivez un profil avec l'utilitaire du fabricant. D'autres sont construits comme une seule interface et n'ont rien à basculer.

Il n'existe pas de code à barres de configuration qui change toutes les marques. Une séquence imprimée pour un autre modèle peut ne rien faire, ou laisser le scanneur dans un mode inattendu. Après tout changement, vérifiez ce que montre le système d'exploitation : un clavier, un port COM, ou les deux. Mettez ensuite à l'essai le chemin que votre application utilise. Le Guide de configuration du scanneur de codes à barres décrit les groupes de réglages habituels. Il ne remplace pas le manuel.

Mettre à l'essai un scanneur HID

  1. Branchez le scanneur et confirmez qu'il est en mode en coin de clavier. Un éditeur de texte doit recevoir des caractères lorsqu'une zone de cet éditeur a le focus.
  2. Ouvrez l'outil d'essai de saisie de codes à barres.
  3. Cliquez sur Start Test, ou cliquez sur la zone de lecture. Elle devient bleue lorsqu'elle est prête. La page ne prend pas le focus d'elle-même.
  4. Lisez un code à barres dont vous connaissez déjà le contenu.
  5. Comparez la valeur captée et le nombre de caractères à ce contenu.
  6. Lisez le suffixe : ENTER, TAB ou None. Enter et Tab ne font pas partie de la chaîne du code à barres.

L'outil enregistre les événements clavier que le navigateur peut voir. Il ne peut pas lire un port sériel, et il ne peut pas identifier le périphérique USB. Lorsque l'écart moyen entre les caractères est inférieur à 100 ms, il signale ce minutage. Le minutage n'est pas une identification du matériel. Pour chaque keydown, y compris key et code, utilisez l'outil d'essai des événements clavier. Un passage d'assurance qualité plus large est dans Comment mettre à l'essai la saisie d'un scanneur de codes à barres.

Mettre à l'essai un scanneur sériel

L'outil d'essai de saisie de codes à barres n'ouvre pas de port COM. Un essai sériel exige un programme capable d'ouvrir le port que le scanneur expose.

  1. Confirmez que le scanneur est dans un mode sériel et que le système d'exploitation énumère un port lorsqu'il est branché. Débranchez-le et vérifiez que le port disparaît.
  2. Notez le nom du port. Il est propre au système d'exploitation et peut changer au branchement suivant.
  3. Ouvrez le port à partir d'une application compatible : un terminal sériel, votre application de bureau, ou l'exemple Web Serial ci-dessus dans un navigateur Chromium en HTTPS ou localhost.
  4. Réglez le débit en bauds, les bits de données, la parité et les bits d'arrêt lorsque le manuel les précise. Écartez les valeurs inventées.
  5. Lisez un code à barres connu.
  6. Comparez les octets ou le texte décodé à ce contenu.
  7. Vérifiez le cadrage. Cherchez un préfixe, et CR, LF ou CRLF après les données, seulement si c'est ce que le manuel a réglé.

Si l'ouverture du port échoue parce qu'il est occupé, fermez l'autre programme qui le détient. Si le texte est incohérent, les réglages de ligne ne concordent pas avec l'appareil. Si le port n'apparaît jamais, le scanneur est peut-être encore en mode clavier, le pilote peut manquer, ou l'utilisateur du système n'a peut-être pas le droit d'ouvrir les périphériques sériels.

Problèmes courants

Le scanneur fonctionne dans un éditeur de texte et pas dans l'application cible. L'appareil tape. La cible n'a pas le focus, ou un écouteur keydown écarte les touches. Commencez par Le scanneur fonctionne dans Notepad mais pas au POS.

Le scanneur ne tape dans aucune zone de texte. Il est peut-être en mode sériel, éteint, ou il ne lit pas le symbole. Un scanneur en mode sériel ne tape pas. Cherchez un port COM avant de diagnostiquer la zone. Le scanneur de codes à barres ne fonctionne pas sépare un scanneur mort de la mauvaise interface.

Le port sériel est absent. Le mode clavier ne crée pas de port COM. Un pilote manquant, un câble de charge seule ou un scanneur sans mode sériel produisent le même symptôme. Surveillez la liste des appareils du système pendant que vous branchez le scanneur.

Le port sériel est déjà utilisé. Un seul processus peut le lire. Fermez le terminal ou l'autre copie de l'application, puis ouvrez-le de nouveau.

Les réglages de communication sont incorrects. Un débit, une parité ou des bits d'arrêt qui ne concordent pas ressemblent à des caractères au hasard. Posez les valeurs du manuel de ce modèle, puis relisez un code connu.

ENTER ou TAB n'arrive jamais. C'est un réglage de suffixe du mode en coin de clavier. L'outil d'essai de saisie signale None. Voir Le scanneur de codes à barres n'envoie pas ENTER et le guide des suffixes lié plus haut. Un scanneur sériel n'envoie pas la touche Enter. Il peut envoyer des octets CR ou LF à la place.

Les caractères sont incorrects sur un scanneur en coin de clavier. La disposition du clavier du scanneur et celle du système d'exploitation peuvent diverger. Les octets sériels ne sont pas réassociés par cette disposition. Voir Mauvaise disposition du clavier du scanneur de codes à barres.

Le navigateur ne peut pas accéder au scanneur. Un scanneur en coin de clavier n'apparaîtra pas dans l'invite Web Serial. Firefox et Safari n'ont pas de Web Serial API. Une page qui n'est pas en HTTPS ou localhost ne peut pas l'utiliser. L'utilisateur peut aussi fermer l'invite de port.

L'application perd le scanneur après qu'il a été débranché. Un scanneur en coin de clavier revient comme un clavier, et la lecture suivante exige encore le focus. Un port sériel a disparu jusqu'à ce que l'application ouvre le nouveau port. Le nom peut ne pas correspondre au précédent.

Scénarios d'intégration

Applications web

Le mode en coin de clavier convient à une saisie qui a le focus et aux événements DOM ordinaires. L'accès sériel dans la page veut dire Web Serial dans un navigateur qui le prend en charge, un contexte sécurisé et un port choisi par l'utilisateur. Une page qui doit prendre en charge Firefox, Safari et des bornes sans surveillance ne peut pas dépendre de Web Serial seule. Un assistant local peut posséder le port COM et acheminer les codes à barres complets vers la page. Cet assistant est un logiciel distinct. La page ne doit pas s'attendre à ce qu'un essai en coin de clavier l'exerce.

Systèmes de POS

Un POS qui place le focus dans la zone d'article et qui valide sur Enter est une intégration en coin de clavier. Un POS qui doit lire pendant qu'une fenêtre modale est ouverte, ou qui doit ignorer le clavier, est une intégration sérielle. Les mélanger produit des lectures dans la mauvaise zone ou des lectures qui n'arrivent jamais. Faites correspondre le mode du scanneur à l'écran qui est réellement en service.

Applications de bureau

Une application de bureau peut accepter la saisie en coin de clavier dans le contrôle qui a le focus, ou ouvrir le port COM virtuel et tenir une session pendant la vie du processus. La possession du port, la reconnexion et le cadrage font partie de cette session. Le focus n'en fait pas partie.

Automatisation de l'assurance qualité

Barcode Scanner Emulator tape une valeur que vous choisissez dans l'application qui a le focus et peut envoyer ENTER, TAB ou aucun suffixe. Cela couvre les régressions du mode en coin de clavier : focus, validation et traitement du suffixe. Il ne crée pas de port COM virtuel, n'énumère pas les périphériques USB et ne reproduit ni le débit en bauds ni le cadrage. Les essais sériels ont encore besoin d'un port sériel et d'un programme de lecture, ou d'un double d'essai qui écrit le même cadrage d'octets que votre application analyse.

Applications de borne

Une borne qui utilise la saisie en coin de clavier doit garder la zone de lecture focalisée à travers les boîtes de dialogue, les économiseurs d'écran et les messages d'erreur. Un focus perdu, et la lecture suivante touche un raccourci ou rien. Une borne qui utilise le sériel peut lire le port sans ce focus, et elle doit conserver l'autorisation sur l'appareil et rouvrir le port après une panne de courant ou un câble retiré.

Où se place Barcode Scanner Emulator

Barcode Scanner Emulator est une application de bureau pour Windows, macOS et Linux. Il reproduit le chemin clavier qu'utilise un scanneur en coin de clavier. Vous saisissez le texte, vous choisissez un délai de frappe et vous choisissez un suffixe parmi aucun, ENTER ou TAB. Un raccourci global tape ce texte dans l'application qui a le focus.

Utilisez-le pour développer et vérifier les régressions des formulaires de style HID lorsque le scanneur n'est pas sur le bureau. Associez-le à l'outil d'essai de saisie de codes à barres pour voir la valeur, les touches de préfixe et le suffixe que le navigateur a reçus.

Il n'émule pas un périphérique USB sériel, un port COM virtuel, une énumération USB ni un décodage optique. Ces comportements appartiennent encore au matériel, ou à un double d'essai sériel que vous contrôlez.