Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os SDKs Microsoft para o DPS (Serviço de Provisionamento de Dispositivos) Hub IoT ajudam a criar aplicativos de dispositivo e back-end que provisionam dispositivos IoT para um ou mais hubs IoT. Os SDKs lidam com os protocolos de transporte e segurança subjacentes entre seus dispositivos ou aplicativos de back-end e DPS, liberando você para se concentrar no desenvolvimento de aplicativos. Usando os SDKs, você obtém suporte para atualizações futuras no DPS, incluindo atualizações de segurança. Este artigo descreve as três categorias de SDKs, lista os SDKs de DPS publicados em idiomas populares e fornece links para referências, exemplos e inícios rápidos do SDK.
Importante
O gerenciamento de certificados no Hub IoT está em preview e tem suporte apenas nos seguintes SDKs de dispositivo DPS: C incorporado (Bare metal, RTOS gratuito), C e Python. Hub IoT SDKs não dão suporte a ele. Para obter mais informações, confira o que é o Gerenciamento de Certificados?
Categorias do SDK
Três categorias de SDKs (kits de desenvolvimento de software) funcionam com o DPS:
OsSDKs de dispositivo DPS fornecem operações de plano de dados para dispositivos. Use o SDK do dispositivo para provisionar um dispositivo por meio do DPS.
Os SDKs do serviço do DPS fornecem operações de plano de dados para aplicativos de back-end. Use os SDKs de serviço para criar e gerenciar registros individuais e grupos de registro e para consultar e gerenciar registros de registro de dispositivo.
Os SDKs de gerenciamento de DPS fornecem operações de plano de controle para aplicativos de back-end. Use os SDKs de gerenciamento para criar e gerenciar instâncias e metadados de DPS. Por exemplo, use-os para criar e gerenciar instâncias de DPS em sua assinatura, para carregar e verificar certificados com uma instância DPS ou para criar e gerenciar políticas de autorização ou políticas de alocação em uma instância DPS.
Os SDKs do DPS ajudam no provisionamento de dispositivos para seus hubs IoT. Microsoft também fornece um conjunto de SDKs para ajudá-lo a criar aplicativos de dispositivo e aplicativos de back-end que se comunicam diretamente com Hub IoT do Azure. Por exemplo, para ajudar seus dispositivos provisionados a enviar telemetria para o hub IoT e, opcionalmente, receber mensagens e atualizações de trabalho, método ou gêmeo do hub IoT. Para saber mais, consulte Hub IoT do Azure SDKs.
SDKs de dispositivo
Os SDKs de dispositivo DPS permitem que seus dispositivos se registrem no DPS e recebam a atribuição do hub IoT. Use os SDKs do dispositivo para implementar o provisionamento do lado do dispositivo com chave simétrica, certificado X.509 ou atestado TPM. Os SDKs de dispositivo de plataforma estão disponíveis para dispositivos que executam um sistema operacional completo e os SDKs de dispositivo inserido estão disponíveis para dispositivos baseados em microcontrolador e restrição de recursos.
SDKs de dispositivo de plataforma
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.
| Plataforma | Pacote | Repositório de códigos | Exemplos | Início Rápido | Referência |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Início rápido | Referência |
| C | apt-get, MBED, Arduino IDE ou iOS | GitHub | Samples | Início rápido | Reference |
| Java | Maven | GitHub | Samples | Início rápido | Referência |
| Node.js | npm | GitHub | Samples | Início rápido | Referência |
| Python | pip | GitHub | Samples | Início rápido | Referência |
Aviso
O SDK do C listado acima, devido ao modelo de threading e ao gerenciamento de memória dele, não é adequado para aplicativos inseridos. Para dispositivos inseridos, confira os SDKs de dispositivos inseridos.
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.
| Linguagem | Pacote | Origem/Ramificação | Exemplos |
|---|---|---|---|
| .NET | NuGet | Azure/azure-iot-sdk-csharp em feature/iot-csr-preview | CertificateSigningRequestSample |
| Python | pip | Azure/azure-iot-sdk-python em feature/iot-csr-preview | exemplos cert-mgmt |
| Node.js | npm | Não disponível | Não disponível |
| Java | Maven | Azure/azure-iot-sdk-java em feature/csr | certificate-signing-sample |
| C | packages | Azure/azure-iot-sdk-c em feature/dps-csr-preview | iothub_ll_client_sample_certificate_signing_request |
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.
| RTOS | SDK | Fonte | Exemplos | Referência |
|---|---|---|---|---|
| Eclipse ThreadX | Middleware Azure RTOS | GitHub | Inícios Rápidos | Referência |
| FreeRTOS | Middleware FreeRTOS | GitHub | Samples | Referência |
| Bare-metal | SDK do Azure do Embedded C | GitHub | Samples | Referência |
Saiba mais sobre os SDKs do dispositivo e do dispositivo inserido em SDKs de IoT.
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.
| RTOS | SDK | Fonte | Exemplos |
|---|---|---|---|
| FreeRTOS | Middleware FreeRTOS | Azure/azure-iot-middleware-freertos em feature/dps-csr-preview | Não disponível |
| Bare-metal | SDK do Azure do Embedded C | Azure/azure-sdk-for-c em feature/dps-csr-preview | paho_iot_hub_csr_sample.c |
SDKs do Serviço
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.
| Plataforma | Pacote | Repositório de códigos | Exemplos | Início Rápido | Referência |
|---|---|---|---|---|---|
| .NET | NuGet | GitHub | Samples | Início rápido | Referência |
| Java | Maven | GitHub | Samples | Início rápido | Referência |
| Node.js | npm | GitHub | Samples | Início rápido | Referência |
SDKs de gerenciamento
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.
| Plataforma | Pacote | Repositório de códigos | Referência |
|---|---|---|---|
| .NET | NuGet | GitHub | Referência |
| Java | Maven | GitHub | Referência |
| Node.js | npm | GitHub | Referência |
| Python | pip | GitHub | Referência |
Próximas etapas
A documentação do Serviço de Provisionamento de Dispositivos fornece tutoriais e exemplos adicionais que você pode usar para experimentar os SDKs e bibliotecas.