2D Code Scanner

FAQ sul lettore di codici a barre

Configurazione, scansione e cosa controllare quando il lettore non raggiunge il PC.

Per iniziare

Cosa fa 2D Code Scanner?

Invia i codici a barre da un lettore Android a un Companion per Windows o macOS (Linux è sperimentale) nella stessa rete locale. Il Companion digita ogni codice nel campo attivo sul PC, come un keyboard wedge.

Funziona come un keyboard wedge?

Sì. Il Companion digita ogni codice a barre nel campo attivo sul PC, esattamente come farebbe un keyboard wedge. Puoi aggiungere Invio o Tab dopo ogni scansione.

Posso usarlo al posto di un lettore di codici a barre USB?

Sì. Un dispositivo Zebra o il tuo smartphone prende il posto di un lettore USB separato. Il Companion digita il codice nel campo attivo su Windows, macOS o Linux sperimentale.

Cosa devo installare?

Entrambe le parti. Installa il Companion desktop sul PC e una app Android: Zebra, Camera, HoneywellProssimamente, UrovoProssimamente, NewlandProssimamente, DatalogicProssimamente o UniversalProssimamente. Il lettore richiede il Companion 1.1.0 o successivo.

App Zebra o app Camera?

Usa l'app adatta al dispositivo. Zebra e UrovoProssimamente usano DataWedge. HoneywellProssimamente usa Data Collection. NewlandProssimamente usa NLScan. DatalogicProssimamente usa Intent Wedge. Camera usa la fotocamera dello smartphone.

UniversalProssimamente usa l'imager del produttore quando quel lettore è installato e la fotocamera in caso contrario.

Il Bluetooth non viene usato.

Mi servono un account o un abbonamento?

No. Non c'è alcun account cloud né abbonamento. I codici a barre restano sul lettore e sul PC. Il collegamento è cifrato sulla tua rete con AES-256-GCM.

Associazione

Come associo il lettore al PC?
  1. Apri il Companion. Se la finestra è nascosta, potrebbe essere ancora nella barra di sistema.
  2. Tieni il lettore e il PC nella stessa rete locale.
  3. Su un dispositivo Zebra, inquadra il QR e premi il grilletto hardware. Nell'app Camera, tocca Scan.
  4. Il lettore dovrebbe mostrare Connected.

Se il PC ha più di una scheda di rete, apri nel Companion Settings → Connection Wizard (o il link Connection Wizard nella home). La procedura guidata consiglia un indirizzo LAN, copre il firewall ed elenca i lettori che compaiono quando apri Connections sul dispositivo. Puoi anche impostare Network manualmente sull'indirizzo che il lettore può raggiungere prima di inquadrare il QR.

Devo associare di nuovo ogni volta?

No. L'associazione viene salvata in Connections sul lettore (tocca la riga della connessione nella schermata iniziale). Il Companion mantiene lo stesso token di associazione quando lo chiudi e lo riapri, così il lettore si riconnette da solo.

Se l'indirizzo del PC cambia nella stessa rete, il Companion annuncia il nuovo indirizzo e la connessione salvata si aggiorna. Inquadra di nuovo il QR solo quando il PC è passato a un'altra rete o dopo aver rigenerato il QR.

Posso usare più di un PC?

Sì. Inquadra il QR di ogni Companion per salvarlo. Puoi dare un nome a una connessione, cambiare quella attiva o eliminarla da Connections.

Cosa fa Regenerate QR?

Crea un nuovo token di associazione e disconnette tutti i lettori. Ogni dispositivo deve inquadrare il nuovo QR prima di potersi riconnettere. Usalo quando vuoi invalidare le vecchie associazioni, non quando l'indirizzo IP è semplicemente cambiato.

Il lettore dice che il Companion è troppo vecchio

Installa il Companion 1.1.0 o successivo da Download oppure usa Check for updates nelle impostazioni del Companion. I Companion più vecchi vengono rifiutati e non si riconnettono finché l'app per PC non viene aggiornata.

Scansione

Il codice compare sul dispositivo, ma sul PC non viene digitato nulla

Fai prima clic in un campo di testo. Il Companion digita nella finestra attiva.

Nelle Settings del Companion, lascia attivo Type into focused window. Sul lettore, Resend last scan invia di nuovo l'ultimo codice quando il collegamento è attivo.

Gli elementi corrispondenti in una sessione di validazione o di conteggio aperta restano sul dispositivo di proposito. Non vengono digitati sul PC. Vedi Sessioni di inventario.

Se lo stato non è Connected, la scansione viene messa in coda e inviata quando il collegamento torna. Se non si connette mai, parti dalla risoluzione dei problemi di rete.

Come invio Invio o Tab dopo ogni scansione?

Sul lettore, apri Settings e imposta After each scan su Enter, Tab o None. Enter è il valore predefinito.

Quali codici a barre sono supportati?

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 e Micro QR Code.

Su un dispositivo Zebra, la simbologia deve essere abilitata anche in DataWedge. L'app Camera legge ciò che lo scanner del dispositivo riesce a decodificare dall'immagine della fotocamera.

Il grilletto Zebra non fa nulla

Al primo avvio viene creato un profilo DataWedge chiamato 2DCodeScanner (input codici a barre, output intent verso questa app, output tastiera disattivato). Verifica che il profilo esista e sia associato a questa app.

Questa app richiede un dispositivo Zebra con DataWedge. Altre marche Android e l'app Camera non usano quel profilo.

L'app Camera non scansiona

Concedi il permesso per la fotocamera quando Android lo chiede, poi tocca Scan. Serve anche il permesso per le notifiche, così il lettore può restare attivo in background.

Sessioni di inventario

Cos'è una sessione di validazione?

Una lista di controllo di codici a barre attesi. Creala sul lettore oppure nel Companion in Tools → Validation, poi inviala al lettore. Le scansioni corrispondenti spuntano gli elementi. Non vengono digitate sul PC.

Quando tutti gli elementi sono spuntati, la sessione è conclusa. Reset / undo sul dispositivo cancella le spunte così puoi scansionare di nuovo la lista. Return to building cancella le spunte e ti permette di aggiungere o rimuovere codici.

Cos'è una sessione di conteggio?

Un conteggio delle quantità. Creala sul lettore (Sessions → Counting) o nel Companion (Tools → Counting), poi aprila sul dispositivo e scansiona. Le quantità si sincronizzano con il Companion. Il Companion può copiare il conteggio come TSV.

Perché durante una sessione una scansione è rimasta sul dispositivo?

Finché è aperta una schermata di dettaglio di validazione o conteggio, le scansioni appartengono a quella sessione. Esci dalla sessione per digitare i normali codici a barre nel campo attivo del PC.

Risoluzione dei problemi di rete

Il lettore e il Companion comunicano solo nella tua rete locale. Non usano internet, il Bluetooth né un relay cloud. Uno smartphone che naviga sul web può comunque non raggiungere il PC quando il Wi‑Fi ospiti, l'isolamento dei client, una VPN o il firewall bloccano il traffico tra dispositivi.

Controlla in quest'ordine

  1. Il Companion è effettivamente in esecuzione

    Chiudere la finestra la nasconde nella barra di sistema quando Close to tray è attivo. In quel caso accetta comunque i lettori. Quit sull'icona nella barra di sistema chiude l'app.

  2. Entrambi i dispositivi sono nella stessa rete locale

    Il lettore usa il Wi‑Fi. Il PC può essere nello stesso Wi‑Fi o su Ethernet nella stessa LAN. Le reti ospiti, gli hotspot pubblici e gli access point con isolamento dei client impediscono ai dispositivi di vedersi, anche se entrambi hanno internet.

  3. Il QR usa un indirizzo che il lettore può raggiungere

    Nel Companion Settings → Network elenca gli indirizzi LAN del PC. Scegli l'indirizzo del Wi‑Fi dell'ufficio o di Ethernet (spesso 192.168… o 10…). Salta le schede VPN, di macchine virtuali e di hypervisor. Oppure usa Connection Wizard — le schede consigliate sono etichettate e il tuo lettore dovrebbe comparire nell'elenco quando Connections è aperto o il flusso di benvenuto è al passaggio della connessione. Inquadra di nuovo il QR dopo aver cambiato questa impostazione.

  4. Il firewall consente il Companion

    Consenti in entrata TCP e UDP 17832 (o la porta impostata in Settings → Port). Il TCP trasporta la connessione. L'UDP sulla stessa porta è il modo in cui un lettore salvato scopre il nuovo indirizzo del PC quando il DHCP lo cambia e in cui il Companion vede il lettore nella Connection Wizard.

  5. Inquadra il QR attuale

    Fallo dopo aver cambiato la rete, la porta o la LAN del PC. Non serve un nuovo QR solo perché l'IP è cambiato nella stessa rete.

Se continua a non funzionare

  • Lo stato resta su Connecting o Not connected

    • Disattiva le VPN sullo smartphone e sul PC, poi inquadra di nuovo il QR. Una VPN spesso nasconde l'indirizzo LAN del PC.
    • Esci dal Wi‑Fi ospiti. Usa una LAN privata in cui smartphone e PC possano raggiungersi.
    • Per provare le app senza la rete dell'ufficio, collega il PC all'hotspot dello smartphone usato come lettore (o metti entrambi su un piccolo router da viaggio) e inquadra lì il QR.
    • Su Windows, consenti il Companion nelle reti Private. Una rete contrassegnata come Public spesso blocca le connessioni in entrata da altri dispositivi.
    • Su macOS, consenti l'accesso alla rete locale se il sistema lo chiede. Su Linux, consenti la stessa porta per TCP e UDP.

  • Funzionava prima, poi l'indirizzo del PC è cambiato

    • Non toccare il token di associazione. Regenerate QR costringe ogni lettore ad associarsi di nuovo.
    • Con quella porta UDP consentita, il Companion annuncia il suo nuovo indirizzo e la connessione salvata si aggiorna. Se la porta è bloccata, inquadra una volta il QR attuale.
    • Una rete diversa (ufficio o casa, o una nuova VLAN) richiede una nuova scansione del QR.

  • Il collegamento cade quando lo schermo si spegne

    • Il lettore mette in pausa il collegamento Wi‑Fi mentre lo schermo è spento. La notifica indica che il collegamento è in pausa.
    • Attiva Keep screen on nelle impostazioni del lettore oppure riattiva lo schermo per riconnetterti.
    • Concedi il permesso per le notifiche se Android lo chiede. Senza, il servizio del lettore non può restare in esecuzione.

  • Le scansioni restano sul dispositivo

    • Se lo stato non è Connected, la scansione viene messa in coda e inviata dopo la riconnessione. Non va persa.
    • Se è aperta una schermata di validazione o conteggio, la scansione viene salvata in quella sessione invece di essere digitata.
    • Se lo stato è Connected nella schermata iniziale, fai clic in un campo di testo del PC e verifica che Type into focused window sia attivo.

  • Hai cambiato la porta

    • La porta è nel QR. Applicala nelle impostazioni del Companion, poi inquadra il nuovo QR.
    • Consenti quella porta sia per TCP sia per UDP. Un lettore che ha già salvato questo Companion apprende la nuova porta dall'annuncio. Un lettore che non l'ha mai salvato emette comunque beacon su 17832, quindi associa quel primo lettore inquadrando il QR.
    • Un altro programma già collegato alla porta impedisce al Companion di restare in ascolto. Scegli una porta libera sopra 1024.

Ancora bloccato? Scrivi a office@updruck.com indicando la versione del Companion (Settings sul PC), la versione dell'app Android (Settings sul lettore), l'indirizzo selezionato in Network e se lo smartphone è su Wi‑Fi ospiti o su una VPN.