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.
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 determinado momento. 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 que você sincronize o estado entre o seu dispositivo e o 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 por um dispositivo e estão fora do escopo deste artigo.
Para saber mais sobre as convenções de propriedade IoT Plug and Play, consulte as convenções IoT Plug and Play.
Para saber mais sobre os dados de propriedade que um dispositivo troca com o IoT Central, consulte conteúdos de telemetria, propriedade e 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.
Definir 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 de ativação/desativação de um dispositivo. As propriedades também podem representar propriedades básicas do dispositivo, como a versão de software do dispositivo. É 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 do Azure IoT Central.
A tabela a seguir mostra as configurações de uma funcionalidade de propriedade.
| Campo | Description |
|---|---|
| Nome de exibição | 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 a partir do nome de exibição, mas você pode escolher seu próprio valor, se necessário. Esse campo deve ser alfanumérico. O código do dispositivo usa este valor 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. |
| Schema | 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 de semântica de estado e evento. |
| 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. |
| Severity | Disponível somente para o tipo semântico do evento. As severidades são Erro, Informações ou Aviso. |
| Valores de estado | Disponível somente para o tipo semântico de estado. Defina os valores de estado possíveis, cada um dos quais tem nome de exibição, nome, tipo de enumeração e valor. |
| Unidade | Uma unidade para o valor da propriedade, como mph ou %°C. |
| Unidade de exibição | Uma unidade de display para uso em painéis de controle e formulários de dispositivo. |
| Comment | Comentários sobre a funcionalidade de propriedade. |
| Description | Uma descrição da capacidade da 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 adicionar mais detalhes à interface e aos recursos.
Ao criar uma propriedade, você pode especificar tipos de esquema complexos, como Objeto e Enumeração.
Quando você seleciona o esquema complexo, como Objeto, 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 valor de propriedade de relatório do dispositivo seja atualizado para o aplicativo 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 dispositivos gêmeos para sincronizar valores de propriedade entre o dispositivo e o aplicativo Azure IoT Central. Os valores de propriedade do dispositivo usam propriedades relatadas do dispositivo gêmeo. Para obter mais informações, consulte Tutorial: Configurar seus dispositivos de um serviço de back-end.
Um dispositivo envia atualizações de propriedade como um conteúdo JSON. Para obter mais informações, consulte Telemetria, propriedade e cargas 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.
Para obter exemplos de implementações em vários idiomas, consulte Tutorial: 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.
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 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ê insere o valor e seleciona Salvar, o status inicial é Pendente. Quando o dispositivo aceita a alteração, o status é alterado 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óximas etapas
Agora que você sabe como usar propriedades em seu aplicativo do Azure IoT Central, confira: