Usar propriedades em uma solução do Azure IoT Central
Este guia de instruções mostra como usar as propriedades do dispositivo definidas em um modelo de dispositivo no aplicativo Azure IoT Central.
As propriedades representam valores de ponto no tempo. Por exemplo, um dispositivo pode usar uma propriedade para relatar a temperatura de destino que está tentando alcançar. Por padrão, as propriedades do dispositivo são somente leitura no IoT Central. As propriedades graváveis permitem sincronizar o estado entre o dispositivo e o aplicativo Azure IoT Central.
Você também pode definir propriedades de nuvem em um aplicativo Azure IoT Central. Os valores de propriedade de nuvem nunca são trocados por meio de um dispositivo e estão fora do escopo deste artigo.
Para saber mais sobre as convenções do IoT Plug and Play, confira Convenções do IoT Plug and Play.
Para saber mais sobre os dados de propriedade que um dispositivo troca com o IoT Central, confira Telemetria, propriedade e conteúdos de comando.
Para saber como gerenciar propriedades usando a API REST do IoT Central, confira Como usar a API REST do IoT Central para controlar dispositivos.
Para saber como implementar propriedades em um dispositivo sem usar os SDKs do dispositivo, consulte Comunicar-se com um hub IoT usando o protocolo MQTT.
Defina suas propriedades
As propriedades são campos de dados que representam o estado do seu dispositivo. Use propriedades para representar o estado durável do dispositivo, como o estado ligado/desligado de um dispositivo. As propriedades também podem representar as propriedades básicas do dispositivo, como a versão do software. É possível declarar propriedades como somente leitura ou graváveis.
A captura de tela a seguir mostra uma definição de propriedade em um aplicativo Azure IoT Central.
A seguinte tabela mostra as configurações para uma funcionalidade de propriedade:
| Campo | Description |
|---|---|
| Display name | O nome de exibição do valor da propriedade usado em blocos de painel e formulários de dispositivo. |
| Nome | O nome da propriedade. O Azure IoT Central gera um valor para esse campo com base no nome de exibição, mas você pode escolher seu próprio valor, se necessário. Este campo deve ser alfanumérico. O código do dispositivo usa esse valor para nome. |
| Tipo de funcionalidade | Propriedade. |
| Tipo semântico | O tipo semântico da propriedade, como temperatura, estado ou evento. A escolha do tipo semântico determina quais dos campos a seguir estão disponíveis. |
| Esquema | O tipo de dados de propriedade, como duplo, cadeia de caracteres ou vetor. O tipo semântico determina as opções disponíveis. O esquema não está disponível para os tipos semânticos de evento e estado. |
| Gravável | Se a propriedade não for gravável, o dispositivo poderá relatar valores de propriedade para o Azure IoT Central. Se a propriedade for gravável, o dispositivo poderá relatar valores de propriedade para o Azure IoT Central. Em seguida, o Azure IoT Central pode enviar atualizações de propriedade para o dispositivo. |
| Severidade | Disponível somente para o tipo semântico de evento. As severidades são Erro, Informação ou Aviso. |
| Valores de estado | Disponível apenas para o tipo de estado semântico. Defina os valores de estado possíveis, cada um dos quais com o nome de exibição, o nome, o tipo de enumeração e o valor. |
| Unidade | Uma unidade para o valor da propriedade, como mph, % ou °C. |
| Unidade de exibição | Uma unidade de exibição para uso em blocos de painel e formulários de dispositivo. |
| Comentário | Comentários sobre a funcionalidade de propriedade. |
| Descrição | Uma descrição da funcionalidade de propriedade. |
Para saber mais sobre a DTDL (Linguagem de Definição de Gêmeo Digital) que o Azure IoT Central usa para definir propriedades em um modelo de dispositivo, consulte Convenções do IoT Plug and Play > Propriedades somente leitura.
Campos opcionais, como nome de exibição e descrição, permitem que você adicione mais detalhes à interface e aos recursos.
Ao criar uma propriedade, você pode especificar tipos de esquema complexos, como Objeto e Enum.
Quando seleciona um Esquema complexo, como Objeto, você precisa definir o esquema do objeto.
Implementar propriedades somente leitura
Por padrão, as propriedades são somente leitura. As propriedades somente leitura permitem que um valor de propriedade de relatório do dispositivo seja atualizado para o aplicativo Azure IoT Central. O aplicativo Azure IoT Central não pode definir o valor de uma propriedade somente leitura.
O Azure IoT Central usa dispositivos gêmeos para sincronizar valores de propriedade entre o dispositivo e o aplicativo do Azure IoT Central. Os valores de propriedade do dispositivo usam propriedades relatadas do dispositivo gêmeo. Para obter mais informações, confira dispositivos gêmeos.
Um dispositivo envia atualizações de propriedade como um conteúdo JSON. Para obter mais informações, confira Conteúdos de telemetria, propriedade e comando.
Você pode usar o SDK do dispositivo IoT do Azure para enviar uma atualização de propriedade para o aplicativo de Azure IoT Central.
Para obter exemplos de implementações em vários idiomas, consulte Criar e conectar um aplicativo cliente ao seu aplicativo do Azure IoT Central.
A exibição a seguir no aplicativo Azure IoT Central mostra as propriedades somente leitura do dispositivo:
Implementar propriedades graváveis
Um operador do IoT Central define propriedades graváveis em um formulário. O Azure IoT Central envia a propriedade para o dispositivo. O Azure IoT Central espera uma confirmação do dispositivo.
Para obter exemplos de implementações em vários idiomas, consulte Criar e conectar um aplicativo cliente ao seu aplicativo do Azure IoT Central.
A mensagem de resposta deve incluir os campos ac e av. O campo ad é opcional. Para saber mais, consulte Convenções do IoT Plug and Play > Propriedades graváveis.
Quando o operador define uma propriedade gravável na interface do usuário do Azure IoT Central, o aplicativo usa uma propriedade desejada do dispositivo gêmeo para enviar o valor para o dispositivo. Em seguida, o dispositivo responde usando uma propriedade relatada do dispositivo gêmeo. Quando o Azure IoT Central recebe o valor da propriedade relatada, ele atualiza a exibição da propriedade com um status Aceito.
Quando você inserir o valor e selecionar Salvar, o status inicial será Pendente. Quando o dispositivo aceita a alteração, o status muda paraAceito.
Usar propriedades em dispositivos não atribuídos
Você pode exibir e atualizar propriedades graváveis em um dispositivo que não foi atribuído a um modelo de dispositivo.
Para exibir as propriedades existentes em um dispositivo não atribuído, navegue até o dispositivo na seção Dispositivos, selecione Gerenciar dispositivo e, em seguida, Propriedades do Dispositivo:
Você pode atualizar as propriedades graváveis nesta exibição:
Próximas etapas
Agora que você aprendeu a configurar um modelo de dispositivo no aplicativo Azure IoT Central, é possível: