Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 em um momento específico no tempo. 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 do seu dispositivo com a sua aplicação 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 | Description |
|---|---|
| Nome de exibição | O nome de exibição do valor da propriedade utilizado 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 . |
| Tipo de capacidade | Imóvel. |
| Tipo semântico | 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. |
| Schema | 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. |
| 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á reportar valores de propriedade ao Azure IoT Central. Em seguida, o Azure IoT Central pode enviar atualizações de propriedade para o dispositivo. |
| Severity | Disponível apenas para o tipo semântico de evento. As gravidades são Erro, Informação ou Aviso. |
| Valores de estado | 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. |
| Unidade de visualização | Uma unidade de exibição para uso em painéis, blocos e formulários de dispositivo. |
| Comment | Quaisquer comentários sobre a capacidade da propriedade. |
| Description | Uma descrição da capacidade da propriedade. |
Para saber mais sobre a Digital Twin Definition Language (DTDL) que o Azure IoT Central usa para definir propriedades em um modelo de dispositivo, consulte as convenções IoT Plug and Play > Propriedades somente leitura.
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. O seu aplicativo do Azure IoT Central não pode definir o valor de uma propriedade de leitura única.
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 das propriedades do dispositivo utilizam as propriedades relatadas do gêmeo digital do dispositivo. Para obter mais informações, consulte Tutorial: Configurar seus dispositivos a partir de um serviço back-end.
Um dispositivo envia atualizações de propriedade como uma carga JSON. Para mais informações, ver Telemetria, propriedades 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 Tutorial: Criar e conectar um aplicativo cliente ao seu aplicativo do Azure IoT Central.
A visualização a seguir na aplicação Azure IoT Central mostra as propriedades de leitura exclusiva 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 o campo ac e o campo av. O campo ad é opcional. Para saber mais, consulte as convenções da IoT Plug and Play > propriedades graváveis.
Quando o operador define uma propriedade gravável na interface do utilizador do Azure IoT Central, a aplicação usa uma propriedade desejada do gémeo digital do dispositivo para enviar o valor para o dispositivo. Em seguida, o dispositivo responde usando uma propriedade relatada de gêmeo digital do 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ê sabe como usar propriedades em seu aplicativo do Azure IoT Central, consulte: