--- title: "Using the Serial Driver" slug: "using-the-serial-driver" tags: ["Devices"] updated: 2024-01-05T16:48:36Z published: 2024-01-05T16:48:36Z canonical: "support.tulip.co/using-the-serial-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. # Usando o driver serial *Um guia para usar o driver Serial* Este artigo descreve os recursos e a configuração associados ao driver Serial no Tulip. Observe que esse driver é diferente do [Generic Serial Driver](https://support.tulip.co/docs/how-to-use-the-generic-serial-driver-on-io-gateway), que atualmente só está disponível para o Tulip I/O Gateway e o Edge IO. ## Recursos O driver Serial permite que os aplicativos Tulip se conectem a dispositivos seriais e enviem e recebam mensagens. Isso inclui todos os tipos de dispositivos USB-Serial, dispositivos seriais conectados por meio de um adaptador USB para Serial e dispositivos seriais conectados por meio de uma porta Virtual Serial (COM). Esses dispositivos podem incluir impressoras Zebra, balanças Mettler Toldeo e muitos outros. Esse driver está disponível apenas para o Tulip Player baseado em Windows e é ativado por padrão. ### Funções O driver suporta as seguintes funções: - **List Ports (Listar portas** ) - Para listar as portas seriais (COM) disponíveis - **Conectar** - Para se conectar a uma porta serial para enviar e receber mensagens - **Conectar com opções** - Opções avançadas para a conexão serial, como controle de fluxo, paridade, bits de dados e bits de parada. *Disponível desde a versão r252 e requer o Desktop Player versão 2.2 ou superior.* - **Send (Enviar** ) - Para enviar uma mensagem a um dispositivo conectado - **Disconnect** - Para desconectar de um dispositivo conectado Essas funções são expostas no Tulip App Editor como uma "Função de dispositivo", conforme mostrado abaixo: **Listar portas**![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Serial%20Driver_259650152.png) **Conectar**![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Serial%20Driver_259650586.png) Conectar **com opções**![Serial Driver Connect with Options](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Serial%20Driver%20Connect%20with%20Options.png) **Enviar**![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Serial%20Driver_259650744.png) **Desconectar**![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Serial%20Driver_259650871.png) Todas as três funções exigem que um "identificador" seja passado como parâmetro. Esse identificador identifica exclusivamente uma conexão dentro do aplicativo Tulip e pode ser usado para manter várias conexões simultaneamente. Os outros parâmetros para a função Connect estão descritos abaixo: - **Path (Caminho** ) - O caminho COM do dispositivo ao qual você gostaria de se conectar. - **Baud Rate** (Taxa de Baud) - A [taxa de baud](https://en.wikipedia.org/wiki/Baud) do dispositivo ao qual você gostaria de se conectar. Normalmente, isso é fornecido na documentação do dispositivo. Se o seu dispositivo tiver uma taxa de baud de configuração automática, esse valor será ignorado. - **Delimitador de mensagem** - Uma cadeia de caracteres delimitadora que separa as mensagens *recebidas*. Toda vez que o delimitador de mensagem for recebido *de* seu dispositivo, todos os dados recebidos desde o último delimitador de mensagem serão enviados ao seu aplicativo por meio do evento **Message**. Geralmente é uma nova linha ("\n") ou um retorno de carro com uma nova linha ("\r\n"). - **Terminador de mensagem** - Uma cadeia de caracteres que será enviada após cada função *Send* para indicar que a mensagem foi encerrada. Geralmente é uma nova linha ("\n") ou um retorno de carro com uma nova linha ("\r\n"). A ação de acionamento "Conectar com opções" está disponível a partir da versão r252 e requer o Windows Desktop Player 2.2 ou superior. As opções adicionais suportam os seguintes valores: | Opção | Valores permitidos | Valores comumente usados | | --- | --- | --- | | Bits de dados | 5, 6, 7, 8 | 8 | | Bits de parada | 1, 1.5, 2 | 1 | | Paridade | nenhuma, par, ímpar, marca, espaço | nenhuma | | Controle de fluxo | nenhuma, rts-cts, xon-xoff | nenhuma | ### Eventos O driver emite dois tipos de eventos: um evento de "Mensagem", que indica que uma conexão enviou uma mensagem, e um evento de "Erro", que indica que algo deu errado no driver ou na conexão. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Serial%20Driver_226548417.png) ## Configuração Não é necessária nenhuma configuração fora da lógica do aplicativo Tulip necessária para se conectar a um dispositivo. Embora nos exemplos acima mostremos valores estáticos sendo usados para os detalhes da conexão, é comum extrair esses valores de variáveis ou registros da tabela Tulip para permitir o gerenciamento central desses valores. --- Encontrou o que estava procurando? Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!