2D Code ScannerFAQ do leitor de códigos
Instalação, leitura e o que verificar quando o leitor não alcança o PC.
Primeiros passos
O que o 2D Code Scanner faz?
Ele envia códigos de barras de um leitor Android para um Companion de Windows ou macOS (Linux é experimental) na mesma rede local. O Companion digita cada código no campo que estiver em foco no PC, como um teclado em cunha.
Isso funciona como um keyboard wedge?
Sim. O Companion digita cada código no campo que está em foco no PC, do mesmo modo que um keyboard wedge. Você pode acrescentar Enter ou Tab depois de cada leitura.
Posso usar isto no lugar de um leitor de código de barras USB?
Sim. Um dispositivo Zebra ou o seu celular substitui um leitor USB separado. O Companion digita o código no campo em foco no Windows, no macOS ou no Linux experimental.
O que eu preciso instalar?
App Zebra ou app Camera?
Use o app que combina com o aparelho. Zebra e UrovoEm breve usam DataWedge. HoneywellEm breve usa Data Collection. NewlandEm breve usa NLScan. DatalogicEm breve usa Intent Wedge. Camera usa a câmera do celular.
UniversalEm breve usa o imager do fabricante quando esse leitor está instalado e, se não, a câmera.
Bluetooth não é usado.
Preciso de uma conta ou de uma assinatura?
Não. Não há conta na nuvem nem assinatura. Os códigos ficam no leitor e no PC. O link é criptografado na sua rede com AES-256-GCM.
Pareamento
Como pareio o leitor com o PC?
- Abra o Companion. Se a janela estiver oculta, ele ainda pode estar na bandeja.
- Mantenha o leitor e o PC na mesma rede local.
- Em um dispositivo Zebra, mire no QR e pressione o gatilho de hardware. No app Camera, toque em Scan.
- O leitor deve mostrar Connected.
Se o PC tiver mais de um adaptador de rede, abra no Companion Settings → Connection Wizard (ou o link Connection Wizard da tela inicial). O assistente recomenda um endereço de LAN, trata do firewall e lista leitores que aparecem quando você abre Connections no aparelho. Você também pode definir Network manualmente para o endereço que o leitor alcança, antes de ler o QR.
Preciso parear de novo toda vez?
Não. O pareamento fica salvo em Connections no leitor (toque na linha de conexão na tela inicial). O Companion mantém o mesmo token de pareamento quando você fecha e abre de novo, então o leitor reconecta sozinho.
Se o endereço do PC mudar na mesma rede, o Companion anuncia o novo endereço e a conexão salva é atualizada. Leia o QR de novo só quando o PC mudar de rede ou depois de gerar o QR outra vez.
Posso usar mais de um PC?
Sim. Leia o QR de cada Companion para salvá-lo. Você pode nomear uma conexão, trocar a ativa ou apagá-la em Connections.
O que Regenerate QR faz?
Cria um token de pareamento novo e desconecta todos os leitores. Cada aparelho precisa ler o QR novo antes de conectar de novo. Use isso para invalidar pareamentos antigos, não quando só o endereço IP mudou.
O leitor diz que o Companion é antigo demais
Instale o Companion 1.1.0 ou mais novo em Downloads, ou use Check for updates nos ajustes do Companion. Companions mais antigos são recusados e não reconectam até o app do PC ser atualizado.
Leitura
O código aparece no aparelho, mas nada é digitado no PC
Clique primeiro em um campo de texto. O Companion digita na janela em foco.
Nos Settings do Companion, deixe Type into focused window ligado. No leitor, Resend last scan envia o último código de novo quando o link está ativo.
Itens que batem em uma sessão aberta de validação ou contagem ficam no aparelho de propósito. Eles não são digitados no PC. Veja Sessões de inventário.
Se o status não for Connected, a leitura fica na fila e é enviada quando o link volta. Comece por Problemas de rede se nunca conectar.
Como envio Enter ou Tab depois de cada leitura?
No leitor, abra Settings e defina After each scan como Enter, Tab ou None. Enter é o padrão.
Quais códigos de barras são aceitos?
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.
Em um dispositivo Zebra, a simbologia também precisa estar ativada no DataWedge. O app Camera lê o que o leitor do aparelho consegue decodificar a partir da imagem da câmera.
O gatilho do Zebra não faz nada
A primeira abertura cria um perfil do DataWedge chamado 2DCodeScanner (entrada de código de barras, saída por intent para este app, saída por teclado desligada). Confirme que esse perfil existe e está associado a este app.
Este app precisa de um dispositivo Zebra com DataWedge. Outras marcas Android e o app Camera não usam esse perfil.
O app Camera não lê
Conceda a permissão da câmera quando o Android pedir e depois toque em Scan. A permissão de notificação também é necessária para o leitor continuar em segundo plano.
Sessões de inventário
O que é uma sessão de validação?
Uma lista dos códigos esperados. Crie no leitor ou no Companion em Tools → Validation e envie para o leitor. Leituras que coincidem marcam os itens. Elas não são digitadas no PC.
Quando todos os itens estão marcados, a sessão termina. Reset / undo no aparelho limpa as marcas para você ler a lista de novo. Return to building limpa as marcas e permite incluir ou remover códigos.
O que é uma sessão de contagem?
Uma contagem de quantidades. Crie no leitor (Sessions → Counting) ou no Companion (Tools → Counting), abra no aparelho e leia. As quantidades sincronizam de volta para o Companion. O Companion pode copiar a contagem como TSV.
Por que uma leitura ficou no aparelho durante uma sessão?
Enquanto a tela de detalhe de validação ou contagem está aberta, as leituras pertencem a essa sessão. Saia da sessão para digitar códigos comuns no campo em foco do PC.
Problemas de rede
O leitor e o Companion só conversam na sua rede local. Eles não usam internet, Bluetooth nem um relay na nuvem. Um celular que abre a web ainda pode falhar em alcançar o PC quando o Wi‑Fi de visitante, o isolamento de clientes, uma VPN ou o firewall bloqueia o tráfego entre aparelhos.
Confira nesta ordem
- O Companion está mesmo em execução
Fechar a janela o esconde na bandeja quando Close to tray está ligado. Assim ele ainda aceita leitores. Quit no ícone da bandeja encerra o app.
- Os dois aparelhos estão na mesma rede local
O leitor usa Wi‑Fi. O PC pode estar nesse mesmo Wi‑Fi ou na Ethernet da mesma LAN. Redes de visitante, hotspots públicos e access points com isolamento de clientes impedem que os aparelhos se vejam, mesmo quando os dois têm internet.
- O QR usa um endereço que o leitor alcança
No Companion, Settings → Network lista os endereços de LAN do PC. Escolha o Wi‑Fi ou a Ethernet do escritório (muitas vezes
192.168…ou10…). Ignore adaptadores de VPN, máquina virtual e hipervisor. Ou use o Connection Wizard — os adaptadores recomendados vêm marcados, e o leitor deve aparecer na lista quando Connections está aberto. Leia o QR de novo depois de mudar isso. - O firewall permite o Companion
Permita entrada em TCP e UDP 17832 (ou a porta definida em Settings → Port). O TCP carrega a conexão. O UDP nessa mesma porta é como um leitor salvo fica sabendo do novo endereço do PC quando o DHCP muda, e como o Companion vê o leitor no Connection Wizard.
- Leia o QR atual
Faça isso depois de mudar a rede, a porta ou a LAN do PC. Você não precisa de um QR novo só porque o IP mudou na mesma rede.
Se ainda falhar
O status fica em Connecting ou Not connected
- Desligue VPNs no celular e no PC e leia o QR de novo. Uma VPN costuma esconder o endereço de LAN do PC.
- Saia do Wi‑Fi de visitante. Use uma LAN privada em que celulares e PCs se alcancem.
- Para testar os apps sem a rede do escritório, coloque o PC no hotspot do celular leitor (ou os dois em um roteador de viagem pequeno) e leia o QR ali.
- No Windows, permita o Companion em redes Private. Uma rede marcada como Public costuma bloquear conexões de entrada de outros aparelhos.
- No macOS, permita o acesso à rede local se o sistema pedir. No Linux, permita essa mesma porta para TCP e UDP.
Funcionava e depois o endereço do PC mudou
- Não mexa no token de pareamento. Regenerate QR obriga todo leitor a parear de novo.
- Com essa porta UDP permitida, o Companion anuncia o novo endereço e a conexão salva é atualizada. Se a porta estiver bloqueada, leia o QR atual uma vez.
- Outra rede (escritório ou casa, ou uma VLAN nova) precisa de uma leitura nova do QR.
O link cai quando a tela apaga
- O leitor pausa o link Wi‑Fi enquanto a tela está desligada. A notificação diz que o link está pausado.
- Ative Keep screen on nos ajustes do leitor ou acorde a tela para reconectar.
- Conceda a permissão de notificação se o Android pedir. Sem ela, o serviço do leitor não continua em execução.
As leituras ficam no aparelho
- Se o status não for Connected, a leitura fica na fila e é enviada depois de reconectar. Ela não se perde.
- Se uma tela de validação ou contagem estiver aberta, a leitura fica nessa sessão em vez de ser digitada.
- Se o status for Connected na tela inicial, clique em um campo de texto do PC e confirme que Type into focused window está ligado.
Você mudou a porta
- A porta está no QR. Aplique nos ajustes do Companion e leia o QR novo.
- Permita essa porta para TCP e UDP. Um leitor que já salvou este Companion aprende a nova porta pelo anúncio. Um que nunca o salvou continua no 17832: pareie esse primeiro lendo o QR.
- Outro programa já ligado a essa porta impede o Companion de escutar. Escolha uma porta livre acima de 1024.
Ainda travou? Escreva para office@updruck.com com a versão do Companion (ajustes do PC), a versão do app Android (ajustes do leitor), o endereço escolhido em Network e se o celular está em Wi‑Fi de visitante ou em uma VPN.