Integre uma impressora Zebra

Saiba como configurar o driver da impressora Zebra e acionar novos trabalhos de impressão a partir de aplicativos de operações de linha de frente.

Neste artigo, você aprenderá…

• Como configurar o driver da impressora Zebra pelo Portal de Dispositivos
• Como adicionar valores dinâmicos às suas etiquetas de impressão no Tulip
• Como usar gatilhos para imprimir trabalhos nos aplicativos do Tulip

Você tem uma estação de expedição ou embalagem em sua linha de produção? Você consegue imprimir etiquetas personalizadas em tempo real, à medida que os produtos ficam prontos para serem embalados e enviados?

Você pode usar uma impressora Zebra para criar etiquetas de remessa em tempo real com dados dinâmicos dos aplicativos do Tulip.

Este guia ajudará você a conectar sua impressora Zebra ao Edge Device e a criar um aplicativo simples que recebe as informações do usuário e gera uma etiqueta personalizada.

Recursos e requisitos

As impressoras Zebra podem ser acionadas diretamente do Tulip de algumas maneiras diferentes, dependendo do tipo de dispositivo que executa o Tulip Player e dos recursos da impressora. Veja abaixo uma tabela comparativa:

As impressoras Zebra em rede podem ser integradas ao Tulip por meio do driver de impressora de rede Zebra (para o Windows Player) ou do driver de impressora Zebra (para dispositivos de ponta do Tulip). As impressoras Zebra compatíveis com RS-232 podem ser integradas, por sua vez, por meio do driver Serial (somente para o Player) (para o Windows Player) ou do driver Serial genérico (para dispositivos de ponta da Tulip).

Os dispositivos Tulip Edge também podem se conectar a impressoras Zebra via RS-232 usando o Node-RED, proporcionando maior flexibilidade para usuários mais avançados.

Por fim, todos os métodos de conexão listados aqui podem acomodar qualquer número de impressoras Zebra, sendo a única restrição a disponibilidade de portas de hardware no caso da comunicação RS-232.

Conectando sua impressora Zebra a um dispositivo Edge

Primeiro, você precisa do endereço IP da impressora. Para obtê-lo, é necessário imprimir um cartão de rede que inclua o endereço IP da impressora.

A maneira mais fácil de fazer isso é pressionar e manter pressionado o botão da impressora Zebra até que o LED pisque uma vez; em seguida, solte-o. Ela imprimirá uma série de etiquetas.

Se a etiqueta superior 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 aceitará isso! Você precisa remover os zeros à esquerda — por exemplo, 010.128.000.005 passa a ser 10.128.0.5

Se isso não funcionar, siga estas instruções para obter uma placa de rede.

Em ambos os casos, ficará mais ou menos assim:

Em seguida, faça login no Portal de Dispositivos no seu computador e selecione a opção “Drivers” no menu à esquerda.

Em seguida, selecione a impressora Zebra na lista de drivers e at ive o botão.

Métodos de conexão

Ao conectar sua impressora Zebra, o único fator a ser considerado é a porta na qual você a está conectando.

RJ-45

Use esse tipo de conexão para comunicação em rede. Você pode fazer isso com:

1. Driver de impressora de rede Zebra — do Player: um método fácil de usar, pois você pode fazer toda a configuração ZPL no Trigger Editor. Não é necessária a configuração do dispositivo. Qualquer Player na mesma rede pode acessar qualquer impressora, o que facilita a troca ou o acesso ao dispositivo à distância.

Observe que, dependendo das configurações de DHCP do local, a conexão pode ser interrompida se o endereço IP for alterado. Por isso, recomendamos definir um IP estático ou verificar regularmente a configuração de IP.

1. Driver de impressora Zebra – a partir de dispositivos de borda: o uso da porta LAN nos dispositivos de borda facilita a identificação do IP da impressora, e esse IP é efetivamente estático, ou seja, não muda. Esse método requer modelos pré-definidos na configuração do driver. As entradas que você digita no aplicativo são uma única sequência de caracteres, separada pelo caractere de barra vertical. Por exemplo: var1|var2|var3

Esse método de conexão pode falhar quando:

• O endereço IP da impressora mudar
• O endereço IP for inserido com zeros à esquerda
• A impressora estiver conectada à WAN, e não à LAN (somente em dispositivos de borda)
• A impressora não estiver acessível pelo dispositivo que está enviando a mensagem de rede (por exemplo, eles estão em redes diferentes, mas estão tentando usar um IP local)

DB9

Use esse tipo de conexão para comunicação RS-232. Isso pode ser feito por meio do:

1. Driver do Player (somente serial). Ele aparecerá como um dispositivo COM no seu computador Windows. Toda configuração, alteração e gravação de zcode ocorre no Editor de Gatilhos.
2. Driver serial genérico (de dispositivos Edge) Toda a configuração deve ser feita na página “Driver Config” do dispositivo.
3. Node-RED: isso permite o máximo de flexibilidade.

Esse método de conexão pode falhar quando:

• Você alterar a porta na qual a impressora está conectada em relação à porta originalmente especificada
• Você enviar uma string nula. Por exemplo, se houver alguma variável nula na sua expressão, toda a expressão será compilada como nula. O Tulip não exibirá um erro, mas a impressora não imprimirá nada.
• Sua expressão contiver uma quebra de linha, por exemplo, ao pressionar Enter ou colar um código ZPL de várias linhas. O Tulip não exibirá um erro, mas a impressora não imprimirá nada.

USB

Esse método de conexão é para comunicação com computadores e requer drivers. Você só deve usá-lo para configurar a impressão de etiquetas.

Configurando o driver da impressora Zebra

Primeiro, adicione o endereço IP da sua impressora na caixa de texto apropriada. Se o endereço IP contiver zeros à esquerda, ou seja, 000, você deve reduzi-los a um único zero.

Por exemplo, o endereço IP acima era, na verdade, 010.000.000.224.

Em seguida, clique no botão + ao lado da etiqueta zplTemplates para personalizar o driver. Se você quiser imprimir vários tipos de etiquetas, será necessário criar vários modelos.

Em seguida, você verá duas seções: 1. nome do modelo 2. dados

A seção**“Dados** ” terá um subcampo chamado “código zpl”.

Para continuar, você precisa adicionar o código ZPL da etiqueta que deseja produzir. Se precisar aprender a escrever código ZPL, consulte a documentação do Tulip.

Se você quiser incluir variáveis dos aplicativos da Tulip no código ZPL, deve adicionar vários campos de código ZPL. Você precisará dividir o código de acordo com o local onde deseja inserir as variáveis da Tulip.

Por exemplo, imagine que você queira criar a seguinte etiqueta.

Ela possui dois campos personalizados: 1. um título “Olá?”; 2. um valor personalizado de código de barras.

Para permitir que os valores das variáveis do Tulip sejam inseridos nessas áreas do código de barras, você deve dividir o código em três campos de código ZPL separados.

Veja como isso fica no Tulip:

Entre cada campo de código ZPL, você poderá adicionar um valor de variável no Editor do App. O último campo contém ^XZ, o que indica o fim do script.

Se você quiser experimentar valores diferentes no seu código ZPL, recomendamos o Labelary. Ele possui um editor de texto para editar ZPL. Certifique-se de que o valor de pontos por polegada (DPI) corresponda ao valor da sua impressora.

Aqui está um exemplo do Labelary mostrando o texto “Hello?” no lugar de um valor de variável do Tulip.

No exemplo acima, se você estiver usando “Hello?” como o primeiro valor de variável do Tulip, copie todo o código antes de “Hello?” para o primeiro campo de código ZPL.

Clique em “Salvar” na página do driver da impressora Zebra no Portal de Dispositivos e, então, você estará pronto para configurar sua lógica de impressão em um aplicativo.

Além disso, você também pode usar o software ZebraDesigner 3 para criar suas etiquetas de maneira muito simples. Esse software gera automaticamente o código ZPL para o seu projeto, e você pode copiá-lo e colá-lo diretamente no seu aplicativo Tulip. No momento, esse software da Zebra está disponível apenas para dispositivos Windows. Você precisará baixar o ZebraDesigner 3 e também o driver adequado para a impressora que pretende usar. Salve a etiqueta criada e abra-a no Bloco de Notas para copiar o código ZPL nos gatilhos do Tulip.

Imprimindo uma etiqueta a partir de um aplicativo

Vamos criar um aplicativo de teste rápido que exija que um operador adicione dois valores personalizados por meio de uma etapa de formulário e, em seguida, os imprima em uma etiqueta pré-configurada. Lembrete: isso significa que seu driver da Zebra deve ter três campos de código ZPL.

Crie um novo aplicativo e, em seguida, crie uma etapa de formulário com dois campos: 1. nome 2. número

Ambos devem ser campos de texto. Salve esses campos também em variáveis chamadas “nome” e “número”.

Em seguida, adicione uma etapa com texto variável para cada um desses dois campos e um botão chamado “Imprimir”.

Crie um gatilho que seja acionado quando o botão for pressionado. A instrução “Then” deve começar assim:

• "Executar função do dispositivo"
• "Impressora Zebra"
• "Modelo personalizado"
• "Nesta estação."

Como o Tulip se comunicará com a impressora Zebra por meio do driver em execução no Portal de Dispositivos, você deve conectar o dispositivo Edge à mesma estação em que o aplicativo de teste está sendo executado na guia “Chão de fábrica ”.

Em seguida, na mesma instrução “then”, você verá esta linha:

Nesse caso, você está acessando um modelo ZPL chamado “kevin Demo”. Aqui está a última linha da instrução:

Essa é a linha onde você adicionará todos os valores personalizados do aplicativo por meio da opção de texto estático. É preciso incluir um operador de barra vertical “|” entre cada valor e adicioná-los na ordem em que deseja que sejam inseridos no código ZPL.

Nesse caso, você adicionaria:

variable.name | variable.number

Isso significa que o valor da variável “name” seria inserido entre os dois primeiros campos do código ZPL, e o valor da variável “number” seria inserido entre o segundo e o terceiro campos do código ZPL.

Veja como fica o código ZPL:

Agora é hora de testar o aplicativo. Para isso, você precisa publicar a versão mais recente do aplicativo, pois é essa que será executada na Station.

Após publicar o aplicativo, abra-o no Tulip Player e preencha o formulário. Verifique se ambos os campos aparecem como texto variável na etapa seguinte e, em seguida, pressione “Imprimir”. Sua etiqueta deve ser impressa imediatamente na impressora Zebra.

Solução de problemas do processo

Se sua etiqueta não for impressa imediatamente, aqui estão algumas coisas que você pode verificar:

1. A impressora Zebra está conectada à mesma rede que o dispositivo Edge via Ethernet?
2. Você criou uma Estação na qual tanto o Dispositivo Edge quanto o aplicativo estejam em execução?
3. Seus valores personalizados correspondem aos espaços em branco no código ZPL em execução no driver?

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á enfrentaram um problema semelhante!