Solução de problemas em impressoras Zebra com o Tulip

Entenda os problemas comuns com impressoras Zebra ao trabalhar com o Tulip.

Processo de depuração

É importante determinar o que está e o que não está funcionando. Primeiro, identifique qual método/driver está sendo usado.

Serial

Player

1. Abra o Console do Desenvolvedor no Player.
2. Se houver, verifique se o gatilho “Conectar Serial” é acionado com sucesso. a. Se não conectar, é provável que sua porta COM esteja incorreta.
3. Tente enviar um comando de impressão. a. Se nada for impresso, mas nenhum erro for enviado, seu zcode está incorreto. b. Se nada for impresso e um erro for enviado, verifique o erro.

Dispositivo de borda (não Node-RED)

1. Verifique os logs do dispositivo.
2. Usando o menu no canto superior esquerdo, filtre por “tulip-cell” para facilitar a leitura.
3. Procure por erros que incluam “serial” ou “generic-serial”

Dispositivo Edge no Node-RED

1. Certifique-se de que a impressora esteja/estivesse ligada antes do Node-RED iniciar. Caso contrário, desligue e ligue novamente o Node-RED pela página de configuração do dispositivo.
2. Confirme se há um caminho /dev/ttyUSB listado na lista suspensa de portas disponíveis do nó serial. A menos que você esteja usando a porta RS232 no EIO, use uma das portas /dev/ttyS
3. Confirme se o nó Serial está indicando que está conectado.
4. Observe o que o nó Serial exibe no painel de depuração. a. Se houver um tempo limite (timeout), a impressora não estava ligada e conectada quando o Node-RED foi executado. Reinicie o Node-RED.
5. Se não houver erro, seu zcode está incorreto.

Rede

Player

1. Confirme se o endereço IP da impressora está correto usando um dos métodos listados na seção de perguntas frequentes: Qual é o endereço IP da minha impressora?a. Lembre-se! Se você obtiver o endereço IP por meio da etiqueta de configuração, a impressora imprimirá cada byte do endereço como três caracteres — por exemplo, 010.001.002.003. O Tulip não aceita isso! Remova os zeros à esquerda: 10.1.2.3.
2. Observe o console de desenvolvimento. Se nenhum erro for exibido, seu código Z está incorreto.

Ao se conectar pela primeira vez à sua impressora Zebra, tente fazer uma impressão simples para garantir que você também não esteja enfrentando erros de ZPL. Como este comando:

Se você receber um erro como este, verifique o painel do console de desenvolvimento — um tempo limite esgotado indica que você provavelmente está com o endereço IP errado ou que seu Player não está na mesma rede que a impressora.

Se você ainda estiver enfrentando problemas e puder acessar seu terminal, execute “ping (insira o endereço IP aqui)>”.

Dispositivo Edge

1. Certifique-se de que o dispositivo Edge esteja online, que o gatilho esteja configurado para o dispositivo/estação correta, etc.
2. Certifique-se de que o dispositivo Edge esteja conectado à impressora apenas pela porta LAN! a. Sempre que um dispositivo Edge tiver algo conectado à porta WAN, ele tentará se conectar à internet por essa conexão, mesmo que também tenha o Wi-Fi configurado!
3. Confirme se o endereço IP da impressora está correto usando um dos métodos listados nas Perguntas Frequentes: (Qual é o endereço IP da minha impressora?) a. Lembre-se! Se você obtiver o endereço IP por meio da etiqueta de configuração, a impressora imprimirá cada byte do endereço como três caracteres — por exemplo, 010.001.002.003. O Tulip não aceita isso! Remova os zeros à esquerda: 10.1.2.3.
4. Verifique os logs do dispositivo em busca de erros. Filtre por “tulip-cell ” usando o menu suspenso e procure por “zebra”.

Perguntas frequentes

Qual é o endereço IP da minha impressora?

• QUALQUER DRIVER: Imprima uma etiqueta de configuração. O endereço está na parte superior.
• Mantenha pressionado o botão da impressora Zebra até que o LED pisque uma vez; em seguida, solte-o. Ela imprimirá uma sequência de etiquetas.
• Se a etiqueta mais acima não especificar um endereço IP, a impressora Zebra ainda não está conectada à rede. Se ela tiver sido ligada recentemente, aguarde um segundo para que ela inicialize. Se já estiver ligada há algum tempo, verifique a conexão
• Cuidado! Essa etiqueta incluirá zeros à esquerda no endereço IP para que cada byte tenha três caracteres. O Tulip não aceita isso! Você precisa remover os zeros à esquerda — por exemplo, 010.128.000.005 passa a ser 10.128.0.5
• WINDOWS, SOMENTE LAN: Execute o comando ipconfig no seu terminal para ver o endereço IP.
• DISPOSITIVO DE BORDA: Verifique a seção “Locações DHCP” na página “Diagnósticos” do portal de configuração do seu dispositivo de borda. Confirme se ele está conectado à LAN; nesse caso, o endereço será 10.0.5.X.

Qual é o número da porta serial/caminho da minha impressora?

• WINDOWS: Clique com o botão direito do mouse em “Iniciar” e selecione “Gerenciador de Dispositivos”. Expanda a seção “Dispositivos COM ” e localize-a entre os itens listados.
• Faça com que o Tulip encontre automaticamente o número da porta usando a técnica descrita nesta publicação da comunidade!
• DISPOSITIVO DE BORDA: É /dev/ttyUSB$, onde $ é o número sequencial em que ele foi conectado, com indexação a partir de 0.
• Por exemplo, se for o primeiro conectado, será …USB0
• Lembre-se! Com o Node-RED, a impressora deve estar conectada e ligada antes que o Node-RED seja iniciado. Acione a chave no portal de configuração do dispositivo para reiniciar o Node-RED.

Tenho o endereço IP e a porta COM corretos, mas nada está saindo da impressora?

Certifique-se de que o código ZPL esteja válido. Para verificar isso, basta colá-lo no Labelary. Se ele não compilar, seu código está incorreto.

Observe que um ZPL válido pode falhar silenciosamente se sua expressão contiver uma quebra de linha, por exemplo: ao pressionar Enter ou colar um ZPL com várias linhas. Remova todas as quebras de linha para que o ZPL seja uma sequência única e contínua.

Por que minha etiqueta está sendo impressa descentrada?

A impressora está configurada para um tamanho de etiqueta diferente do que ela realmente possui, portanto, sua suposição sobre a “origem” (canto superior esquerdo da etiqueta) está incorreta.

Você pode corrigir isso no zcode com comandos do tipo “deslocar tudo para a esquerda”, como ^LH, mas esse não é um método sustentável nem responsável, pois só corrigirá aquela etiqueta específica. Além disso, esse deslocamento permanecerá na impressora até que ela seja reiniciada — portanto, você pode comprometer outras etiquetas!

A maneira correta de resolver isso é baixar o Zebra Setup Utility, conectá-lo à impressora via USB e usar o utilitário para definir o tamanho correto da etiqueta. Você também pode usar o utilitário para imprimir uma página de configuração e confirmar se as alterações foram aplicadas.

Por que as luzes da minha impressora estão piscando?

• Luz verde piscando: a impressora precisa se calibrar. Pressione o botão uma vez.
• Luz vermelha piscando: há um problema, como um atolamento de papel ou falta de papel.

Acho que meu zcode está errado, mas não sei qual é?

A maneira mais fácil de fazer isso é depurar seu gatilho, investigando a ação do gatilho registrada para ver o que realmente está sendo enviado como mensagem zcode. Observe que isso provavelmente não inclui as informações do modelo salvas na configuração do dispositivo; portanto, para isso, você precisa colá-las no Labelary.

Se você tiver alguma variável na sua mensagem (por exemplo, usando métodos seriais para enviar uma expressão), certifique-se de que elas não sejam nulas! Qualquer variável nula em uma expressão torna toda a mensagem nula. Você não consegue ver isso a menos que imprima a expressão em outro lugar ou examine o gatilho no painel de depuração.

Trabalhando com etiquetas

Observe que existem dois tipos diferentes de etiquetas. Uma impressora de um tipo não será capaz de imprimir no outro — as etiquetas sairão em branco!

Impressão térmica direta

Sua impressora é do tipo térmica direta se o único componente interno for um rolo de etiquetas. Suas etiquetas são do tipo térmica direta se começarem a ficar pretas quando o calor é aplicado. A impressora aplica calor à etiqueta, e a tinta reativa fica preta para formar uma imagem. Não é necessário nenhum “material” extra para servir de tinta, apenas a etiqueta.

Impressão por transferência térmica

Sua impressora é do tipo de transferência se houver dois rolos dentro dela: a fita e as etiquetas. Suas etiquetas são do tipo de transferência se não reagirem ao calor aplicado.

Você encontrou o que estava procurando?

Você também pode acessar community.tulip.co para postar sua dúvida ou ver se outras pessoas já tiveram uma dúvida semelhante!