2D Code Scanner

FAQ do lector de códigos de barras

Instalación, escaneo e o que revisar cando o lector non chega ao PC.

Primeiros pasos

Que fai 2D Code Scanner?

Envía códigos de barras desde un lector Android a un Companion de Windows ou macOS (Linux é experimental) na mesma rede local. O Companion escribe cada código no campo que ten o foco no PC, como un keyboard wedge.

Funciona como un keyboard wedge?

Si. O Companion escribe cada código de barras no campo que ten o foco no PC, igual que faría un keyboard wedge. Pode engadir Intro ou Tab despois de cada escaneo.

Podo usalo en lugar dun lector USB de códigos de barras?

Si. Un dispositivo Zebra ou o seu teléfono substitúe un lector USB separado. O Companion escribe o código no campo activo en Windows, macOS ou Linux experimental.

Que teño que instalar?

Os dous lados. Instale o Companion de escritorio no PC, e unha app Android: Zebra, Camera, HoneywellProximamente, UrovoProximamente, NewlandProximamente, DatalogicProximamente ou UniversalProximamente. O lector necesita o Companion 1.1.0 ou posterior.

App Zebra ou app Camera?

Use a app que corresponda ao dispositivo. Zebra e UrovoProximamente usan DataWedge. HoneywellProximamente usa Data Collection. NewlandProximamente usa NLScan. DatalogicProximamente usa Intent Wedge. Camera usa a cámara do teléfono.

UniversalProximamente usa o imaxeador do fabricante cando ese lector está instalado, e a cámara no resto de casos.

Non se usa Bluetooth.

Necesito unha conta ou unha subscrición?

Non. Non hai conta na nube nin subscrición. Os códigos de barras quedan no lector e no PC. A conexión cífrase na súa rede con AES-256-GCM.

Emparellamento

Como emparello o lector co PC?
  1. Abra o Companion. Se a xanela está oculta, pode seguir na bandexa do sistema.
  2. Manteña o lector e o PC na mesma rede local.
  3. Nun dispositivo Zebra, apunte ao QR e prema o gatillo físico. Na app Camera, toque Scan.
  4. O lector debería mostrar Connected.

Se o PC ten máis dun adaptador de rede, abra no Companion Settings → Connection Wizard (ou a ligazón Connection Wizard da páxina de inicio). O asistente recomenda un enderezo LAN, cobre o cortalumes e lista os lectores que aparecen cando abre Connections no dispositivo. Tamén pode definir Network manualmente co enderezo ao que o lector pode chegar antes de escanear o QR.

Teño que emparellar de novo cada vez?

Non. O emparellamento gárdase en Connections no lector (toque a liña de conexión na páxina de inicio). O Companion mantén o mesmo token de emparellamento ao saír e volver abrilo, polo que o lector se reconecta sozinho.

Se o enderezo do PC cambia na mesma rede, o Companion anuncia o novo enderezo e a conexión gardada actualízase. Escanee o QR de novo só cando o PC pase a outra rede, ou despois de xerar de novo o QR.

Podo usar máis dun PC?

Si. Escanee o QR de cada Companion para gardalo. Pode dar nome a unha conexión, cambiar a activa ou eliminala desde Connections.

Que fai Regenerate QR?

Crea un novo token de emparellamento e desconecta todos os lectores. Cada dispositivo ten que escanear o novo QR antes de poder conectarse de novo. Use esta opción para invalidar emparellamentos antigos, non cando só cambiou o enderezo IP.

O lector di que o Companion é demasiado antigo

Instale o Companion 1.1.0 ou posterior desde Descargas, ou use Check for updates nos Settings do Companion. Os Companion antigos recházanse e non se reconectan ata que se actualice a app do PC.

Escaneo

O código aparece no dispositivo, pero non se escribe nada no PC

Faga clic primeiro nun campo de texto. O Companion escribe na xanela que ten o foco.

Nos Settings do Companion, deixe activado Type into focused window. No lector, Resend last scan envía de novo o último código cando a conexión está activa.

Os elementos coincidentes nunha sesión de validación ou contaxe aberta quedan no dispositivo a propósito. Non se escriben no PC. Consulte Sesións de inventario.

Se o estado non é Connected, o escaneo queda en cola e envíase cando volve a conexión. Comece pola resolución de problemas de rede se nunca se conecta.

Como envío Intro ou Tab despois de cada escaneo?

No lector, abra Settings e defina After each scan como Intro, Tab ou Ningún. Intro é o predeterminado.

Que códigos de barras son compatibles?

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.

Nun dispositivo Zebra, tamén hai que activar unha simboloxía en DataWedge. A app Camera le o que o lector do dispositivo pode decodificar da imaxe da cámara.

O gatillo do Zebra non fai nada

O primeiro inicio crea un perfil de DataWedge chamado 2DCodeScanner (entrada de códigos de barras, saída intent cara a esta app, saída de teclas desactivada). Confirme que ese perfil existe e está asociado a esta app.

Esta app necesita un dispositivo Zebra con DataWedge. Outras marcas Android e a app Camera non usan ese perfil.

A app Camera non escanea

Conceda o permiso da cámara cando Android o pida e despois toque Scan. Tamén se necesita o permiso de notificacións para que o lector poida seguir en segundo plano.

Sesións de inventario

Que é unha sesión de validación?

Unha lista de control de códigos de barras esperados. Créea no lector, ou no Companion en Tools → Validation, e despois envíea ao lector. Os escaneos coincidentes marcan elementos. Non se escriben no PC.

Cando se marcan todos os elementos, a sesión está rematada. Reset / undo no dispositivo borra as marcas para poder escanear a lista de novo. Return to building borra as marcas e permite engadir ou quitar códigos.

Que é unha sesión de contaxe?

Un recontó de cantidades. Créea no lector (Sessions → Counting) ou no Companion (Tools → Counting), ábrea no dispositivo e escanee. As cantidades sincronízanse co Companion. O Companion pode copiar o recontó como TSV.

Por que un escaneo quedou no dispositivo durante unha sesión?

Mentres está aberta a pantalla de detalle dunha validación ou contaxe, os escaneos pertencen a esa sesión. Saia da sesión para escribir códigos de barras normais no campo do PC que ten o foco.

Resolución de problemas de rede

O lector e o Companion só se comunican na súa rede local. Non usan Internet, Bluetooth nin un relé na nube. Un teléfono que pode navegar pola web aínda pode non chegar ao PC cando a Wi‑Fi de convidados, o illamento de clientes, unha VPN ou o cortalumes bloquean o tráfico entre dispositivos.

Revise estes puntos por orde

  1. O Companion está realmente en execución

    Pechar a xanela oculta o Companion na bandexa cando Close to tray está activado. Iso segue aceptando lectores. Quit na icona da bandexa sae da aplicación.

  2. Os dous dispositivos están na mesma rede local

    O lector usa Wi‑Fi. O PC pode estar na mesma Wi‑Fi ou conectado por Ethernet á mesma LAN. As redes de convidados, os hotspots públicos e os puntos de acceso con illamento de clientes impiden que os dispositivos se vexan, aínda que ambos teñan Internet.

  3. O QR usa un enderezo ao que o lector pode chegar

    Companion Settings → Network lista os enderezos LAN do PC. Escolla o enderezo Wi‑Fi ou Ethernet da oficina (a miúdo 192.168… ou 10…). Omita os adaptadores de VPN, máquina virtual e hipervisor. Ou use Connection Wizard — os adaptadores recomendados están marcados, e o lector debería aparecer na lista cando Connections estea aberto ou o fluxo de benvida estea no paso de conexión. Escanee o QR de novo despois de cambiar isto.

  4. O cortalumes permite o Companion

    Permita o tráfico entrante de TCP e UDP 17832 (ou o porto que definiu en Settings → Port). TCP transporta a conexión. UDP no mesmo porto é como un lector gardado aprende un novo enderezo do PC cando DHCP o cambia, e como o Companion ve o lector no Connection Wizard.

  5. Escanee o QR actual

    Faga isto despois de cambiar a rede, o porto ou a LAN do PC. Non precisa un QR novo só porque cambiou a IP na mesma rede.

Se aínda falla

  • O estado segue en Connecting ou Not connected

    • Desactive as VPN no teléfono e no PC, e despois escanee o QR de novo. Unha VPN adoita ocultar o enderezo LAN do PC.
    • Saia da Wi‑Fi de convidados. Use unha LAN privada onde os teléfonos e os PC se poidan alcanzar.
    • Para probar as apps sen a rede da oficina, conecte o PC ao hotspot do teléfono lector (ou poña os dous nun pequeno router de viaxe) e escanee alí o QR.
    • En Windows, permita o Companion nas redes Private. Unha rede marcada como Public adoita bloquear as conexións entrantes doutros dispositivos.
    • En macOS, permita o acceso á rede local se o sistema o pregunta. En Linux, permita ese mesmo porto para TCP e UDP.

  • Funcionou antes, pero cambiou o enderezo do PC

    • Non toque no token de emparellamento. Regenerate QR obriga a emparellar de novo cada lector.
    • Con ese porto UDP permitido, o Companion anuncia o seu novo enderezo e a conexión gardada actualízase. Se o porto está bloqueado, escanee o QR actual unha vez.
    • Unha rede diferente (oficina ou casa, ou unha VLAN nova) necesita un novo escaneo do QR.

  • A conexión cae cando a pantalla se apaga

    • O lector pausa a conexión Wi‑Fi mentres a pantalla está apagada. A notificación indica que a conexión está en pausa.
    • Active Keep screen on nos Settings do lector, ou acorde a pantalla para reconectar.
    • Conceda o permiso de notificacións se Android o pide. Sen el, o servizo do lector non pode seguir en execución.

  • Os escaneos quedan no dispositivo

    • Se o estado non é Connected, o escaneo queda en cola e envíase ao reconectar. Non se perde.
    • Se hai unha pantalla de validación ou contaxe aberta, o escaneo gárdase nesa sesión en lugar de escribirse.
    • Se o estado é Connected na páxina de inicio, faga clic nun campo de texto do PC e confirme que Type into focused window está activado.

  • Cambiou o porto

    • O porto está no QR. Aplíqueo nos Settings do Companion e despois escanee o novo QR.
    • Permita ese porto para TCP e UDP. Un lector que xa gardou este Companion aprende o novo porto co anuncio. Un lector que nunca o gardou segue emitindo no 17832, así que emparelle o primeiro escaneando o QR.
    • Outro programa xa vinculado ao porto impedirá que o Companion escoite. Escolla un porto libre por riba do 1024.

Aínda non funciona? Escriba a office@updruck.com indicando a versión do Companion (Settings do PC), a versión da app Android (Settings do lector), o enderezo seleccionado en Network e se o teléfono está na Wi‑Fi de convidados ou nunha VPN.