# Conheça o repositório open-source de connectors da TagoIO

> Conheça a mais nova melhoria da TagoIO para a integração de dispositivos IoT. Nossa nova abordagem usa decoders e scripts open-source para converter os dados de payload de dispositivos IoT no modelo de dados da TagoIO. Explore nosso repositório open-source completo, os processos para adicionar novos decoders e os passos simplificados de submissão. Aprimore suas soluções IoT com mais transparência, flexibilidade e escalabilidade.

![Conheça o repositório open-source de connectors da TagoIO](https://tago.io/og/pt-br/blog/introducing-tagoio-s-open-source-connector-repository.png)

Na TagoIO, estamos sempre evoluindo para tornar a integração de dispositivos IoT fluida e eficiente. Hoje, temos o prazer de anunciar uma melhoria importante na forma como você cria e mantém connectors públicos para dispositivos IoT na nossa plataforma.

# Simplificando a integração de dispositivos com decoders

Nossa nova abordagem usa decoders e scripts open-source criados para interpretar os dados de payload de dispositivos IoT e convertê-los em um modelo de dados da TagoIO. Todos os decoders disponíveis no nosso [GitHub público](https://github.com/tago-io/decoders) ficarão automaticamente disponíveis no nosso Admin. Essa melhoria torna o processo de integração mais transparente, flexível e escalável, garantindo que seus dispositivos se comuniquem de forma eficaz com a nossa plataforma.

# Componentes principais do nosso novo processo de integração

1.  **Repositório de decoders:** criamos um repositório open-source completo com todas as ferramentas e diretrizes necessárias para criar e gerenciar decoders. Esse repositório é o seu recurso principal para garantir que os dados do seu dispositivo sejam interpretados e usados corretamente dentro da TagoIO. Assim, qualquer pessoa pode contribuir com correções de bugs, melhorias e a adição de novos decoders.

2.  **Network e connector decoders:**

3.  **Network decoders** cuidam da interpretação dos dados de redes IoT específicas.

4.  **Connector decoders** são feitos sob medida para fabricantes e modelos de dispositivos específicos, oferecendo um nível mais detalhado de interpretação de dados.

5.  **Manifests**: são arquivos JSONC que descrevem cada versão de decoder, garantindo que os decoders sigam o formato de arquivo e os nomes de arquivo corretos.


## Processo simplificado para adicionar novos decoders

Todos os decoders listados no nosso [GitHub](https://github.com/tago-io/decoders) público já estão disponíveis dentro do TagoIO Admin para você usar. Se precisar criar um connector específico para o seu dispositivo, você não precisa torná-lo público: veja como criar uma [network/connector](https://help.tago.io/portal/en/kb/articles/468-creating-a-network-integration#Serial_Number) privada. Mesmo assim, siga o nosso processo quando quiser que o seu connector se torne público. Nosso novo processo para liberar decoders ao público foi pensado para ser simples e eficiente:

-   **Crie pastas:** organize seus decoders por network e fabricante, garantindo uma estrutura lógica e acessível.

-   **Defina manifests:** use arquivos de schema predefinidos para criar arquivos manifest que descrevem seus decoders em detalhes.

-   **Controle de versão:** mantenha diferentes versões dos seus decoders, seguindo o padrão SemVer para o versionamento.

-   **Validação e testes:** use comandos como npm start validator e npm test para garantir que seus decoders estejam corretos e confiáveis.


# Enviando seu decoder para o GitHub público

Simplificamos o processo de submissão para deixá-lo o mais direto possível:

1.  **Crie uma branch:** comece criando uma nova branch para o seu decoder.

2.  **Adicione seu decoder:** siga as diretrizes estruturadas para adicionar o seu decoder.

3.  **Valide:** execute o comando de validação para verificar se há algum problema.

4.  **Commit e pull request:** faça o commit das suas alterações e abra um pull request para revisão.

5.  **Revisão e merge:** após a revisão e quaisquer ajustes necessários, seu decoder será incorporado ao código principal.


# Conclusão

Essa nova abordagem simplifica o processo de integração e amplia a escalabilidade e a flexibilidade da plataforma TagoIO. Ao permitir que qualquer desenvolvedor adicione e gerencie decoders com facilidade no nosso repositório no [GitHub público](https://github.com/tago-io/decoders), damos aos usuários o poder de integrar uma variedade maior de dispositivos, ampliando as possibilidades das suas soluções IoT.

Estamos animados para ver os novos dispositivos e aplicações que você vai criar com essas melhorias.

[llms.txt](https://tago.io/llms.txt)
