Utilizar as propriedades numa solução do Azure IoT Central
Este guia de instruções mostra como usar as propriedades do dispositivo definidas em um modelo de dispositivo em seu aplicativo do Azure IoT Central.
As propriedades representam valores point-in-time. Por exemplo, um dispositivo pode usar uma propriedade para relatar a temperatura alvo 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 seu dispositivo e seu aplicativo do Azure IoT Central.
Você também pode definir propriedades de nuvem em um aplicativo do Azure IoT Central. Os valores de propriedade de nuvem nunca são trocados com um dispositivo e estão fora do escopo deste artigo.
Para saber mais sobre as convenções de propriedade do IoT Pug and Play, consulte Convenções do IoT Plug and Play.
Para saber mais sobre os dados de propriedade que um dispositivo troca com o IoT Central, consulte Telemetria, propriedade e cargas úteis de comando.
Para saber como gerenciar propriedades usando a API REST do IoT Central, consulte 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 com um hub IoT usando o protocolo MQTT.
Defina as 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 de software do dispositivo. Você declara propriedades como somente leitura ou graváveis.
A captura de tela a seguir mostra uma definição de propriedade em um aplicativo do Azure IoT Central.
A tabela a seguir mostra as definições de configuração para um recurso de propriedade.
| Campo | Descrição |
|---|---|
| Display name | O nome para exibição do valor da propriedade usada em blocos de painel e formulários de dispositivo. |
| Nome | O nome da propriedade. O Azure IoT Central gera um valor para esse campo a partir do nome para 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 Name . |
| Capability type | Imóvel. |
| Semantic type (Tipo de semântica) | O tipo semântico da propriedade, como temperatura, estado ou evento. A escolha do tipo semântico determina qual dos seguintes campos está disponível. |
| Esquema | O tipo de dados da propriedade, como double, string 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. |
| Writable (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. |
| Gravidade | Disponível apenas para o tipo semântico de evento. As gravidades são Erro, Informação ou Aviso. |
| State values | Disponível apenas para o tipo semântico de estado. Defina os valores de estado possíveis, cada um dos quais tem nome para exibição, nome, tipo de enumeração e valor. |
| Unidade | Uma unidade para o valor da propriedade, como mph, %, ou °C. |
| Display unit | Uma unidade de exibição para uso em painéis, blocos e formulários de dispositivo. |
| Comentário | Quaisquer comentários sobre a capacidade da propriedade. |
| Description | Uma descrição da capacidade da propriedade. |
Para saber mais sobre a DTDL (Digital Twin Definition Language) que o Azure IoT Central usa para definir propriedades em um modelo de dispositivo, consulte Propriedades somente leitura de > convenções IoT Plug and Play.
Campos opcionais, como nome para exibição e descrição, permitem adicionar mais detalhes à interface e aos recursos.
Ao criar uma propriedade, você pode especificar tipos de esquema complexos, como Object e Enum.
Ao selecionar o esquema complexo, como Object, você precisa definir o esquema de objeto.
Implementar propriedades somente leitura
Por padrão, as propriedades são somente leitura. As propriedades somente leitura permitem que um dispositivo relate atualizações de valor de propriedade para seu aplicativo do Azure IoT Central. Seu aplicativo do Azure IoT Central não pode definir o valor de uma propriedade somente leitura.
O Azure IoT Central usa gêmeos de dispositivo para sincronizar valores de propriedade entre o dispositivo e o aplicativo Azure IoT Central. Os valores de propriedade do dispositivo usam as propriedades relatadas do gêmeo do dispositivo. Para obter mais informações, consulte gêmeos de dispositivo.
Um dispositivo envia atualizações de propriedade como uma carga JSON útil. Para obter mais informações, consulte Telemetria, propriedade e cargas úteis de comando.
Você pode usar o SDK do dispositivo IoT do Azure para enviar uma atualização de propriedade para seu aplicativo do Azure IoT Central.
Por exemplo, implementações em vários idiomas, consulte Criar e conectar um aplicativo cliente ao seu aplicativo do Azure IoT Central.
O modo de 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.
Por exemplo, 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 ac campos e av . O campo ad é opcional. Para saber mais, consulte Convenções Plug and Play da > IoT 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 de gêmeo de dispositivo para enviar o valor para o dispositivo. Em seguida, o dispositivo responde usando uma propriedade relatada de gêmeos de dispositivo. Quando o Azure IoT Central recebe o valor da propriedade relatada, ele atualiza a exibição da propriedade com um status de Aceito.
Quando você insere o valor e seleciona Salvar, o status inicial é Pendente. Quando o dispositivo aceita a alteração, o status muda para Aceito.
Usar propriedades em dispositivos não atribuídos
Você pode exibir e atualizar propriedades graváveis em um dispositivo que não está 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óximos passos
Agora que você aprendeu como usar propriedades em seu aplicativo do Azure IoT Central, consulte: