--- title: "How to: Use Serial with Node-RED" slug: "how-to-use-serial-with-node-red-1" updated: 2023-11-04T14:58:57Z published: 2023-11-04T14:58:57Z canonical: "support.tulip.co/how-to-use-serial-with-node-red-1" --- > ## 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. # Como fazer: Usar o Serial com o Node-RED ## Como fazer: Usar serial com o Node-RED *Guia sobre como se conectar a um dispositivo serial, configurar uma porta serial no node-RED e uma introdução aos fluxos da biblioteca node-RED* Este artigo descreve como ler e gravar dados seriais de dispositivos Tulip Edge usando o Node-RED. Ele abordará como se conectar às diferentes portas seriais em cada tipo de dispositivo Edge e dois fluxos de biblioteca do Tulip Node-RED que usam comunicação serial. O que você precisará é de: - Um Edge IO ou Edge MC [registrado na sua conta Tulip](https://support.tulip.co/docs/how-to-register-an-edge-io) - Um dispositivo que se comunicará via serial com seu Edge device - [O Edge IO](https://support.tulip.co/docs/how-to-use-serial-with-edge-io) suporta dispositivos seriais que utilizam: - RS-232 - RS-485 (half-duplex) - Serial via USB - [O Edge MC](https://support.tulip.co/docs/how-to-use-serial-on-edge-mc) é compatível com dispositivos seriais que usam: - Serial sobre USB - TTY UART com TX/RX ## 1. Configuração de hardware: Conectar ao dispositivo serial Primeiro, certifique-se de conectar fisicamente seu periférico serial ao dispositivo Edge. *Opcional*: se quiser testar primeiro o fluxo do Node-RED comunicando-se com um dispositivo host (ou seja, seu laptop, outro dispositivo Tulip Edge etc.), você pode fazer isso usando RS-232 com um modem nulo ou cabos USB-UART com linhas TX/RX cruzadas ( *não* conecte a alimentação). Exemplos de programas que você pode usar no dispositivo host para se comunicar com o dispositivo Edge são - **screen (MacOS)**: Um utilitário de linha de comando para comunicação serial. - **PuTTY (Windows/Linux)**: Um emulador de terminal gratuito que pode atuar como um console serial. - **Node-RED**: Crie um fluxo complementar do Node-RED em uma instância do Node-RED que esteja sendo executada no dispositivo host. ## 2. Configuração do Node-RED: Configurar a porta serial Usaremos os nós do pacote `node-red-contrib-serialport` para comunicações seriais no Node-RED. Se estiver em um dispositivo Tulip Edge OS44+, esse pacote estará pré-instalado. Caso contrário, você poderá adicionar os nós à paleta usando o editor do Node-RED, conforme descrito [aqui](https://nodered.org/docs/user-guide/runtime/adding-nodes). Os nós seriais aparecerão na guia de `rede`: ![Node RED Serial Setup Port Config](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Port%20Config.png) Para ler entradas seriais, arraste e solte o nó `de entrada serial`. Para gravar saídas seriais, arraste e solte o nó `serial out`. Em qualquer um dos nós, para configurar a porta serial, clique no botão de edição da propriedade "Porta serial": ![Node RED Serial Set Up Edit Port Modal](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Set%20Up%20Edit%20Port%20Modal.png) Em seguida, você preencherá as seguintes propriedades: - **Porta serial**: o caminho do dispositivo da porta serial (por exemplo: /dev/ttyS0). Isso depende do dispositivo do Edge e da porta serial física à qual você está se conectando (consulte os artigos do [Edge IO](https://support.tulip.co/docs/how-to-use-serial-with-edge-io) ou [do Edge MC](https://support.tulip.co/docs/how-to-use-serial-on-edge-mc)). Os caminhos disponíveis podem ser visualizados clicando no botão de pesquisa, conforme mostrado abaixo. ![Node RED Serial Setup Add New Port](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Add%20New%20Port.png) *Observação: no momento, não há suporte para conexão a quente de dispositivos USB no Node-RED. Isso significa que o dispositivo USB deve estar conectado quando o dispositivo for inicializado para que o Node-RED tenha acesso a ele.* - **Configurações**: A taxa de baud e outras configurações devem corresponder à taxa de baud do dispositivo serial com o qual você está se comunicando. ![Node RED Serial Setup Settings](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Settings.png) - **Entrada**: Escolha quando o nó emitirá uma mensagem. As opções incluem aguardar um caractere dividido (como quebra de linha, vírgula ou espaço), aguardar a cada `n` caracteres se a saída for de comprimento fixo, ou você pode definir um tempo limite para obter uma saída a cada `n` segundos. ![Node RED Serial Setup Input](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Input.png) - **Saída**: Adicione caracteres à mensagem de saída (por exemplo, adicione novamente a quebra de linha). ![Node RED Serial Setup Output](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Output.png) Você poderá ver que está conectado a uma porta serial válida se, após a implantação, o status do nó for "conectado": ![Node RED Serial Setup Connected Status](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Connected%20Status.png) ## 3. Fluxos da biblioteca do Node-RED: Comunicação com a Tulip O Tulip fornece vários fluxos de biblioteca para ler entradas seriais e gravar saídas seriais em dispositivos Tulip Edge usando o Node-RED. Consulte [Importar fluxos do Tulip Node-RED](https://support.tulip.co/docs/importing-tulip-node-red-flows) para obter informações sobre como importar um fluxo de biblioteca do Tulip. Para gravar uma saída serial em um dispositivo Tulip Edge a partir de um aplicativo Tulip, você pode usar o fluxo `serial_http_endpoint` e configurar um conector HTTP em sua instância do Tulip em execução no host do conector do dispositivo Edge. Você precisará adicionar uma função de conector a esse conector para enviar solicitações POST ao endpoint HTTP `/serial` e chamar essa função de conector a partir do aplicativo. Saiba mais sobre como gravar valores no Node-RED usando o host [do](https://support.tulip.co/docs/communicate-with-machines-using-edge-mcs-connector-host-amp-node-red) conector em [Comunicar-se com máquinas usando o host do conector e o Node-RED do Edge MC](https://support.tulip.co/docs/communicate-with-machines-using-edge-mcs-connector-host-amp-node-red). ![Node RED Serial Setup Flow1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Flow1.png) Para ler a entrada serial em um dispositivo Tulip Edge e enviar para o Tulip, você pode usar a API Tables (para gravar os dados em uma tabela) ou a API Machine (para gravar os dados em um atributo de máquina). O fluxo da biblioteca `serial_to_tulip_table` é um exemplo de como gravar entradas seriais delimitadas por nova linha em uma tabela da Tulip. Você precisará configurar o nó serial e os dois nós das tabelas Tulip com as definições corretas para o seu caso de uso. Saiba mais sobre como usar o nó da API Tulip Tables em [Usando o Node-RED com a API Tulip](https://support.tulip.co/docs/using-node-red-with-the-tulip-api) ![Node RED Serial Setup Flow2](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Node%20RED%20Serial%20Setup%20Flow2.png)