2D Code Scanner

FAQ du lecteur de codes

Installation, scan, et quoi vérifier quand le lecteur n’atteint pas le PC.

Premiers pas

Que fait 2D Code Scanner ?

L’application envoie les codes-barres d’un lecteur Android vers un Companion Windows ou macOS (Linux est expérimental) sur le même réseau local. Le Companion tape chaque code dans le champ qui a le focus sur le PC, comme un clavier en mode wedge.

Est-ce que cela fonctionne comme un keyboard wedge ?

Oui. Le Companion saisit chaque code dans le champ qui a le focus sur le PC, comme le ferait un keyboard wedge. Vous pouvez ajouter Entrée ou Tab après chaque scan.

Puis-je l’utiliser à la place d’un lecteur de codes USB ?

Oui. Un appareil Zebra ou votre téléphone remplace un lecteur USB séparé. Le Companion saisit le code dans le champ actif sous Windows, macOS ou Linux expérimental.

Que dois-je installer ?

Les deux côtés. Installez le Companion de bureau sur le PC, et une application Android : Zebra, Camera, HoneywellBientôt, UrovoBientôt, NewlandBientôt, DatalogicBientôt ou UniversalBientôt. Le lecteur a besoin de Companion 1.1.0 ou plus récent.

Application Zebra ou application Camera ?

Utilisez l’application qui correspond à l’appareil. Zebra et UrovoBientôt utilisent DataWedge. HoneywellBientôt utilise Data Collection. NewlandBientôt utilise NLScan. DatalogicBientôt utilise Intent Wedge. Camera utilise la caméra du téléphone.

UniversalBientôt utilise l’imageur constructeur quand ce lecteur est installé, sinon la caméra.

Le Bluetooth n’est pas utilisé.

Faut-il un compte ou un abonnement ?

Non. Il n’y a pas de compte cloud ni d’abonnement. Les codes restent sur le lecteur et le PC. La liaison est chiffrée sur votre réseau en AES-256-GCM.

Appairage

Comment appairer le lecteur avec le PC ?
  1. Ouvrez le Companion. Si la fenêtre est masquée, il peut encore être dans la barre des tâches.
  2. Gardez le lecteur et le PC sur le même réseau local.
  3. Sur un appareil Zebra, visez le QR et appuyez sur la gâchette matérielle. Dans l’app Camera, touchez Scan.
  4. Le lecteur doit afficher Connected.

Si le PC a plusieurs adaptateurs réseau, ouvrez dans le Companion Settings → Connection Wizard (ou le lien Connection Wizard de l’accueil). L’assistant recommande une adresse LAN, couvre le pare-feu et liste les lecteurs qui apparaissent quand vous ouvrez Connections sur l’appareil. Vous pouvez aussi régler Network à la main sur l’adresse que le lecteur peut atteindre avant de scanner le QR.

Dois-je appairer à chaque fois ?

Non. L’appairage est enregistré sous Connections sur le lecteur (touchez la ligne de connexion à l’accueil). Le Companion garde le même jeton d’appairage quand vous le quittez et le rouvrez, donc le lecteur se reconnecte seul.

Si l’adresse du PC change sur le même réseau, le Companion annonce la nouvelle adresse et la connexion enregistrée se met à jour. Rescannez le QR seulement si le PC a changé de réseau, ou après avoir régénéré le QR.

Puis-je utiliser plus d’un PC ?

Oui. Scannez le QR de chaque Companion pour l’enregistrer. Vous pouvez nommer une connexion, changer celle qui est active ou la supprimer depuis Connections.

Que fait Regenerate QR ?

Cela crée un nouveau jeton d’appairage et déconnecte chaque lecteur. Chaque appareil doit scanner le nouveau QR avant de pouvoir se reconnecter. Utilisez-le pour invalider d’anciens appairages, pas quand seule l’adresse IP a changé.

Le lecteur indique que le Companion est trop ancien

Installez Companion 1.1.0 ou plus récent depuis Téléchargements, ou utilisez Check for updates dans les réglages du Companion. Les Companion plus anciens sont refusés et ne se reconnectent pas tant que l’application PC n’est pas mise à jour.

Scan

Le code s’affiche sur l’appareil, mais rien n’est tapé sur le PC

Cliquez d’abord dans un champ de texte. Le Companion tape dans la fenêtre qui a le focus.

Dans les Settings du Companion, laissez Type into focused window activé. Sur le lecteur, Resend last scan renvoie le dernier code une fois la liaison établie.

Les éléments qui correspondent dans une session de validation ou de comptage ouverte restent volontairement sur l’appareil. Ils ne sont pas tapés sur le PC. Voir Sessions d’inventaire.

Si le statut n’est pas Connected, le scan est mis en file et envoyé quand la liaison revient. Commencez par Dépannage réseau s’il ne se connecte jamais.

Comment envoyer Entrée ou Tab après chaque scan ?

Sur le lecteur, ouvrez Settings et réglez After each scan sur Enter, Tab ou None. Enter est la valeur par défaut.

Quels codes-barres sont pris en charge ?

Code 128, Code 39, Code 93, EAN-8, EAN-13, UPC-A, UPC-E, Interleaved 2 of 5, GS1 DataBar, QR Code, Data Matrix, PDF417, Aztec, MaxiCode, MicroPDF417 et Micro QR Code.

Sur un appareil Zebra, une symbologie doit aussi être activée dans DataWedge. L’app Camera lit ce que le lecteur de l’appareil peut décoder depuis l’image de la caméra.

La gâchette Zebra ne fait rien

Le premier lancement crée un profil DataWedge nommé 2DCodeScanner (entrée code-barres, sortie intent vers cette app, sortie frappes désactivée). Vérifiez que ce profil existe et est associé à cette app.

Cette app a besoin d’un appareil Zebra avec DataWedge. Les autres marques Android et l’app Camera n’utilisent pas ce profil.

L’app Camera ne scanne pas

Accordez l’autorisation de la caméra quand Android le demande, puis touchez Scan. L’autorisation de notification est aussi requise pour que le lecteur continue en arrière-plan.

Sessions d’inventaire

Qu’est-ce qu’une session de validation ?

Une liste des codes attendus. Créez-la sur le lecteur, ou sur le Companion sous Tools → Validation, puis envoyez-la au lecteur. Les scans correspondants cochent les éléments. Ils ne sont pas tapés sur le PC.

Quand chaque élément est coché, la session est terminée. Reset / undo sur l’appareil efface les coches pour rescanner la liste. Return to building efface les coches et permet d’ajouter ou de retirer des codes.

Qu’est-ce qu’une session de comptage ?

Un relevé de quantités. Créez-le sur le lecteur (Sessions → Counting) ou sur le Companion (Tools → Counting), ouvrez-le sur l’appareil et scannez. Les quantités se synchronisent vers le Companion. Le Companion peut copier le relevé en TSV.

Pourquoi un scan est-il resté sur l’appareil pendant une session ?

Tant qu’un écran de détail de validation ou de comptage est ouvert, les scans appartiennent à cette session. Quittez la session pour taper des codes ordinaires dans le champ du PC qui a le focus.

Dépannage réseau

Le lecteur et le Companion ne parlent que sur votre réseau local. Ils n’utilisent pas Internet, le Bluetooth ni un relais cloud. Un téléphone qui peut naviguer sur le web peut quand même ne pas atteindre le PC si le Wi‑Fi invité, l’isolation des clients, un VPN ou le pare-feu bloque le trafic d’appareil à appareil.

Vérifiez dans cet ordre

  1. Le Companion tourne vraiment

    Fermer la fenêtre le masque dans la barre quand Close to tray est activé. Il accepte encore les lecteurs. Quit sur l’icône de la barre quitte l’application.

  2. Les deux appareils sont sur le même réseau local

    Le lecteur utilise le Wi‑Fi. Le PC peut être sur ce même Wi‑Fi ou en Ethernet sur le même LAN. Les réseaux invités, les hotspots publics et les points d’accès avec isolation des clients empêchent les appareils de se voir, même si les deux ont Internet.

  3. Le QR utilise une adresse que le lecteur peut atteindre

    Dans le Companion, Settings → Network liste les adresses LAN du PC. Choisissez l’adresse Wi‑Fi ou Ethernet du bureau (souvent 192.168… ou 10…). Ignorez les adaptateurs VPN, machine virtuelle et hyperviseur. Ou utilisez Connection Wizard — les adaptateurs recommandés sont indiqués, et votre lecteur devrait apparaître dans la liste quand Connections est ouvert. Rescannez le QR après ce changement.

  4. Le pare-feu autorise le Companion

    Autorisez en entrée TCP et UDP 17832 (ou le port défini sous Settings → Port). TCP porte la connexion. L’UDP sur ce même port permet à un lecteur enregistré d’apprendre la nouvelle adresse du PC quand le DHCP la change, et au Companion de voir le lecteur dans Connection Wizard.

  5. Scannez le QR actuel

    Faites-le après avoir changé le réseau, le port ou le LAN du PC. Un nouveau QR n’est pas nécessaire seulement parce que l’IP a changé sur le même réseau.

Si cela échoue encore

  • Le statut reste sur Connecting ou Not connected

    • Coupez les VPN du téléphone et du PC, puis rescannez le QR. Un VPN masque souvent l’adresse LAN du PC.
    • Quittez le Wi‑Fi invité. Utilisez un LAN privé où téléphones et PC peuvent se joindre.
    • Pour tester les apps sans le réseau du bureau, joignez le PC au partage de connexion du téléphone lecteur (ou mettez les deux sur un petit routeur de voyage) et scannez le QR là.
    • Sous Windows, autorisez le Companion sur les réseaux Private. Un réseau marqué Public bloque souvent les connexions entrantes des autres appareils.
    • Sous macOS, autorisez l’accès au réseau local si le système le demande. Sous Linux, autorisez ce même port pour TCP et UDP.

  • Cela marchait, puis l’adresse du PC a changé

    • Ne touchez pas au jeton d’appairage. Regenerate QR force chaque lecteur à s’appairer de nouveau.
    • Avec ce port UDP autorisé, le Companion annonce sa nouvelle adresse et la connexion enregistrée se met à jour. Si le port est bloqué, scannez le QR actuel une fois.
    • Un autre réseau (bureau ou domicile, ou un nouveau VLAN) exige un nouveau scan du QR.

  • La liaison tombe quand l’écran s’éteint

    • Le lecteur met la liaison Wi‑Fi en pause tant que l’écran est éteint. La notification indique que la liaison est en pause.
    • Activez Keep screen on dans les réglages du lecteur, ou réveillez l’écran pour reconnecter.
    • Accordez l’autorisation de notification si Android le demande. Sans elle, le service du lecteur ne peut pas rester actif.

  • Les scans restent sur l’appareil

    • Si le statut n’est pas Connected, le scan est mis en file et envoyé après reconnexion. Il n’est pas perdu.
    • Si un écran de validation ou de comptage est ouvert, le scan est stocké dans cette session au lieu d’être tapé.
    • Si le statut est Connected à l’accueil, cliquez dans un champ de texte du PC et vérifiez que Type into focused window est activé.

  • Vous avez changé le port

    • Le port est dans le QR. Appliquez-le dans les réglages du Companion, puis scannez le nouveau QR.
    • Autorisez ce port pour TCP et UDP. Un scanner qui a déjà enregistré ce Companion apprend le nouveau port via l’annonce. Un scanner qui ne l’a jamais enregistré émet encore sur 17832 : associez-le d’abord en scannant le QR.
    • Un autre programme déjà lié à ce port empêche le Companion d’écouter. Choisissez un port libre au-dessus de 1024.

Toujours bloqué ? Écrivez à office@updruck.com avec la version du Companion (réglages PC), la version de l’app Android (réglages du lecteur), l’adresse choisie sous Network, et si le téléphone est en Wi‑Fi invité ou sur un VPN.