- Impressão
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, 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
Conectar
Conectar com opções
Enviar
Desconectar
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 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.
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 para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!