2D Code ScannerFAQ do leitor de códigos de barras
Configuração, leitura e o que verificar quando o leitor não consegue chegar ao PC.
Primeiros passos
O que faz o 2D Code Scanner?
Envia códigos de barras de um leitor Android para um Companion em Windows ou macOS (o Linux é experimental) na mesma rede local. O Companion escreve cada código no campo que estiver em foco no PC, como um keyboard wedge.
Funciona como um keyboard wedge?
Sim. O Companion escreve cada código de barras no campo que estiver em foco no PC, tal como faria um keyboard wedge. Pode acrescentar Enter ou Tab depois de cada leitura.
Posso usar isto em vez de um leitor de códigos de barras USB?
Sim. Um dispositivo Zebra ou o seu telemóvel ocupa o lugar de um leitor USB separado. O Companion escreve o código no campo em foco no Windows, no macOS ou no Linux experimental.
O que preciso de instalar?
Aplicação Zebra ou aplicação Camera?
Use a aplicação que corresponde ao dispositivo. Zebra e UrovoEm breve usam DataWedge. HoneywellEm breve usa Data Collection. NewlandEm breve usa NLScan. DatalogicEm breve usa Intent Wedge. Camera usa a câmara do telemóvel.
UniversalEm breve usa o imager do fabricante quando esse leitor está instalado e, caso contrário, a câmara.
O Bluetooth não é utilizado.
Preciso de uma conta ou de uma subscrição?
Não. Não há conta na nuvem nem subscrição. Os códigos de barras ficam no leitor e no PC. A ligação é cifrada na sua rede com AES-256-GCM.
Emparelhamento
Como emparelho o leitor com o PC?
- Abra o Companion. Se a janela estiver oculta, pode continuar na área de notificação.
- Mantenha o leitor e o PC na mesma rede local.
- Num dispositivo Zebra, aponte ao QR e prima o gatilho físico. Na aplicação Camera, toque em Scan.
- O leitor deve mostrar Connected.
Se o PC tiver mais do que um adaptador de rede, abra Settings → Connection Wizard no Companion (ou a ligação Connection Wizard no ecrã inicial). O assistente recomenda um endereço de LAN, trata da firewall e lista os leitores que aparecem quando abre Connections no dispositivo. Também pode definir Network manualmente para o endereço a que o leitor consegue chegar antes de ler o QR.
Tenho de emparelhar de novo de cada vez?
Não. O emparelhamento fica guardado em Connections no leitor (toque na linha de ligação no ecrã inicial). O Companion mantém o mesmo token de emparelhamento quando o fecha e volta a abrir, por isso o leitor volta a ligar-se sozinho.
Se o endereço do PC mudar na mesma rede, o Companion anuncia o novo endereço e a ligação guardada é atualizada. Só tem de ler o QR de novo quando o PC passou para outra rede ou depois de regenerar o QR.
Posso usar mais do que um PC?
Sim. Leia o QR de cada Companion para o guardar. Pode dar um nome a uma ligação, mudar a ativa ou eliminá-la em Connections.
O que faz Regenerate QR?
Cria um novo token de emparelhamento e desliga todos os leitores. Cada dispositivo tem de ler o novo QR antes de poder voltar a ligar-se. Use-o quando quiser invalidar emparelhamentos antigos, não quando o endereço IP apenas mudou.
O leitor diz que o Companion é demasiado antigo
Instale o Companion 1.1.0 ou superior a partir de Transferências ou use Check for updates nas definições do Companion. Os Companions mais antigos são rejeitados e não voltam a ligar-se até a aplicação do PC ser atualizada.
Leitura
O código aparece no dispositivo, mas nada é escrito no PC
Clique primeiro num campo de texto. O Companion escreve na janela em foco.
Nas Settings do Companion, deixe Type into focused window ativado. No leitor, Resend last scan volta a enviar o último código assim que a ligação estiver ativa.
Os itens correspondentes numa sessão de validação ou de contagem aberta ficam no dispositivo de propósito. Não são escritos no PC. Consulte Sessões de inventário.
Se o estado não for Connected, a leitura fica em fila e é enviada quando a ligação regressar. Comece por Resolução de problemas de rede se nunca ligar.
Como envio Enter ou Tab depois de cada leitura?
No leitor, abra Settings e defina After each scan como Enter, Tab ou None. Enter é a predefinição.
Que códigos de barras são suportados?
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.
Num dispositivo Zebra, a simbologia também tem de estar ativada no DataWedge. A aplicação Camera lê o que o leitor do dispositivo consegue descodificar a partir da imagem da câmara.
O gatilho da Zebra não faz nada
O primeiro arranque cria um perfil DataWedge chamado 2DCodeScanner (entrada de código de barras, saída por intent para esta aplicação, saída de teclas desativada). Confirme que esse perfil existe e está associado a esta aplicação.
Esta aplicação precisa de um dispositivo Zebra com DataWedge. Outras marcas Android e a aplicação Camera não usam esse perfil.
A aplicação Camera não lê
Conceda a permissão da câmara quando o Android pedir e depois toque em Scan. A permissão de notificações também é necessária para que o leitor possa continuar a funcionar em segundo plano.
Sessões de inventário
O que é uma sessão de validação?
Uma lista de verificação de códigos de barras esperados. Crie-a no leitor ou no Companion, em Tools → Validation, e envie-a para o leitor. As leituras correspondentes assinalam os itens. Não são escritas no PC.
Quando todos os itens estão assinalados, a sessão está concluída. Reset / undo no dispositivo limpa as marcas para poder ler a lista de novo. Return to building limpa as marcas e permite acrescentar ou remover códigos.
O que é uma sessão de contagem?
Uma contagem de quantidades. Crie-a no leitor (Sessions → Counting) ou no Companion (Tools → Counting), abra-a depois no dispositivo e leia. As quantidades sincronizam de volta para o Companion. O Companion pode copiar a contagem como TSV.
Porque é que uma leitura ficou no dispositivo durante uma sessão?
Enquanto um ecrã de detalhe de validação ou de contagem está aberto, as leituras pertencem a essa sessão. Saia da sessão para escrever códigos de barras normais no campo em foco do PC.
Resolução de problemas de rede
O leitor e o Companion comunicam apenas na sua rede local. Não usam a Internet, o Bluetooth nem um relay na nuvem. Um telemóvel que consegue navegar na Web pode, ainda assim, não chegar ao PC quando uma rede Wi‑Fi de convidados, o isolamento de clientes, uma VPN ou a firewall bloqueiam o tráfego entre dispositivos.
Verifique por esta ordem
- O Companion está realmente em execução
Fechar a janela oculta-a na área de notificação quando Close to tray está ativado. Isso continua a aceitar leitores. Quit no ícone da área de notificação sai da aplicação.
- Os dois dispositivos estão na mesma rede local
O leitor usa Wi‑Fi. O PC pode estar nessa mesma rede Wi‑Fi ou em Ethernet na mesma LAN. Redes de convidados, hotspots públicos e pontos de acesso com isolamento de clientes impedem que os dispositivos se vejam, mesmo que ambos tenham Internet.
- O QR usa um endereço a que o leitor consegue chegar
Em Settings → Network no Companion, são listados os endereços de LAN do PC. Escolha o endereço do Wi‑Fi do escritório ou da Ethernet (muitas vezes
192.168…ou10…). Ignore os adaptadores de VPN, de máquina virtual e de hipervisor. Ou use Connection Wizard — os adaptadores recomendados estão assinalados e o seu leitor deve aparecer na lista quando Connections está aberto ou o fluxo de boas-vindas está no passo de ligação. Leia o QR de novo depois de alterar isto. - A firewall permite o Companion
Permita a entrada em TCP e UDP 17832 (ou na porta que definiu em Settings → Port). O TCP transporta a ligação. O UDP nessa mesma porta é como um leitor guardado descobre um novo endereço do PC depois de o DHCP o alterar e como o Companion vê o leitor no Connection Wizard.
- Leia o QR atual
Faça-o depois de alterar a rede, a porta ou a LAN do PC. Não precisa de um novo QR só porque o IP mudou na mesma rede.
Se continuar a falhar
O estado fica em Connecting ou Not connected
- Desative as VPN no telemóvel e no PC e leia o QR de novo. Uma VPN muitas vezes oculta o endereço de LAN do PC.
- Saia da rede Wi‑Fi de convidados. Use uma LAN privada onde os telemóveis e os PC se alcancem mutuamente.
- Para testar as aplicações sem a rede do escritório, ligue o PC ao hotspot do telemóvel leitor (ou coloque ambos num pequeno router de viagem) e leia o QR aí.
- No Windows, permita o Companion em redes Private. Uma rede marcada como Public bloqueia muitas vezes as ligações de entrada vindas de outros dispositivos.
- No macOS, permita o acesso à rede local se o sistema perguntar. No Linux, permita essa mesma porta para TCP e UDP.
Funcionava antes, depois o endereço do PC mudou
- Deixe o token de emparelhamento em paz. Regenerate QR obriga todos os leitores a emparelhar de novo.
- Com essa porta UDP permitida, o Companion anuncia o novo endereço e a ligação guardada é atualizada. Se a porta estiver bloqueada, leia o QR atual uma vez.
- Uma rede diferente (escritório vs. casa, ou uma nova VLAN) precisa de uma nova leitura do QR.
A ligação cai quando o ecrã se apaga
- O leitor coloca a ligação Wi‑Fi em pausa enquanto o ecrã está apagado. A notificação indica que a ligação está em pausa.
- Ative Keep screen on nas Settings do leitor ou acorde o ecrã para voltar a ligar.
- Conceda a permissão de notificações se o Android pedir. Sem ela, o serviço do leitor não consegue manter-se em execução.
As leituras ficam no dispositivo
- Se o estado não for Connected, a leitura fica em fila e é enviada após a nova ligação. Não se perde.
- Se um ecrã de validação ou de contagem estiver aberto, a leitura é guardada nessa sessão em vez de ser escrita.
- Se o estado for Connected no ecrã inicial, clique num campo de texto do PC e confirme que Type into focused window está ativado.
Alterou a porta
- A porta está no QR. Aplique-a nas definições do Companion e leia o novo QR.
- Permita essa porta para TCP e UDP. Um leitor que já guardou este Companion aprende a nova porta através do anúncio. Um leitor que nunca o guardou continua a emitir na 17832, por isso emparelhe esse primeiro lendo o QR.
- Outro programa já ligado à porta impede o Companion de escutar. Escolha uma porta livre acima de 1024.
Continua com problemas? Envie um e-mail para office@updruck.com com a versão do Companion (Settings do PC), a versão da aplicação Android (Settings do leitor), o endereço selecionado em Network e se o telemóvel está numa rede Wi‑Fi de convidados ou numa VPN.