Share via

Conectividade do dispositivo e entrada de telemetria

  • Artigo

Importante

Uma nova versão do serviço dos Gêmeos Digitais do Azure foi lançada. À luz das funcionalidades expandidas do novo serviço, o serviço original dos Gêmeos Digitais do Azure (descrito neste conjunto de documentação) foi desativado.

Para exibir a documentação do novo serviço, visite a Documentação ativa dos Gêmeos Digitais do Azure.

Os dados de telemetria enviados por dispositivos e sensores formam o backbone de qualquer solução de IoT. Como representar esses recursos diferentes e gerenciá-los dentro do contexto de um local são as principais preocupações no desenvolvimento de aplicativos IoT. Os Gêmeos Digitais do Azure simplifica o processo de desenvolvimento de soluções de IoT unindo dispositivos e sensores com um gráfico de inteligência espacial.

Para começar, crie um recurso do Azure Hub IoT na raiz do gráfico espacial. O recurso Hub IoT permite que todos os dispositivos abaixo do espaço raiz enviem mensagens. Depois que o Hub IoT for criado, registre os dispositivos com sensores dentro da instância de Gêmeos Digitais do Azure. Os dispositivos podem enviar dados para um serviço Digital Twins por meio do SDK do dispositivo IoT do Azure.

Para obter um guia passo a passo sobre como colocar dispositivos a bordo, leia o Tutorial para implantar e configurar os Gêmeos Digitais. Em uma visão geral, as etapas são:

  • Implante uma instância Digital Twins do portal do Microsoft Azure.
  • Crie espaços no seu gráfico.
  • Crie um recurso Hub IoT e atribua-o a um espaço em seu gráfico.
  • Crie dispositivos e sensores em seu gráfico e atribua-os aos espaços criados nas etapas anteriores.
  • Crie um combinador para filtrar mensagens de telemetria com base nas condições.
  • Crie uma função definida pelo usuário e atribua-a a um espaço no grafo para processamento personalizado de suas mensagens de telemetria.
  • Atribuir uma função para permitir que a função definida pelo usuário acesse os dados do gráfico.
  • Obtenha a cadeia de conexão do dispositivo Hub IoT nas APIs do Digital Twins Management.
  • Configure a cadeia de conexão do dispositivo no dispositivo com o SDK do dispositivo IoT do Azure.

Nas seções a seguir, você aprende como obter a cadeia de conexão do dispositivo Hub IoT na Digital Twins Management API. Você também aprenderá a usar o formato de mensagem de telemetria Hub IoT para enviar telemetria baseada em sensores. Os Gêmeos Digitais exigem que cada parte da telemetria recebida seja associada a um sensor dentro do gráfico espacial. Esse requisito garante que os dados sejam processados e roteados dentro do contexto espacial apropriado.

Obter a cadeia de conexão de dispositivo do Hub IoT da API de Gerenciamento

Nos exemplos a seguir, YOUR_MANAGEMENT_API_URL refere-se ao URI de APIs de Gêmeos Digitais:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
Nome Substitua por
NOME_DA_SUA_INSTÂNCIA O nome da sua instância de Gêmeos Digitais do Azure
SUA_LOCALIZAÇÃO A região em que sua instância está hospedada

Fazer uma chamada GET na API do Dispositivo com um parâmetro includes=ConnectionString para obter a cadeia de conexão do dispositivo do Hub IoT. Filtre pelo GUID do dispositivo ou pelo ID do hardware para localizar o dispositivo fornecido.

YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
Parâmetro Substitua por
YOUR_DEVICE_GUID A ID do dispositivo 
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
Valor do parâmetro Substitua por
YOUR_DEVICE_HARDWARE_ID A ID de hardware do dispositivo

Na carga útil de resposta, copie a propriedade connectionString do dispositivo. Você o usa quando liga para o SDK do dispositivo IoT do Azure para enviar dados a gêmeos digitais.

Mensagem de dispositivo para nuvem

Você pode personalizar o payload e o formato de mensagem do dispositivo para atender às necessidades da sua solução. Use qualquer contrato de dados que possa ser serializado em uma matriz de bytes ou fluxo compatível com a classe Mensagem do Cliente de Dispositivo do IoT do Azure, Message (byte [] byteArray). A mensagem pode ser um formato binário personalizado de sua escolha, desde que você decodifique o contrato de dados em uma função definida pelo usuário correspondente. Há apenas um requisito para uma mensagem de dispositivo para nuvem. Mantenha um conjunto de propriedades para garantir que sua mensagem seja roteada adequadamente para o mecanismo de processamento.

Propriedades de telemetria

O conteúdo da carga útil de uma Mensagem pode ser um dado arbitrário de até 256 KB de tamanho. Existem alguns requisitos esperados para as propriedades do tipo Message.Properties. A tabela mostra as propriedades obrigatórias e opcionais com suporte do sistema.

Nome da propriedade Valor Obrigatório Descrição
DigitalTwins-Telemetry 1.0 Sim Um valor constante que identifica uma mensagem para o sistema.
DigitalTwins-SensorHardwareId string(72) Yes Um identificador exclusivo do sensor que envia a Mensagem. Esse valor deve corresponder a uma propriedade HardwareId do objeto para o sistema para processá-lo. Por exemplo, 00FF0643BE88-CO2.
CreationTimeUtc string No Uma cadeia de data formatada ISO 8601 que identifica o tempo de amostragem da carga útil. Por exemplo, 2018-09-20T07:35:00.8587882-07:00.
CorrelationId string No Um UUID que foi usado para eventos de rastreamento em todo o sistema. Por exemplo, cec16751-ab27-405d-8fe6-c68e1412ce1f.

Envie sua mensagem para Gêmeos Digitais

Use a chamada DeviceEvent SendEventAsync ou SendEventBatchAsync para enviar sua mensagem para Gêmeos Digitais.

Próximas etapas