Desenvolvimento de SDK

Prev Next

Saiba como iniciar o desenvolvimento e a iteração de seu Tulip Edge Driver

Introdução

  1. O que você aprenderá
    1. Como desenvolver seu primeiro projeto de edge driver
      1. Criar um projeto
      2. Atualizar os arquivos de manifesto e índice
  2. O que você precisará (pré-requisitos)
    1. Ter seguido todas as etapas do SDK Create

Primeiros passos

Depois de criar seu novo Edge Driver com a ferramenta create-edge-driver, você estará pronto para começar a implementar seu próprio código de driver!

Atualização do manifest.json

Primeiro, precisamos definir os eventos e as funções implementados pelo nosso driver. Os eventos do dispositivo podem ser usados como gatilhos para a lógica nos aplicativos Tulip. Por exemplo, você pode configurar um acionador de aplicativo como:

"Quando meu sensor disparar um evento de medição, armazene os dados de temperatura na variável 'Shop Floor Temperature'".

Os drivers também podem implementar funções de dispositivo, que podem ser executadas em resposta a acionadores em um aplicativo. Por exemplo:

"Quando eu clicar neste botão, chame a função 'Toggle Light' no meu dispositivo."

Neste exemplo, nosso driver não terá funções, mas disparará um evento chamado "data" quando nosso sensor fizer uma medição. Atualize a seção de funções no seu arquivo src/manifest.json deixando-a vazia ou removendo-a completamente:

json... "functions":``[],...Em seguida, atualize a seção de eventos para definir a forma do evento "data". Esse evento será um objeto com duas propriedades de flutuação, "temperatura" e "umidade":json... "events": [ { "name": "data", "schema": { "type": "object", "properties": { "temperature" (temperatura): { "type": "float" }, "humidity": { "type": "float" } } } } ],...

Atualizando index.ts

Agora escreveremos o código do driver que usa o Edge Driver SDK para localizar e se conectar a uma porta serial, ler os dados seriais recebidos, analisar as mensagens JSON e disparar o evento "data" usando fireEvent(). Substitua o código de exemplo em seu arquivo src/index.ts por este novo código:



serial.onData((data) => { try { const decoder = new TextDecoder(); const stringData = decoder.decode(new Uint8Array(data)); const espData = JSON.parse(stringData.split("ESP: ")[1]); edgeDriverSdk.fireEvent("data", espData); } catch (error) { console.error(error); } });


serial.open();});```Este é um exemplo muito simples que tenta encontrar automaticamente o dispositivo usando o ID do produto do dispositivo USB, uma única vez quando o driver é iniciado. O Edge Driver SDK também suporta o registro de drivers a serem iniciados quando novos dispositivos são detectados pelo sistema, o que pode ajudar a criar drivers de produção mais robustos.


#### Criação do driver


Depois de atualizar o código do driver e o manifest.json, compile o driver novamente`:npm run build`


Isso gerará o arquivo JavaScript compilado e empacotado, bem como uma cópia do manifesto validado dentro do diretório dist.![SDK](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-03-27%20at%2011.12.19%20AM.png){height="" width=""}