--- title: "Driver Banner PTL" slug: "how-to-use-the-banner-ptl-driver" updated: 2026-10-22T12:50:46Z published: 2026-10-22T12:50:46Z canonical: "support.tulip.co/how-to-use-the-banner-ptl-driver" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Driver Banner PTL ## Utilizando o Driver Banner PTL *Um guia para o driver Banner Pick-to-Light (PTL) para o Tulip* Este artigo descreve os recursos e a configuração associados ao driver Banner PTL no Tulip. Note This driver will only be available for Player 2.8.0 and above. Please reach out to developer@tulip.co to put this on your instance. ## Visão geral Neste artigo, vamos nos concentrar na conexão entre o Tulip e um dispositivo PTL da Banner. Abordaremos como configurar a conexão e, em seguida, exploraremos os recursos do driver, como alterar as cores das luzes, exibir mensagens de texto em vários modos e controlar animações de luz. Você precisará ter o dispositivo PTL conectado ao seu PC com Windows e o sinalizador de recurso apropriado ativado na sua instância do Tulip. --- ## Configuração Para configurar seu dispositivo Banner PTL para uso com o Tulip, siga as etapas abaixo. ### Pré-requisitos 1. **Conecte o dispositivo**: conecte seu dispositivo Banner PTL ao seu PC com Windows, normalmente via USB ou por meio de uma conexão serial que forneça uma porta COM. 2. **Configuração do Windows**: Certifique-se de que seu PC com Windows consiga reconhecer o dispositivo PTL conectado e atribua a ele uma porta COM. ### Configuração do Tulip Player A conexão e a configuração do dispositivo Banner PTL são gerenciadas pelo Tulip Player, geralmente dentro de um aplicativo dedicado ao teste de drivers. 1. **Acesse o driver do Banner PTL**: - Abra o Tulip Player. - Acesse o “Driver Unit tests app” ou um aplicativo semelhante que contenha a “página do driver do Player”. - Clique no botão “BannerPTL” ou acesse a seção correspondente. 2. **Identifique a porta COM**: - Clique no botão **“Listar dispositivos seriais** ”. Isso consultará o sistema e exibirá as portas COM disponíveis. - Identifique a porta COM correspondente ao seu dispositivo Banner PTL conectado. ![Screenshot 2025-05-28 at 11.10.05 AM.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-05-28%20at%2011.10.05%20AM.png) 1. **Registrar e configurar o dispositivo**: *(Espaço reservado para uma imagem mostrando a interface de conexão do Banner PTL no Tulip Player, com campos para caminho (porta COM), taxa de transmissão, ID do dispositivo, botões “Register RTU” e “Setup”.)* - No aplicativo de teste da unidade (ou na interface do seu aplicativo para este driver): - Insira a porta COM identificada no campo **“caminho** ”. - Defina a **taxa de transmissão** como `19200`. - Defina o **ID do dispositivo** como `1` (ou conforme apropriado para a configuração do seu dispositivo PTL). - Clique no botão **“Registrar RTU** ”. Isso inicia a comunicação com o dispositivo especificado. - Após o registro bem-sucedido, clique no botão **“Setup”** para concluir a inicialização do dispositivo. ### Solução de problemas - **Não é possível listar a porta COM**: - Verifique se o dispositivo Banner PTL está conectado corretamente ao PC e ligado. - Verifique o Gerenciador de Dispositivos do Windows para ver se o dispositivo (ou seu adaptador USB para serial) foi reconhecido e se uma porta COM foi atribuída. - Tente reconectar o dispositivo ou reiniciar o Tulip Player. - **Falha no registro ou na configuração**: - Verifique se a porta COM (`caminho`), a taxa de transmissão (`19200`) e `o ID do dispositivo` corretos foram inseridos. - Certifique-se de que nenhum outro aplicativo esteja usando a mesma porta COM no momento. - Confirme se o sinalizador de recurso `CUSTOM_EDGE_DRIVER_BANNER_PTL` está ativo. - Consulte a documentação do dispositivo Banner PTL para obter requisitos específicos de configuração ou modo de operação. --- ## Recursos O driver Banner PTL permite que os aplicativos Tulip se integrem aos dispositivos Banner Pick-to-Light conectados ao Tulip Player do Windows. Isso possibilita funcionalidades como o controle das cores das luzes, a exibição de mensagens e o gerenciamento de animações para orientação visual do operador. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28910%29.png) ### Funções As seguintes funções podem ser usadas nos Gatilhos do Tulip para interagir com o dispositivo Banner PTL conectado: *(Espaço reservado para uma imagem genérica ilustrando as ações do Tulip Trigger para um driver de dispositivo.)* - **Listar dispositivos seriais**: - **Descrição**: Consulta a máquina do Windows Player e lista as portas seriais (COM) disponíveis. - **Entradas**: Nenhuma. - **Saídas**: Uma lista das portas COM disponíveis. - **Registrar RTU**: - **Descrição**: Registra o dispositivo PTL no driver utilizando seus parâmetros de comunicação. Esse é um pré-requisito para interações posteriores. - **Entradas**: - `path`: A porta COM à qual o dispositivo PTL está conectado (por exemplo, “COM3”). - `baudRate`: A velocidade de comunicação, normalmente `19200` para o Banner PTL. - `deviceID`: O ID específico da unidade PTL (por exemplo, `1`). - **Saídas**: Status da tentativa de registro (aciona um evento `OperationStatus` ). - **Configuração**: - **Descrição**: Realiza a instalação inicial ou a configuração do dispositivo PTL registrado. Deve ser chamado após o sucesso `do Register RTU`. - **Entradas**: Nenhuma (presume-se que o dispositivo esteja registrado). - **Saídas**: Status da tentativa de configuração (aciona um evento `OperationStatus` ). - **Definir Cor 1**: - **Descrição**: Altera a cor principal exibida pelo dispositivo PTL. - **Entradas**: - `colorValue`: A cor desejada (por exemplo, “Vermelho”, “Verde”, “Azul” ou um código específico compatível com o dispositivo). - **Saídas**: Aciona um evento `OperationStatus`. Confirmação visual no dispositivo PTL. - **Definir cor 2**: - **Descrição**: Altera uma cor secundária exibida pelo dispositivo PTL (se compatível). - **Entradas**: - `colorValue`: A cor desejada. - **Saídas**: Aciona um evento `OperationStatus`. Confirmação visual no dispositivo PTL. - **Definir Modo ASCII**: - **Descrição**: Configura a tela do dispositivo PTL para aceitar sequências de caracteres ASCII. - **Entradas**: Nenhuma. - **Saídas**: Aciona um evento `OperationStatus`. - **Gravar sequência de entrada**: - **Descrição**: Envia uma sequência de texto para ser exibida no dispositivo PTL. Normalmente, o dispositivo deve estar no modo ASCII. O PTL pode exibir isso como uma sequência rotativa ou estática (por exemplo, “Olá”). - **Entradas**: - `inputString`: O texto a ser exibido (por exemplo, “Olá”). - **Saídas**: Aciona um evento `OperationStatus`. Confirmação visual no dispositivo PTL. - **Definir modo bruto**: - **Descrição**: Alterna a exibição do dispositivo PTL para um modo de representação bruta ou numérica. A exibição de uma sequência ASCII como “Olá” nesse modo pode mostrar sua representação numérica/em bytes no dispositivo. - **Entradas**: Nenhuma. - **Saídas**: Aciona um evento `OperationStatus`. - **Definir modo de animação**: - **Descrição**: Altera o padrão de animação das luzes no dispositivo PTL. - **Entradas**: - `animationMode`: Um identificador para a animação desejada (por exemplo, “Flash”, “Pulse”, “Scroll” ou um código específico). - **Saídas**: Aciona um evento `OperationStatus`. Confirmação visual da animação alterada no dispositivo PTL. - **Desconectar/Cancelar registro**: - **Descrição**: (Supondo que exista uma função para liberar o dispositivo) Desconecta ou cancela o registro do dispositivo PTL do driver. - **Entradas**: `deviceID` (opcional, caso haja gerenciamento de vários dispositivos). - **Saídas**: Status da desconexão (aciona um evento `OperationStatus` ). ### Eventos Os seguintes eventos podem ser usados no Tulip Triggers para reagir a informações ou mudanças de status do driver Banner PTL: - **Erro**: - **Descrição**: indica um problema com o driver, a comunicação ou o dispositivo. - **Carga útil**: Contém uma `mensagem` detalhando o erro. - **Status da operação**: - **Descrição**: Indica o resultado de um comando executado (por exemplo, Registrar RTU, Definir cor, Gravar string de entrada). - **Carga útil**: - `comando`: O nome da função que foi executada (por exemplo, “RegisterRTU”, “SetColor1”). - `status`: “success” ou “failure”. - `mensagem`: Informações adicionais sobre o resultado da operação. ---