IoT do Azure SDKs de dispositivo e serviço

Essa referência lista os SDKs do Azure que você pode usar para criar soluções de IoT, incluindo SDKs de dispositivo, serviço e gerenciamento para Hub IoT e DPS (Serviço de Provisionamento de Dispositivos), SDKs de visualização para gerenciamento de certificados e links para apIs do plano de controle de Gêmeos Digitais do Azure e do plano de dados.

SDKs de dispositivo

Os SDKs do dispositivo IoT do Azure da Microsoft contêm código que facilita a criação de aplicativos que se conectam e são gerenciados por serviços de Hub IoT do Azure. Esses SDKs podem ser executados em um dispositivo de computação baseado em MPU geral, como um pc, tablet, smartphone ou Raspberry Pi. Os SDKs dão suporte ao desenvolvimento em C e em linguagens gerenciadas modernas, incluindo em C#, Node.js, Python e Java.

Os SDKs estão disponíveis em vários idiomas, fornecendo a flexibilidade para escolher qual melhor se adapta à sua equipe e cenário.

O SDK do dispositivo Java inclui samplas para Android.

O SDK do dispositivo C inclui samplas para iOS que usam CocoaPods.

Use os SDKs do dispositivo para desenvolver código para execução em dispositivos IoT que se conectam a Hub IoT ou IoT Central.

SDKs de dispositivos inseridos

Esses SDKs foram projetados e criados para execução em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

Os SDKs de dispositivos inseridos estão disponíveis para vários sistemas operacionais, fornecendo a flexibilidade para escolher qual melhor se adapta ao seu cenário.

Use os SDKs de dispositivo inserido para desenvolver código para execução em dispositivos IoT que se conectam a Hub IoT ou IoT Central.

Para saber mais sobre quando usar os SDKs do dispositivo inserido, consulte Cenários de uso do SDK do C e do SDK do C inserido.

Ciclo de vida e suporte de SDK do dispositivo

Esta seção resume o ciclo de vida e a política de suporte do SDK do Dispositivo IoT do Azure. Para obter mais informações, consulte SDK do Azure Ciclo de Vida e política de suporte.

Ciclo de vida do pacote

Os pacotes são lançados nas categorias a seguir. Cada categoria tem uma estrutura de suporte definida.

1. Beta – Também conhecido como Versão Prévia ou Release Candidate. Disponível para fins de acesso antecipado e comentários e não é recomendado para uso em produção. O suporte à versão prévia é limitado a problemas de GitHub. As versões prévias normalmente ficam ativas por menos de seis meses. Após disso são preteridas ou lançadas como ativas.

2. Ativa – Geralmente disponível e totalmente compatível, recebe novas atualizações de recursos, bem como correções de bugs e segurança. Use a versão mais recente porque essa versão recebe correções e atualizações.

3. Preterida – substituído por uma versão mais recente. A substituição ocorre ao mesmo tempo em que a nova versão se torna ativa. As versões preteridas abordam as correções de bugs e correções de segurança mais críticas por mais 12 meses.

Obtenha suporte

Se você tiver problemas ao usar os SDKs do IoT do Azure, procure suporte por meio das seguintes opções:

• Reportando bugs - Todos os clientes podem relatar bugs na página de problemas do repositório GitHub associado ao SDK relevante.

• Microsoft equipe de Suporte ao Cliente - Os usuários que têm um plano support podem envolver a equipe de Suporte ao Cliente Microsoft criando um tíquete de suporte diretamente do portal Azure.

SDKs do serviço Hub IoT

Os SDKs do serviço IoT do Azure contêm código para facilitar a criação de aplicativos que interagem diretamente com Hub IoT para gerenciar dispositivos e segurança.

Para saber mais sobre como usar os SDKs de serviço para interagir com dispositivos por meio de um hub IoT, consulte IoT Plug and Play guia do desenvolvedor de serviços.

SDKs de gerenciamento de Hub IoT

Os SDKs de gerenciamento de Hub IoT ajudam você a criar aplicativos de back-end que gerenciam os hubs IoT em sua assinatura Azure.

As alternativas aos SDKs de gerenciamento incluem o CLI do Azure, PowerShell e REST API.

SDKs de dispositivo DPS

Os SDKs de dispositivo do DPS fornecem implementações da API de Registro e outras que os dispositivos chamam para provisionar por meio do DPS. Os SDKs de dispositivo podem ser executados em dispositivos de computação baseado em MPU gerais, como um pc, tablet, smartphone ou Raspberry Pi. Os SDKs dão suporte ao desenvolvimento em C e em linguagens gerenciadas modernas, incluindo em C#, Node.js, Python e Java.

A tabela a seguir lista os SDKs do dispositivo disponíveis para cada idioma com suporte.

SDKs de dispositivos incorporados DPS

Esses SDKs foram projetados e criados para execução em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

Saiba mais sobre os SDKs do dispositivo e do dispositivo inserido em SDKs de IoT.

SDKs do serviço DPS

Os SDKs do serviço do DPS ajudam você a criar aplicativos de back-end para gerenciar registros e registros em instâncias do DPS.

SDKs de gerenciamento de DPS

Os SDKs de gerenciamento de DPS ajudam você a criar aplicativos de back-end que gerenciam as instâncias DPS e seus metadados em sua assinatura Azure.

SDKs de gerenciamento de certificados (versão prévia)

Para SDKs que dão suporte ao gerenciamento de certificados X.509 com suporte Microsoft na versão prévia, use as instruções e os exemplos a seguir. Para usar SDKs de gerenciamento de certificados na versão prévia, você deve usar Hub IoT do Azure com uma instância de DPS vinculada e os dispositivos devem provisionar por meio do DPS.

SDKs do dispositivo de gerenciamento de certificados (versão prévia)

A tabela a seguir lista os SDKs da plataforma que atualmente dão suporte ao gerenciamento de certificados X.509 com suporte Microsoft em versão prévia.

SDKs de dispositivo inserido de gerenciamento de certificados (versão prévia)

A tabela a seguir lista os SDKs inseridos que atualmente dão suporte ao gerenciamento de certificados X.509 com suporte Microsoft em versão prévia.

APIs do painel de controle Gêmeos Digitais do Azure

As APIs do plano de controle são ARM APIs usadas para gerenciar sua instância de Gêmeos Digitais do Azure como um todo, para que elas cubram operações como criar ou excluir toda a instância. Você também usará essas APIs para criar e excluir pontos de extremidade.

Para chamar as APIs diretamente, faça referência à pasta swagger mais recente no repositório swagger do plano controle. Essa pasta também inclui outra pasta de exemplos de uso.

Aqui estão os SDKs disponíveis atualmente para as APIs do plano de controle Gêmeos Digitais do Azure.

APIs do plano de dados Gêmeos Digitais do Azure

As APIs do plano de dados são as APIs de Gêmeos Digitais do Azure usadas para gerenciar os elementos em sua instância de Gêmeos Digitais do Azure. Elas incluem operações como criar rotas, carregar modelos, criar relações e gerenciar gêmeos e podem ser amplamente divididas nas seguintes categorias:

• DigitalTwinModels - A categoria DigitalTwinModels contém APIs para gerenciar os models em uma instância de Gêmeos Digitais do Azure. As atividades de gerenciamento incluem carregamento, validação, recuperação e exclusão de modelos criados na DTDL.
• DigitalTwins - A categoria DigitalTwins contém as APIs que permitem que os desenvolvedores criem, modifiquem e excluam digital twins e suas relações em uma instância de Gêmeos Digitais do Azure.
• Query – a categoria Consulta permite que os desenvolvedores encontrem conjuntos de gêmeos digitais no grafo de gêmeos entre diferentes relações.
• Event Routes – a categoria Rotas de Eventos contém APIs para rotear dados pelo sistema e para serviços downstream.
• Import Jobs – A API de Importação de Trabalhos permite gerenciar uma ação assíncrona de execução prolongada para importar modelos, gêmeos e relações em massa.
• Delete Jobs – A API de Exclusão de Trabalhos permite gerenciar uma ação assíncrona de execução prolongada para excluir todos os modelos, gêmeos e relações em uma instância.

Para chamar as APIs diretamente, faça referência à pasta swagger mais recente no repositório swagger do plano data. Essa pasta também inclui outra pasta de exemplos de uso. Você também pode exibir a documentação de referência da API do plano de dados.

Aqui estão os SDKs disponíveis atualmente para as APIs do plano de dados Gêmeos Digitais do Azure.

Próximas Etapas 

As próximas etapas sugeridas incluem:

• Guia do desenvolvedor do dispositivo
• Guia do desenvolvedor do serviço