Gerenciar dispositivos individuais em seu aplicativo do Azure IoT Central
Este artigo descreve como você gerencia dispositivos em seu aplicativo do Azure IoT Central. Pode:
- Use a página Dispositivos para exibir, adicionar e excluir dispositivos conectados ao seu aplicativo do Azure IoT Central.
- Mantenha os metadados do dispositivo atualizados alterando os valores armazenados nas propriedades do dispositivo a partir das suas visualizações.
- Controle o comportamento dos seus dispositivos atualizando uma definição num dispositivo específico a partir das suas vistas.
Para saber como gerenciar dispositivos em massa, consulte Gerenciar dispositivos em massa em seu aplicativo do Azure IoT Central.
Para saber como gerenciar dispositivos usando a API REST do IoT Central, consulte Como usar a API REST do IoT Central para gerenciar dispositivos.
Ver os seus dispositivos
Para visualizar um dispositivo individual:
Escolha Dispositivos no painel esquerdo. Aqui você vê uma lista de seus modelos de dispositivo e uma lista de todos os dispositivos acessíveis à sua organização.
Escolha um modelo de dispositivo.
No painel direito da página Dispositivos , você vê uma lista de dispositivos acessíveis à sua organização criados a partir desse modelo de dispositivo:
Escolha um dispositivo individual para ver a página de detalhes do dispositivo desse dispositivo.
Gorjeta
Você pode usar a ferramenta de filtro nesta página para exibir dispositivos em uma organização específica.
Monitorizar os dispositivos
Utilize a página Dispositivos para monitorizar e gerir os seus dispositivos.
O vídeo a seguir orienta você pelo status de conectividade do dispositivo de monitoramento:
Valores de estado do dispositivo
Cada dispositivo tem um único valor de status na interface do usuário. O estado do dispositivo pode ser um dos seguintes:
O status do dispositivo é primeiro Registrado. Esse status significa que o dispositivo é criado no IoT Central e tem uma ID de dispositivo. Um dispositivo é registado quando:
- Um novo dispositivo real é adicionado na página Dispositivos .
- Um conjunto de dispositivos é adicionado usando Importar na página Dispositivos .
O status do dispositivo muda para Provisionado quando um dispositivo registrado conclui a etapa de provisionamento usando o DPS (Serviço de Provisionamento de Dispositivo). Para concluir o processo de provisionamento, o dispositivo precisa da ID do dispositivo que foi usada para registrar o dispositivo, uma chave SAS ou um certificado X.509 e o escopo da ID. Depois que o DPS provisiona o dispositivo, ele pode se conectar ao seu aplicativo IoT Central e começar a enviar dados.
Os dispositivos bloqueados têm um estado de Bloqueado. Um operador pode bloquear e desbloquear dispositivos. Quando um dispositivo é bloqueado, ele não pode enviar dados para seu aplicativo IoT Central. Um operador deve desbloquear o dispositivo antes que ele possa retomar o envio de dados. Quando um operador desbloqueia um dispositivo, o status retorna ao seu valor anterior, Registrado ou Provisionado.
Se o status do dispositivo for Aguardando aprovação, isso significa que a opção Aprovação automática está desativada na página Grupos de conexão de dispositivos. Um operador deve aprovar explicitamente um dispositivo antes que ele possa ser provisionado e enviar dados. Os dispositivos não registados manualmente na página Dispositivos , mas ligados a credenciais válidas, têm o estado do dispositivo Aguardando aprovação. Os operadores podem aprovar esses dispositivos na página Dispositivos usando o botão Aprovar.
A tabela a seguir mostra como o valor de status de um dispositivo na interface do usuário mapeia para os valores usados pela API REST para interagir com dispositivos:
| Status do dispositivo da interface do usuário | Notas | Obter API REST |
|---|---|---|
| Aguardando aprovação | A opção de aprovação automática está desativada no grupo de conexões de dispositivo e o dispositivo não foi adicionado por meio da interface do usuário. Um usuário deve aprovar manualmente o dispositivo por meio da interface do usuário antes que ele possa ser usado. |
Provisioned: false Enabled: false |
| Registado | Um dispositivo foi aprovado automaticamente ou manualmente. | Provisioned: false Enabled: true |
| Aprovisionado | O dispositivo foi provisionado e pode se conectar ao seu aplicativo IoT Central. | Provisioned: true Enabled: true |
| Bloqueado | O dispositivo não tem permissão para se conectar ao seu aplicativo IoT Central. Você pode bloquear um dispositivo que esteja em qualquer um dos outros estados. | Provisioned: depende de Waiting for approval/Registered/Provisioned status Enabled: false |
Um dispositivo também pode ter um status de Não atribuído. Esse status não é mostrado no campo Status do dispositivo na interface do usuário, ele é mostrado no campo Modelo de dispositivo na interface do usuário. No entanto, você pode filtrar a lista de dispositivos para dispositivos com o status Não atribuído . Se o status do dispositivo for Não atribuído, o dispositivo que se conecta ao IoT Central não será atribuído a um modelo de dispositivo. Essa situação normalmente acontece nos seguintes cenários:
- Um conjunto de dispositivos é adicionado usando Importar na página Dispositivos sem especificar o modelo de dispositivo.
- Um dispositivo foi registrado manualmente na página Dispositivos sem especificar o modelo de dispositivo. O dispositivo, em seguida, conectado com credenciais válidas.
Um operador pode atribuir um dispositivo a um modelo de dispositivo na página Dispositivos usando o botão Migrar .
Estado da ligação do dispositivo
Quando um dispositivo ou dispositivo de borda se conecta usando o protocolo MQTT, eventos conectados e desconectados para o dispositivo são gerados. O dispositivo não envia esses eventos, o IoT Central os gera internamente.
O diagrama a seguir mostra como, quando um dispositivo se conecta, a conexão é registrada no final de uma janela de tempo. Se ocorrerem vários eventos de conexão e desconexão, o IoT Central registrará aquele que estiver mais próximo do final da janela de tempo. Por exemplo, se um dispositivo se desconectar e se reconectar dentro da janela de tempo, o IoT Central registrará o evento de conexão. Atualmente, a janela de tempo é de aproximadamente um minuto.
Assista ao vídeo a seguir para saber mais sobre como monitorar o status da conexão do dispositivo:
Você pode incluir eventos de conexão e desconexão em Exportar dados de IoT para destinos na nuvem usando o Armazenamento de Blob. Para saber mais, consulte Reagir a eventos > do Hub IoT Limitações para eventos de dispositivo conectado e dispositivo desconectado.
Adicionar um dispositivo
Para adicionar um dispositivo ao seu aplicativo do Azure IoT Central:
Escolha Dispositivos no painel esquerdo.
Escolha o modelo de dispositivo a partir do qual pretende criar um dispositivo.
Escolha + Novo.
Insira um nome e ID de dispositivo ou aceite o padrão. O comprimento máximo de um nome de dispositivo é de 148 caracteres. O comprimento máximo de um ID de dispositivo é de 128 caracteres.
Ative ou Desative o botão Simulado. Um dispositivo real é para um dispositivo físico que você conecta ao seu aplicativo do Azure IoT Central. Um dispositivo simulado tem dados de exemplo gerados para você pelo Azure IoT Central.
Se seu aplicativo usa organizações, escolha a organização à qual o dispositivo pertence.
Gorjeta
Você pode definir uma organização padrão para aparecer na lista suspensa da organização.
Selecione Criar.
Este dispositivo aparece agora na sua lista de dispositivos para este modelo. Selecione o dispositivo para ver a página de detalhes do dispositivo que contém todas as visualizações do dispositivo.
Obter informações de conexão do dispositivo
Quando um dispositivo provisiona e se conecta ao IoT Central, ele precisa de informações de conexão do seu aplicativo IoT Central:
- O Escopo de ID que identifica o aplicativo para DPS.
- A ID do dispositivo que foi usada para registrar o dispositivo.
- Uma chave SAS ou um certificado X.509.
Para encontrar estes valores:
Escolha Dispositivos no painel esquerdo.
Para ver os detalhes do dispositivo, clique no dispositivo na lista de dispositivos.
Selecione Conectar para exibir as informações de conexão. O código QR codifica um documento JSON que inclui o Escopo da ID, a ID do Dispositivo e a Chave primária derivada do grupo de conexão de dispositivo padrão SAS-IoT-Devices.
Nota
Se o tipo de autenticação for Assinatura de acesso compartilhado, as chaves exibidas serão derivadas do grupo de conexão de dispositivo padrão SAS-IoT-Devices .
Mudar de organização
Para mover um dispositivo para uma organização diferente, você deve ter acesso às organizações de origem e de destino. Para mover um dispositivo:
Escolha Dispositivos no painel esquerdo.
Selecione o dispositivo a ser movido na lista de dispositivos.
Selecione Gerenciar dispositivo e organização no menu suspenso.
Selecione a nova organização para o dispositivo:
Selecione Guardar.
Migrar dispositivos para um modelo
Se você registrar dispositivos iniciando a importação em Todos os dispositivos, os dispositivos serão criados sem qualquer associação de modelo de dispositivo. Os dispositivos devem ser atribuídos a um modelo para explorar os dados e outros detalhes sobre o dispositivo. Siga estas etapas para atribuir dispositivos a um modelo:
Escolha Dispositivos no painel esquerdo.
No painel esquerdo, escolha Todos os dispositivos.
Selecione os dispositivos não atribuídos que deseja atribuir a um modelo:
Selecione Migrar:
Escolha o modelo na lista de modelos disponíveis e selecione Migrar.
Os dispositivos selecionados são atribuídos ao modelo de dispositivo escolhido.
Eliminar um dispositivo
Para excluir um dispositivo real ou simulado do seu aplicativo do Azure IoT Central:
Escolha Dispositivos no painel esquerdo.
Escolha o modelo de dispositivo do dispositivo que você deseja excluir.
Utilize as ferramentas de filtro para filtrar e procurar os seus dispositivos. Marque a caixa ao lado dos dispositivos a serem excluídos.
Escolha Eliminar. Você pode acompanhar o status dessa exclusão no painel Operações do dispositivo.
Alterar uma propriedade
As propriedades da nuvem são os metadados do dispositivo associados ao dispositivo, como cidade e número de série. As propriedades de nuvem só existem no aplicativo IoT Central e não são sincronizadas com seus dispositivos. As propriedades graváveis controlam o comportamento de um dispositivo e permitem definir o estado de um dispositivo remotamente, por exemplo, definindo a temperatura alvo de um dispositivo termostato. As propriedades do dispositivo são definidas pelo dispositivo e são somente leitura no IoT Central. Pode ver e atualizar as propriedades nas vistas Detalhes do Dispositivo do seu dispositivo.
Escolha Dispositivos no painel esquerdo.
Escolha o modelo de dispositivo cujas propriedades você deseja alterar e selecione o dispositivo de destino.
Escolha a vista que contém propriedades para o seu dispositivo, esta vista permite-lhe introduzir valores e selecione Guardar na parte superior da página. Aqui você vê as propriedades que seu dispositivo tem e seus valores atuais. As propriedades de nuvem e as propriedades graváveis têm campos editáveis, enquanto as propriedades do dispositivo são somente leitura. Para propriedades graváveis, você pode ver seu status de sincronização na parte inferior do campo.
Modifique as propriedades para os valores necessários. Você pode modificar várias propriedades ao mesmo tempo e atualizá-las todas ao mesmo tempo.
Escolha Guardar. Se você salvou propriedades graváveis, os valores são enviados para o seu dispositivo. Quando o dispositivo confirma a alteração para a propriedade gravável, o status retorna para sincronizado. Se você salvou uma propriedade na nuvem, o valor será atualizado.