Iot Central

Contents
Documentação do Azure IoT Central

Visão geral
O que é Azure IoT Central
Tour da interface do usuário
Inícios rápidos
Crie um novo aplicativo
Tutoriais
1 - Definir um novo tipo de dispositivo
2 - Configurar regras
3 - Personalizar exibição do operador
4 - Monitorar seus dispositivos
5 - Adicionar um dispositivo
Conceitos
Arquitetura
Conectividade
O que são modelos de aplicativo?
Guias de instruções
Conectar dispositivos
Preparar e conectar um aplicativo Node.js (genérico)
Preparar e conectar um MXChip IoT DevKit
Preparar e conectar um Raspberry Pi (Python)
Preparar e conectar um Raspberry Pi (C#)
Preparar e conectar um dispositivo Windows IoT Core
Preparar e conectar um dispositivo SensorTile.box
Monitorar a conectividade do dispositivo usando a linha de comando
Gerenciar dispositivos
Configurar um modelo de dispositivo
Gerenciar seus dispositivos
Executar um trabalho
Usar conjuntos de dispositivos
Modelo do dispositivo de versão
Monitoramento e análise
Criar regra de telemetria
Criar uma regra de eventos
Analisar dados do dispositivo
Ações e extensibilidade
Agrupar várias ações em regras
Criar ações de webhook em regras
Criar fluxos de trabalho no Microsoft Flow
Criar fluxos de trabalho em Aplicativos Lógicos do Azure
Disparar Azure Functions
Exportar seus dados
Exportar para Hubs de Eventos e Barramento de Serviço
Exportar para o Armazenamento de Blobs
Criar regras personalizadas
Criar análise personalizada
Visualizar seus dados no Power BI
Conectar outras nuvens de IoT
Administração
Gerenciar seu aplicativo
Gerenciar usuários e funções
Exibir a fatura
Personalizar a interface do usuário do aplicativo
Preparar e carregar a imagem
Adicionar blocos ao dashboard
Usar blocos de painel
Usar modelos de aplicativo
Gerenciar usando o portal do Azure
Gerenciar usando a CLI do Azure
Gerenciar usando o Azure PowerShell
Criar e gerir um aplicativo enquanto CSP
Personalização
Criar dashboards pessoais do Azure IoT Central
Gerenciar suas preferências
Alternar chat ao vivo
Relacionados
Soluções
Central da IoT
Aceleradores de solução do IoT
Serviços de plataforma
Hub IoT
IoT Plug and Play
Provisionamento de Dispositivos no Hub IoT
SDKs do Serviço de IoT
Mapas
Time Series Insights
IoT Edge
Azure IoT Edge
SDKs do dispositivo IoT
Recursos
Solicitações de dados do cliente
Navegadores com suporte
O que é Azure IoT Central?
14/01/2020 • 9 minutes to read • Edit Online
NOTE
No momento, você está exibindo a documentação do IoT Central dos modelos de aplicativo que usam os recursos em
disponibilidade geral. Para exibir a documentação de modelos de aplicativo que usam a versão prévia dos recursos, acesse O
que é o Azure IoT Central (versão prévia dos recursos)?.
O Azure IoT Central é uma plataforma de aplicativo IoT que reduz a carga e o custo associado ao
desenvolvimento, ao gerenciamento e à manutenção de soluções de IoT de nível empresarial. Optar por criar com
o Azure IoT Central oferece a oportunidade de concentrar seu tempo, dinheiro e energia na transformação de seus
negócios com os dados de IoT, em vez de apenas manter e atualizar uma infraestrutura de IoT complexa e
continuamente em evolução.
A interface fácil de usar facilita o monitoramento das condições do dispositivo, a criação de regras e o
gerenciamento de milhões de dispositivos e seus dados ao longo de seu ciclo de vida. Além disso, permite que
você atue com base em insights do dispositivo estendendo a inteligência da IoT em aplicativos de linha de
negócios.
Este artigo descreve os seguintes tópicos do Azure IoT Central:
As personas típicas associadas a um projeto.
Como criar seu aplicativo.
Como conectar seus dispositivos ao seu aplicativo
Como gerenciar seu aplicativo.
Personas
A documentação do Azure IoT Central refere-se a quatro personas que interagem com um aplicativo do Azure IoT
Central:
Um construtor é responsável pela definição dos tipos de dispositivos que se conectam ao aplicativo e pela
personalização do aplicativo para o operador.
Um operador gerencia os dispositivos conectados ao aplicativo.
Um administrador é responsável por tarefas como gerenciar funções de usuários e permissões dentro do
aplicativo.
Um desenvolvedor de dispositivo cria o código que é executado em um dispositivo conectado ao seu aplicativo.
Criar seu aplicativo do Azure IoT Central

Como um construtor, você usa o Azure IoT Central para criar uma solução de IoT personalizada e hospedada na
nuvem para sua organização. Uma solução de IoT personalizada normalmente consiste em:
Um aplicativo baseado em nuvem que recebe telemetria de seus dispositivos e permite o gerenciamento dos
dispositivos.
Vários dispositivos executando o código personalizado conectado ao seu aplicativo baseado em nuvem.
É possível implantar rapidamente um novo aplicativo do Azure IoT Central e personalizá-lo no navegador de
acordo com seus requisitos específicos. Como um construtor, você usa as ferramentas baseadas na web para criar
um modelo de dispositivo para os dispositivos que se conectam ao seu aplicativo. Um modelo de dispositivo é um
blueprint que define as características e o comportamento de um tipo de dispositivo, como:
A telemetria que ele envia.
As propriedades de negócios que um operador pode modificar.
As propriedades do dispositivo que são definidas por um dispositivo e são somente leitura no aplicativo.
Os limites aos quais o aplicativo responde.
Configurações que determinam o comportamento do dispositivo.
É possível testar imediatamente seus modelos de dispositivo e o aplicativo com dados simulados que o Azure IoT
Central gera para você.
Como um construtor, você também pode personalizar o aplicativo do Azure IoT Central da interface do usuário
para os operadores responsáveis pelo uso diário do aplicativo. As personalizações que um construtor pode fazer
incluem:
A definição do layout de propriedades e configurações em um modelo do dispositivo.
A configuração de painéis personalizados para ajudar os operadores a descobrirem insights e resolverem
problemas mais rapidamente.
A configuração da análise personalizada para explorar os dados de série temporal de seus dispositivos
conectados.
Conecte seus dispositivos

Depois que o construtor define os tipos de dispositivos que podem se conectar ao aplicativo, um desenvolvedor de
dispositivo cria o código para executar os dispositivos. Como um desenvolvedor de dispositivo, você usa os SDKs
do Azure IoT de código aberto da Microsoft para criar seu código de dispositivo. Esses SDKs têm amplo suporte a
linguagem, plataforma e protocolo para atender às suas necessidades de conexão de dispositivos ao seu aplicativo
do Azure IoT Central. Os SDKs ajudam a implementar os seguintes recursos do dispositivo:
Criar uma conexão segura.
Enviar telemetria.
Relatar o status.
Receber atualizações periódicas.
Para obter mais informações, consulte a postagem de blog Os benefícios de usar os SDKs do Azure IoT e as
armadilhas a serem evitadas caso não os use.
Gerenciar seu aplicativo

Aplicativos do Azure IoT Central são totalmente hospedados pela Microsoft, o que reduz a sobrecarga de
administração do gerenciamento de seus aplicativos.
Como um operador, você pode usar o aplicativo do Azure IoT Central para gerenciar os dispositivos em sua
solução do Azure IoT Central. Operadores realizam tarefas como:
Monitorar os dispositivos conectados ao aplicativo.
Solucionar e corrigir problemas com dispositivos.
Provisionar novos dispositivos.
Como desenvolvedor, você pode definir regras e ações personalizadas que operem em um fluxo de dados dos
dispositivos conectados. Um operador pode habilitar ou desabilitar essas regras no nível do dispositivo para
controlar e automatizar tarefas dentro do aplicativo.
Os administradores gerenciam o acesso ao seu aplicativo com funções de usuário e permissões.
Próximas etapas
Agora que você tem uma visão geral do Azure IoT Central, aqui estão as próximas etapas sugeridas:
Entenda as tecnologias e os serviços disponíveis do Azure para criar soluções de IoT disponíveis.
Familiarizar-se com a interface do usuário do Azure IoT Central.
Comece com a criação de um aplicativo do Azure IoT Central.
Siga uma sequência de tutoriais que mostram:
Como um construtor, como criar um modelo de dispositivo
Como um construtor, como adicionar regras para automatizar a sua solução
Como um construtor, como personalizar o aplicativo para seus operadores
Como um operador, como monitorar seus dispositivos
Como um operador, como adicionar um dispositivo real à sua solução
Como um desenvolvedor do dispositivo, como criar código para seus dispositivos
Faça um tour da interface do usuário do Azure IoT
Central
NOTE
Este artigo apresenta a interface do usuário do Microsoft Azure IoT Central. Você pode usar a interface do usuário
para criar, gerenciar e usar uma solução do Azure IoT Central e seus dispositivos conectados.
Como um construtor, use a interface do usuário do Azure IoT Central para definir sua solução o Azure IoT Central.
Você pode usar a interface do usuário para:
Definir os tipos de dispositivos que se conectam à sua solução.
Configurar as regras e ações para seus dispositivos.
Personalizar a interface do usuário para um operador que usa sua solução.
Como um operador, você pode usar a interface do usuário do Azure IoT Central para gerenciar sua solução do
Azure IoT Central. Você pode usar a interface do usuário para:
Monitorar seus dispositivos.
Configurar seus dispositivos.
Solucionar e corrigir problemas com dispositivos.
Provisione novos dispositivos.
Usar o painel esquerdo

Use o painel esquerdo para acessar as diferentes áreas do aplicativo. Você pode expandir ou recolher a barra de
navegação, selecionando < ou > :
Painel exibe o painel de seu aplicativo. Como um construtor, você pode personalizar o painel para seus
operadores. Os usuários também podem criar seus próprios painéis.
O Device Explorer lista os dispositivos simulados e reais associados a cada modelo de dispositivo no aplicativo.
Como um operador, use o Device Explorer para gerenciar os dispositivos conectados.
Conjuntos de Dispositivos permite exibir e criar conjuntos de dispositivos. Como um operador, você pode criar
conjuntos de dispositivos como uma coleção lógica de dispositivos especificados por uma consulta.
Análise mostra a análise derivada da telemetria do dispositivo para dispositivos e conjuntos de dispositivos.
Como um operador, você pode criar exibições personalizadas sobre dados do dispositivo para derivar insights de
seu aplicativo.
Trabalhos habilita o gerenciamento de dispositivo em massa fazendo você criar e executar trabalhos para realizar
atualizações em escala.
Modelos de Dispositivo mostra as ferramentas usadas por um construtor para criar e gerenciar modelos de
dispositivo.
Exportação Contínua de Dados permite que um administrador configure uma exportação contínua para outros
serviços do Azure, como armazenamento e filas.
Administração mostra as páginas de administração do aplicativo em que um administrador pode gerenciar as
configurações de aplicativo, usuários e funções.
Pesquisa, ajuda e suporte

O menu superior aparece em cada página:
Para procurar dispositivos e modelos de dispositivo, insira um valor Pesquisar.
Para alterar o idioma da interface do usuário ou o tema, escolha o ícone Configurações.
Para sair do aplicativo, escolha o ícone Conta.
Para obter ajuda e suporte, escolha o menu suspenso da Ajuda para ver uma lista de recursos. Em um
aplicativo de avaliação, os recursos de suporte incluem o acesso ao chat ao vivo.
Você pode escolher entre um tema claro ou escuro para a interface do usuário:
NOTE
A opção de escolher entre os temas claro e escuro não estará disponível se o administrador tiver configurado um tema
personalizado para o aplicativo.
painel
O painel é a primeira página que você vê quando entra no seu aplicativo do Azure IoT Central. Como um
construtor, você pode adicionar blocos para personalizar o painel de outros usuários do aplicativo. Para
obter mais informações, consulte o tutorial Personalizar modo de exibição do operador do Azure IoT
Central.
Como operador, você pode criar painéis personalizados e alternar entre eles e o painel padrão. Para saber
mais, confira o artigo de instruções Criar painéis pessoais do Azure IoT Central.
Gerenciador de dispositivos
A página Explorer mostra os dispositivos no aplicativo do Azure IoT Central agrupados por modelo de dispositivo.
Um modelo do dispositivo define um tipo de dispositivo que pode se conectar ao seu aplicativo. Para saber
mais, consulte Definir um novo tipo de dispositivo em seu aplicativo do Azure IoT Central.
Um dispositivo representa um dispositivo real ou simulado no seu aplicativo. Para saber mais, consulte
Adicionar um novo dispositivo ao seu aplicativo do Azure IoT Central.
Conjuntos de dispositivos
A página Conjuntos de dispositivos mostra conjuntos de dispositivos criados pelo construtor. Um conjunto de
dispositivos é uma coleção de dispositivos relacionados. Um construtor define uma consulta para identificar os
dispositivos que estão incluídos em um conjunto de dispositivos. Ao personalizar a análise em seu aplicativo, você
usa conjuntos de dispositivos. Para saber mais, consulte o artigo Usar conjuntos de dispositivos em seu aplicativo
do Azure IoT Central.
Análise
A página Análise mostra gráficos que ajudam você a entender como os dispositivos conectados ao seu aplicativo
estão se comportando. Um operador usa essa página para monitorar e investigar problemas com dispositivos
conectados. O construtor pode definir os gráficos mostrados nessa página. Para saber mais, consulte o artigo Criar
análises personalizadas para seu aplicativo do Azure IoT Central.
Trabalhos
A página de trabalhos permite que você execute operações de gerenciamento de dispositivos em massa em seus
dispositivos. O construtor usa essa página para atualizar propriedades do dispositivo, configurações e comandos.
Para saber mais, consulte o artigo Executar um trabalho.
Modelos de dispositivo
A página Modelos de Dispositivo é o local em que um construtor cria e gerencia os modelos de dispositivo no
aplicativo. Um modelo de dispositivo especifica as características do dispositivo, como:
medidas de telemetria, estado e evento.
configurações e propriedades.
comandos.
Regras com base em eventos ou valores de telemetria.
Para saber mais, consulte o tutorial Definir um novo tipo de dispositivo em seu aplicativo do Azure IoT Central.
Exportação contínua de dados
A página de exportação contínua de dados é onde o administrador define como transmitir dados, como a
telemetria, do aplicativo. Outros serviços podem armazenar os dados exportados ou usá-los para análise. Para
saber mais, confira o artigo Exportar seus dados no Azure IoT Central.
Administração
A página de administração contém links para as ferramentas usadas por um administrador para definir usuários e
funções no aplicativo e personalizar a interface do usuário. Para saber mais, consulte o artigo Administrar seu
aplicativo do Azure IoT Central.
Próximas etapas
Agora que você tem uma visão geral do Azure IoT Central e está familiarizado com o layout da interface do
usuário, a próxima etapa sugerida é concluir o início rápido Criar um aplicativo do Azure IoT Central.
Crie um aplicativo Azure IoT Central
NOTE
disponibilidade geral. Para exibir a documentação de modelos de aplicativo que usam a versão prévia dos recursos,
acesse O que é o Azure IoT Central (versão prévia dos recursos)?.
Como um construtor, use a interface do usuário do Azure IoT Central para definir seu aplicativo Microsoft
Azure IoT Central. Este início rápido mostra como criar um aplicativo Azure IoT Central que contém um
modelo de dispositivo de exemplo. O aplicativo que você cria não usa nenhuma versão prévia dos recursos.
Criar um aplicativo
Navegue até o site do Build do Azure IoT Central. Em seguida, entre com uma conta pessoal, corporativa ou de
estudante da Microsoft.
Para começar a criar um aplicativo do Azure IoT Central sem a versão prévia dos recursos habilitada, selecione
Build. Esse link leva você para a página Crie um aplicativo IoT.
Em seguida, selecione Aplicativo personalizado.

Para criar um novo aplicativo Azure IoT Central:
1. O Azure IoT Central sugere automaticamente um nome de aplicativo com base no modelo de aplicativo
selecionado. Aceite esse nome ou insira seu próprio nome de aplicativo amigável, como Contoso IoT.
O Azure IoT Central também gera uma URL exclusiva para você, com base no nome do aplicativo. Você
terá a liberdade para alterar esse prefixo de URL para algo mais fácil de memorizar se desejar.
2. Selecione o modelo de aplicativo herdado que não use recursos da versão prévia.
MODELO DE APLICATIVO DESCRIÇÃO
Aplicativo herdado Cria um aplicativo vazio para você preencher com seus
próprios dispositivos e modelos de dispositivos.
3. Escolha um plano de pagamento:

Os aplicativos de avaliação gratuita de 7 dias são gratuitos por sete dias antes de expirarem.
Eles podem ser convertidos em Pagamento Conforme o Uso em qualquer momento antes de
expirarem. Se você criar um aplicativo de Avaliação, precisará inserir suas informações de
contato e escolher se deseja receber informações e dicas da Microsoft.
Os aplicativos de Pagamento Conforme o Uso são cobrados por dispositivo, com os cinco
primeiros dispositivos gratuitos. Se você criar um aplicativo de Pagamento Conforme o Uso,
precisará escolher o Directory, a Assinatura do Azure e a Localização:
Directory é o AD (Azure Active Directory) para criar o aplicativo. Ele contém identidades de
usuário, credenciais e outras informações organizacionais. Se você não tiver um Azure AD, ele
será gerado quando você criar uma assinatura do Azure.
Uma Assinatura do Azure permite que você crie instâncias de serviços do Azure. O IoT
Central provisiona recursos em sua assinatura. Se você não tiver uma assinatura do Azure,
poderá criar uma na página de entrada do Azure. Depois de criar a assinatura do Azure, volte
à página Criar um aplicativo. A nova assinatura aparece na lista suspensa Assinatura do
Azure.
A Localização é a geografia em que você deseja criar seu aplicativo. Normalmente, você deve
escolher a localização fisicamente mais próxima de seus dispositivos para obter um
desempenho ideal. No momento, o Azure IoT Central está disponível nos Estados Unidos, na
Austrália, no Pacífico Asiático e na Europa. Depois de escolher uma localização, você não
poderá mover o aplicativo posteriormente para outra localização.
Saiba mais sobre preços na Página de preços da microsoft IoT Central.
4. Preencha as informações adicionais necessárias para o plano de pagamento selecionado anteriormente,
na Etapa 1.
5. Selecione Criar na parte inferior da página.
Próximas etapas
Neste início rápido, você criou um aplicativo IoT Central. Aqui estão sugestões para as próximas etapas:
Definir um novo tipo de dispositivo em seu aplicativo do Azure IoT Central
Tutorial: Definir um novo tipo de dispositivo em seu
aplicativo do Azure IoT Central
NOTE
disponibilidade geral. Para exibir a documentação de modelos de aplicativo que usam a versão prévia dos recursos, acesse
O que é o Azure IoT Central (versão prévia dos recursos)?.
Este tutorial mostra a você, como um construtor, como usar um modelo de dispositivo para definir um novo
tipo de dispositivo no seu aplicativo Microsoft Azure IoT Central. Um modelo de dispositivo define a telemetria,
estado, propriedades e configurações para o seu tipo de dispositivo.
Para permitir que você teste o seu aplicativo antes de conectá-lo a um dispositivo real, o IoT Central gera um
dispositivo simulado a partir do modelo de dispositivo quando você o cria.
Neste tutorial, você criará um modelo de dispositivo de Ar-condicionado conectado. Um dispositivo de ar-
condicionado conectado:
Envia a telemetria como temperatura e umidade.
Relata o estado, como se ele está ligado ou desligado.
Tem propriedades de dispositivo como versão de firmware e número de série.
Tem configurações como temperatura de destino.
Neste tutorial, você aprenderá como:
Criar um novo modelo de dispositivo
Adicionar telemetria ao seu dispositivo
Exibir telemetria simulada
Definir uma medida de evento
Exibir eventos simulados
Definir medida de estado
Exibir estado simulado
Usar configurações e propriedades
Usar comandos
Exibir seu dispositivo simulado no painel
Pré-requisitos
Para concluir este tutorial, você precisa de um aplicativo do Azure IoT Central criado com base no modelo de
Aplicativo personalizado. Se não tiver um aplicativo, conclua o início rápido Criar um aplicativo do Azure IoT
Central escolhendo o modelo de Aplicativo personalizado.
Crie um modelo de dispositivo

Como um construtor, você pode criar e editar os modelos de dispositivo no seu aplicativo. Quando você cria um
modelo de dispositivo, o Azure IoT Central gera um dispositivo simulado a partir do modelo. O dispositivo
simulado gera telemetria que permite que você teste o comportamento do seu aplicativo antes de você
conectar um dispositivo real.
Para adicionar um novo modelo de dispositivo ao aplicativo, você precisará acessar a página Modelos de
Aplicativo. Para fazer isso, selecione Modelos de Dispositivo no painel esquerdo.
Adicionar um modelo de dispositivo

As etapas a seguir mostram como criar um novo modelo de dispositivo de Ar-condicionado conectado para
dispositivos que enviam telemetria de temperatura para o seu aplicativo:
1. Na página Modelos de Dispositivo, selecione + Novo:
2. A página mostra os modelos que você pode escolher.

3. Selecione Personalizado, insira Ar Condicionado Conectado como o nome do modelo de dispositivo
e, em seguida, selecione Criar. Você também pode carregar uma imagem do seu dispositivo que é visível
para os operadores no Device Explorer:
4. No modelo de dispositivo Ar-condicionado Conectado, verifique se você está na guia Medidas, na

qual a telemetria é definida. Cada modelo de dispositivo definido tem guias separadas para você:
Especificar as medidas, como telemetria, evento e estado, enviadas pelo dispositivo.
Definir as configurações usadas para controlar o dispositivo.
Definir as propriedades que são os metadados do dispositivo.
Definir os comandos a serem executados diretamente no dispositivo.
Definir as regras associadas ao dispositivo.
Personalizar o painel do dispositivo para os operadores.
NOTE
Para alterar o nome do modelo de dispositivo, selecione o nome do modelo na parte superior da página.
5. Para adicionar a medida de telemetria de temperatura, selecione + Nova Medida. Em seguida, escolha
Telemetria como o tipo de medida:
6. Cada tipo de telemetria que você define para um modelo de dispositivo inclui opções de configuração
como:
Opções de exibição.
Detalhes da telemetria.
Parâmetros de simulação.
Para configurar sua telemetria de Temperatura, use as informações na tabela a seguir:
CONFIGURAÇÃO VALOR
Nome de exibição Temperatura
Nome do campo temperatura
Unidades F
Min 60
max 110
Casas decimais 0
Você também pode escolher uma cor para a exibição da telemetria. Para salvar a definição de
telemetria, selecione Salvar:
7. Após alguns instantes, a guia Medidas mostrará um gráfico da telemetria de temperatura do dispositivo
simulado de ar-condicionado conectado. Use os controles para gerenciar a visibilidade, agregação, ou
para editar a definição de telemetria:
NOTE
Para telemetria, Média é definida como a agregação padrão.
8. Você também pode personalizar o gráfico usando os controles Linha, Empilhado e Editar intervalo
de tempo:
Adicionar uma medida de evento

Use eventos para definir dados pontuais enviados pelo dispositivo quando houver um evento, como um erro ou
uma falha de componente. O Azure IoT Central pode simular eventos do dispositivo para permitir que você
teste o comportamento do aplicativo antes de conectar um dispositivo real. Defina medidas de evento para o
modelo de dispositivo na exibição Medidas.
1. Para adicionar a medida de evento Erro do Motor de Ventilador, selecione + Nova Medida. Em
seguida, escolha Evento como o tipo de medida:
2. Cada tipo de Evento que você define para um modelo de dispositivo inclui opções de configuração como:
Nome de exibição.
Nome do campo.
Gravidade.
Para configurar seu evento de Erro do motor do ventilador, use as informações na tabela a
seguir:
Nome de exibição Erro do motor do ventilador
Nome do campo fanmotorerr
Severity Erro
Para salvar a definição de evento, selecione Salvar:

3. Após alguns instantes, a guia Medidas mostrará um gráfico dos eventos gerados aleatoriamente com
base no dispositivo simulado de ar-condicionado conectado. Use os controles para gerenciar a
visibilidade ou para editar a definição de evento:
4. Para ver detalhes adicionais sobre o evento, selecione o evento no gráfico:

Definir uma medida de estado
Use o estado para definir e visualizar o estado do dispositivo ou de seu componente ao longo de um período. O
Azure IoT Central pode simular o estado do dispositivo para permitir que você teste o comportamento do
aplicativo antes de conectar um dispositivo real. Você define as medidas de estado para o seu tipo de
dispositivo na exibição Medidas.
1. Para adicionar uma medida de estado Modo Ventilador, selecione + Nova Medida. Em seguida,
escolha Estado como o tipo de medida:
2. Cada tipo de estado definido para um modelo de dispositivo inclui opções de configuração como:
Nome de exibição.
Nome do campo.
Valores com rótulos de exibição opcionais.
Cor de cada valor.
Para configurar seu estado de Modo ventilação, use as informações na tabela a seguir:
Nome de exibição Modo ventilação
Nome do campo fanmode
Valor 1
Rótulo de exibição Operacional
Valor 0
Rótulo de exibição Parado
Para salvar a definição de medida de estado, selecione Salvar:
3. Após alguns instantes, a guia Medidas mostrará um gráfico dos estados gerados aleatoriamente com
base no dispositivo simulado de ar-condicionado conectado. Use os controles para gerenciar a
visibilidade ou para editar a definição de estado:
4. Se houver muitos pontos de dados enviados pelo dispositivo durante um curto período, a medida de
estado será mostrada com um visual diferente. Selecione o gráfico para ver todos os pontos de dados
dentro desse período exibidos em ordem cronológica. Também é possível reduzir o intervalo de tempo
para ver as medidas com mais detalhes.
Configurações, propriedades e comandos

Configurações, propriedades e comandos são valores diferentes definidos em um modelo de dispositivo e
associados a cada dispositivo individual:
Você usa configurações para enviar dados de configuração para um dispositivo a partir de seu aplicativo.
Por exemplo, um operador pode usar uma configuração para alterar o intervalo de telemetria do
dispositivo de dois segundos para cinco segundos. Quando um operador altera uma configuração, a
configuração é marcada como pendente na interface do usuário até que o dispositivo responda com uma
confirmação.
Você usa propriedades para definir metadados associados ao seu dispositivo. Existem duas categorias de
propriedades:
Você usa propriedades de aplicativo para registrar informações sobre seu dispositivo no seu
aplicativo. Por exemplo, você pode usar as propriedades do aplicativo para registrar o local de um
dispositivo e sua última data de serviço. Essas propriedades são armazenadas no aplicativo e não
são sincronizadas com o dispositivo. Um operador pode atribuir valores às propriedades.
Você usa propriedades do dispositivo para habilitar um dispositivo para envio de valores de
propriedade para o seu aplicativo. Essas propriedades só podem ser alteradas pelo dispositivo.
Para um operador, as propriedades do dispositivo são somente leitura. Nesse cenário de um ar-
condicionado conectado, o número de série do dispositivo e a versão de firmware são
propriedades do dispositivo relatadas pelo dispositivo.
Para obter mais informações, confira Propriedades no guia de instruções sobre como configurar
um modelo de dispositivo.
Você usa comandos para gerenciar remotamente seu dispositivo a partir de seu aplicativo. Você pode
executar comandos diretamente no dispositivo da nuvem para controlar os dispositivos. Por exemplo,
um operador pode executar comandos como reinicialização para reinicializar o dispositivo
instantaneamente.
Use as configurações
Você usa configurações para permitir que um operador envie dados de configuração para um dispositivo. Nesta
seção, você adiciona uma configuração para o seu modelo de dispositivo de Ar-condicionado conectado que
permite que um operador defina a temperatura de destino do ar-condicionado conectado.
1. Navegue para a guia Configurações do modelo de dispositivo Ar-condicionado Conectado.
2. Você pode criar configurações de tipos diferentes, como números ou texto. Selecione Número para
adicionar uma configuração de número ao dispositivo.
3. Para definir sua configuração de Temperatura definida, use as informações na tabela a seguir:
CAMPO VALOR
Nome de exibição Temperatura definida
Nome do campo setTemperature
Unidade de medida F
Casas Decimais 1
Valor mínimo 20
Valor máximo 200
Valor inicial 80
DESCRIÇÃO Defina a temperatura de destino para o ar-condicionado
Em seguida, selecione Salvar:

NOTE
Quando o dispositivo confirmar a alteração da configuração, o status da configuração mudará para sincronizado.
4. Personalize o layout da guia Configurações movendo e redimensionando os blocos de configurações:

Usar propriedades
Você usa propriedades do aplicativo para registrar informações sobre seu dispositivo no seu aplicativo. Nesta
seção, você adiciona as propriedades do aplicativo para seu modelo de dispositivo Ar-Condicionado
Conectado para armazenar o local do dispositivo e a última data de serviço. Essas propriedades são editáveis
no aplicativo. O dispositivo também relata propriedades, como número de série e versão de firmware, que são
somente leitura no aplicativo.
1. Navegue para a guia Propriedades do modelo de dispositivo Ar-condicionado Conectado.
2. Você pode criar propriedades de dispositivo de tipos diferentes, como números ou texto. Para adicionar
uma propriedade local para seu modelo de dispositivo, escolha Local. Para configurar sua propriedade
de local, use as informações na tabela a seguir:
CAMPO VALOR
Nome de exibição Location
Nome do campo location
Valor inicial Seattle, WA
DESCRIÇÃO Localização do dispositivo
Deixe os outros campos com os seus respectivos valores padrão.

Clique em Salvar.
3. Para adicionar uma propriedade de última data de serviço ao seu modelo de dispositivo, escolha Data.
4. Para configurar a sua última propriedade data de serviço, use as informações na tabela a seguir:
CAMPO VALOR
Nome de exibição Data do Último Serviço
Nome do campo serviceDate
Valor inicial 1/1/2019
DESCRIÇÃO Atendido por último

Clique em Salvar.
5. Personalize o layout da guia Propriedades movendo e redimensionando os blocos de propriedade.
6. Para adicionar uma propriedade do dispositivo como versão de firmware para o seu modelo de
dispositivo, escolha Propriedade do dispositivo.
7. Para configurar sua versão de firmware, use as informações na tabela a seguir:
CAMPO VALOR
Nome de exibição Versão do firmware
Nome do campo firmwareVersion
Tipo de Dados text
DESCRIÇÃO A versão de firmware de ar-condicionado

Clique em Salvar.
8. Para adicionar uma propriedade do dispositivo como número de série para o seu modelo de dispositivo,
escolha Propriedade do dispositivo.
9. Para configurar o número de série, use as informações na tabela a seguir:
CAMPO VALOR
Nome de exibição Número de série
Nome do campo serialNumber
Tipo de Dados text
DESCRIÇÃO O número de série do ar-condicionado

Clique em Salvar.
NOTE
A propriedade do dispositivo é enviada do dispositivo para o aplicativo. Os valores de versão de firmware e do
número de série serão atualizados quando o dispositivo real se conectar ao IoT Central.
Usar comandos
Use comandos para habilitar um operador a executar comandos diretamente no dispositivo. Nesta seção, você
adicionará um comando ao modelo de dispositivo de Ar Condicionado Conectado que permite que um
operador ecoe determinada mensagem sobre a exibição do ar condicionado conectado.
1. Navegue para a guia Comandos do modelo de dispositivo Ar-condicionado Conectado para editar o
modelo.
2. Selecione + Novo Comando para adicionar um comando ao dispositivo e começar a configurar o novo
comando.
3. Para configurar seu novo comando, use as informações da tabela a seguir:
CAMPO VALOR
Nome de exibição Comando echo
Nome do campo echo
Tempo limite padrão 30

CAMPO VALOR
Tipo de Dados text
DESCRIÇÃO Comando do dispositivo
É possível adicionar entradas adicionais ao comando, selecionando + para Campos de Entrada.
Clique em Salvar.
4. Personalize o layout da guia Comandos movendo e redimensionando os blocos de comando.
Exibir seu dispositivo simulado

Agora que você definiu o modelo de dispositivo Ar-condicionado Conectado, personalize o Painel para
incluir as medidas, as configurações e as propriedades definidas. Em seguida, você pode visualizar o painel
como um operador:
1. Escolha a guia Painel do modelo de dispositivo Ar-condicionado Conectado.
2. Selecione Gráfico de Linhas para adicionar o componente ao Painel.
3. Configure o componente Gráfico de linhas usando as informações na tabela a seguir:
Title Temperatura
Intervalo de tempo Últimos 30 minutos
Medidas Temperatura (selecione Visibilidade ao lado de

Temperatura)
Em seguida, selecione Salvar.

4. Selecione o componente Histórico de Eventos usando as informações da seguinte tabela:
Title Eventos do Motor do Ventilador
Medidas Erro do Motor do Ventilador (selecione Visibilidade ao

lado de Erro do Motor do Ventilador)
5. Configure o componente Histórico de Estado usando as informações na tabela a seguir:
Title Modo ventilação
Medidas Modo Ventilador (selecione Visibilidade ao lado de

Modo Ventilador)
6. Para adicionar as configurações e as propriedades do dispositivo ao painel, escolha Configurações e
Propriedades. Selecione Adicionar/Remover para adicionar as configurações ou propriedades que
você gostaria de ver no painel.
7. Configure o componente Configurações e propriedades usando as informações na tabela a seguir:
Title Propriedades do dispositivo
Configurações e propriedades Temperatura definida

Número de série
Versão do firmware
As configurações e as propriedades definidas anteriormente nas páginas Configurações e

Propriedades são mostradas em Colunas Disponíveis.
8. Agora você poderá ver dados simulados para o Ar-condicionado Conectado no painel. Edite os blocos e
o layout do painel:
Próximas etapas
Neste tutorial, você aprendeu como:
Criar um novo modelo de dispositivo
Adicionar telemetria ao seu dispositivo
Exibir telemetria simulada
Definir eventos de dispositivo
Exibir eventos simulados
Definir seu estado
Exibir estado simulado
Usar configurações e propriedades
Usar comandos
Exibir seu dispositivo simulado no painel
Agora que você definiu um modelo de dispositivo no aplicativo do Azure IoT Central, estas são as próximas
etapas sugeridas:
Configurar regras e ações para o seu dispositivo
Personalizar os modos de exibição do operador
Tutorial: Configurar regras e ações para o seu
dispositivo no Azure IoT Central
Este artigo aplica -se a operadores, construtores e administradores.
NOTE
Neste tutorial, você cria uma regra que envia um email quando a temperatura em um dispositivo de ar-
condicionado conectado excede 90° F.
Criar uma regra baseada em telemetria
Adicionar uma ação
Pré-requisitos
Antes de começar, você deve concluir o tutorial Definir um novo tipo de dispositivo em seu aplicativo para criar o
modelo do dispositivo de Ar-condicionado conectado que será usado.

1. Para adicionar uma nova regra baseada em telemetria ao aplicativo, no painel esquerdo, selecione
Modelos do Dispositivo:
Você verá o modelo de dispositivo Ar-condicionado Conectado (1.0.0) criado no tutorial anterior.
2. Para personalizar seu modelo de serviço, selecione o modelo de Ar-Condicionado Conectado criado no
tutorial anterior.
3. Para adicionar uma regra baseada em telemetria no modo de exibição de Regras, selecione Regras, +
Nova Regra e depois selecione Telemetria:
4. Para definir a sua regra, use as informações na tabela a seguir:
NOME Alerta de temperatura do ar-condicionado
Habilitar regra para todos os dispositivos deste modelo Por
Condição A temperatura é maior que 90
Agregação Nenhum

Quando você definir uma regra, você também define uma ação a ser executada quando as condições da regra são
atendidas. Neste tutorial, você criará uma regra com uma ação que envia uma notificação por email.
1. Para adicionar uma Ação, primeiro Salve a regra e, em seguida, role a tela para baixo no painel
Configurar Regra de Telemetria. Escolha o + ao lado de Ações e, em seguida, escolha Email:
2. Para definir a sua ação, use as informações na tabela a seguir:
Para Seu endereço de email
Observações A temperatura do ar-condicionado excedeu o limite.
NOTE
Para receber uma notificação por email, o endereço de email deve ser uma ID de usuário no aplicativo, e esse
usuário deve entrar no aplicativo pelo menos uma vez.
3. Clique em Salvar. A regra é listada na página Regras.
Teste a regra
Logo depois de salvar a regra, ela passa a valer. Quando as condições definidas na regra são atendidas, o
aplicativo envia uma mensagem para o endereço de email especificado na ação.
NOTE
Depois que os testes forem concluídos, desligue a regra para interromper o recebimento de alertas na caixa de entrada.
Próximas etapas
Agora que você definiu uma regra baseada em limite, a próxima etapa sugerida é Personalizar as exibições do
operador.
Para saber mais sobre os diferentes tipos de regras no Azure IoT Central e como parametrizar a definição de
regra, consulte:
Criar uma regra de telemetria e configurar as notificações.
Criar uma regra de evento e configurar as notificações.
Tutorial: Personalizar o modo de exibição do
operador do Azure IoT Central
NOTE
Este tutorial mostra a você, como um construtor, como personalizar o modo de exibição do operador do seu
aplicativo. Ao fazer uma alteração no aplicativo como um construtor, você pode visualizar o modo de exibição do
operador no aplicativo do Microsoft Azure IoT Central.
Neste tutorial, você personaliza o aplicativo para exibir informações relevantes sobre o dispositivo de ar
condicionado conectado a um operador. Suas personalizações habilitam o operador gerenciar os dispositivos de
ar condicionado conectados ao aplicativo.
Configurar o painel do dispositivo
Configurar o layout das configurações do dispositivo
Configurar o layout das propriedades do dispositivo
Visualizar o dispositivo como operador
Configurar o painel de aplicativo padrão
Visualizar o painel do aplicativo padrão como um operador
Pré-requisitos
Antes de começar, você deve concluir os dois tutoriais anteriores:
Definir um novo tipo de dispositivo em seu aplicativo do Azure IoT Central.
Configurar regras e ações para o seu dispositivo.

Como um construtor, você pode definir quais informações são exibidas em um painel do dispositivo. No tutorial
Definir um novo tipo de dispositivo no aplicativo, você adicionou um gráfico de linhas e outras informações ao
painel do Ar-condicionado Conectado.
1. Para editar o modelo de dispositivo Ar-condicionado Conectado, escolha Modelos de Dispositivo no
painel à esquerda:
2. Para personalizar o painel do dispositivo, clique no modelo de dispositivo Ar-condicionado Conectado
(1.0.0) criado no tutorial Definir um novo tipo de dispositivo no aplicativo.
3. Para editar o painel, selecione a guia Painel.
4. Para adicionar um bloco de indicador chave de desempenho (KPI) para o painel, escolha KPI:
Para definir o KPI, use as informações da tabela a seguir:
NOME Temperatura máxima
Intervalo de tempo Passada uma semana
Tipo de Medida Telemetria
Medida temperatura
Agregação Máximo
Visibilidade habilitado
5. Clique em Salvar. Agora você pode ver o bloco KPI no painel:
6. Para mover ou redimensionar um bloco no painel, mova o ponteiro do mouse sobre o bloco. Arraste o
bloco para uma nova localização ou redimensione-o.
Configurar o layout do dispositivo

Como um construtor, você também pode configurar o modo de exibição do operador das configurações do
dispositivo. Um operador usa a guia de configurações do dispositivo para configurar um dispositivo. Por
exemplo, um operador usa a guia de configurações para definir a temperatura-alvo do ar-condicionado
conectado.
1. Para editar o layout de configurações do ar-condicionado conectado, escolha a guia Configurações.
2. É possível mover e redimensionar os blocos de configurações:
Configurar o layout das propriedades
Além do painel e das configurações, também é possível configurar o modo de exibição do operador das
propriedades do dispositivo. Um operador usa a guia de propriedades do dispositivo para gerenciar os
metadados do dispositivo. Por exemplo, um operador usa a guia de propriedades para exibir o número de série
de um dispositivo ou atualizar detalhes de contato do fabricante.
1. Para editar o layout de propriedades do ar-condicionado conectado, escolha a guia Propriedades.
2. Você pode mover e redimensionar os campos de propriedades:
Visualizar o aplicativo
Use a página Modelos de Dispositivo para personalizar as guias do painel, de configurações e de propriedades
de um operador. Use a página Device Explorer para exibir e usar o modelo de dispositivo.
1. Para exibir e usar o modelo de ar-condicionado conectado como um operador, navegue para a página do
Device Explorer e escolha o dispositivo simulado gerado pelo IoT Central com base no modelo:
2. Para atualizar a Localização desse dispositivo, escolha Propriedades e edite o valor no bloco Localização.
Em seguida, selecione Salvar:
3. Para enviar uma configuração ao ar condicionado conectado, escolha Configurações, altere o valor de
uma configuração em um bloco e escolha Atualizar:
Quando o dispositivo reconhecer o novo valor de configuração, a configuração é exibida como
sincronizada no bloco.
4. Como um operador, você pode exibir o painel do dispositivo conforme configurado pelo construtor:
Configurar o diretório padrão
Quando um construtor ou um operador entra em um aplicativo do Azure IoT Central, eles veem uma página
inicial. Como um construtor, você pode configurar o conteúdo desta do painel padrão para incluir o conteúdo
mais útil e relevante para um operador.
NOTE
Os usuários também podem criar seus próprios painéis pessoais e escolher um como padrão.
1. Para personalizar o painel padrão, navegue até a página Painel e selecione Editar no canto superior
direito da página. Um painel é exibido com uma biblioteca de objetos que você pode adicionar ao painel.
2. Para personalizar o painel, adicione blocos da Biblioteca. Escolha Link e adicione detalhes do site da sua
organização. Depois escolha Salvar:
NOTE
Também é possível adicionar links para páginas dentro do seu aplicativo do Azure IoT Central. Por exemplo, é
possível adicionar um link para um painel do dispositivo ou uma página de configurações.
3. Como opção, escolha Imagem e carregue uma imagem a ser exibida no painel. Uma imagem pode conter
uma URL à qual você navega ao clicar nela:
Para saber mais, consulte Como preparar e carregar imagens para o aplicativo Azure IoT Central.
Versão prévia do painel

Para visualizar o painel do aplicativo como um operador, selecione Concluído na parte superior direita da
página.
É possível selecionar o link e os blocos de imagem para navegar até as URLs que você definir como um
construtor.
Próximas etapas
Neste tutorial, você aprendeu como personalizar o modo de exibição do operador do aplicativo.
Configurar o layout das configurações do dispositivo
Configurar o layout das propriedades do dispositivo
Visualizar o dispositivo como operador
Configurar sua página inicial padrão
Visualizar a página inicial padrão como operador
Agora que você aprendeu como personalizar o modo de exibição do aplicativo do operador, as próximas etapas
sugeridas são:
Monitorar seus dispositivos (como um operador)
Adicionar um novo dispositivo ao seu aplicativo (como um operador e desenvolvedor do dispositivo)
Tutorial: Use o Azure IoT Central para monitorar seus
dispositivos
NOTE
Este tutorial mostra a você, como um operador, como usar o seu aplicatio Azure IoT Central para monitorar seus
dispositivos e alterar as configurações.
Receber uma notificação
Investigar um problema
Resolver um problema
Pré-requisitos
Antes de começar, o construtor deve concluir os três tutorial para construtores para criar o aplicativo Azure IoT
Central:
Definir um novo tipo de dispositivo
Configurar regras e ações para o seu dispositivo
Personalizar os modos de exibição do operador

O Azure IoT Central envia notificações sobre dispositivos como mensagens de email. O construtor adicionou uma
regra para enviar uma notificação quando a temperatura em um ar-condicionado conectado exceder um limite.
Verifique os emails enviados para a conta escolhida pelo construtor para receber notificações.
Abra a mensagem de email recebida no final do tutorial Configurar regras e ações para o seu dispositivo. No
email, selecione o link para o dispositivo ao lado de Nome do Dispositivo na seção Detalhes:
A página Dispositivo para o dispositivo simulado Ar-condicionado conectado 1 que você criou nos tutoriais
anteriores abre no navegador:
Como um operador, você pode ver informações sobre as páginas de Medidas, Configurações, Propriedades,
Regras e Painel. O construtor personalizou o Painel para exibir informações importantes sobre um dispositivo
de ar-condicionado conectado.
Escolha o modo de exibição de Painel para ver informações sobre o dispositivo.
O gráfico no painel mostra um gráfico de temperatura do dispositivo. Você também pode ver a temperatura de
destino atual para o dispositivo no bloco Propriedades do destino. Você decide se a temperatura de destino está
muito alta.
Para alterar a temperatura de destino do dispositivo, use a página Configurações:
1. Escolha Configurações. Altere a Configuração de temperatura para 75. Escolha Atualizar para enviar a
nova temperatura de destino par ao dispositivo. Quando o dispositivo confirma as alterações de
configuração, o status da configuração muda para sincronizado:
2. Escolha Painel e verifique o novo valor configurado:
Próximas etapas
Agora que você sabe como monitorar o seu dispositivo, a próxima etapa sugerida é Adicionar um dispositivo.
Tutorial: Adicionar um dispositivo real ao aplicativo
Azure IoT Central
NOTE
Este tutorial mostra como adicionar e configurar um dispositivo real para o seu aplicativo Microsoft Azure IoT
Central. Neste tutorial, você codificará o dispositivo real usando o Node.js e executará o código em um
computador desktop. Você não precisa de um dispositivo IoT separado, tal como um dispositivo Raspberry Pi ou
MXChip IoT DevKit, para concluir este tutorial.
Este tutorial é composto de duas partes:
Primeiro, como um operador, você aprenderá a adicionar e configurar um dispositivo real em seu aplicativo
do Azure IoT Central. No final dessa parte, você deve recuperar uma cadeia de conexão para usar na segunda
parte.
Em seguida, como um desenvolvedor do dispositivo, você aprenderá sobre o código em seu dispositivo real.
Você pode adicionar a cadeia de conexão desde a primeira parte para o exemplo de código.
Adicionar um novo dispositivo real
Configurar o dispositivo real
Obter cadeia de conexão para um dispositivo real a partir do aplicativo
Entender como o código do cliente é mapeado para o aplicativo
Configurar o código do cliente para o dispositivo real
Pré-requisitos
Antes de começar, o construtor deve concluir pelo menos o primeiro tutorial para construtores para criar o
aplicativo Azure IoT Central: Definir um novo tipo de dispositivo (Obrigatório)
Instale o Node.js versão 8.0.0 ou posterior em seu computador de desenvolvimento. É possível executar
node --version na linha de comando para verificar a versão. O Node.js está disponível para uma ampla
variedade de sistemas operacionais.
Adicionar um dispositivo real

Para adicionar um dispositivo real no seu aplicativo, você deve usar o modelo de dispositivo Ar-condicionado
conectado que você criou no tutorial Definir um novo tipo de dispositivo.
1. Para adicionar um novo dispositivo como um operador, escolha Dispositivos no painel esquerdo:
O Gerenciador de Dispositivos mostra o modelo de dispositivo Ar-Condicionado Conectado e um
dispositivo simulado. Quando você cria um modelo de dispositivo, o IoT Central cria automaticamente um
dispositivo simulado.
2. Observe que o modelo de dispositivo Ar-Condicionado Conectado é aquele selecionado no Device
Explorer. Para começar a se conectar um dispositivo real de ar-condicionado que usa esse modelo,
escolha + , depois Real:
3. Insira sua própria ID do Dispositivo (deve estar em minúsculas) ou use o valor sugerido. Você também
pode inserir um Nome do Dispositivo para o novo dispositivo e escolher Criar.
Configurar um dispositivo real
O dispositivo real é criado a partir do modelo de dispositivo de Ar-condicionado conectado. Você pode usar
Configurações para configurar seu dispositivo e definir valores de propriedade para registrar informações
sobre o seu dispositivo.
1. Na página Configurações, observe que o status da configuração Definir temperatura é nenhuma
atualização. Ela permanece nesse estado até que o dispositivo real se conecte ao aplicativo e confirme
que agiu na configuração.
2. Na página de Propriedades para seu novo dispositivo real, tanto o local do serviço quanto a data do
último serviço são propriedades editáveis. Os campos de versão de firmware e número de série ficam
vazios, até que o dispositivo esteja conectado ao aplicativo. Esses valores somente leitura são enviados do
dispositivo e não podem ser editados.
3. Você pode visualizar as páginas de Medidas, Regras e Painel para o seu dispositivo real.
Preparar o código do cliente

O exemplo de código neste artigo é escrito em Node.js e mostra código suficiente para um dispositivo:
Conectar-se a um aplicativo Azure IoT Central.
Enviar telemetria de temperatura como um dispositivo de ar-condicionado conectado.
Enviar propriedades do dispositivo ao seu aplicativo Azure IoT Central.
Responder a um operador que usa a configuração Definir temperatura.
Tratar o comando Echo no seu aplicativo do Azure IoT Central.
Os artigos listados na seção Próximas Etapas incluem exemplos mais completos e mostram outras linguagens
de programação. Para obter mais informações sobre como os dispositivos se conectam ao Azure IoT Central,
consulte o artigo Conectividade do dispositivo.
As etapas a seguir mostram como preparar o exemplo em Node.js:
Obter as informações de conexão do dispositivo
1. A cadeia de conexão para uma instância de dispositivo em seu aplicativo é gerada a partir de informações
do dispositivo fornecidas pelo IoT Central.
Na tela do dispositivo para o seu ar-condicionado real conectado, escolha Conectar.
2. Na página de Conexão do Dispositivo, anote os valores de ID do Escopo, ID do Dispositivo e Chave
Primária. Você usará esses valores mais adiante neste tutorial.
Preparar o projeto do Node.js

1. Crie uma pasta chamada connectedairconditioner no computador de desenvolvimento.
2. No ambiente de linha de comando, navegue até a pasta connectedairconditioner que você criou.
3. Para inicializar o projeto Node.js, execute os comandos a seguir aceitando todos os valores padrão:
npm init
4. Para instalar os pacotes necessários execute o comando a seguir:
npm install azure-iot-device azure-iot-device-mqtt azure-iot-provisioning-device-mqtt azure-iot-

security-symmetric-key --save
5. Usando um editor de texto, crie um arquivo chamado ConnectedAirConditioner.js na pasta
connectedairconditioner .
6. Adicione as seguintes instruções require no início do arquivo ConnectedAirConditioner.js:
'use strict';
var iotHubTransport = require('azure-iot-device-mqtt').Mqtt;

var Client = require('azure-iot-device').Client;
var Message = require('azure-iot-device').Message;
var ProvisioningTransport = require('azure-iot-provisioning-device-mqtt').Mqtt;
var SymmetricKeySecurityClient = require('azure-iot-security-symmetric-
key').SymmetricKeySecurityClient;
var ProvisioningDeviceClient = require('azure-iot-provisioning-device').ProvisioningDeviceClient;
7. Adicione as declarações de variáveis a seguir ao arquivo. Substitua os espaços reservados

{your Scope ID} , {your Device ID} e {your Primary Key} pelas informações de conexão do dispositivo
anotadas anteriormente:
var provisioningHost = 'global.azure-devices-provisioning.net';

var idScope = '{your Scope ID}';
var registrationId = '{your Device ID}';
var symmetricKey = '{your Primary Key}';
var provisioningSecurityClient = new SymmetricKeySecurityClient(registrationId, symmetricKey);
var provisioningClient = ProvisioningDeviceClient.create(provisioningHost, idScope, new
ProvisioningTransport(), provisioningSecurityClient);
var hubClient;
var targetTemperature = 0;
8. Salve as alterações feitas até agora, mas mantenha o arquivo aberto.
Examine o código do cliente

Na seção anterior, você criou um esqueleto de projeto em Node.js para um aplicativo de dispositivo que se
conecta ao seu aplicativo Azure IoT Central. A próxima etapa é adicionar código para:
Conectar-se a um aplicativo Azure IoT Central.
Enviar telemetria ao seu aplicativo Azure IoT Central.
Enviar propriedades do dispositivo ao seu aplicativo Azure IoT Central.
Receber configurações do seu aplicativo Azure IoT Central.
Tratar o comando Echo no seu aplicativo do Azure IoT Central.
1. Para enviar telemetria de temperatura para o seu aplicativo Azure IoT Central, adicione o seguinte código
ao arquivo ConnectedAirConditioner.js:
// Send device measurements.

function sendTelemetry() {
var temperature = targetTemperature + (Math.random() * 15);
var data = JSON.stringify({ temperature: temperature });
var message = new Message(data);
hubClient.sendEvent(message, (err, res) => console.log(`Sent message: ${message.getData()}` +
(err ? `; error: ${err.toString()}` : '') +
(res ? `; status: ${res.constructor.name}` : '')));
}
O nome do campo no JSON que você enviar deve corresponder ao nome do campo especificado para a
telemetria de temperatura no modelo de dispositivo. Neste exemplo, o nome do campo é temperatura.
2. Para enviar as propriedades do dispositivo, como firmwareVersion e serialNumber, adicione a seguinte
definição:
// Send device properties

function sendDeviceProperties(twin) {
var properties = {
firmwareVersion: "9.75",
serialNumber: "10001"
};
twin.properties.reported.update(properties, (errorMessage) =>
console.log(` * Sent device properties ` + (errorMessage ? Èrror: ${errorMessage.toString()}` :
`(success)`)));
}
3. Para definir as configurações compatíveis com o dispositivo, tais como setTemperature adicione a
definição a seguir:
// Add any settings your device supports

// mapped to a function that is called when the setting is changed.
var settings = {
'setTemperature': (newValue, callback) => {
// Simulate the temperature setting taking two steps.
setTimeout(() => {
targetTemperature = targetTemperature + (newValue - targetTemperature) / 2;
callback(targetTemperature, 'pending');
setTimeout(() => {
targetTemperature = newValue;
callback(targetTemperature, 'completed');
}, 5000);
}, 5000);
}
};
4. Para lidar com as configurações enviadas ao Azure IoT Central, adicione a função a seguir que localiza e
executa o código de dispositivo apropriado:
// Handle settings changes that come from Azure IoT Central via the device twin.
function handleSettings(twin) {
twin.on('properties.desired', function (desiredChange) {
for (let setting in desiredChange) {
if (settings[setting]) {
console.log(`Received setting: ${setting}: ${desiredChange[setting].value}`);
settings[setting](desiredChange[setting].value, (newValue, status, message) => {
var patch = {
[setting]: {
value: newValue,
status: status,
desiredVersion: desiredChange.$version,
message: message
}
}
twin.properties.reported.update(patch, (err) => console.log(`Sent setting update for
${setting}; ` +
(err ? èrror: ${err.toString()}` : `status: success`)));
});
}
}
});
}
Esta função:
Observa o Azure IoT Central enviando uma propriedade desejada.
Localiza a função apropriada a ser chamada para tratar a alteração de configuração.
Envia uma confirmação de volta para o seu aplicativo Azure IoT Central.
5. Para responder a um comando, como echo do seu aplicativo do Azure IoT Central, adicione a seguinte
definição:
// Respond to the echo command

function onCommandEcho(request, response) {
// Display console info
console.log(' * Echo command received');
// Respond
response.send(10, 'Success', function (errorMessage) {});
}
6. Adicione o seguinte código para concluir a conexão ao Azure IoT Central e associe as funções no código
cliente:
// Handle device connection to Azure IoT Central.

var connectCallback = (err) => {
if (err) {
console.log(`Device could not connect to Azure IoT Central: ${err.toString()}`);
} else {
console.log('Device successfully connected to Azure IoT Central');
// Create handler for countdown command

hubClient.onDeviceMethod('echo', onCommandEcho);
// Send telemetry measurements to Azure IoT Central every 1 second.

setInterval(sendTelemetry, 1000);
// Get device twin from Azure IoT Central.

hubClient.getTwin((err, twin) => {
if (err) {
console.log(Èrror getting device twin: ${err.toString()}`);
} else {
// Send device properties once on device start up.
sendDeviceProperties(twin);
// Apply device settings and handle changes to device settings.

handleSettings(twin);
}
});
}
};
7. Registre e conecte o dispositivo ao aplicativo IoT Central:

// Start the device (connect it to Azure IoT Central).
provisioningClient.register((err, result) => {
if (err) {
console.log("error registering device: " + err);
} else {
console.log('registration succeeded');
console.log('assigned hub=' + result.assignedHub);
console.log('deviceId=' + result.deviceId);
var connectionString = 'HostName=' + result.assignedHub + ';DeviceId=' + result.deviceId +
';SharedAccessKey=' + symmetricKey;
hubClient = Client.fromConnectionString(connectionString, iotHubTransport);
hubClient.open(connectCallback);
}
});
8. Salve as alterações feitas.
Executar o código do cliente

Agora você pode executar o código do cliente e ver como ele interage com o aplicativo IoT Central:
1. Para executar o exemplo, execute o seguinte comando no seu ambiente de linha de comando:
node ConnectedAirConditioner.js
NOTE
Verifique se você está na pasta connectedairconditioner ao executar esse comando.
2. O aplicativo imprime a saída para o console:
3. Após cerca de 30 segundos, você deve ver a telemetria na página Medidas do dispositivo:
4. Na página Configurações, você poderá ver que agora a configuração está sincronizada. Quando o
dispositivo conectou-se pela primeira vez, ele recebeu o valor da configuração e confirmou a alteração:
5. Na página Configurações, defina a temperatura do dispositivo para 95 e escolha Atualizar dispositivo.

O aplicativo de exemplo recebe e processa essa alteração:
NOTE
Há duas mensagens de “atualização de configuração”. Quando o status pending é enviado e quando o status
completed é enviado.
6. Na página Medidas você pode ver que o dispositivo está enviando valores mais altos de temperatura:
Próximas etapas
Adicionar um novo dispositivo real
Configurar o novo dispositivo
Obter cadeia de conexão para um dispositivo real a partir do aplicativo
Entender como o código do cliente é mapeado para o aplicativo
Configurar o código do cliente para o dispositivo real
Agora que você conectou um dispositivo real ao aplicativo Azure IoT Central, apresentamos algumas das
próximas etapas sugeridas.
Como um operador, você pode aprender como:
Criar análise personalizada
Como um desenvolvedor do dispositivo, você pode aprender como:
Preparar e conectar um dispositivo DevKit (C )
Preparar e conectar um Raspberry Pi (Python)
Preparar e conectar um Raspberry Pi (C#)
Preparar e conectar um dispositivo Windows 10 IoT Core (C#)
Conectar um cliente Node.js genérico ao aplicativo Azure IoT Central
Arquitetura do Azure IoT Central
NOTE
Este artigo fornece uma visão geral da arquitetura do Microsoft Azure IoT Central.
Dispositivos
Os dispositivos trocam dados com o aplicativo Azure IoT Central. Um dispositivo pode:
Enviar medidas, como telemetria.
Sincronizar as configurações com o aplicativo.
No Azure IoT Central, os dados que um dispositivo pode trocar com o aplicativo são especificados em um modelo
de dispositivo. Para obter mais informações sobre modelos de dispositivos, consulte Gerenciamento de metadados.
Para saber mais sobre como os dispositivos conectam ao aplicativo do Azure IoT Central, consulte Conectividade
de Dispositivo.
Gateway de nuvem
O Azure IoT Central usa o Hub IoT como um gateway de nuvem que permite a conectividade de dispositivo. O
Hub IoT permite:
Ingestão de dados em escala na nuvem.
Gerenciamento de dispositivo.
Conectividade de dispositivo segura.
Para saber mais sobre Hub IoT, consulte Hub IoT.
Para saber mais sobre a conectividade de dispositivos no Azure IoT Central, consulte Conectividade de dispositivo.
Armazenamentos de dados
O Azure IoT Central armazena dados de aplicativos na nuvem. Os dados armazenados de aplicativo armazenados
incluem:
Modelos de dispositivos.
Identidades de dispositivos.
Metadados do dispositivo.
Dados de usuário e função.
O Azure IoT Central usa um armazenamento de série temporal para os dados de medida enviados dos
dispositivos. Os dados da série temporal dos dispositivos usados pelo serviço analítico.
Análise
O serviço analítico é responsável por gerar os dados de relatório personalizados que o aplicativo exibe. Um
operador pode personalizar a análise exibida no aplicativo. O serviço analítico é compilado no Azure Time Series
Insights e processa os dados de medida enviados a partir dos dispositivos.
Regras e ações
Regras e ações trabalham em conjunto para automatizar tarefas no aplicativo. Um construtor pode definir regras
baseadas na telemetria de dispositivo, como a temperatura que excede um limite definido. O Azure IoT Central usa
um processador de fluxo para determinar quando as condições da regra são atendidas. Quando uma condição de
regra é atendida, ela dispara uma ação definida pelo construtor. Por exemplo, uma ação pode enviar um email para
notificar um engenheiro de que a temperatura em um dispositivo está muito alta.
Gerenciamento de metadados
Em um aplicativo do Azure IoT Central, os modelos de dispositivo definem o comportamento e a capacidade dos
tipos de dispositivo. Por exemplo, um modelo de dispositivo de refrigerador especifica a telemetria que um
refrigerador envia ao aplicativo.
Em um modelo de dispositivo:
As Medidas especificam a telemetria que o dispositivo envia ao aplicativo.
As Configurações especificam as configurações que um operador pode definir.
As Propriedades especificam os metadados que um operador pode definir.
As Regras automatizam o comportamento no aplicativo com base nos dados enviados de um dispositivo.
Os Painéis são exibições personalizáveis de um dispositivo no aplicativo.
Um aplicativo pode ter um ou mais dispositivos simulados e reais com base em cada modelo de dispositivo.
Exportação de dados
Em um aplicativo IoT Central do Azure, você pode Exportar continuamente seus dados para seus próprios hubs de
eventos do Azure, barramento de serviço do Azure e instâncias de armazenamento de BLOBs do Azure. IoT
Central pode exportar medidas, dispositivos e modelos de dispositivo.
Atualizações de dispositivo do lote

Em um aplicativo IoT Central do Azure, você pode criar e executar trabalhos para gerenciar dispositivos
conectados. Esses trabalhos permitem que você faça atualizações em massa nas propriedades ou configurações do
dispositivo ou execute comandos. Por exemplo, você pode criar um trabalho para aumentar a velocidade do
ventilador para várias máquinas de venda com refrigeração.
RBAC (Controle de Acesso Baseado em Função)

Um administrador pode definir regras de acesso para um aplicativo Azure IoT Central usando as funções
predefinidas. Um administrador pode atribuir usuários a funções que determinam quais áreas do aplicativo o
usuário tem acesso.
Segurança
Os recursos de segurança do Azure IoT Central incluem:
Os dados são criptografados em trânsito e em repouso.
A autenticação é fornecida pelo Azure Active Directory ou pela Conta Microsoft. A autenticação de dois fatores
tem suporte.
Isolamento de locatário completo.
Segurança em nível de dispositivo.
Shell de interface do usuário

O shell de interface do usuário é um aplicativo dinâmico e moderno com base no navegador HTML5. Um
administrador pode personalizar a interface do usuário do aplicativo aplicando temas personalizados e
modificando os links da ajuda para apontar para seus próprios recursos de ajuda personalizados. Para saber mais
sobre a personalização da interface do usuário, consulte o artigo personalizar a interface do usuário IOT central do
Azure .
Um operador pode criar painéis de aplicativo personalizados. Você pode ter vários painéis que exibem dados
diferentes e alternam entre eles.
Próximas etapas
Agora que você aprendeu sobre a arquitetura do Azure IoT Central, a próxima etapa sugerida é saber mais sobre a
conectividade do dispositivo na IOT central do Azure.
Conectividade de dispositivo no Azure IoT Central |
Microsoft Docs
NOTE
Este artigo apresenta os principais conceitos relacionados à conectividade de dispositivo no Microsoft Azure IoT
Central.
O Azure IoT Central usa o DPS (serviço de provisionamento de dispositivos) do Hub IOT do Azure para
gerenciar todo o registro e a conexão do dispositivo.
O uso do DPS permite:
IoT Central para dar suporte à integração e à conexão de dispositivos em escala.
Você deve gerar credenciais de dispositivo e configurar os dispositivos offline sem registrar os dispositivos
por meio da interface do usuário do IoT Central.
Dispositivos para se conectar usando SAS (assinaturas de acesso compartilhado).
Dispositivos para se conectar usando certificados X. 509 padrão do setor.
Você usa suas próprias IDs de dispositivo para registrar dispositivos no IoT Central. O uso de suas próprias
IDs de dispositivo simplifica a integração com sistemas de Back-Office existentes.
Uma maneira única e consistente de conectar dispositivos a IoT Central.
Este artigo descreve os quatro casos de uso a seguir:
Conectar rapidamente um único dispositivo usando SAS
Conectar dispositivos em escala usando SAS
Conectar dispositivos em escala usando certificados X. 509 esta é a abordagem recomendada para ambientes
de produção.
Conectar sem primeiro registrar dispositivos
Conectar um único dispositivo

Essa abordagem é útil quando você está experimentando IoT Central ou dispositivos de teste. Você pode usar as
informações de conexão do dispositivo do seu aplicativo IoT Central para conectar um dispositivo ao seu
aplicativo IoT Central usando o DPS (serviço de provisionamento de dispositivos). Você pode encontrar o código
do cliente do dispositivo DPS de exemplo para os seguintes idiomas:
C#
Node.js
Conectar dispositivos em escala usando SAS

Para conectar dispositivos a IoT Central em escala usando SAS, você precisa registrar e, em seguida, configurar
os dispositivos:
Registrar dispositivos em massa
Para registrar um grande número de dispositivos com seu aplicativo IoT Central, use um arquivo CSV para
importar IDs de dispositivo e nomes de dispositivo.
Para recuperar as informações de conexão dos dispositivos importados, exporte um arquivo CSV de seu
aplicativo IOT central.
NOTE
Para saber como você pode conectar dispositivos sem primeiro registrá-los no IoT Central, consulte conectar sem primeiro
registrar os dispositivos.
Configurar seus dispositivos

Use as informações de conexão do arquivo de exportação no código do dispositivo para permitir que seus
dispositivos se conectem e enviem dados para o IoT para seu aplicativo IoT Central. Para obter mais
informações sobre como conectar dispositivos, consulte próximas etapas.
Conectar dispositivos usando certificados X. 509

Em um ambiente de produção, o uso de certificados X. 509 é o mecanismo de autenticação de dispositivo
recomendado para IoT Central. Para saber mais, consulte Autenticação de dispositivo usando certificados de AC
X.509.
As etapas a seguir descrevem como conectar dispositivos a IoT Central usando certificados X. 509:
1. No aplicativo IoT Central, adicione e verifique o certificado X. 509 intermediário ou raiz que você está
usando para gerar certificados de dispositivo:
Navegue até administração > conexão de dispositivo > certificados (X. 509) e adicione a raiz
ou o certificado intermediário X. 509 que você está usando para gerar os certificados de
dispositivo de folha.
Se você tiver uma violação de segurança ou se o certificado principal estiver definido como expirar,
use o certificado secundário para reduzir o tempo de inatividade. Você pode continuar a
provisionar dispositivos usando o certificado secundário enquanto atualiza o certificado primário.
Verificar a propriedade do certificado garante que o carregador do certificado tenha a chave
privada do certificado. Para verificar o certificado:
Selecione o botão ao lado do código de verificação para gerar um código.
Crie um certificado de verificação X. 509 com o código de verificação gerado na etapa
anterior. Salve o certificado como um arquivo. cer.
Carregue o certificado de verificação assinado e selecione verificar.
2. Use um arquivo CSV para importar e registrar dispositivos no seu aplicativo IOT central.
3. Configure seus dispositivos. gere os certificados secundários usando o certificado raiz carregado. Use a ID
do dispositivo como o valor CNAME nos certificados folha. A ID do dispositivo deve ter todas as letras
minúsculas. Em seguida, programe seus dispositivos com as informações do serviço de provisionamento.
Quando um dispositivo é ativado pela primeira, ele recupera suas informações de conexão para seu
aplicativo IoT Central do DPS.
Referência adicional
Exemplo de implementação para RaspberryPi.
Exemplo de cliente de dispositivo em C.
Somente para fins de teste
Somente para teste, você pode usar esses utilitários para gerar certificados de autoridade de certificação e
certificados de dispositivo.
Se você estiver usando um dispositivo DevKit, essa ferramenta de linha de comando gerará um
certificado de autoridade de certificação que você pode adicionar ao seu aplicativo IOT central para
verificar os certificados.
Use essa ferramenta de linha de comando para:
Crie uma cadeia de certificados. Siga a etapa 2 no artigo do GitHub.
Salve os certificados como arquivos. cer para carregar em seu aplicativo IoT Central.
Use o código de verificação do aplicativo IoT Central para gerar o certificado de verificação. Siga a
etapa 3 no artigo do GitHub.
Crie certificados folha para seus dispositivos usando suas IDs de dispositivo como um parâmetro para
a ferramenta. Siga a etapa 4 no artigo do GitHub.
Conectar sem registrar dispositivos

Um cenário-chave IoT Central permite que os OEMs para fabricar dispositivos em massa que podem se
conectar a um aplicativo IoT Central sem ser registrado primeiro. Um fabricante deve gerar credenciais
adequadas e configurar os dispositivos na fábrica. Quando um dispositivo é ativado pela primeira vez, ele se
conecta automaticamente a um aplicativo IoT Central. Um operador de IoT Central deve aprovar o dispositivo
antes de poder enviar dados.
O diagrama a seguir descreve esse fluxo:
As etapas a seguir descrevem esse processo mais detalhadamente. As etapas diferem um pouco dependendo se
você estiver usando certificados SAS ou X. 509 para autenticação de dispositivo:
1. Defina as configurações de conexão:
Certificados X. 509: adicione e verifique o certificado raiz/intermediário e use-o para gerar os
certificados de dispositivo na etapa a seguir.
SAS: Copie a chave primária. Essa é a chave de SAS do grupo para o aplicativo IoT Central. Use a
chave para gerar as chaves SAS do dispositivo na etapa a seguir.
2. Gerar suas credenciais de dispositivo
Certificados X. 509: Gere os certificados de folha para seus dispositivos usando o certificado raiz
ou intermediário que você adicionou ao seu aplicativo IoT Central. Certifique-se de usar a ID do
dispositivo em minúsculas como o CNAME nos certificados folha. Somente para fins de teste, use
essa ferramenta de linha de comando para gerar certificados de dispositivo.
SAS: Use esta ferramenta de linha de comando para gerar chaves SAS do dispositivo. Use a
chave primária do grupo da etapa anterior. A ID do dispositivo deve estar em letras minúsculas.
Para instalar o utilitário de gerador de chave, execute o seguinte comando:
npm i -g dps-keygen
Para gerar uma chave de dispositivo a partir da chave primária de SAS do grupo, execute o
seguinte comando:
dps-keygen -mk:<Primary_Key(GroupSAS)> -di:<device_id>
3. Para configurar seus dispositivos, atualize cada dispositivo com a ID do escopo, a ID do dispositivoe o
certificado de dispositivo X. 509 ou a chave SAS.
4. Em seguida, ligue o dispositivo para que ele se conecte ao seu aplicativo IoT Central. Quando você alterna
um dispositivo, ele se conecta primeiro ao DPS para recuperar suas informações de registro IoT Central.
5. Inicialmente, o dispositivo conectado aparece como um dispositivo não associado na página Device
Explorer . O status de provisionamento do dispositivo é Registrado. Associe o dispositivo ao modelo de
dispositivo apropriado e aprove o dispositivo para se conectar ao seu aplicativo IOT central. O dispositivo
pode então recuperar uma cadeia de conexão do Hub IoT e começar a enviar dados. O provisionamento
do dispositivo agora está concluído e o status de provisionamento agora está provisionado.
Status de provisionamento
Quando um dispositivo real se conecta ao seu aplicativo IoT Central, seu status de provisionamento é alterado
da seguinte maneira:
1. O status de provisionamento do dispositivo é registradoprimeiro. Esse status significa que o dispositivo
foi criado em IoT Central e tem uma ID de dispositivo. Um dispositivo é registrado quando:
Um novo dispositivo real é adicionado na página de Device Explorer .
Um conjunto de dispositivos é adicionado usando a importação na página Device Explorer .
Um dispositivo não foi registrado manualmente na página Device Explorer , mas conectado com
credenciais válidas e está visível como um dispositivo não associado na página Device Explorer .
2. O status de provisionamento do dispositivo muda para provisionado quando o dispositivo conectado ao
seu aplicativo IOT central com credenciais válidas conclui a etapa de provisionamento. Nesta etapa, o
dispositivo recupera uma cadeia de conexão do Hub IoT. Agora, o dispositivo pode se conectar ao Hub
IoT e começar a enviar dados.
3. Um operador pode bloquear um dispositivo. Quando um dispositivo é bloqueado, ele não pode enviar
dados para seu aplicativo IoT Central. Os dispositivos bloqueados têm um status de provisionamento de
bloqueado. Um operador deve redefinir o dispositivo antes que ele possa retomar o envio de dados.
Quando um operador desbloqueia um dispositivo, o status de provisionamento retorna ao seu valor
anterior, registrado ou provisionado.
Suporte a SDK
Os SDKs de dispositivo do Azure oferecem a maneira mais fácil de implementar o código do dispositivo. Estão
disponíveis os SDKs do dispositivo a seguir:
SDK do IoT do Azure para C
SDK do IoT do Azure para Python
SDK do IoT do Azure para Node.js
SDK do IoT do Azure para Java
SDK do IoT do Azure para .NET
Recursos de SDK e conectividade do Hub IoT
Toda a comunicação do dispositivo com o Hub IoT usa as opções de conectividade do Hub IoT a seguir:
Mensagens de dispositivo para nuvem
Dispositivos gêmeos
A tabela a seguir resume como os recursos do dispositivo Azure IoT Central são mapeados para os recursos do
Hub IoT:
AZURE IOT CENTRAL HUB IOT DO AZURE
Medida: Telemetria Mensagens do dispositivo para a nuvem
Propriedades do dispositivo Propriedades relatadas do dispositivo gêmeo
Configurações Propriedades desejadas e relatadas do dispositivo gêmeo
Para saber mais sobre como usar os SDKs do Dispositivo, consulte um dos artigos a seguir para exemplo de
código:
Conectar um dispositivo Raspberry Pi ao aplicativo Azure IoT Central
Conectar um dispositivo do kit de DevDiv ao aplicativo Azure IoT Central.
Protocolos
Os SDKs do Dispositivo dão suporte aos protocolos de rede a seguir para conectar um Hub IoT:
MQTT
AMQP
HTTPS
Para obter informações sobre esses diferentes protocolos e as diretrizes sobre como escolher um deles, consulte
Escolher um protocolo de comunicação.
Se o dispositivo não puder usar nenhum dos protocolos com suporte, será possível usar o Azure IoT Edge para
fazer a conversão de protocolo. O IoT Edge dá suporte a outros cenários de inteligência na borda para transferir
o processamento para a borda do aplicativo Azure IoT Central.
Segurança
Todos os dados trocados entre dispositivos e o Azure IoT Central são criptografados. O Hub IoT autentica todas
as solicitações de um dispositivo que conecta a qualquer ponto de extremidade do Hub IoT voltado para o
dispositivo. Para evitar a troca de credenciais pela rede, um dispositivo usa tokens assinados para autenticar. Para
obter mais informações, consulte Controlar o acesso ao Hub IoT.
Próximos passos
Agora que você aprendeu sobre a conectividade do dispositivo no Azure IoT Central, aqui estão as próximas
etapas sugeridas:
Preparar e conectar um dispositivo DevKit
Preparar e conectar um Raspberry Pi
SDK do C: Provisionando o SDK do cliente do dispositivo
O que são modelos de aplicativo?
Os modelos de aplicativo no Azure IoT Central são uma ferramenta para ajudar os criadores de solução a início
rápido seu desenvolvimento de solução de IoT. Você pode usar modelos de aplicativo para tudo, desde o que é
possível, para personalizar totalmente e seu aplicativo para revenda para seus clientes.
Os modelos de aplicativo consistem em:
painéis de operador de exemplo;
Modelos de dispositivo de exemplo
Dispositivos simulados que produzem dados em tempo real
regras e trabalhos pré-configurados e
Documentação avançada, incluindo tutoriais e instruções
Modelos de visualização
Sua escolha de modelo de aplicativo determina se seu aplicativo usa IoT Central recursos de visualização, como
Plug and Play para dispositivos.
Atualmente, o modelo de aplicativo que usa recursos geralmente disponíveis é:
Aplicativo personalizado > aplicação herdada
Atualmente, os modelos de aplicativo que usam recursos de Visualização pública são:
Aplicativo de visualização de > de aplicativo personalizado
Logística de varejo > conectada
Centro de distribuição digital de > de varejo
Retail > Analytics na loja – monitoramento de condição
Retail > Analytics na loja – check-out
Centro de microatendimento de > de varejo
Gerenciamento de inventário inteligente do > de varejo
Monitoramento de medidor inteligente de energia >
Monitoramento do painel solar de energia >
Gerenciamento de lixo conectado > governamental
Monitoramento de consumo de água do governo >
Monitoramento de qualidade de água do governo > aquático
Assistência médica > monitoramento contínuo de pacientes
NOTE
Os modelos de aplicativo herdados estão disponíveis no momento no Estados Unidos, na Austrália, Pacífico Asiáticoou
nos locais da Europa , enquanto outros modelos estão disponíveis no momento apenas nas localizações da Europa e dos
EUA .
Modelos focados no setor

O Azure IoT Central é uma plataforma de aplicativo independente do setor. Os modelos de aplicativo são
exemplos voltados para o setor disponíveis para esses setores hoje, com mais informações sobre o futuro:
Varejo
Logística conectada
Centro de distribuição digital
Análise na loja – monitoramento de condição
Análise na loja-check-out
Gerenciamento de inventário inteligente
Energia
Monitoramento do medidor inteligente
Monitoramento de painel solar
Instituições
Gestão de resíduos conectada
Monitoramento do consumo de água
Monitoramento da qualidade da água
Saúde.
Monitoramento contínuo do paciente
Próximos passos
Agora que você sabe o que são os modelos de aplicativo IoT Central, comece criando um aplicativo IOT central.
Conectar um aplicativo cliente genérico ao aplicativo
Azure IoT Central (Node.js)
NOTE
Este artigo descreve, como um desenvolvedor de dispositivos, como se conectar a um aplicativo Node.js genérico
representando um dispositivo real ao aplicativo Microsoft Azure IoT Central.
Antes de começar
Para concluir as etapas neste artigo, você precisa do seguinte:
Um aplicativo Azure IoT Central. Para obter mais informações, consulte o Criar um início rápido de aplicativo.
Um computador de desenvolvimento com Node.js versão 4.0.0 ou posterior instalado. É possível executar
Criar um modelo de dispositivo

No aplicativo IoT Central do Azure, você precisa de um modelo de dispositivo com as seguintes medidas,
propriedades do dispositivo, configurações e comandos.
Para obter mais informações sobre nomes de propriedade válidos, consulte marcas e formato de propriedades.
Medidas de telemetria
Adicione a seguinte telemetria na página medidas :
NOME DE
EXIBIÇÃO NOME DO CAMPO UNIDADES MIN MAX CASAS DECIMAIS
Temperatura temperatura F 60 110 0
Umidade umidade % 0 100 0
Pressão pressure kPa 80 110 0
NOTE
O tipo de dados da medição de telemetria é um número de ponto flutuante.
Insira os nomes dos campos exatamente como mostrado na tabela no modelo de dispositivo. Se os nomes de
campo não corresponderem aos nomes de propriedade no código de dispositivo correspondente, a telemetria
não poderá ser exibida no aplicativo.
Medidas de estado
Adicione o seguinte estado na página medidas :
NOME DE NOME DE NOME DE

EXIBIÇÃO NOME DO CAMPO VALOR 1 EXIBIÇÃO VALOR 2 EXIBIÇÃO
Modo da fanmode 1 Executando 0 Parada

ventoinha
NOTE
O tipo de dados da medida State é string.
campo não corresponderem aos nomes de propriedade no código de dispositivo correspondente, o estado não
poderá ser exibido no aplicativo.
Medidas de evento
Adicione o seguinte evento na página medidas :
NOME DE EXIBIÇÃO NOME DO CAMPO SEVERITY
Superaquecimento overheat Erro
NOTE
O tipo de dados da medida de evento é cadeia de caracteres.
Medidas de localização
Adicione a seguinte medida de localização na página medidas :
NOME DE EXIBIÇÃO NOME DO CAMPO
Local padrão location
O tipo de dados de medição local é composto de dois números de ponto flutuante para longitude e latitude e um
número de ponto flutuante opcional para altitude.
campo não corresponderem aos nomes de propriedade no código de dispositivo correspondente, o local não
poderá ser exibido no aplicativo.
Propriedades do dispositivo
Adicione as seguintes propriedades de dispositivo na página Propriedades :
NOME DE EXIBIÇÃO NOME DO CAMPO TIPO DE DADOS
Número de série serialNumber texto
Fabricante do dispositivo manufacturer texto
Insira os nomes de campo exatamente conforme mostrado na tabela no modelo de dispositivo. Se os nomes de
campo não corresponderem aos nomes de propriedade no código de dispositivo correspondente, as
propriedades não poderão ser exibidas no aplicativo.
Configurações
Adicione as seguintes configurações de número na página configurações :
NOME DE NOME DO
EXIBIÇÃO CAMPO UNIDADES DECIMAIS MIN MAX INICIAL
Velocidade da fanSpeed rpm 0 0 3000 0

ventoinha
Temperatura setTemperatur F 0 20 200 80

definida e
Insira o nome de campo exatamente conforme mostrado na tabela no modelo de dispositivo. Se os nomes de
campo não corresponderem aos nomes de propriedade no código do dispositivo correspondente, o dispositivo
não poderá receber o valor da configuração.
Comandos
Adicione o seguinte comando na página comandos :
NOME DE EXIBIÇÃO NOME DO CAMPO TEMPO LIMITE PADRÃO TIPO DE DADOS
Contagem regressiva Contagem regressiva 30 número
Adicione o seguinte campo de entrada ao comando de contagem regressiva:
NOME DE EXIBIÇÃO NOME DO CAMPO TIPO DE DADOS VALOR
Contar de countFrom número 10
Insira nomes de campo exatamente como mostrado nas tabelas no modelo de dispositivo. Se os nomes de campo
não corresponderem aos nomes de propriedade no código de dispositivo correspondente, o dispositivo não
poderá processar o comando.

No aplicativo IoT Central do Azure, adicione um dispositivo real ao modelo de dispositivo que você criou na
seção anterior.
Anote as informações de conexão do dispositivo na página conexão do dispositivo : ID do escopo, ID do
dispositivoe chave primária. Você adicionará esses valores no código do dispositivo posteriormente neste guia
de instruções:
Criar um aplicativo do Node.js
As etapas a seguir mostram como criar um aplicativo cliente que implementa o dispositivo real que você
adicionou ao aplicativo. Aqui, o aplicativo Node.js representa o dispositivo real.
1. Crie uma pasta chamada connected-air-conditioner-adv no computador. Navegue até essa pasta no
ambiente de linha de comando.
2. Para inicializar o projeto Node.js, execute os comandos a seguir:
npm init
npm install azure-iot-device azure-iot-device-mqtt azure-iot-provisioning-device-mqtt azure-iot-
security-symmetric-key --save
3. Crie um arquivo chamado connectedAirConditionerAdv.js na pasta connected-air-conditioner-adv .

4. Adicione as require instruções no início do arquivo connectedAirConditionerAdv.js:
"use strict";
// Use the Azure IoT device SDK for devices that connect to Azure IoT Central.
var iotHubTransport = require('azure-iot-device-mqtt').Mqtt;
var Client = require('azure-iot-device').Client;
var Message = require('azure-iot-device').Message;
var ProvisioningTransport = require('azure-iot-provisioning-device-mqtt').Mqtt;
var SymmetricKeySecurityClient = require('azure-iot-security-symmetric-
key').SymmetricKeySecurityClient;
var ProvisioningDeviceClient = require('azure-iot-provisioning-device').ProvisioningDeviceClient;
5. Adicione as declarações de variáveis a seguir ao arquivo:
var provisioningHost = 'global.azure-devices-provisioning.net';

var idScope = '{your Scope ID}';
var registrationId = '{your Device ID}';
var symmetricKey = '{your Primary Key}';
var provisioningSecurityClient = new SymmetricKeySecurityClient(registrationId, symmetricKey);
var provisioningClient = ProvisioningDeviceClient.create(provisioningHost, idScope, new
ProvisioningTransport(), provisioningSecurityClient);
var hubClient;
var targetTemperature = 0;
var locLong = -122.1215;
var locLat = 47.6740;
Atualize os espaços reservados {your Scope ID} , {your Device ID} e {your Primary Key} com os valores
anotados anteriormente. Neste exemplo, você inicializa targetTemperature como zero, pode usar a leitura
atual do dispositivo ou um valor do dispositivo.
6. Para enviar medidas de telemetria, estado, evento e local para o aplicativo de IoT Central do Azure,
adicione a seguinte função ao arquivo:
// Send device measurements.

function sendTelemetry() {
var temperature = targetTemperature + (Math.random() * 15);
var humidity = 70 + (Math.random() * 10);
var pressure = 90 + (Math.random() * 5);
var fanmode = 0;
var locationLong = locLong - (Math.random() / 100);
var locationLat = locLat - (Math.random() / 100);
var data = JSON.stringify({
temperature: temperature,
humidity: humidity,
pressure: pressure,
fanmode: (temperature > 25) ? "1" : "0",
overheat: (temperature > 35) ? "ER123" : undefined,
location: {
lon: locationLong,
lat: locationLat }
});
var message = new Message(data);
hubClient.sendEvent(message, (err, res) => console.log(`Sent message: ${message.getData()}` +
(err ? `; error: ${err.toString()}` : '') +
(res ? `; status: ${res.constructor.name}` : '')));
}
7. Para enviar as propriedades de dispositivo ao aplicativo Azure IoT Central, adicione a função a seguir ao
arquivo:
// Send device reported properties.
function sendDeviceProperties(twin, properties) {
twin.properties.reported.update(properties, (err) => console.log(`Sent device properties:
${JSON.stringify(properties)}; ` +
}
8. Para definir as configurações que o dispositivo responde, adicione a definição a seguir:
// Add any settings your device supports,

// mapped to a function that is called when the setting is changed.
var settings = {
'fanSpeed': (newValue, callback) => {
// Simulate it taking 1 second to set the fan speed.
setTimeout(() => {
callback(newValue, 'completed');
}, 1000);
},
'setTemperature': (newValue, callback) => {
// Simulate the temperature setting taking two steps.
setTimeout(() => {
targetTemperature = targetTemperature + (newValue - targetTemperature) / 2;
callback(targetTemperature, 'pending');
setTimeout(() => {
targetTemperature = newValue;
callback(targetTemperature, 'completed');
}, 5000);
}, 5000);
}
};
9. Para identificar configurações atualizadas do aplicativo Azure IoT Central, adicione o seguinte ao arquivo:
// Handle settings changes that come from Azure IoT Central via the device twin.
function handleSettings(twin) {
twin.on('properties.desired', function (desiredChange) {
for (let setting in desiredChange) {
if (settings[setting]) {
console.log(`Received setting: ${setting}: ${desiredChange[setting].value}`);
settings[setting](desiredChange[setting].value, (newValue, status, message) => {
var patch = {
[setting]: {
value: newValue,
status: status,
desiredVersion: desiredChange.$version,
message: message
}
}
twin.properties.reported.update(patch, (err) => console.log(`Sent setting update for
${setting}; ` +
});
}
}
});
}
10. Adicione o seguinte código para manipular um comando de contagem regressiva enviado do aplicativo IoT
Central:
// Handle countdown command
function onCountdown(request, response) {
console.log('Received call to countdown');
var countFrom = (typeof(request.payload.countFrom) === 'number' && request.payload.countFrom < 100) ?

request.payload.countFrom : 10;
response.send(200, (err) => {

if (err) {
console.error('Unable to send method response: ' + err.toString());
} else {
function doCountdown(){
if ( countFrom >= 0 ) {
var patch = {
countdown:{
value: countFrom
}
};
sendDeviceProperties(twin, patch);
countFrom--;
setTimeout(doCountdown, 2000 );
}
}
doCountdown();
});
}
});
}
11. Adicione o seguinte código para concluir a conexão ao Azure IoT Central e associe as funções no código
cliente:
// Handle device connection to Azure IoT Central.
var connectCallback = (err) => {
if (err) {
console.log(`Device could not connect to Azure IoT Central: ${err.toString()}`);
} else {
console.log('Device successfully connected to Azure IoT Central');
// Create handler for countdown command

hubClient.onDeviceMethod('countdown', onCountdown);
// Send telemetry measurements to Azure IoT Central every 1 second.

setInterval(sendTelemetry, 1000);
// Get device twin from Azure IoT Central.

if (err) {
console.log(Èrror getting device twin: ${err.toString()}`);
} else {
// Send device properties once on device start up.
var properties = {
serialNumber: '123-ABC',
manufacturer: 'Contoso'
};
sendDeviceProperties(twin, properties);
// Apply device settings and handle changes to device settings.

handleSettings(twin);
}
});
}
};
// Start the device (register and connect to Azure IoT Central).

provisioningClient.register((err, result) => {
if (err) {
console.log('Error registering device: ' + err);
} else {
console.log('Registration succeeded');
console.log('Assigned hub=' + result.assignedHub);
console.log('DeviceId=' + result.deviceId);
var connectionString = 'HostName=' + result.assignedHub + ';DeviceId=' + result.deviceId +
';SharedAccessKey=' + symmetricKey;
hubClient = Client.fromConnectionString(connectionString, iotHubTransport);
hubClient.open(connectCallback);
}
});
Execute o aplicativo Node.js

Execute o comando a seguir no ambiente de linha de comando:
node connectedAirConditionerAdv.js
Como um operador no aplicativo Azure IoT Central, para o dispositivo real, é possível:
Exibir a telemetria na página Medidas:
Exiba o local na página medidas :
Exibir os valores da propriedade de dispositivo enviados pelo dispositivo na página Propriedades. Os

blocos de propriedades do dispositivo são atualizados quando o dispositivo se conecta:
Defina a velocidade do ventilador e a temperatura de destino na página configurações :
Chame o comando de contagem regressiva na página comandos :

Próximas etapas
Agora que você aprendeu como conectar um cliente Node. js genérico ao aplicativo IoT Central do Azure, a
próxima etapa sugerida é aprender a configurar um modelo de dispositivo personalizado para seu próprio
dispositivo IOT.
Conectar um dispositivo MXChip IoT DevKit ao
aplicativo Azure IoT Central
NOTE
Este artigo descreve como um desenvolvedor de dispositivos conecta um dispositivo MXChip IoT DevKit (DevKit)
ao aplicativo Microsoft Azure IoT Central.
Antes de começar
Para concluir as etapas neste artigo, você precisa dos seguintes recursos:
1. Um aplicativo de IoT Central do Azure criado com base no modelo de aplicativo herdado . Para obter mais
informações, consulte o Criar um início rápido de aplicativo.
2. Um dispositivo DevKit. Para adquirir um dispositivo DevKit, visite MXChip IoT DevKit.

No aplicativo IoT Central do Azure, adicione um novo modelo de dispositivo MXChip que define as seguintes
características de dispositivo:
Medidas de telemetria para umidade, temperatura, pressão, magnetômetro (medida ao longo de x, y, eixo
z), acelerômetro (medido ao longo de x, y, eixo z) e giroscópio (medido ao longo do eixo x, y, z).
Medida de estado para o estado do dispositivo.
Medida de evento para o botão B pressionado.
Configurações de tensão, atual, velocidade do ventiladore uma alternância de ir .
O número de matrizes e o local do dispositivosão propriedades do dispositivo, que é uma propriedade de
local.
Propriedade de nuvem fabricada em.
Comandos Echo e contagem regressiva. Quando um dispositivo real recebe um comando Echo , ele mostra
o valor enviado na tela do dispositivo. Quando um dispositivo real recebe um comando de contagem
regressiva , o LED percorre um padrão e o dispositivo envia valores de contagem regressiva de volta para IOT
central.
1. Selecione + novo nos modelos de dispositivo
2. Selecione MXChip e crie o modelo de dispositivo MXChip
Para obter detalhes completos sobre a configuração, consulte detalhes do modelo de dispositivo MXChip

Obter detalhes de conexão do dispositivo
No aplicativo IoT Central do Azure, adicione um dispositivo real do modelo de dispositivo MXChip e anote os
detalhes de conexão do dispositivo: ID do escopo, ID do dispositivo e chave primária:
1. Adicionar um dispositivo real de dispositivos, selecione + novo > real para adicionar um dispositivo real.
Insira uma ID de dispositivoem minúsculas ou use a ID de dispositivosugerida.
Insira um nome de dispositivoou use o nome sugerido
2. Para obter os detalhes de conexão do dispositivo, a ID do escopo, a ID do dispositivoe a chave

primária, selecione conectar na página do dispositivo.
3. Anote os detalhes da conexão. Você estará temporariamente desconectado da Internet quando preparar o
dispositivo DevKit na próxima etapa.
Preparar o dispositivo DevKit
Se você já usou o dispositivo e deseja reconfigurá-lo para usar uma rede WiFi diferente, uma cadeia de conexão
ou uma medição de telemetria, pressione os botões a e B ao mesmo tempo. Se não funcionar, pressione o botão
Redefinir e tente novamente.
Para preparar o dispositivo DevKit
1. Baixe o último firmware do Azure IoT Central pré-criado para o MXChip na página versões no GitHub.
2. Conecte o dispositivo DevKit ao computador de desenvolvimento usando um cabo USB. No Windows,
uma janela do explorador de arquivos abre em uma unidade mapeada para o armazenamento no
dispositivo DevKit. Por exemplo, a unidade pode ser chamada AZ3166 (D:) .
3. Arraste o arquivo iotCentral.bin para a janela da unidade. Quando a cópia for concluída, o dispositivo
será reiniciado com o novo firmware.
4. Quando o dispositivo DevKit for reiniciado, a tela a seguir será exibida:
Connect HotSpot:
AZ3166_??????
go-> 192.168.0.1
PIN CODE xxxxx
NOTE
Se a tela exibir qualquer outra diferente dessa, redefina o dispositivo e pressione os botões A e B no dispositivo ao
mesmo tempo para reinicializar o dispositivo.
5. O dispositivo agora está no modo de AP (Ponto de Acesso). É possível conectar esse ponto de acesso WiFi
a partir do computador ou dispositivo móvel.
6. No computador, telefone ou tablet, conecte o nome da rede WiFi exibido na tela do dispositivo. Quando
você se conecta a essa rede, você não tem acesso à Internet. Esse estado é esperado e você só está
conectado a essa rede por um curto período enquanto configura o dispositivo.
7. Abra o navegador da Web e navegue até http://192.168.0.1/start. A página da Web a seguir é exibida:
Na página da Web, digite:

O nome da rede WiFi
Sua senha de rede WiFi
O código do PIN mostrado na exibição do dispositivo
A ID do escopodos detalhes da conexão, a ID do dispositivoe a chave primária do seu dispositivo
(você já deve ter salvo isso seguindo as etapas)
Selecionar todas as medidas de telemetria disponíveis
8. Após escolher Configurar Dispositivo, você verá esta página:
9. Pressione o botão Reiniciar no dispositivo.
Exibir a Telemetria
Quando o dispositivo DevKit for reiniciado, a tela no dispositivo exibirá:
O número de mensagens de telemetria enviadas.
O número de falhas.
O número de propriedades desejadas recebidas e o número de propriedades relatadas enviadas.
NOTE
Se o dispositivo parecer fazer um loop ao tentar se conectar, verifique se o dispositivo está bloqueado no IOT central e
desbloqueie o dispositivo para que ele possa se conectar ao aplicativo.
Agite o dispositivo para enviar uma propriedade relatada. O dispositivo envia um número aleatório como a
propriedade de dispositivo Número impresso.
É possível exibir as medidas de telemetria e os valores das propriedades relatadas e definir as configurações no
Azure IoT Central:
1. Use dispositivos para navegar até a página de medidas do dispositivo real MXChip que você adicionou:
2. Na página Medidas, é possível ver a telemetria proveniente do dispositivo MXChip:
3. Na página Propriedades, é possível ver o último número impresso e a localização do dispositivo relatados
pelo dispositivo:
4. Na página Configurações, é possível atualizar as configurações no dispositivo MXChip:

5. Na página comandos , você pode chamar os comandos Echo e regressiva :
6. Na página Painel, você pode ver o mapa do local

Fazer o download do código-fonte
Se você quiser explorar e modificar o código do dispositivo, poderá baixá-lo do GitHub. Se você planeja modificar
o código, siga essas instruções para preparar o ambiente de desenvolvimento do sistema operacional de área de
trabalho.
Para baixar o código-fonte, execute o comando a seguir no computador desktop:
git clone https://github.com/Azure/iot-central-firmware
O comando anterior baixa o código-fonte para uma pasta chamada iot-central-firmware .
NOTE
Se o git não estiver instalado no ambiente de desenvolvimento, será possível baixá-lo a partir de https://git-
scm.com/download.
Examine o código
Use Visual Studio Code para abrir a pasta MXCHIP/mxchip_advanced na pasta iot-central-firmware :
Para ver como a telemetria é enviada ao aplicativo de IoT Central do Azure, abra o arquivo telemetria. cpp na
pasta src :
A função TelemetryController::buildTelemetryPayload cria a carga de telemetria JSON usando dados dos
sensores no dispositivo.
A função TelemetryController::sendTelemetryPayload chama sendTelemetry no AzureIOTClient. cpp para
enviar a carga JSON para o Hub IOT que seu aplicativo do Azure IOT central usa.
Para ver como os valores de propriedade são relatados para o aplicativo de IoT Central do Azure, abra o arquivo
telemetria. cpp na pasta src :
A função TelemetryController::loop envia a propriedade de localização relatada aproximadamente a
cada 30 segundos. Ele usa a função sendReportedProperty no arquivo de origem AzureIOTClient. cpp .
A função TelemetryController::loop envia a propriedade relatada dieNumber quando o dispositivo
acelerômetro detecta um toque duplo. Ele usa a função sendReportedProperty no arquivo de origem
AzureIOTClient. cpp .
Para ver como o dispositivo responde aos comandos chamados do aplicativo IoT Central, abra o arquivo
registeredMethodHandlers. cpp na pasta src :
A função dmEcho é o manipulador para o comando Echo . Ele mostra o distocadovalue arquivado na
carga na tela do dispositivo.
A função dmCountdown é o manipulador do comando de contagem regressiva . Ele altera a cor do LED
do dispositivo e usa uma propriedade relatada para enviar o valor de contagem regressiva de volta para o
aplicativo IoT Central. A propriedade relatada tem o mesmo nome que o comando. A função usa a função
sendReportedProperty no arquivo de origem AzureIOTClient. cpp .
O código no arquivo de origem AzureIOTClient. cpp usa funções do Microsoft Azure SDKs e bibliotecas de IOT
para C para interagir com o Hub IOT.
Para obter informações sobre como modificar, compilar e carregar o código de exemplo no dispositivo, consulte o
arquivo readme.md na pasta MXCHIP/mxchip_advanced .
Detalhes do modelo de Dispositivo de MXChip

Um aplicativo criado com base no modelo de aplicativo de Devkits de Exemplo inclui um modelo de dispositivo
MXChip com as características a seguir:
Medidas
Telemetria
NOME DO CAMPO UNIDADES MÍNIMO MÁXIMO CASAS DECIMAIS
umidade % 0 100 0
temp °C -40 120 0
pressão hPa 260 1260 0
magnetometerX mgauss -1000 1.000 0
magnetometerY mgauss -1000 1.000 0
magnetometerZ mgauss -1000 1.000 0
accelerometerX mg -2000 2000 0
accelerometerY mg -2000 2000 0
accelerometerZ mg -2000 2000 0
gyroscopeX mdps -2000 2000 0
gyroscopeY mdps -2000 2000 0
gyroscopeZ mdps -2000 2000 0
Estados
NOME NOME DE EXIBIÇÃO NORMAL CUIDADO PERIGO
DeviceState Estado do dispositivo Verde Orange Vermelho
Eventos
NOME NOME DE EXIBIÇÃO
ButtonBPressed Botão B Pressionado
Configurações
Configurações numéricas
NOME DE NOME DO CASAS

EXIBIÇÃO CAMPO UNIDADES DECIMAIS MÍNIMO MÁXIMO INICIAL
Voltagem setVoltage Volts 0 0 240 0

Current setCurrent Amps 0 0 100 0
Velocidade da fanSpeed RPM 0 0 1.000 0

ventoinha
Configurações de alternância
NOME DE EXIBIÇÃO NOME DO CAMPO TEX TO ATIVADO TEX TO DESATIVADO INICIAL
IR activateIR ATIVADO OFF Desligar
Propriedades
TIPO NOME DE EXIBIÇÃO NOME DO CAMPO TIPO DE DADOS
Propriedade de dispositivo Número impresso dieNumber número
Propriedade de dispositivo Localização do dispositivo local local
Texto Fabricado em manufacturedIn N/D
Comandos
NOME DE
EXIBIÇÃO DO
NOME DE CAMPO DE NOME DO CAMPO TIPO DE CAMPO DE
EXIBIÇÃO NOME DO CAMPO TIPO DE RETORNO ENTRADA DE ENTRADA ENTRADA
Echo echo text valor a ser disreproduçãoval text

exibido ue
Contagem contagem número Contar de countFrom número

regressiva regressiva
Próximos passos
Agora que você aprendeu como conectar um MXChip IoT DevKit ao seu aplicativo IoT Central do Azure, a
próxima etapa sugerida é aprender como configurar um modelo de dispositivo personalizado para seu próprio
dispositivo IOT.
Conectar um Raspberry Pi ao aplicativo Azure IoT
Central (Python)
NOTE
Este artigo descreve como um desenvolvedor de dispositivos conecta um Raspberry Pi ao aplicativo Microsoft
Azure IoT Central usando a linguagem de programação Python.
Antes de começar
Para concluir as etapas deste artigo, você precisa dos seguintes componentes:
Um aplicativo de IoT Central do Azure criado com base no modelo de aplicativo herdado . Para obter mais
Um dispositivo Raspberry Pi executando o sistema operacional Raspbian. O Raspberry Pi deve ser capaz de se
conectar à Internet. Para obter mais informações, consulte Configurando o Raspberry Pi.
TIP
Para saber mais sobre como configurar e conectar-se a um dispositivo Raspberry Pi, visite introdução ao Raspberry Pi

No aplicativo IoT Central do Azure, adicione um novo modelo de dispositivo do Raspberry Pi com as seguintes
características:
Telemetria, que inclui as seguintes medidas que o dispositivo coletará:
Umidade
Temperatura
Pressão
Magnetômetro (X, Y, Z )
Acelerômetro (X, Y, Z )
Giroscópio (X, Y, Z )
Configurações
Voltagem
Current
Velocidade da ventoinha
Alternar IR.
Propriedades
Propriedade do dispositivo número de dado
Propriedade de localização da nuvem
2. Selecione Raspberry Pi e crie o modelo de dispositivo Raspberry Pi
Para obter os detalhes completos da configuração do modelo de dispositivo, consulte os detalhes do modelo de
dispositivo do Raspberry Pi.

No aplicativo IoT Central do Azure, adicione um dispositivo real do modelo de dispositivo Raspberry Pi . Anote
os detalhes de conexão do dispositivo (ID do escopo, ID do dispositivoe chave primária). Para obter mais
informações, consulte Adicionar um dispositivo real ao aplicativo Azure IoT Central.
Configurar o Raspberry Pi
As etapas a seguir descrevem como baixar e configurar o aplicativo Python de exemplo do GitHub. Este aplicativo
de exemplo:
Envia dados de telemetria e valores de propriedade para o Azure IoT Central.
Responde a alterações de configuração feitas no Azure IoT Central.
1. Conecte-se a um ambiente de Shell em seu Raspberry Pi, seja da área de trabalho do Raspberry Pi ou
remotamente usando SSH.
2. Execute o seguinte comando para instalar o IoT Central cliente Python:
pip install iotc
3. Baixe o código Python de exemplo:
curl -O https://raw.githubusercontent.com/Azure/iot-central-firmware/master/RaspberryPi/app.py
4. Edite o arquivo de app.py que você baixou e substitua os espaços reservados DEVICE_ID , SCOPE_ID e
PRIMARY/SECONDARY device KEY pelos valores de conexão anotados anteriormente. Salve suas alterações.
TIP
No Shell no Raspberry Pi, você pode usar os editores de texto nano ou vi .
5. Use o seguinte comando para executar a amostra:
python app.py
O Raspberry Pi começa a enviar medidas de telemetria para o Azure IoT Central.

6. No aplicativo Azure IoT Central, é possível ver como o código em execução no Raspberry Pi interage com
o aplicativo:
Na página Medidas do dispositivo real, é possível ver a telemetria enviada do Raspberry Pi.
Na página Propriedades , você pode ver a propriedade de dispositivo número de matriz .
Na página configurações , você pode alterar as configurações no Raspberry Pi, como tensão e
velocidade do ventilador. Quando o Raspberry Pi reconhece a alteração, a configuração é mostrada
como sincronizada.
Detalhes do modelo de dispositivo Raspberry Pi

Um aplicativo criado a partir do modelo de aplicativo de Devkits de Exemplo inclui um modelo de dispositivo
Raspberry Pi com as características a seguir:
umidade % 0 100 0
temp °C -40 120 0
Configurações


ventoinha
Propriedades
Texto Local local N/D
Próximos passos
Agora que você aprendeu como conectar um Raspberry Pi ao seu aplicativo IoT Central do Azure, a próxima
etapa sugerida é aprender como configurar um modelo de dispositivo personalizado para seu próprio dispositivo
IOT.
Conectar um Raspberry Pi ao aplicativo Azure IoT
Central (C#)
NOTE
Este artigo descreve como um desenvolvedor de dispositivos conecta um Raspberry Pi ao aplicativo Microsoft
Azure IoT Central usando a linguagem de programação C#.
Antes de começar
Para concluir as etapas deste artigo, você precisa dos seguintes componentes:
Um dispositivo Raspberry Pi executando o sistema operacional Raspbian. O Raspberry Pi deve ser capaz de se
conectar à Internet. Para obter mais informações, consulte Configurando o Raspberry Pi.

No aplicativo IoT Central do Azure, adicione um novo modelo de dispositivo do Raspberry Pi com as seguintes
características:
Telemetria, que inclui as seguintes medidas que o dispositivo coletará:
Umidade
Temperatura
Pressão
Magnetômetro (X, Y, Z )
Acelerômetro (X, Y, Z )
Giroscópio (X, Y, Z )
Configurações
Voltagem
Current
Velocidade da ventoinha
Alternar IR.
Propriedades
Propriedade do dispositivo número de dado
Propriedade de localização da nuvem
2. Selecione Raspberry Pi e crie o modelo de dispositivo Raspberry Pi
Para obter os detalhes completos da configuração do modelo de dispositivo, consulte os detalhes do modelo de
dispositivo do Raspberry Pi.

No aplicativo IoT Central do Azure, adicione um dispositivo real do modelo de dispositivo Raspberry Pi . Anote
os detalhes de conexão do dispositivo (ID do escopo, ID do dispositivoe chave primária). Para obter mais
informações, consulte Adicionar um dispositivo real ao aplicativo Azure IoT Central.
Criar o aplicativo .NET
Você cria e testa o aplicativo do dispositivo no computador desktop.
Para concluir as etapas a seguir, você pode usar o Visual Studio Code. Para saber mais, consulte Trabalhando com
C#.
NOTE
Se preferir, você pode concluir as etapas a seguir usando um editor de código diferente.
1. Para inicializar o projeto .NET e adicionar os pacotes necessários do NuGet, execute os comandos a seguir:
mkdir pisample
cd pisample
dotnet new console
dotnet add package Microsoft.Azure.Devices.Client
dotnet add package Microsoft.Azure.Devices.Provisioning.Client
dotnet add package Microsoft.Azure.Devices.Provisioning.Transport.Mqtt
dotnet restore
2. Abra a pasta pisample no Visual Studio Code. Em seguida, abra o arquivo de projeto pisample.csproj.
Adicione a marca <RuntimeIdentifiers> mostrada no seguinte snippet de código:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp2.1</TargetFramework>
<RootNamespace>pisample</RootNamespace>
<RuntimeIdentifiers>win-arm;linux-arm</RuntimeIdentifiers>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.Azure.Devices.Client" Version="1.21.0" />
<PackageReference Include="Microsoft.Azure.Devices.Provisioning.Client" Version="1.4.0" />
<PackageReference Include="Microsoft.Azure.Devices.Provisioning.Transport.Mqtt" Version="1.1.8" />
</ItemGroup>
</Project>
NOTE
Os números de versão do pacote podem ser maiores do que os mostrados.
3. Salve o pisample.csproj. Se o Visual Studio Code solicitar que você execute o comando de restauração,
escolha Restaurar.
4. Abra Program.cs e substitua o conteúdo pelo código a seguir. Atualize o {your Scope ID} ,
{your Device ID} e {your Device Primary Key} com os valores anotados anteriormente:
using System;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.Azure.Devices.Client;
using Microsoft.Azure.Devices.Shared;
using Microsoft.Azure.Devices.Provisioning.Client;
using Microsoft.Azure.Devices.Provisioning.Client.Transport;
using Newtonsoft.Json;
namespace pisample
{
class Program
{
static string ScopeID = "{your Scope ID}";
static string DeviceID = "{your Device ID}";
static string PrimaryKey = "{your Device Primary Key}";
static string GlobalDeviceEndpoint = "global.azure-devices-provisioning.net";
static DeviceClient Client = null;
static TwinCollection reportedProperties = new TwinCollection();
static CancellationTokenSource cts;
static double baseTemperature = 60;
static double basePressure = 500;
static double baseHumidity = 50;
static async Task Main(string[] args)

{
Console.WriteLine("== Raspberry Pi Azure IoT Central example ==");
try
{
using (var security = new SecurityProviderSymmetricKey(DeviceID, PrimaryKey, null))

{
DeviceRegistrationResult result = await RegisterDeviceAsync(security);
if (result.Status != ProvisioningRegistrationStatusType.Assigned) {
Console.WriteLine("Failed to register device");
return;
}
IAuthenticationMethod auth = new
DeviceAuthenticationWithRegistrySymmetricKey(result.DeviceId, (security as
SecurityProviderSymmetricKey).GetPrimaryKey());
Client = DeviceClient.Create(result.AssignedHub, auth, TransportType.Mqtt);
}
await SendDevicePropertiesAsync();
Console.Write("Register settings changed handler...");

await Client.SetDesiredPropertyUpdateCallbackAsync(HandleSettingChanged, null);
Console.WriteLine("Done");
cts = new CancellationTokenSource();

Task task = SendTelemetryAsync(cts.Token);
Console.WriteLine("Press any key to exit...");

Console.ReadKey();
cts.Cancel();
await task;
}
catch (Exception ex)
{
Console.WriteLine();
Console.WriteLine(ex.Message);
}
}
public static async Task<DeviceRegistrationResult> RegisterDeviceAsync(SecurityProviderSymmetricKey

security)
{
Console.WriteLine("Register device...");
using (var transport = new ProvisioningTransportHandlerMqtt(TransportFallbackType.TcpOnly))

{
ProvisioningDeviceClient provClient =
ProvisioningDeviceClient.Create(GlobalDeviceEndpoint, ScopeID, security,
transport);
Console.WriteLine($"RegistrationID = {security.GetRegistrationID()}");
Console.WriteLine($"RegistrationID = {security.GetRegistrationID()}");
Console.Write("ProvisioningClient RegisterAsync...");
DeviceRegistrationResult result = await provClient.RegisterAsync();
Console.WriteLine($"{result.Status}");
Console.WriteLine($"ProvisioningClient AssignedHub: {result.AssignedHub}; DeviceID:
{result.DeviceId}");
return result;
}
}
public static async Task SendDevicePropertiesAsync()

{
Console.WriteLine("Send device properties...");
Random random = new Random();
TwinCollection telemetryConfig = new TwinCollection();
reportedProperties["dieNumber"] = random.Next(1, 6);
Console.WriteLine(JsonConvert.SerializeObject(reportedProperties));
await Client.UpdateReportedPropertiesAsync(reportedProperties);
}
private static async Task SendTelemetryAsync(CancellationToken token)

{
Random rand = new Random();
while (true)
{
double currentTemperature = baseTemperature + rand.NextDouble() * 20;
double currentPressure = basePressure + rand.NextDouble() * 100;
double currentHumidity = baseHumidity + rand.NextDouble() * 20;
var telemetryDataPoint = new

{
humidity = currentHumidity,
pressure = currentPressure,
temp = currentTemperature
};
var messageString = JsonConvert.SerializeObject(telemetryDataPoint);
var message = new Message(Encoding.ASCII.GetBytes(messageString));
token.ThrowIfCancellationRequested();
await Client.SendEventAsync(message);
Console.WriteLine("{0} > Sending telemetry: {1}", DateTime.Now, messageString);
await Task.Delay(1000);
}
}
private static async Task HandleSettingChanged(TwinCollection desiredProperties, object

userContext)
{
Console.WriteLine("Received settings change...");
Console.WriteLine(JsonConvert.SerializeObject(desiredProperties));
string setting = "fanSpeed";

if (desiredProperties.Contains(setting))
{
// Act on setting change, then
BuildAcknowledgement(desiredProperties, setting);
}
setting = "setVoltage";
{
}
setting = "setCurrent";
{
}
setting = "activateIR";
{
}
Console.WriteLine("Send settings changed acknowledgement...");
await Client.UpdateReportedPropertiesAsync(reportedProperties);
}
private static void BuildAcknowledgement(TwinCollection desiredProperties, string setting)

{
reportedProperties[setting] = new
{
value = desiredProperties[setting]["value"],
status = "completed",
desiredVersion = desiredProperties["$version"],
message = "Processed"
};
}
}
}
Executar o aplicativo .NET

Para compilar e executar o aplicativo de exemplo:
1. Execute o comando a seguir no ambiente de linha de comando:
dotnet restore
dotnet publish -r linux-arm
2. Copie a pasta pisample\bin\Debug\netcoreapp2.1\linux-arm\publish ao dispositivo Raspberry Pi. É possível

usar o comando scp para copiar os arquivos, por exemplo:
scp -r publish pi@192.168.0.40:publish
Para obter mais informações, consulte Acesso remoto do Raspberry Pi.

3. Entre no dispositivo Raspberry Pi e execute os comandos a seguir em um shell:
sudo apt-get update

sudo apt-get install libc6 libcurl3 libgcc1 libgssapi-krb5-2 liblttng-ust0 libstdc++6 libunwind8
libuuid1 zlib1g
4. No Raspberry Pi, execute os comandos a seguir:
cd publish
chmod 777 pisample
./pisample
5. No aplicativo Azure IoT Central, é possível ver como o código em execução no Raspberry Pi interage com o
aplicativo:
Na página Medidas do dispositivo real, é possível ver a telemetria.
Na página Propriedades, é possível ver o valor da propriedade do Número Impresso.
Na página Configurações, é possível alterar várias configurações no Raspberry Pi, como voltagem
e velocidade da ventoinha.
A captura de tela a seguir mostra o Raspberry Pi recebendo a alteração de configuração:
Detalhes do modelo de dispositivo Raspberry Pi

Raspberry Pi com as características a seguir:
umidade % 0 100 0
temp °C -40 120 0

Configurações


ventoinha
Propriedades
Local Local local {Lat: float, Long: float, Alt?:

float}
Próximos passos
Agora que você aprendeu como conectar um Raspberry Pi ao seu aplicativo IoT Central do Azure, a próxima
IOT.
Conectar um dispositivo Windows IoT Core ao
aplicativo Azure IoT Central
NOTE
Este artigo descreve como um desenvolvedor de dispositivos conecta um dispositivo Windows IoT Core ao
aplicativo Microsoft Azure IoT Central.
Antes de começar
Um dispositivo executando o sistema operacional Windows 10 IoT Core. Para obter mais informações,
consulte configurando seu dispositivo Windows 10 IOT Core.
Um computador de desenvolvimento com o node. js versão 8.0.0 ou posterior instalado. É possível executar

No aplicativo IoT Central do Azure, adicione um novo modelo de dispositivo Windows IOT Core com as
seguintes características:
Medições de telemetria para o dispositivo: umidade, temperaturae pressão.
Configuração para controlar a velocidade do ventilador.
Um número de matriz de propriedade de dispositivo e um localde propriedade de nuvem.
2. Selecione Windows IOT Core e crie o modelo de dispositivo Windows iot Core
Para obter detalhes completos sobre a configuração do modelo de dispositivo, consulte detalhes do modelo de
dispositivo do Windows IOT Core.

No aplicativo IoT Central do Azure, use a página Device Explorer para adicionar um dispositivo real do modelo
de dispositivo do Windows 10 IOT Core . Anote os detalhes de conexão do dispositivo (ID do escopo, ID do
dispositivoe chave primária).
Preparar o dispositivo
Para que o dispositivo se conecte ao IoT Central, ele precisa de uma cadeia de conexão:
1. Use o utilitário de linha de comando dps-keygen para gerar uma cadeia de conexão:
Para instalar o utilitário de gerador de chave, execute o seguinte comando:
npm i -g dps-keygen
2. Para gerar uma cadeia de conexão, execute o seguinte comando usando os detalhes de conexão anotados
anteriormente:
dps-keygen -di:<Device ID> -dk:<Primary or Secondary Key> -si:<Scope ID>
3. Copie a cadeia de conexão da saída dps-keygen para usar em seu código de dispositivo.
Para que o código do dispositivo acesse a cadeia de conexão, salve-o em um arquivo chamado Connection.
String. iothub na pasta C:\Data\Users\DefaultAccount\Documents\ em seu dispositivo Windows 10 IOT Core.
Para copiar o arquivo Connection. String. iothub de seu computador desktop para a pasta
C:\Data\Users\DefaultAccount\Documents\ em seu dispositivo, você pode usar o portal do dispositivo Windows:
1. Use seu navegador da Web para navegar até o portal do dispositivo Windows em seu dispositivo.
2. Para procurar os arquivos em seu dispositivo, escolha aplicativos > explorador de arquivos.
3. Navegue para o usuário Folders\Documents. Em seguida, carregue o arquivo Connection. String.
iothub :
Implantar e executar
Para implantar e executar o aplicativo de exemplo em seu dispositivo, você pode usar o portal de dispositivo do
Windows:
1. Use seu navegador da Web para navegar até o portal do dispositivo Windows em seu dispositivo.
2. Para implantar e executar o aplicativo cliente do Hub IOT do Azure , escolha aplicativos > amostras de
execução rápida. Em seguida, escolha cliente do Hub IOT do Azure.
3. Em seguida, escolha implantar e executar.
Após alguns minutos, você pode exibir a telemetria do seu dispositivo no seu aplicativo IoT Central.
O portal de dispositivos do Windows inclui ferramentas que você pode usar para solucionar problemas de seu
dispositivo:
A página Gerenciador de aplicativos permite controlar os aplicativos em execução no seu dispositivo.
Se você não tiver um monitor conectado ao seu dispositivo, poderá usar a página configurações do
dispositivo para capturar capturas de tela do seu dispositivo. Por exemplo:
Fazer o download do código-fonte
Se você quiser explorar e modificar o código-fonte do aplicativo cliente, poderá baixá-lo no repositório GitHub
Windows-iotcore-Samples.
Detalhes do modelo de dispositivo

Windows IoT Core com as características a seguir:
umidade % 0 100 0
temp °C -40 120 0
Configurações


ventoinha
Propriedades
Texto Local local N/D
Próximos passos
Agora que você aprendeu como conectar um dispositivo Windows IoT Core ao seu aplicativo IoT Central do
Azure, a próxima etapa sugerida é aprender a configurar um modelo de dispositivo personalizado para seu próprio
dispositivo IOT.
Conectar o dispositivo SensorTile. Box ao seu
aplicativo IoT Central do Azure
NOTE
Este artigo descreve como, como desenvolvedor de dispositivos, conectar um dispositivo SensorTile. Box ao seu
aplicativo Microsoft Azure IoT Central.
Antes de começar
Para concluir as etapas neste artigo, você precisa dos seguintes recursos:
Um dispositivo SensorTile. Box. Para obter mais informações, consulte SensorTile. Box.
O aplicativo de sensor ST BLE instalado em seu dispositivo Android, você pode baixá-lo aqui. Para obter mais
informações, visite: St ble sensor
Um aplicativo de IoT Central do Azure criado com base no modelo de aplicativo DevKits . Para obter mais
Adicione o modelo de dispositivo SensorTile. Box ao seu aplicativo IOT central visitando a página modelos
de dispositivo , clicando em + novoe selecionando o modelo SensorTile. Box .
Obter detalhes de conexão do dispositivo
No aplicativo IoT Central do Azure, adicione um dispositivo real do modelo de dispositivo SensorTile. Box e
anote os detalhes de conexão do dispositivo: ID do escopo, ID do dispositivoe chave primária:
1. Adicionar um dispositivo de dispositivos. Selecione + novo > real para adicionar um dispositivo real.
Insira uma ID de dispositivoem minúsculas ou use a ID de dispositivosugerida.
Insira um nome de dispositivoou use o nome sugerido
2. Para obter os detalhes de conexão do dispositivo, a ID do escopo, a ID do dispositivoe a chave primária,

selecione conectar na página do dispositivo.
3. Anote os detalhes da conexão. Você estará temporariamente desconectado da Internet quando preparar o
dispositivo DevKit na próxima etapa.
Configurar o SensorTile. Box com o aplicativo móvel

Nesta seção, você aprenderá a enviar por push o firmware do aplicativo para o dispositivo. Em seguida, você deve
enviar os dados do dispositivo para IoT Central por meio do aplicativo móvel ST BLE sensor usando conectividade
BLE (Bluetooth de baixa energia).
1. Abra o aplicativo de sensor ST BLE e pressione o botão criar um novo aplicativo .
2. Selecione o aplicativo indicador .

3. Pressione o botão carregar.
4. Pressione o botão reproduzir associado à sua SensorTile. Box.
5. Quando o processo for concluído, o SensorTile. Box transmitirá a temperatura, a pressão e a umidade sobre
BLE.
Conectar o SensorTile. Box à nuvem

Nesta seção, você aprenderá a conectar o SensorTile. Box ao aplicativo móvel e a conectar o aplicativo móvel à
nuvem.
1. Usando o painel esquerdo, selecione o botão log de nuvem .
2. Selecione Azure IOT central como o provedor de nuvem.

3. Insira a ID do dispositivo e a ID do escopo que foram indicadas anteriormente.
4. Selecione o botão de opção chave do aplicativo .
5. Clique em conectar e selecione os dados de telemetria que você deseja carregar.
6. Após alguns segundos, os dados aparecerão no painel do aplicativo IoT Central.
Detalhes do modelo de dispositivo SensorTile. Box

Um aplicativo criado a partir do modelo de dispositivo SensorTile. Box com as seguintes características:
Telemetria
umidade % 30 90 1
temp °C 0 40 1
pressure mbar 900 1100 2
magnetometerX mgauss -1000 1000 0
magnetometerY mgauss -1000 1000 0
magnetometerZ mgauss -1000 1000 0
gyroscopeX DPS -3276 3276 1
gyroscopeY DPS -3276 3276 1
gyroscopeZ DPS -3276 3276 1
FFT_X
FFT_Y
FFT_Z
Próximas etapas
Agora que você aprendeu como conectar um SensorTile. Box ao seu aplicativo IoT Central do Azure, a próxima
IOT.
Monitorar a conectividade de dispositivo usando o
Azure IoT Central Explorer
Este tópico aplica -se a construtores e administradores.

Use a CLI do IoT Central Explorer para ver as mensagens que os dispositivos estão enviando para o IoT Central e
observe as alterações no dispositivo gêmeo do Hub IoT. É possível usar essa ferramenta de software livre para
obter informações mais detalhadas sobre o estado da conectividade de dispositivo e diagnosticar problemas de
mensagens do dispositivo que não alcançam a nuvem ou dispositivos que não estão respondendo a alterações do
dispositivo gêmeo.
Visite o repositório IOTC -Explorer no GitHub.
Pré-requisitos
Node.js versão 8.x ou superior - https://nodejs.org
Um administrador do seu aplicativo deve gerar um token de acesso para você usar no IOTC -Explorer
Instalar o IOTC-Explorer
Para instalar, execute o comando a seguir na linha de comando:
npm install -g iotc-explorer
NOTE
Normalmente, você precisa executar o comando install com sudo em ambientes semelhantes ao Unix.
Executar o IOTC-Explorer
As seções a seguir descrevem comandos e opções comuns que você pode usar ao executar o iotc-explorer . Para
exibir o conjunto completo de comandos e opções, passe --help para iotc-explorer ou qualquer um de seus
subcomandos.
Logon
Antes de começar, é necessário ter um administrador do aplicativo IoT Central para obter um token de acesso para
você usar. O administrador executa as etapas a seguir:
1. Navegue até Administração e, em seguida, acesse tokens.
2. Selecione gerar token.
3. Insira um nome de token, selecione Avançare, em seguida, copiar.
NOTE
O valor do token é mostrado apenas uma vez, portanto, ele deve ser copiado antes de fechar a caixa de diálogo.
Depois de fechar a caixa de diálogo, ela nunca é mostrada novamente.
Você pode usar o token para fazer logon na CLI da seguinte maneira:
iotc-explorer login "<Token value>"
Se preferir não ter o token persistido no histórico do Shell, você poderá deixar o token fora e, em vez disso,
fornecê-lo quando solicitado:
iotc-explorer login
Monitorar mensagens de dispositivo
É possível inspecionar as mensagens provenientes de um dispositivo específico ou de todos os dispositivos no
aplicativo usando o comando monitor-messages . Esse comando inicia um observador que gera continuamente
novas mensagens à medida que elas chegam:
Para inspecionar todos os dispositivos no aplicativo, execute o comando a seguir:
iotc-explorer monitor-messages
Saída:
Para assistir a um dispositivo específico, basta adicionar a ID do dispositivo ao final do comando:
iotc-explorer monitor-messages <your-device-id>
Você também pode gerar um formato mais amigável adicionando a opção --raw ao comando:
iotc-explorer monitor-messages --raw
Obter dispositivo gêmeo

É possível usar o comando get-twin para obter o conteúdo do dispositivo gêmeo de um dispositivo IoT Central.
Para fazer isso, execute o comando a seguir:
iotc-explorer get-twin <your-device-id>
Saída:
Tal como em monitor-messages , você pode obter uma saída amigável do computador, passando a opção --raw :
iotc-explorer get-twin <your-device-id> --raw
Próximos passos
Agora que você aprendeu a usar o IoT Central Explorer, a próxima etapa sugerida é explorar o Gerenciamento de
dispositivos IOT central.
Configurar um modelo de dispositivo
NOTE
Um modelo de dispositivo é um blueprint que define as características e os comportamentos de um tipo de

dispositivo que conecta a um aplicativo do Azure IoT Central.
Por exemplo, um construtor pode criar um modelo de dispositivo para um ventilador conectado com as
seguintes características:
Medição de telemetria de temperatura
Medida de localização
Medição de evento de erro de motor da ventoinha
Medição do estado operacional da ventoinha
Ajuste de velocidade da ventoinha
Regras que enviam alertas
Painel que oferece uma visão geral do dispositivo
A partir desse modelo de dispositivo, um operador pode criar e conectar dispositivos de ventoinhas reais
com nomes como ventoinha-1 e ventoinha-2. Todos esses fãs possuem medidas, configurações,
propriedades, regras e um painel que os usuários do seu aplicativo podem monitorar e gerenciar.
NOTE
Somente construtores e administradores podem criar, editar e excluir modelos de dispositivo. Qualquer usuário pode
criar dispositivos na página Device Explorer a partir de modelos de dispositivos existentes.
Crie um modelo de dispositivo

1. Navegue para a página Modelos de Dispositivo.
2. Para criar um modelo, comece selecionando + novo.
3. Para começar rapidamente, escolha entre os modelos predefinidos existentes. Caso contrário,
selecione personalizado, insira um nome e clique em criar para criar seu próprio modelo do zero.
4. Ao criar um modelo personalizado, você verá a página de detalhes do dispositivo para o novo
modelo de dispositivo. O IoT Central cria automaticamente um dispositivo simulado quando você cria
um modelo de dispositivo. Um dispositivo simulado permite testar o comportamento do aplicativo
antes de você conectar um dispositivo real.
As seções a seguir descrevem cada uma das guias da página Modelo de Dispositivo.
Medidas
Medidas são os dados que vêm do seu dispositivo. É possível adicionar várias medidas ao modelo de
dispositivo para corresponder aos recursos do dispositivo.
Telemetria são os pontos de dados numéricos que o seu dispositivo coleta ao longo do tempo. Eles são
representados como um fluxo contínuo. Um exemplo é a temperatura.
As medições do evento são dados point-in-time que representam algo significativo no dispositivo. Um
nível de severidade representa a importância de um evento. Um exemplo é um erro no motor do
ventilador.
Medidas de Estado representam o estado do dispositivo ou os respectivos componentes durante um
período de tempo. Por exemplo, um modo de ventilador pode ser definido como tendo Operating e
Stopped como os dois estados possíveis.
As medidas de localização são as coordenadas de longitude e latitude do dispositivo durante um período
de tempo no. Por exemplo, um ventilador pode ser movido de um local para outro.
Criar uma medição de telemetria
Para adicionar uma nova medição de telemetria, selecione + nova medida, escolha telemetria como o tipo
de medida e insira os detalhes no formulário.
NOTE
Os nomes de campo no modelo de dispositivo precisarão corresponder aos nomes de propriedade no código do
dispositivo correspondente para que a medida de telemetria seja exibida no aplicativo quando um dispositivo real
estiver conectado. Faça o mesmo ao definir configurações, propriedades do dispositivo e comandos enquanto você
continua a definir o modelo de dispositivo nas seções a seguir.
Por exemplo, é possível adicionar uma nova medida de telemetria de temperatura:
NOME DE EXIBIÇÃO NOME DO CAMPO UNIDADES MIN MÁX.
Temperatura temp degC 0 100
Depois de selecionar Salvar, a medição Temperatura aparece na lista de medições. Em alguns instantes,
você verá a visualização dos dados de temperatura do dispositivo simulado.
Ao exibir a telemetria, você pode escolher entre as seguintes opções de agregação: média, mínimo, máximo,
soma e contagem. A média é selecionada como a agregação padrão no gráfico.
NOTE
O tipo de dados da medida de telemetria é número de ponto flutuante.
Crie uma medição de evento

Para adicionar uma nova medição de evento, selecione + nova medição e selecione evento como o tipo de
medida. Insira os detalhes no formulário Criar Evento.
Forneça os detalhes Nome para exibição, Nome do campo e Gravidade para o evento. Você pode
escolher entre os três níveis de gravidade disponíveis: Erro, Aviso e Informação.
Por exemplo, você pode adicionar um novo evento Fan Motor Error.
NOME DE EXIBIÇÃO NOME DO CAMPO GRAVIDADE PADRÃO
Erro do motor do ventilador fanmotorerror Erro

Depois de selecionar Gravar, a medição Erro do Motor do Ventilador aparece na lista de medições. Em
alguns instantes, você verá a visualização dos dados de evento do dispositivo simulado.
Para exibir mais detalhes sobre um evento, selecione o ícone de evento no gráfico:
NOTE
O tipo de dados da medida de evento é cadeia de caracteres.
Crie uma medida de estado

Para adicionar uma nova medida de estado, selecione o botão de medida + nova e selecione estado como
o tipo de medida. Insira os detalhes no formulário Criar Estado.
Forneça os detalhes para Nome de exibição, Nome do campo e Valores do estado. Cada valor também
pode ter um nome de exibição que será usado quando o valor aparecer em gráficos e tabelas.
Por exemplo, você pode adicionar um novo estado do Modo de fãs que tenha dois valores possíveis que o
dispositivo pode enviar, Em funcionamento e Parado.
NOME DE NOME DE NOME DE

EXIBIÇÃO NOME DO CAMPO VALOR 1 EXIBIÇÃO VALOR 2 EXIBIÇÃO
Modo ventilação fanmode 1 Operacional 0 Parado

Depois de selecionar Gravar, a medição do estado do Fan Mode aparece na lista de medições. Em alguns
instantes, você verá a visualização dos dados de estado do dispositivo simulado.
Se o dispositivo enviar muitos pontos de dados durante um curto período, a medida de estado será exibida
com um visual diferente. Selecione o gráfico para exibir todos os pontos de dados dentro desse período de
tempo em ordem cronológica. Também é possível reduzir o intervalo de tempo para ver a medida plotada no
gráfico.
NOTE
O tipo de dados da medida de estado é cadeia de caracteres.
Criar uma medição de local

Para adicionar uma nova medida de local, selecione + nova medida, escolha local como o tipo de medida e
insira os detalhes no formulário criar medição .
Por exemplo, você pode adicionar uma nova medida de telemetria de local:
NOME DE EXIBIÇÃO NOME DO CAMPO
Local do ativo assetloc

Depois de selecionar salvar, a medida de localização aparece na lista de medições. Em breve, você verá a
visualização dos dados do local do dispositivo simulado.
Ao exibir o local, você pode escolher entre as seguintes opções: o local mais recente e o histórico de
localização. O histórico de localização só é aplicado no intervalo de tempo selecionado.
O tipo de dados da medida de localização é um objeto que contém a longitude, a latitude e uma altitude
opcional. O trecho a seguir mostra a estrutura JavaScript:
assetloc: {
lon: floating point number,
lat: floating point number,
alt?: floating point number
}
Quando o dispositivo real estiver conectado, o local que você adicionou como uma medida será atualizado
com o valor enviado pelo dispositivo. Depois de configurar sua medição de local, você pode Adicionar um
mapa para visualizar o local no painel do dispositivo.
Configurações
As configurações controlam um dispositivo. Elas permitem que os operadores forneçam entradas ao
dispositivo. É possível adicionar várias configurações ao modelo de dispositivo que aparecem como blocos
na guia Configurações para os operadores usarem. Você pode adicionar vários tipos de configurações:
número, texto, data, alternância e rótulo de seção.
As configurações podem estar em um dos três estados. O dispositivo informa esses estados.
Sincronizado: o dispositivo foi alterado para refletir o valor da configuração.
Pendente: o dispositivo está mudando para o valor de configuração.
Erro: o dispositivo retornou um erro.
Por exemplo, você pode adicionar uma nova configuração de velocidade do ventilador selecionando
configurações e inserindo na nova configuração de número :
NOME DE EXIBIÇÃO NOME DO CAMPO UNIDADES DECIMAIS INICIAL
Velocidade da fanSpeed RPM 2 0

ventoinha
Depois que você selecionar Salvar, a configuração Velocidade do Ventilador será exibida como um bloco.
Um operador pode usar a configuração na página Device Explorer para alterar a velocidade do ventilador
do dispositivo.
propriedades
As propriedades são metadados associados ao dispositivo, como um local do dispositivo fixo e um número
de série. Adicione várias propriedades ao modelo de dispositivo que aparecem como blocos na guia
Propriedades . Uma propriedade tem um tipo como número, texto, data, alternância, Propriedade do
dispositivo, rótulo ou um local fixo. Um operador especifica os valores para propriedades quando eles criam
um dispositivo e podem editar esses valores a qualquer momento. As propriedades de dispositivo são
somente leitura e são enviadas do dispositivo para o aplicativo. Um operador não pode alterar as
propriedades do dispositivo. Quando um dispositivo real se conecta, o bloco de propriedades do dispositivo é
atualizado no aplicativo.
Existem duas categorias de propriedades:
Propriedades de dispositivo que o dispositivo relata ao aplicativo do IoT Central. As propriedades de
dispositivo são valores somente leitura relatados pelo dispositivo e são atualizadas no aplicativo quando
um dispositivo real é conectado.
Propriedades do aplicativo que são armazenadas no aplicativo e que podem ser editadas pelo operador.
As propriedades do aplicativo são armazenadas apenas no aplicativo e nunca são vistas por um
dispositivo.
Por exemplo, adicione a última data de manutenção do dispositivo como uma nova propriedade Data (uma
propriedade do aplicativo) à guia Propriedades:
NOME DE EXIBIÇÃO NOME DO CAMPO VALOR INICIAL
Atendido por último lastServiced 29/01/2019
Depois que você selecionar Salvar, a última data de manutenção do dispositivo será exibida como um bloco.
Depois de criar o bloco, você poderá alterar o valor da propriedade do aplicativo no Device Explorer.
Criar uma propriedade de local
Você pode fornecer um contexto geográfico aos dados de localização no Azure IoT Central e mapear
quaisquer coordenadas de latitude e longitude ou um endereço de rua. O Azure Maps habilita esse recurso
na IoT Central.
Você pode adicionar dois tipos de propriedades de localização:
Localização como uma propriedade do aplicativo, que é armazenada no aplicativo. As propriedades
do aplicativo são armazenadas apenas no aplicativo e nunca são vistas por um dispositivo.
Localização como uma propriedade de dispositivo, relatada pelo dispositivo ao aplicativo. Esse tipo
de propriedade é melhor usado para um local estático.
NOTE
O local como uma propriedade não registra um histórico. Se o histórico for desejado, use uma medida de local.
Adicionar local como uma propriedade do aplicativo

Você pode criar uma propriedade de local como uma propriedade de aplicativo usando o Azure Maps no seu
aplicativo IoT Central. Por exemplo, adicione o endereço de instalação do dispositivo:
1. Navegue para a guia Propriedades.
2. Na biblioteca, selecione Local.
3. Configure Nome de exibição, Nome do campo e (opcionalmente) Valor inicial para o local.
NOME DE EXIBIÇÃO NOME DO CAMPO VALOR INICIAL
Endereço de instalação installAddress Microsoft, 1 Microsoft Way,

Redmond, WA 98052
Há dois formatos com suporte para adicionar um local:

Local como um endereço
Local como coordenadas
4. Clique em Salvar. Um operador pode atualizar o valor de localização no Device Explorer.
Adicionar local como uma propriedade de dispositivo
Você pode criar uma propriedade de localização como uma propriedade de dispositivo que o dispositivo
reporta. Por exemplo, se você quiser rastrear a localização do dispositivo:
1. Navegue para a guia Propriedades.
2. Selecione Propriedade do Dispositivo na biblioteca.
3. Configure o nome de exibição e o nome de campo e selecione Localização como o tipo de dados:
NOME DE EXIBIÇÃO NOME DO CAMPO TIPO DE DADOS
Localização do dispositivo deviceLocation location
NOTE
Os nomes de campo devem corresponder aos nomes de propriedade no código do dispositivo correspondente
Quando o dispositivo real estiver conectado, o local que você adicionou como uma propriedade de
dispositivo será atualizado com o valor enviado pelo dispositivo. Depois de configurar sua propriedade
Location, você pode Adicionar um mapa para visualizar o local no painel do dispositivo.
Comandos
Os comandos são usados para gerenciar remotamente um dispositivo. Eles permitem que os operadores
executem comandos no dispositivo. Você pode adicionar vários comandos ao seu modelo de dispositivo que
aparecem como blocos na guia Comandos para os operadores usarem. Como construtor do dispositivo,
você tem a flexibilidade de definir comandos de acordo com seus requisitos.
Como um comando é diferente de um cenário?
Configuração: uma configuração é uma configuração que você deseja aplicar a um dispositivo. Você
deseja que o dispositivo persista essa configuração até você alterá-la. Por exemplo, você deseja definir
a temperatura do seu freezer e desejar essa configuração mesmo quando o freezer reiniciar.
Comando: Você usa comandos para executar instantaneamente um comando no dispositivo
remotamente a partir do IoT Central. Se um dispositivo não estiver conectado, o comando atingirá o
tempo limite e falhará. Por exemplo, você deseja reiniciar um dispositivo.
Por exemplo, você pode adicionar um novo comando de eco selecionando a guia comandos , selecionando
+ novo comandoe inserindo os detalhes do novo comando:
NOME DE EXIBIÇÃO NOME DO CAMPO TEMPO LIMITE PADRÃO TIPO DE DADOS
Comando echo echo 30 text
Depois que você selecionar Salvar, o comando Eco será exibido como um bloco e estará pronto para ser
usado no Device Explorer quando o dispositivo real for conectado. Os nomes de campo do comando
devem corresponder aos nomes de propriedade no código de dispositivo correspondente para que os
comandos sejam executados com êxito.
Aqui está o link para o código de dispositivo C de exemplo.
Regras
As regras permitem que os operadores monitorem os dispositivos quase em tempo real. As regras invocam
automaticamente ações como o envio de um email quando a regra é acionada. Um tipo de regra está
disponível hoje:
Regra de telemetria, que é acionada quando a telemetria do dispositivo selecionado ultrapassa um
limite especificado. Saiba mais sobre as regras de telemetria.
painel
O painel é onde um operador vai para ver informações sobre um dispositivo. Como um construtor, você
adiciona blocos a esta página para ajudar os operadores a entender como o dispositivo está se comportando.
Você pode adicionar muitos tipos de blocos do painel, como imagem, gráfico de linhas, gráfico de barras, KPI
(indicador chave de desempenho), configurações, propriedades e rótulo.
Por exemplo, adicione um bloco Configurações e Propriedades para mostrar uma seleção dos valores
atuais de configurações e propriedades selecionando a guia Painel e o bloco na Biblioteca:
Agora, quando um operador exibir o painel no Device Explorer, ele poderá ver o bloco.
Adicionar uma medida de local no painel
Se você configurou uma medida de local, poderá visualizar o local com um mapa no painel do seu
dispositivo. Para as medidas de localização, você tem a opção de plotar o histórico de localização.
1. Navegue para a guia Painel.
2. No painel do dispositivo, selecione Mapa da biblioteca.
3. Dê um título ao mapa. O exemplo a seguir tem o título local atual do dispositivo. Em seguida,
escolha a medida local que você configurou anteriormente na guia medidas . No exemplo a seguir, a
medida local do ativo é selecionada:
4. Clique em Salvar. O bloco do mapa agora exibe o local selecionado.
Você pode redimensionar o bloco mapa. Quando um operador exibe o painel no Device Explorer, todos os
blocos de painel que você configurou, incluindo um mapa de local, são visíveis.
Adicionar uma propriedade local no painel
Se você configurou uma propriedade Location, poderá visualizar o local com um mapa no painel do seu
dispositivo.
1. Navegue para a guia Painel.
2. No painel do dispositivo, selecione Mapa da biblioteca.
3. Dê um título ao mapa. O exemplo a seguir tem o título local atual do dispositivo. Em seguida,
escolha a propriedade local que você configurou anteriormente na guia Propriedades . No exemplo a
seguir, a medição do local do dispositivo é selecionada:
4. Clique em Salvar. O bloco do mapa agora exibe o local selecionado.
Você pode redimensionar o bloco mapa. Quando um operador exibe o painel no Device Explorer, todos os
blocos de painel que você configurou, incluindo um mapa de local, são visíveis.
Para saber mais sobre como usar blocos no Azure IoT Central, confira usar blocos do Dashboard.
Próximos passos
Agora que você aprendeu a configurar um modelo de dispositivo no aplicativo Central do IoT do Azure, é
possível:
Criar uma nova versão do modelo de dispositivo
Conectar um dispositivo MXChip IoT DevKit ao seu aplicativo Azure IoT Central
Conectar um aplicativo cliente genérico ao seu aplicativo de IoT Central do Azure (Node. js)
Gerenciar dispositivos no aplicativo Azure IoT
Central
NOTE
Este artigo descreve como, como operador, gerenciar dispositivos no seu Microsoft IoT Central. Como um
operador, você pode:
Use a página dispositivos para exibir, adicionar e excluir dispositivos conectados ao seu aplicativo IOT
central do Azure.
Mantenha um inventário atualizado dos seus dispositivos.
Mantenha os metadados do dispositivo atualizados, alterando os valores armazenados nas propriedades de
dispositivo.
Controle o comportamento dos dispositivos, atualizando uma configuração em um dispositivo específico na
página Configurações.
Exibir dispositivos
Para exibir um dispositivo individual:
1. Escolha dispositivos no painel esquerdo. Aqui você visualiza uma lista dos modelos de dispositivos.
2. Escolha um modelo de dispositivo na lista Modelos.
3. No painel à direita da página dispositivos , você verá uma lista de dispositivos criados a partir desse
modelo de dispositivo. Escolha um dispositivo individual para ver a página de detalhes do dispositivo
para o dispositivo:
Adicionar um dispositivo
Para adicionar um dispositivo ao aplicativo Azure IoT Central:
1. Escolha dispositivos no painel esquerdo.
2. Escolha o modelo de dispositivo, a partir do qual você deseja criar um dispositivo.
3. Escolha + Novo.
4. Escolha Real ou Simulado. Um dispositivo real é para um dispositivo físico que você conecta ao
aplicativo Azure IoT Central. Um dispositivo simulado tem dados de exemplo gerados a você pelo Azure
IoT Central.
Importar dispositivos
Para conectar um grande número de dispositivos ao seu aplicativo, você pode importar em massa os
dispositivos de um arquivo CSV. O arquivo CSV deve ter as seguintes colunas e cabeçalhos:
IOTC_DeviceID – a ID do dispositivo deve estar toda em letras maiúsculas ou toda em letras minúsculas.
IOTC_DeviceName – essa coluna é opcional.
Para dispositivos de registro em massa no aplicativo:
2. No painel esquerdo, escolha o modelo de dispositivo para o qual você deseja criar os dispositivos em
massa.
NOTE
Se você ainda não tiver um modelo de dispositivo, poderá importar dispositivos em Dispositivos não associados
e registrá-los sem um modelo. Depois que dispositivos foram importados, você pode associá-los a um modelo.
3. Selecione Importar.
4. Selecione o arquivo CSV que contém a lista de IDs dos Dispositivos a serem importados.
5. A importação de dispositivo inicia assim que o arquivo é carregado. É possível acompanhar o status de
importação na parte superior da grade do dispositivo.
6. Depois que a importação estiver concluída, uma mensagem de êxito será exibida na grade do dispositivo.
Se a operação de importação do dispositivo falhar, uma mensagem de erro será exibida na grade do dispositivo.
É gerado um arquivo de log captura todos os erros que você pode baixar.
Associando dispositivos a um modelo
Se você registrar dispositivos iniciando a importação em Dispositivos não associados, os dispositivos serão
criados sem associação de modelos de dispositivo. Os dispositivos devem estar associados a um modelo para
explorar os dados e outros detalhes sobre o dispositivo. Siga estas etapas para associar dispositivos a um
modelo:
2. No painel esquerdo, escolha Dispositivos não associados:
3. Selecione os dispositivos que você deseja associar a um modelo:
4. Selecione associar:
5. Escolha o modelo na lista de modelos disponíveis e selecione associar.

6. Os dispositivos selecionados estão associados ao modelo de dispositivo que você escolheu.
NOTE
Depois que um dispositivo tiver sido associado a um modelo, não poderá ser desassociado ou associado a um modelo
diferente.
Exportar dispositivos
Para conectar um dispositivo real à IoT Central, você precisa de sua cadeia de conexão. Você pode exportar
detalhes do dispositivo em massa para obter as informações necessárias para criar cadeias de conexão de
dispositivo. O processo de exportação cria um arquivo CSV com a identidade do dispositivo, o nome do
dispositivo e as chaves para todos os dispositivos selecionados.
Para exportar em massa os dispositivos do seu aplicativo:
2. No painel esquerdo, escolha o modelo de dispositivo para o qual você deseja exportar os dispositivos.
3. Selecione os dispositivos que você deseja exportar e, em seguida, selecione a ação Exportar .
4. O processo de exportação tem início. Você pode acompanhar o status na parte superior da grade.
5. Quando a exportação for concluída, será mostrada uma mensagem com um link para baixar o arquivo
gerado.
6. Selecione a mensagem de êxito para baixar o arquivo em uma pasta local no disco.
7. O arquivo CSV exportado contém as seguintes colunas: ID do dispositivo, nome do dispositivo, chaves de
dispositivo e impressões digitais de certificado X509:
IOTC_DEVICEID
IOTC_DEVICENAME
IOTC_SASKEY_PRIMARY
IOTC_SASKEY_SECONDARY
IOTC_X509THUMBPRINT_PRIMARY
IOTC_X509THUMBPRINT_SECONDARY
Consulte conectividade do dispositivo no Azure IOT central, para obter mais informações sobre cadeias de
conexão e conectar dispositivos reais ao seu aplicativo IOT central.
Excluir um dispositivo
Para excluir um dispositivo real ou simulado do aplicativo Azure IoT Central:
2. Escolha o modelo de dispositivo do dispositivo que você deseja excluir.
3. Marque a caixa próxima ao dispositivo a ser excluído.
4. Clique em Excluir.
Alterar uma configuração de dispositivo

As configurações controlam o comportamento de um dispositivo. Em outras palavras, elas permitem que você
forneça entradas ao dispositivo. É possível exibir e atualizar as configurações do dispositivo na página Detalhes
do Dispositivo.
2. Escolha o modelo de dispositivo do dispositivo cujas configurações você quer alterar.
3. Escolha a guia configurações . Aqui você vê todas as configurações que seu dispositivo tem e seus
valores atuais. Para cada configuração é possível ver se o dispositivo ainda está sendo sincronizado.
4. Modifique as configurações para os valores de que você precisa. É possível modificar várias configurações
de uma só vez e atualizá-las todas ao mesmo tempo.
5. Escolha Atualizar. Os valores são enviados ao dispositivo. Quando o dispositivo confirma a alteração da
configuração, o status da configuração retorna para sincronizado.
Alterar uma propriedade

Propriedades são os metadados do dispositivo associados ao dispositivo, como cidade e número de série. É
possível exibir e atualizar as propriedades na página Detalhes do Dispositivo.
2. Escolha o modelo de dispositivo do dispositivo cujas propriedades você quer alterar.
3. Escolha a guia Propriedades, na qual todas as propriedades são exibidas.
4. Modificar as propriedades do aplicativo para os valores que necessários. É possível modificar várias
propriedades de uma vez e atualizá-las todas ao mesmo tempo. Escolha Atualizar.
NOTE
Não é possível alterar o valor das propriedades do dispositivo. As propriedades do dispositivo são definidas pelo
dispositivo e são somente leitura no aplicativo Azure IoT Central.
Próximas etapas
Agora que você aprendeu como gerenciar dispositivos no aplicativo Azure IoT Central, a próxima etapa sugerida
é apresentada:
Como usar conjuntos de dispositivos
Criar e executar um trabalho em seu aplicativo de
IoT Central do Azure
É possível usar o Microsoft Azure IoT Central para gerenciar seus dispositivos conectados em escala usando
trabalhos. Os trabalhos permitem que você faça atualizações em massa nas propriedades, configurações e
comandos do dispositivo. Este artigo explica como começar a usar trabalhos em seu próprio aplicativo.
NOTE
No momento, não há suporte para trabalhos para dispositivos Azure IoT Edge.
Criar e executar um trabalho

Esta seção mostra como criar e executar um trabalho. Ele mostra como aumentar a velocidade do ventilador para
várias máquinas de vendas refrigeradas.
1. Navegue até o painel Trabalhos no painel de navegação.
2. Selecione + novo para criar um novo trabalho.
3. Insira um nome e uma descrição para identificar o trabalho que você está criando.
4. Selecione o conjunto de dispositivos ao qual você deseja que seu trabalho se aplique. Depois de selecionar
o conjunto de dispositivos, você verá o lado direito popular com os dispositivos no conjunto de
dispositivos. Se você selecionar um conjunto de dispositivos quebrado, nenhum dispositivo será exibido e
você verá uma mensagem informando que seu conjunto de dispositivos está quebrado.
5. Em seguida, escolha o tipo de trabalho a ser definido (uma configuração, propriedade ou comando).
Selecione + ao lado do tipo de trabalho selecionado e adicione suas operações.
6. No lado direito, escolha os dispositivos nos quais você gostaria de executar o trabalho. Ao marcar a caixa
de seleção superior, todos os dispositivos são selecionados em todo o conjunto de dispositivos. Ao marcar
a caixa de seleção ao lado de nome, todos os dispositivos na página atual são selecionados.
7. Depois de selecionar os dispositivos, escolha executar ou salvar. O trabalho agora aparece na página de
trabalhos principais. Nessa exibição, você pode ver seu trabalho em execução no momento e o histórico
de qualquer trabalho executado anteriormente. O trabalho em execução sempre aparece na parte superior
da lista. Seu trabalho salvo pode ser aberto novamente a qualquer momento para continuar editando ou
para ser executado.
NOTE
Você pode exibir o histórico de seus trabalhos executados anteriormente por até 30 dias.
8. Para obter uma visão geral do seu trabalho, selecione o trabalho a ser exibido na lista. Esta visão geral
contém os detalhes do trabalho, dispositivos e valores de status do dispositivo. Nesta visão geral, você
também pode selecionar baixar detalhes do trabalho para baixar um arquivo. csv dos detalhes do seu
trabalho, incluindo os dispositivos e seus valores de status. Essas informações podem ser úteis para a
solução de problemas.
Parar um trabalho em execução

Para interromper um trabalho em execução, selecione-o e escolha parar no painel. O status do trabalho muda
para refletir que o trabalho foi interrompido.
Executar um trabalho interrompido

Para executar um trabalho que está parado no momento, selecione o trabalho parado. Escolha executar no
painel. O status do trabalho muda para refletir que o trabalho agora está em execução novamente.
Copiar um trabalho
Para copiar um trabalho existente que você criou, selecione-o na página principais trabalhos e selecione copiar.
Uma nova cópia da configuração do trabalho é aberta para você editar. Você pode salvar ou executar o novo
trabalho. Se forem feitas alterações no conjunto de dispositivos selecionado, elas serão refletidas nesse trabalho
copiado para você editar.
Exibir o status do trabalho

Depois que um trabalho é criado, a coluna status é atualizada com a mensagem de status mais recente do
trabalho. A tabela a seguir lista os valores de status possíveis:
MENSAGEM DE STATUS SIGNIFICADO DO STATUS
Concluído Este trabalho foi executado em todos os dispositivos.
Com falha Esse trabalho falhou e não foi totalmente executado nos
dispositivos.
Pendente Esse trabalho ainda não começou a ser executado em

dispositivos.
Executando Esse trabalho está sendo executado nos dispositivos.
Parado Este trabalho foi interrompido manualmente por um usuário.
A mensagem de status é seguida por uma visão geral dos dispositivos no trabalho. A tabela a seguir lista os
possíveis valores de status do dispositivo:
Bem-sucedido O número de dispositivos em que o trabalho foi executado

com êxito.
Com falha O número de dispositivos nos quais o trabalho falhou ao ser

executado.
Exibir o status do dispositivo

Para exibir o status do trabalho e de todos os dispositivos afetados, selecione o trabalho. Para baixar um arquivo.
csv que inclui os detalhes do trabalho, incluindo a lista de dispositivos e seus valores de status, selecione baixar
detalhes do trabalho. Ao lado de cada nome de dispositivo, você verá uma das seguintes mensagens de status:
Concluído O trabalho foi executado neste dispositivo.
Com falha A execução do trabalho falhou neste dispositivo. A mensagem

de erro mostra mais informações.
Pendente O trabalho ainda não foi executado neste dispositivo.
NOTE
Se um dispositivo tiver sido excluído, você não poderá selecionar o dispositivo e ele será exibido como excluído com a ID do
dispositivo.
Próximos passos
Agora que você aprendeu como criar trabalhos em seu aplicativo IoT Central do Azure, aqui estão algumas
próximas etapas:
Versão de seu modelo de dispositivo
Usar conjuntos de dispositivos no aplicativo Azure
IoT Central
NOTE
Este artigo descreve como, como operador, usar conjuntos de dispositivos no seu Microsoft IoT Central.
Um conjunto de dispositivos é uma lista de dispositivos agrupados, pois correspondem a alguns critérios
especificados. Os conjuntos de dispositivos ajudam a gerenciar, visualizar e analisar dispositivos em grande
escala, agrupando dispositivos em grupos lógicos menores. Por exemplo, você pode criar um dispositivo
definido para listar todos os dispositivos de ar-condicionado em Seattle para permitir que um técnico encontre
os dispositivos para os quais eles são responsáveis. Este artigo mostra como criar e configurar conjuntos de
dispositivos.
Criar um conjunto de dispositivos

Para criar um conjunto de dispositivos:
1. Escolha conjuntos de dispositivos no painel esquerdo.
2. Selecione + novo.
3. Forneça ao dispositivo um nome que seja exclusivo em todo o aplicativo. Também é possível adicionar
uma descrição. Um conjunto de dispositivos somente pode conter dispositivos de um único modelo de
dispositivo. Escolha o modelo de dispositivo a ser usado para esse conjunto.
4. Crie a consulta para identificar os dispositivos para o conjunto de dispositivos, selecionando uma
propriedade, um operador de comparação e um valor. É possível adicionar várias consultas e dispositivos
que atendam a todos os critérios colocados no conjunto de dispositivos. O conjunto de dispositivos
criado por você é acessível a qualquer pessoa que tenha acesso ao aplicativo, para que qualquer pessoa
possa visualizar, modificar ou excluir o conjunto de dispositivos.
NOTE
O conjunto de dispositivos é uma consulta dinâmica. Cada vez que você visualizar a lista de dispositivos, poderá
haver diferentes dispositivos na lista. A lista depende de quais dispositivos atualmente atendem aos critérios da
consulta.
5. Escolha Salvar.
Configurar o painel para seu conjunto de dispositivos

Após criar o conjunto de dispositivos, você poderá configurar o Painel. O painel é a página inicial onde você
coloca imagens e links. Além disso, é possível adicionar grades que listam os dispositivos no conjunto de
dispositivos.
2. Escolher o conjunto do dispositivo.
3. Selecione a guia Painel .
4. Selecione Editar.
5. Para obter informações sobre como adicionar uma imagem, consulte Preparar e carregar imagens no
aplicativo Azure IoT Central.
6. Adicione um bloco de link:
a. EscolhaLink no painel direito.
b. Forneça um Título ao link.
c. Escolha uma URL a ser aberta quando o link for selecionado.
d. Forneça ao link uma descrição que exiba abaixo do Título.
e. Escolha Salvar.
f. É possível mover e redimensionar o bloco de link no Painel.
7. Adicione uma grade. Uma grade é uma tabela de dispositivos no conjunto de dispositivos com as colunas
escolhidas.
a. Escolha Grade no painel direito.
b. Forneça um Título à grade.
c. Selecione as colunas a serem mostrados, escolhendo Adicionar/remover. No painel que é
exibido, escolha a coluna que você deseja mostrar e escolha a seta direita para selecioná-la.
d. Escolha OK.
e. Escolha Salvar.
f. Arraste e solte a grade para colocá-la no Painel.
NOTE
É possível adicionar várias imagens, links e grades.
g. Selecione Concluído.
Para saber mais sobre como usar blocos no Azure IoT Central, confira usar blocos do Dashboard.
Configurar um mapa de localização em seu painel de conjuntos de dispositivos
Você pode adicionar um mapa para visualizar o local dos dispositivos no seu conjunto de dispositivos.
Para adicionar um mapa ao seu painel de conjuntos de dispositivos, você deve ter configurado uma medida de
local ou uma propriedade local em seu modelo de dispositivo. Para saber mais, confira criar uma medida de
local ou criar uma propriedade de local.
1. No paineldo conjunto de dispositivos, selecione mapa na biblioteca.
2. Adicione um título e escolha a medida ou a propriedade local que você configurou anteriormente.
3. Selecione salvar e o bloco mapa exibe os últimos locais conhecidos dos dispositivos em seu conjunto de
dispositivos.
4. Quando um operador exibe o painel de conjuntos de dispositivos, o operador vê todos os blocos que você
configurou, incluindo o mapa de local.
Você pode redimensionar o bloco mapa no painel. A seleção de um PIN no mapa exibe as informações do
dispositivo, o nome e o local. Selecione o pop-up para ir para a página de propriedades do dispositivo.
Configurar a lista para o conjunto de dispositivos

Após criar o conjunto de dispositivos, será possível configurar uma Lista. A Lista mostra todos os dispositivos
no conjunto de dispositivos em uma tabela com as colunas escolhidas.
2. Escolha a guia Lista.
3. Escolha Opções de Coluna.
4. Escolha as colunas a serem mostradas, selecionando a coluna que você deseja mostrar e escolhendo a
seta direita para selecioná-la.
5. Escolha OK.
Análises
A análise em conjuntos de dispositivos é a mesma guia análise principal no painel esquerdo. É possível saber
mais sobre análise, consultando o artigo sobre como criar análises.
Próximos passos
Agora que você aprendeu como usar conjuntos de dispositivos no aplicativo Azure IoT Central, a próxima etapa
sugerida é apresentada:
Como criar regras de telemetria
Criar uma nova versão do modelo de dispositivo
NOTE
A Microsoft IoT Central permite o rápido desenvolvimento de Aplicativos IoT. É possível iterar rapidamente nos
designs de modelos de dispositivos adicionando, editando ou excluindo medidas, configurações ou propriedades.
Algumas dessas alterações podem ser intrusivas para os dispositivos conectados no momento. O Azure IoT
Central identifica essas alterações importantes e fornece uma maneira de implantar com segurança essas
atualizações nos dispositivos.
Ao criar um modelo de dispositivo, ele conterá um número de versão. Por padrão, o número de versão é 1.0.0. Se
você editar um modelo de dispositivo e essa alteração puder afetar os dispositivos conectados em tempo real, o
Azure IoT Central solicitará a criação de uma nova versão de modelo de dispositivo.
NOTE
Para saber mais sobre como criar um modelo de dispositivo, consulte Configurar um modelo de dispositivo
Alterações que solicitam uma alteração de versão

Em geral, as alterações nas configurações ou nas propriedades do modelo de dispositivo solicitam uma alteração
de versão.
NOTE
As alterações feitas no modelo de dispositivo não solicitam a criação de uma nova versão quando nenhum dispositivo ou no
máximo um dispositivo estiver conectado.
A lista a seguir descreve as ações do usuário que podem exigir uma nova versão:
Propriedades (obrigatório)
Adicionar ou excluir uma propriedade obrigatória
Alterar o nome de campo de uma propriedade, nome de campo usado pelos dispositivos para enviar
mensagens.
Propriedades (opcional)
Excluir uma propriedade opcional
Alterar o nome de campo de uma propriedade, nome de campo usado pelos dispositivos para enviar
mensagens.
Alterar uma propriedade opcional para uma propriedade obrigatória
Configurações
Adicionar ou excluir uma configuração
Alterar o nome de campo de uma configuração, o nome de campo usado pelos dispositivos para enviar
e receber mensagens.
O que acontece na alteração da versão?

O que acontece com as regras e os painéis de dispositivos quando há uma alteração da versão?
As regras na versão anterior do modelo de dispositivo continuam a funcionar inalteradas. As regras não são
migradas automaticamente para a nova versão de modelo de dispositivo. Você pode criar regras na nova versão
do modelo como de costume. Para obter mais informações, consulte o artigo como criar uma regra de telemetria e
configurar notificações no seu aplicativo IOT central do Azure .
Os painéis do dispositivo podem conter vários tipos de blocos. Algumas blocos podem conter configurações e
propriedades. Quando uma propriedade ou configuração usada em um bloco é removida, o bloco é desfeito total
ou parcialmente. Você pode acessar o bloco e corrigir o problema, removendo o bloco ou atualizando o conteúdo
do bloco.
Migrar um dispositivo nas versões de modelos de dispositivos

É possível criar várias versões do modelo de dispositivo. Com o tempo, você terá vários dispositivos conectados
usando esses modelos de dispositivo. Você pode migrar dispositivos de uma versão do modelo de dispositivo para
outra. As etapas a seguir descrevem como migrar um dispositivo:
1. Vá para a página de Device Explorer .
2. Selecione o dispositivo que você precisa migrar para outra versão.
3. Escolha Migrar Dispositivo.
4. Selecione o número de versão para o qual você deseja migrar o dispositivo e escolha Migrar.
Próximas etapas
Agora que você aprendeu a usar as versões de modelos de dispositivo no aplicativo Azure IoT Central, a próxima
etapa sugerida é apresentada:
Como criar regras de telemetria
Criar uma regra de telemetria e configurar
notificações no aplicativo Azure IoT Central
NOTE
É possível usar a Azure IoT Central para monitorar remotamente os dispositivos conectados. As regras do
Azure IoT Central permitem monitorar os dispositivos quase em tempo real e invocar ações automaticamente,
como enviar um email ou disparar o Microsoft Flow. Com apenas alguns cliques, você pode definir a condição
para monitorar os dados do dispositivo e configurar a ação correspondente. Este artigo explica como criar
regras para monitorar a telemetria enviada pelo dispositivo.
Dispositivos podem usar a medição de telemetria para enviar dados numéricos do dispositivo. Uma regra de
telemetria é disparada quando a telemetria do dispositivo selecionado ultrapassa um limite especificado.
Criar uma regra de telemetria

Para criar uma regra de telemetria, o modelo do dispositivo deve ter pelo menos uma medida de telemetria
definida. Este exemplo usa um dispositivo de máquina de vendas conectado que envia telemetria de
temperatura e umidade. A regra monitora a temperatura relatada pelo dispositivo e envia um email quando fica
acima de 70° F.
1. Usando a página modelos de dispositivo , navegue até o modelo de dispositivo para o qual você está
adicionando a regra.
2. Se você ainda não criou regras, a tela a seguir será exibida:
3. Na guia regras , selecione + nova regra para ver os tipos de regras que você pode criar.
4. Selecione telemetria para criar uma regra para monitorar a telemetria do dispositivo.
5. Digite um nome que o ajude a identificar a regra neste modelo de dispositivo.

6. Para habilitar imediatamente a regra para todos os dispositivos criados para este modelo, alterne
habilitar regra para todos os dispositivos deste modelo.
A regra se aplica automaticamente a todos os dispositivos no modelo de dispositivo.
Configurar as condições de regra
A condição define os critérios que são monitorados pela regra.
1. Selecione + ao lado de condições para adicionar uma nova condição.
2. Escolha a telemetria que deseja monitorar na lista suspensa Medida.
3. Em seguida, escolha Agregação, Operador e forneça um valor Limite.
A agregação é opcional. Sem agregação, a regra é disparada para cada ponto de dados de
telemetria que atenda à condição. Por exemplo, se a regra estiver configurada para disparar
quando a temperatura estiver acima de 70° F, a regra será disparada quase instantaneamente
quando o dispositivo relatar a temperatura > 70.
Se uma função como Contagem, Média, Mín, Máx for escolhida, o usuário deverá fornecer uma
Janela de tempo de agregação por meio da qual a condição precisa ser avaliada. Por exemplo,
se você definir o período como "5 minutos" e a regra procurar a temperatura média acima de 70,
a regra será disparada quando a temperatura média estiver acima de 70° F por pelo menos 5
minutos. A frequência de avaliação da regra é igual à Janela de tempo de agregação, o que
significa que, neste exemplo, a regra é avaliada uma vez a cada 5 minutos.
NOTE
Mais de uma medida de telemetria pode ser adicionada em Condição. Quando várias condições são
especificadas, todas as condições devem ser atendidas para que a regra seja disparada. Cada condição é
unida por uma cláusula 'AND' implicitamente. Ao usar a agregação, cada medida deve ser agregada.
Configurar ações
Esta seção mostra como configurar as ações a serem executadas quando a regra é disparada. Ações são
invocadas quando todas as condições especificadas na regra são avaliadas como true.
1. Escolha + próximo a Ações. Aqui, você vê a lista de ações disponíveis.
2. Escolha a ação Email, insira um endereço de email válido no campo Para e forneça uma observação
para aparecer no corpo do email quando a regra for disparada.
NOTE
Os emails serão enviados apenas aos usuários que foram adicionados ao aplicativo e fizeram logon pelo menos
uma vez. Saiba mais sobre o gerenciamento de usuários no Azure IoT Central.
3. Para salvar a regra, escolha Salvar. A regra entra em ação em poucos minutos e começa a monitorar a
telemetria enviada ao aplicativo. Quando a condição especificada na regra é atendida, a regra aciona a
ação de e-mail configurada.
É possível adicionar outras ações à regra, como o Microsoft Flow e webhooks. Você pode adicionar até 5 ações
por regra.
Ação do Microsoft Flow para iniciar um fluxo de trabalho no Microsoft Flow quando uma regra é disparada
Ação do Webhook para notificar outros serviços quando uma regra é disparada
Parametrizar a regra
As regras podem derivar determinados valores de Propriedades do Dispositivo como parâmetros. A
utilização de parâmetros é útil em cenários onde os limites de telemetria variam para diferentes dispositivos. Ao
criar a regra, escolha uma propriedade de dispositivo que especifique o limite, como o limite máximo ideal,
em vez de fornecer um valor absoluto, como 70° F. Quando a regra é executada, ela corresponde à telemetria
do dispositivo com o valor definido na Propriedade do dispositivo.
Usar parâmetros é uma maneira eficiente de reduzir o número de regras a serem gerenciadas por modelo de
dispositivo.
As ações também podem ser configuradas usando a Propriedade de Dispositivo como um parâmetro. Se
um endereço de email for armazenado como uma propriedade, ele poderá ser usado quando você definir o
endereço Para.
Excluir uma regra

Se você não precisar mais de uma regra, exclua-a, abrindo a regra e escolhendo Excluir. Excluir a regra
remove-a do modelo de dispositivo e de todos os dispositivos associados.
Habilitar ou desabilitar uma regra para um modelo de dispositivo

Navegue até o dispositivo e escolha a regra que você deseja habilitar ou desabilitar. Alterne o botão Habilitar
regra para todos os dispositivos deste modelo na regra para habilitar ou desabilitar a regra para todos os
dispositivos associados ao modelo de dispositivo.
Habilitar ou desabilitar uma regra para um dispositivo

regra para este dispositivo para habilitar ou desabilitar a regra para esse dispositivo.
Próximos passos
Agora que você aprendeu como criar regras no aplicativo Azure IoT Central, estas são algumas das próximas
etapas:
Adicionar ação do Microsoft Flow em regras
Adicionar ação de Webhook em regras
Agrupar várias ações para executar a partir de uma ou mais regras
Como gerenciar seus dispositivos
Criar uma regra de Eventos e configurar notificações
no aplicativo Azure IoT Central
Este artigo se aplica a operadores, construtores e administradores.
NOTE
É possível usar o Azure IoT Central para monitorar remotamente os dispositivos conectados. As regras do Azure
IoT Central permitem monitorar os dispositivos quase em tempo real e invocar ações automaticamente, como
enviar um email ou disparar o Microsoft Flow. Com apenas alguns cliques, você pode definir a condição para
monitorar os dados do dispositivo e configurar a ação correspondente. Este artigo explica como criar regras para
monitorar eventos enviados pelo dispositivo.
Dispositivos podem usar a medição de evento para enviar eventos de dispositivo importantes ou informativos.
Uma regra de eventos é disparada quando o evento de dispositivo selecionado é relatado pelo dispositivo.
Criar uma regra de eventos

Para criar uma regra de evento, o modelo do dispositivo deve ter pelo menos um evento de medida definido. Este
exemplo usa um dispositivo de máquina de venda refrigerada que relata um evento de erro do motor da
ventoinha. A regra monitora o evento relatado pelo dispositivo e enviará um email sempre que o evento for
relatado.
1. Usando a página modelos de dispositivo , navegue até o modelo de dispositivo para o qual você está
adicionando a regra.
2. Se você ainda não criou regras, a tela a seguir será exibida:
3. Na guia regras , selecione + nova regra para ver os tipos de regras que você pode criar.
4. Escolha o bloco de eventos para criar uma regra de monitoramento de eventos.
5. Digite um nome que o ajude a identificar a regra neste modelo de dispositivo.

6. Para habilitar imediatamente a regra para todos os dispositivos criados com base neste modelo, alterne
habilitar regra para todos os dispositivos deste modelo.
A regra se aplica automaticamente a todos os dispositivos no modelo de dispositivo.
Configurar as condições de regra
A condição define os critérios que são monitorados pela regra.
1. Escolha + próximo a Condições para adicionar uma nova condição.
2. Escolha o evento que deseja monitorar na lista suspensa Medida. Neste exemplo, foi selecionado o evento
Erro do Motor do Ventilador.
3. Opcionalmente, você também pode definir Contagem como Agregação e fornecer o limite
correspondente.
Sem agregação, a regra dispara para cada ponto de dados de evento que atenda à condição. Por
exemplo, se você configurar a condição da regra para disparar quando ocorrer um evento de erro
do motor do ventilador , a regra será disparada quase imediatamente quando o dispositivo relatar
esse evento.
Se a Contagem for usada como uma função de agregação, você precisará fornecer um Limite e uma
Janela de tempo de agregação por meio dos quais a condição precisa ser avaliada. Nesse caso, a
contagem de eventos é agregada e a regra será disparada somente se a contagem de eventos
agregados corresponder ao limite.
Por exemplo, se você quiser alertar quando há mais de três eventos de dispositivo em cinco minutos,
selecione o evento e defina a função de agregação como "contagem", o operador como "maior que"
e "limite" como 3. Defina "Período de tempo de agregação" como "5 minutos". A regra dispara
quando mais de três eventos são enviados pelo dispositivo em cinco minutos. A frequência de
avaliação da regra é igual à Janela de tempo de agregação, o que significa que, neste exemplo, a
regra é avaliada uma vez a cada cinco minutos.
NOTE
Mais de uma medida de evento pode ser adicionada em Condição. Quando várias condições são
especificadas, todas as condições devem ser atendidas para que a regra seja disparada. Cada condição é
unida por uma cláusula ' AND ' implicitamente. Ao usar a agregação, cada medida deve ser agregada.
Configurar ações
Esta seção mostra como configurar as ações a serem executadas quando a regra é disparada. Ações são invocadas
quando todas as condições especificadas na regra são avaliadas como true.
1. Escolha + próximo a Ações. Aqui, você vê a lista de ações disponíveis.
2. Escolha a ação Email, insira um endereço de email válido no campo Para e forneça uma observação para
aparecer no corpo do email quando a regra for disparada.
NOTE
Os emails serão enviados apenas aos usuários que foram adicionados ao aplicativo e fizeram logon pelo menos uma
vez. Saiba mais sobre o gerenciamento de usuários no Azure IoT Central.
3. Para salvar a regra, escolha Salvar. A regra entra em ação em alguns minutos e começa a monitorar os
eventos enviados ao aplicativo. Quando a condição especificada na regra corresponde, a regra dispara a
ação de email configurada.
É possível adicionar outras ações à regra, como o Microsoft Flow e webhooks. Você pode adicionar até cinco
ações por regra.
Ação do Microsoft Flow para iniciar um fluxo de trabalho no Microsoft Flow quando uma regra é disparada
Ação do Webhook para notificar outros serviços quando uma regra é disparada
Parametrizar a regra
As ações também podem ser configuradas usando a Propriedade de Dispositivo como um parâmetro. Se um
endereço de email for armazenado como uma propriedade de dispositivo, ele poderá ser usado quando você
definir o endereço Para.
Excluir uma regra

Se você não precisar mais de uma regra, exclua-a, abrindo a regra e escolhendo Excluir. Excluir a regra remove-a
do modelo de dispositivo e de todos os dispositivos associados.
Habilitar ou desabilitar uma regra para um modelo de dispositivo

regra para todos os dispositivos deste modelo para habilitar ou desabilitar a regra para todos os dispositivos
associados ao modelo de dispositivo.
Habilitar ou desabilitar uma regra para um dispositivo
regra para este dispositivo para habilitar ou desabilitar a regra para esse dispositivo.
Próximos passos
Agora que você aprendeu como criar regras no aplicativo Azure IoT Central, estas são algumas das próximas
etapas:
Adicionar ação do Microsoft Flow em regras
Adicionar ação de Webhook em regras
Agrupar várias ações para executar a partir de uma ou mais regras
Como gerenciar seus dispositivos
Como usar análise para analisar os dados do
dispositivo

A Central de IoT do Azure fornece recursos avançados de análise para compreender grandes quantidades de
dados de seus dispositivos. Para começar, visite análise no painel esquerdo.
Consultando seus dados

Você precisará escolher um conjunto de dispositivos, adicionar um filtro (opcional) e selecionar um período
de tempo para começar. Depois de terminar, selecione Mostrar resultados para começar a visualizar seus dados.
Conjuntos de dispositivos: um conjunto de dispositivo é um grupo de dispositivos definido pelo usuário.
Por exemplo, todos os refrigeradores em Oakland ou todas as turbinas eólicas rev 2.0.
Filtros: opcionalmente, você pode adicionar filtros à pesquisa para apurar ainda mais os dados. Você pode
adicionar até 10 filtros por vez. Por exemplo, em todos os refrigeradores em Oakland, encontre aqueles que
apresentaram temperatura acima de 60 graus.
Período de tempo: por padrão, recuperaremos dados dos últimos 10 minutos. Você pode alterar esse
valor para um dos intervalos de tempo predefinidos ou selecionar um período de tempo personalizado.
Visualizando seus dados

Depois de consultar seus dados, você poderá começar a visualizá-los. Você pode mostrar/ocultar medidas, alterar
a maneira como os dados são agregados e dividir os dados ainda mais pelas diferentes propriedades do
dispositivo.
Dividir por: dividir os dados pelas propriedades do dispositivo permite que você faça uma busca mais
detalhada nos dados. Por exemplo, você pode dividir os resultados por ID ou local do dispositivo.
Medições: você pode optar por mostrar/ocultar até 10 itens de telemetria diferentes que estão sendo
relatados por seus dispositivos por vez. As medidas são itens como temperatura e umidade.
Agregação: por padrão, podemos agregar dados pela média, mas você pode alterar a agregação de dados
para outra coisa para atender às suas necessidades.
Interagindo com seus dados

Você tem várias maneiras de alterar os resultados da consulta para atender às suas necessidades de visualização.
Você pode alternar entre uma exibição de gráfico e uma exibição de grade, ampliar e reduzir, atualizar o conjunto
de dados e alterar o modo como as linhas são mostradas.
Mostrar grade: Os resultados estão disponíveis em um formato de tabela, permitindo que você exiba o
valor específico para cada ponto de dados. Essa exibição também atende aos padrões de acessibilidade.
Mostrar gráfico: Os resultados são exibidos em um formato de linha para ajudá-lo a identificar tendências
e anomalias ascendentes ou descendentes.
O zoom permite que você se baseie em seus dados. Se você encontrar um período de tempo em que gostaria de
se concentrar no conjunto de resultados, use o cursor para capturar a área que deseja ampliar e use os controles
disponíveis para executar uma das seguintes ações:
Ampliar: Depois de selecionar um período de tempo, o zoom é habilitado e permite que você amplie seus
dados.
Reduzir: esse controle permite que você reduza um nível em relação ao último zoom. Por exemplo, se você
ampliar seus dados três vezes, reduzir o levará de volta uma etapa por vez.
Redefinir zoom: depois de experimentar vários níveis de zoom, você pode usar o controle de redefinição
de zoom para retornar ao conjunto de resultados original.
Você pode alterar o estilo da linha para atender às suas necessidades. Você tem quatro opções:
Linha: Uma linha simples entre cada um dos pontos de dados.
Smooth: Uma linha curva entre cada ponto.
Etapa: A linha entre cada ponto no gráfico é uma etapa.
Dispersão: Todos os pontos são plotados no gráfico sem linhas que os conectam.
Por fim, você pode organizar seus dados no eixo Y escolhendo um dos três modos:
Empilhado: um gráfico para cada medida é empilhado e cada um dos gráficos tem seu próprio eixo Y. Os
gráficos empilhados são úteis quando você tem várias medidas selecionadas e deseja ter uma exibição
distinta dessas medidas.
Não empilhado: um gráfico para cada medida é plotado em relação a um eixo Y, mas os valores para o
eixo Y são alterados com base na medida realçada. Gráficos não empilhados são úteis quando você deseja
sobrepor várias medidas e deseja ver padrões nessas medidas para o mesmo intervalo de tempo.
Eixo Y compartilhado: todos os gráficos compartilham o mesmo eixo Y e os valores do eixo não são
alterados. Os gráficos compartilhados do eixo Y são úteis quando você deseja examinar uma única medida
ao fatiar os dados com a opção dividir por.
Próximas etapas
Agora que você aprendeu a criar análises personalizadas para o aplicativo Azure IoT Central, a próxima etapa
sugerida é apresentada:
Preparar e conectar um aplicativo Node.js
Agrupar várias ações para executar a partir de uma
ou mais regras
Este artigo se aplica a construtores e administradores.
NOTE
No Azure IoT Central, você cria regras para executar ações quando uma condição é atendida. As regras são
baseadas em eventos ou telemetria do dispositivo. Por exemplo, você pode notificar um operador quando a
temperatura em um dispositivo exceder um limite. Este artigo descreve como usar Azure monitor grupos de ação
para anexar várias ações a uma regra de IOT central. Você pode anexar um grupo de ações a várias regras. Um
grupo de ações é uma coleção de preferências de notificação definidas pelo proprietário de uma assinatura do
Azure.
Pré-requisitos
Um aplicativo com pagamento conforme o uso
Uma conta do Azure e uma assinatura para criar e gerenciar Azure Monitor grupos de ação
Criar grupos de ação

Você pode criar e gerenciar grupos de ações no portal do Azure ou com um modelo de Azure Resource Manager.
Um grupo de ações pode:
Envie notificações como um email, um SMS ou faça uma chamada de voz.
Execute uma ação como chamar um webhook.
A captura de tela a seguir mostra um grupo de ações que envia email e notificações de SMS e chama um
webhook:
Para usar um grupo de ações em uma regra de IoT Central, o grupo de ações deve estar na mesma assinatura do
Azure que o aplicativo IoT Central.
Usar um grupo de ação

Para usar um grupo de ações em seu aplicativo IoT Central, primeiro crie uma telemetria ou regra de evento. Ao
adicionar uma ação à regra, selecione Azure monitor grupos de ação:
Escolha um grupo de ação da sua assinatura do Azure:

Clique em Salvar. O grupo de ações agora aparece na lista de ações a serem executadas quando a regra é
disparada:
A tabela a seguir resume as informações enviadas para os tipos de ação com suporte:
TIPO DE AÇÃO FORMATO DA SAÍDA
Email Modelo de email de IoT Central padrão
SMS Alerta do Azure IoT Central: $ {applicationName}-"$

{ruleName}" disparado em "$ {DeviceName}" em $
{triggerDate} $ {triggertime}
Voz Alerta central do Azure I. O. T: regra "$ {ruleName}" disparada

no dispositivo "$ {DeviceName}" em $ {triggerDate} $
{triggertime}, no aplicativo $ {applicationName}
webhook {"SchemaId": "AzureIoTCentralRuleWebhook", "data": {carga

regular do webhook}}
O texto a seguir é um exemplo de mensagem de SMS de um grupo de ação:

iotcentral: Azure IoT Central alert: Sample Contoso 22xu4spxjve - "Low pressure alert" triggered on
"Refrigerator 2" at March 20, 2019 10:12 UTC
O JSON a seguir mostra um exemplo de carga de ação de webhook:
{
"schemaId":"AzureIoTCentralRuleWebhook",
"data":{
"id":"97ae27c4-17c5-4e13-9248-65c7a2c57a1b",
"timestamp":"2019-03-20T10:53:17.059Z",
"rule":{
"id":"031b660e-528d-47bb-b33d-f1158d7e31bf",
"name":"Low pressure alert",
"enabled":true,
"deviceTemplate":{
"id":"c318d580-39fc-4aca-b995-843719821049",
"version":"1.0.0"
}
},
"device":{
"id":"2383d8ba-c98c-403a-b4d5-8963859643bb",
"name":"Refrigerator 2",
"simulated":true,
"deviceId":"2383d8ba-c98c-403a-b4d5-8963859643bb",
"deviceTemplate":{
"id":"c318d580-39fc-4aca-b995-843719821049",
"version":"1.0.0"
},
"measurements":{
"telemetry":{
"pressure":343.269190673549
}
}
},
"application":{
"id":"8e70742b-0d5c-4a1d-84f1-4dfd42e61c7b",
"name":"Sample Contoso",
"subdomain":"sample-contoso"
}
}
}
Próximos passos
Agora que você aprendeu a usar grupos de ação com regras, a próxima etapa sugerida é aprender a gerenciar
seus dispositivos.
Criar ações de webhook em regras no Microsoft
Azure IoT Central
NOTE
Webhooks permitem que você conecte o aplicativo IoT Central a outros aplicativos e serviços de monitoramento
remoto e notificações. Webhooks notificam automaticamente os outros aplicativos e serviços conectados sempre
que uma regra é acionada no aplicativo IoT Central. Seu aplicativo IoT Central envia uma solicitação POST para o
ponto de extremidade HTTP do outro aplicativo sempre que uma regra é disparada. A carga contém detalhes do
dispositivo e detalhes do gatilho da regra.
Configurar o webhook
Neste exemplo, você se conecta ao RequestBin para ser notificado quando as regras forem acionadas usando
WebHooks.
1. Abra RequestBin.
2. Crie um novo RequestBin e copie a URL do Compartimento.
3. Crie uma regra de telemetria ou uma regra de evento. Salve a regra e adicione uma nova ação.
4. Escolha a ação do webhook, forneça um nome de exibição e cole a URL do Compartimento como URL de
Retorno de Chamada.
5. Salve a regra.
Agora, quando a regra for disparada, você verá que uma nova solicitação aparecerá em RequestBin.
Carga útil
Quando uma regra é acionada, uma solicitação HTTP POST é feita para a URL de retorno de chamada que
contém uma carga json com as medidas, dispositivo, regra e detalhes do aplicativo. Para uma regra de telemetria,
o conteúdo é semelhante ao seguinte:
{
"id": "ID",
"timestamp": "date-time",
"device" : {
"id":"ID",
"name": "Refrigerator1",
"simulated" : true,
"deviceId": "deviceID",
"deviceTemplate":{
"id": "ID",
"version":"1.0.0"
},
"properties":{
"device":{
"firmwareversion":"1.0"
},
"cloud":{
"location":"One Microsoft Way"
}
},
"measurements":{
"telemetry":{
"temperature":20,
"pressure":10
}
}
},
"rule": {
"id": "ID",
"name": "High temperature alert",
"enabled": true,
"deviceTemplate": {
"id":"GUID",
"version":"1.0.0"
}
},
"application": {
"id": "ID",
"name": "Contoso app",
"subdomain":"contoso-app"
}
}
Limitações conhecidas
Atualmente não há nenhuma maneira programática de assinar/cancelar a assinatura desses webhooks por meio
de uma API.
Se você tiver algumas ideias para melhorar esse recurso, poste suas sugestões em nosso fórum Uservoice.
Próximos passos
Agora que você aprendeu como configurar e usar WebHooks, a próxima etapa sugerida é explorar a criação de
fluxos de trabalho em Microsoft Flow.
Criar fluxos de trabalho com o conector da IoT
Central no Microsoft Flow
Este tópico se aplica a construtores e administradores.
NOTE
Use o Microsoft Flow para automatizar fluxos de trabalho entre os vários aplicativos e serviços dos quais os
usuários empresariais dependem. Usando o conector de IoT Central no Microsoft Flow, você pode disparar
fluxos de trabalho quando uma regra é acionada na IoT Central. Em um fluxo de trabalho disparado por IoT
Central ou qualquer outro aplicativo, você pode usar as ações no conector de IoT Central para:
Criar um dispositivo
Obter informações do dispositivo
Atualizar as propriedades e configurações de um dispositivo
Executar um comando em um dispositivo
Excluir um dispositivo
Confira estes modelos do Microsoft Flow que conectam a IoT Central a outros serviços, tais como notificações
móveis e o Microsoft Teams.
pré-requisitos
Uma conta pessoal ou corporativa ou de estudante da Microsoft para usar Microsoft Flow (saiba mais sobre
planos de Microsoft Flow )
Uma conta corporativa ou de estudante para usar o conector de IoT Central do Azure
Disparar um fluxo de trabalho

Esta seção mostra como disparar uma notificação móvel no aplicativo móvel do Flow quando uma regra é
disparada no IoT Central. Você pode criar todo o fluxo de trabalho em seu aplicativo IoT Central usando o
designer de Microsoft Flow incorporado.
1. Comece criando uma regra na IoT Central. Depois de salvar as condições de regra, selecione a ação
Microsoft Flow como uma nova ação. Uma janela de diálogo será aberta para que você configure seu
fluxo de trabalho. A conta de usuário IoT Central à qual você está conectado será usada para entrar no
Microsoft Flow.
2. Você verá uma lista de fluxos de trabalho aos quais você tem acesso e está anexado a esta regra de IoT
Central. Clique em explorar modelos ou em novo > criar a partir do modelo e você pode escolher
entre qualquer um dos modelos disponíveis.
3. Você será solicitado a entrar nos conectores no modelo escolhido.
NOTE
Para usar o conector de IoT Central do Azure, você deve entrar usando uma conta de Azure Active Directory
(conta corporativa ou de estudante). Uma conta pessoal, como abc@outlook.com ou abc@live.com, não é
suportada pelo conector de IoT Central do Azure.
Depois de entrar nos conectores, você será levado ao designer para criar seu fluxo de trabalho. O fluxo de
trabalho tem um gatilho da IoT Central que contém seu aplicativo e a regra já preenchidos.
4. Você pode personalizar o fluxo de trabalho Personalizando as informações passadas para a ação e
adicionando novas ações. Neste exemplo, a ação é notificações-envie-me uma notificação móvel.
Você pode incluir conteúdo dinâmico da regra da IoT Central, passando informações importantes como o
nome do dispositivo e o carimbo de data/hora para a notificação.
NOTE
Selecione a janela Ver mais texto no conteúdo dinâmico para obter valores de medição e propriedade que
dispararam a regra.
5. Quando terminar de editar sua ação, selecione salvar. Você será direcionado à página de visão geral do
fluxo de trabalho. Aqui você pode ver o histórico de execução e compartilhá-lo com outros colegas.
NOTE
Se desejar que outros usuários em seu aplicativo de Central da IoT editem essa regra, você precisará compartilhá-la
com eles no Microsoft Flow. Adicione as contas do Microsoft Flow deles como proprietários em seu fluxo de
trabalho.
6. Se voltar para seu aplicativo IoT Central, você verá que essa regra tem uma ação Microsoft Flow na área
ações.
Você também pode criar fluxos de trabalho usando o conector de IoT Central diretamente do Microsoft Flow.
Em seguida, você pode escolher a qual aplicativo IoT Central se conectar.
Criar um dispositivo em um fluxo de trabalho

Esta seção mostra como criar um novo dispositivo na IoT Central por meio de um botão em um dispositivo
móvel usando o aplicativo móvel Microsoft Flow. Você pode usar essa ação no Flow para integrar sistemas ERP,
tais como o Dynamics, com a IoT Central, criando um novo dispositivo quando um dispositivo é adicionado em
outro lugar.
1. Comece criando um fluxo de trabalho em branco no Microsoft Flow.
2. Pesquise por botão do Flow para dispositivos móveis como um gatilho.
3. Nesse gatilho, adicione uma entrada de texto chamada Nome do dispositivo. Altere o texto da
descrição, substituindo-o por Insira o nome do dispositivo do seu novo dispositivo.
4. Adicione uma nova ação. Pesquise pela ação Azure IoT Central – Criar um dispositivo.
5. Escolha seu aplicativo e escolha um modelo de dispositivo do qual criar um dispositivo nas listas
suspensas. Você verá a ação se expandir para mostrar todas as propriedades e configurações do
dispositivo.
6. Selecione o campo Nome do Dispositivo. No painel de conteúdo dinâmico, escolha Nome do
Dispositivo. Esse valor é passado da entrada que o usuário insere por meio do aplicativo móvel e é o
nome do novo dispositivo no IoT Central. Neste exemplo, o único campo obrigatório é o nome do
dispositivo, indicado por um asterisco vermelho. Outro modelo de dispositivo pode ter vários campos
obrigatórios que precisam ser preenchidos para criar um novo dispositivo.
7. (Opcional) Preencha outros campos conforme considerar adequado para criar novos dispositivos.
8. Por fim, salve o fluxo de trabalho.
9. Experimente o fluxo de trabalho no aplicativo móvel do Microsoft Flow. Navegue até a guia botões no
aplicativo. Você deve ver o Botão -> Criar um novo fluxo de trabalho do dispositivo. Insira o nome do
novo dispositivo e assista enquanto ele aparece na IoT Central!
Atualizar um dispositivo em um fluxo de trabalho
Esta seção mostra como atualizar as configurações e propriedades de um dispositivo na IoT Central apenas
pressionando um botão em um dispositivo móvel usando o aplicativo móvel Microsoft Flow.
1. Comece criando um fluxo de trabalho em branco no Microsoft Flow.
2. Pesquise por botão do Flow para dispositivos móveis como um gatilho.
3. Nesse gatilho, adicione uma entrada como uma entrada de texto Local que corresponda a uma
configuração ou a propriedade que você deseja alterar. Altere o texto de descrição.
4. Adicione uma nova ação. Pesquise pela ação Azure IoT Central – Atualizar um dispositivo.
5. Selecione o aplicativo na lista suspensa. Agora, você precisará da ID do dispositivo existente que deseja
atualizar.
NOTE
Você deve usar a ID encontrada na URL na página de detalhes do dispositivo do dispositivo que você deseja
atualizar. A ID do dispositivo encontrada na lista de dispositivos do Gerenciador de dispositivos não é a correta a
ser usada no Microsoft Flow.
6. Você pode atualizar o nome do dispositivo. Para atualizar qualquer uma das configurações e
propriedades do dispositivo, você precisa selecionar o modelo de dispositivo do dispositivo que você
deseja atualizar na lista suspensa Modelo de Dispositivo. O bloco de ação se expande para mostrar
todas as propriedades e configurações que você pode atualizar.
7. Selecione cada uma das propriedades e configurações que você deseja atualizar. No painel de conteúdo
dinâmico, escolha a entrada correspondente do gatilho. Neste exemplo, o valor Localização é propagado
para baixo para atualizar a propriedade Localização do dispositivo.
8. Por fim, salve o fluxo de trabalho.
9. Experimente o fluxo de trabalho no aplicativo móvel do Microsoft Flow. Navegue até a guia botões no
aplicativo. Você deverá ver o Botão -> Atualizar um fluxo de trabalho do dispositivo. Insira as entradas e
veja o dispositivo ser atualizado na IoT Central!
Obter informações do dispositivo em um fluxo de trabalho

Você pode obter informações de dispositivo por sua ID usando a IOT central do Azure-obter uma ação de
dispositivo.
NOTE
Você deve usar a ID encontrada na URL na página de detalhes do dispositivo do dispositivo que você deseja atualizar. A
ID do dispositivo encontrada na lista de dispositivos do Gerenciador de dispositivos não é a correta a ser usada no
Microsoft Flow.
Você pode obter informações como nome do dispositivo, nome do modelo de dispositivo, valores de
propriedade e valores de configurações para passar para ações posteriores no fluxo de trabalho. Veja um
exemplo de fluxo de trabalho que passa o valor da propriedade Customer Name de um dispositivo para o
Microsoft Teams.
Executar um comando em um dispositivo em um fluxo de trabalho

Você pode executar um comando em um dispositivo especificado por sua ID usando o IOT central do Azure-
executar uma ação de comando.
NOTE
Microsoft Flow.
Você pode escolher o comando a ser executado e passar os parâmetros do comando por meio desta ação. Veja
um exemplo de fluxo de trabalho que executa um comando de reinicialização de dispositivo de um botão no
aplicativo Microsoft Flow móvel.
Excluir um dispositivo em um fluxo de trabalho
Você pode excluir um dispositivo por sua ID usando a ação IOT central do Azure-excluir um dispositivo .
NOTE
Microsoft Flow.
Aqui está um fluxo de trabalho de exemplo que exclui um dispositivo apenas pressionando um botão no
aplicativo móvel Microsoft Flow.
Solucionando problemas
Se você está tendo problemas ao criar uma conexão para o conector do Azure IoT Central, aqui estão algumas
dicas para ajudá-lo.
1. Contas pessoais da Microsoft (assim como os domínios @hotmail.com, @live.com, @outlook.com) não
são compatíveis no momento. Você deve usar uma conta corporativa ou de estudante do Azure Active
Directory (AD ).
2. Para usar o conector da IoT Central no Microsoft Flow, você precisa ter entrado no aplicativo da IoT
Central pelo menos uma vez. Caso contrário, o aplicativo não aparecerá nas listas suspensas de
aplicativos.
3. Se você estiver recebendo um erro ao usar uma conta do Azure AD, tente abrir o Windows PowerShell e
execute o commandlets a seguir como administrador.
Install-Module AzureAD
Connect-AzureAD
New-AzureADServicePrincipal -AppId 9edfcdd9-0bc5-4bd4-b287-c3afc716aac7 -DisplayName "Azure IoT
Central"
Próximas etapas
Agora que você aprendeu a usar Microsoft Flow para criar fluxos de trabalho, a próxima etapa sugerida é
gerenciar dispositivos.
Criar fluxos de trabalho com o conector do IoT
Central em Aplicativos Lógicos do Azure

Use Aplicativos Lógicos do Azure para criar fluxos de trabalho automatizados e escalonáveis que integram
aplicativos e dados nos serviços de nuvem e sistemas locais. O recurso Aplicativos Lógicos do Azure tem muitos
conectores em muitos serviços do Azure, serviços da Microsoft e outros produtos de SaaS (Software como
Serviço). Usando o conector de IoT Central em Aplicativos Lógicos do Azure, você pode disparar fluxos de trabalho
quando uma regra é acionada na IoT Central. Você também pode usar as ações no conector do IoT Central para
criar um dispositivo, atualizar as propriedades e as configurações de um dispositivo ou excluir um dispositivo.
Você pode usar o conector do IoT Central no Microsoft Flow. Tanto Aplicativos Lógicos do Azure quanto o
Microsoft Flow são serviços de integração primeiro do designer, mas têm públicos-alvo um pouco diferentes. O
Flow permite que qualquer trabalho possa criar os fluxos de trabalho de negócios de que precisa. O recurso
Aplicativos Lógicos capacita os Profissionais de TI a criar as integrações de que eles precisam para conectar dados.
Compare Flow e Aplicativos Lógicos aqui. Saiba mais sobre como criar fluxos de trabalho com o conector do IoT
Central no Microsoft Flow aqui.
Pré-requisitos
Uma conta e uma assinatura do Azure para criar e gerenciar Aplicativos Lógicos
Disparar um fluxo de trabalho quando uma regra é acionada

Esta seção mostra como postar uma mensagem no Microsoft Teams quando uma regra é disparada. Você pode
configurar seu fluxo de trabalho para usar outros conectores para realizar ações como enviar um evento para seu
hub de eventos, criar um novo item de trabalho do Azure DevOps ou inserir uma nova linha no SQL server.
1. Comece criando uma regra na IoT Central. Depois de salvar as condições de regra, selecione o bloco
aplicativos lógicos do Azure como uma nova ação. Selecione criar em portal do Azure. Você será
levado para a portal do Azure para criar um novo aplicativo lógico. Talvez você precise entrar em sua conta
do Azure.
2. Insira as informações necessárias para criar um novo aplicativo lógico. Você pode escolher uma assinatura
do Azure na qual provisionar seu novo aplicativo lógico. Não precisa ser a mesma assinatura em que seu
aplicativo IoT Central foi criado. Clique em Criar.
3. Depois que o aplicativo lógico tiver sido criado com êxito, você será automaticamente navegado para o
designer de aplicativos lógicos. Selecione Aplicativo lógico em branco.
4. No designer, pesquise "iot central" e escolha o gatilho Quando uma regra for disparada. Entrar no
conector com a conta usada para entrar no aplicativo IoT Central.
5. Depois de entrar com êxito, você deverá ver campos. Selecione Aplicativo e Regra nas listas suspensas.
6. Adicione uma nova ação. Pesquise equipes de postar mensagem e escolha Postar uma mensagem do
conector do Microsoft Teams. Entre no conector com a conta usada no Microsoft Teams.
7. Na ação, escolha a Equipe e o Canal. Preencha o campo Mensagem com o que você deseja que cada
mensagem diga. Você pode incluir conteúdo dinâmico da regra da IoT Central, passando informações
importantes como o nome do dispositivo e o carimbo de data/hora para a notificação.
NOTE
Selecione a janela Ver mais texto no conteúdo dinâmico para obter valores de medição e propriedade que
dispararam a regra.
8. Quando terminar de editar sua ação, selecione salvar.
9. Se você voltar ao seu aplicativo da IoT Central, verá que essa regra tem uma ação de Aplicativos Lógicos do
Azure na área Ações.
Você sempre pode começar a criar um fluxo de trabalho usando o conector do IoT Central em Aplicativos Lógicos
no Portal do Azure. Você pode escolher a qual IoT Central aplicativo e a qual regra se conectar e ainda funciona da
mesma maneira. Não é necessário iniciar da página de regras do IoT Central a cada vez.
Criar, atualizar e excluir um dispositivo em um fluxo de trabalho

Quando você estiver criando um fluxo de trabalho em seu aplicativo lógico, poderá adicionar uma ação usando o
conector do IoT Central. As ações disponíveis são criar um dispositivo, atualizar um dispositivoe excluir um
dispositivo.
NOTE
Para Atualize um dispositivo e Excluir um dispositivo, você precisará de uma ID de dispositivo existente que deseje
atualizar ou excluir. É possível obter a ID do dispositivo da IoT Central na URL do Device Explorer
Próximos passos
Agora que você aprendeu a usar Microsoft Flow para criar fluxos de trabalho, a próxima etapa sugerida é gerenciar
dispositivos.
Disparar o Azure Functions usando webhooks no
Azure IoT Central
NOTE
Use o Azure Functions para executar código sem servidor na saída de webhook das regras do IoT Central. Você
não precisa provisionar uma VM ou publicar um aplicativo Web para usar Azure Functions, mas, em vez disso,
você pode executar esse código sem servidor. Use o Azure Functions para transformar o conteúdo do webhook
antes de enviá-lo ao seu destino final, como um banco de dados SQL ou grade de eventos.
Pré-requisitos
Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Como conectar o Azure Functions

1. Crie um novo aplicativo de funções no portal do Azure.
2. Expanda seu aplicativo de funções e selecione o botão + ao lado de funções. Se essa função for a primeira
em seu aplicativo de funções, selecione no portal como ambiente de desenvolvimento e selecione
continuar.
3. Escolha modelo de webhook + API e selecione criar. Este tópico usa o Azure function baseado no .NET.
4. Em sua nova função, selecione </> obter URL de função, em seguida, copie e salve o valor. Use esse valor
para configurar o webhook.
5. Na IoT Central, navegue para a regra que você deseja se conectar ao seu aplicativo de funções.
6. Adicionar uma ação de webhook. Insira um Nome de exibição e cole a URL de função que você copiou
anteriormente na URL de retorno de chamada.
7. Salve a regra. Agora, quando a regra é disparada, o webhook invoca o aplicativo de funções para ser
executado. Em seu aplicativo de funções, você pode selecionar Monitor para ver o histórico de invocação da
função. Você pode usar o App Insights ou o modo de exibição clássico para examinar o histórico.
Para obter mais informações, visite o artigo do Azure Functions sobre criar uma função disparada pelo webhook
genérico.
Próximos passos
Agora que você aprendeu a configurar e usar webhooks, a próxima etapa sugerida é explorar Compilar fluxos de
trabalho no Microsoft Flow.
Exportar dados no Azure IoT Central
NOTE
Este tópico aplica -se aos administradores.

Este artigo descreve como usar o recurso de exportação de dados contínuos no Azure IoT Central para exportar
seus dados para seus próprios hubs de eventos do Azuree instâncias do barramento de serviço do Azure .
Exporte medidas, dispositivos e modelos de dispositivo para seu próprio destino para obter insights e análises
de caminhos frequentes. Isso inclui disparar regras personalizadas no Azure Stream Analytics, disparar fluxos de
trabalho personalizados nos Aplicativos Lógicos do Azure ou transformar os dados e passá-los pelo Azure
Functions.
NOTE
Mais uma vez, ao ativar a exportação contínua de dados, você obtém apenas os dados desse momento em diante.
Atualmente, não é possível recuperar dados por um tempo quando a exportação contínua de dados for desativada. Para
reter dados mais históricos, ative a exportação contínua de dados no início.
Pré-requisitos
Você precisa ser um administrador do aplicativo IoT Central
Configurar o destino de exportação

Se você não tiver um hub de eventos/barramento de serviço existente para exportar para o, siga estas etapas para
criar um:
Criar um namespace dos Hubs de Eventos
1. Crie um namespace dos Hubs de Eventos no portal do Azure. Saiba mais na documentação dos Hubs de
Eventos do Azure.
2. Escolha uma assinatura.
NOTE
Agora você pode exportar dados para outras assinaturas que não são a mesma usada para o aplicativo IoT Central
pago conforme o uso. Você se conectará usando uma cadeia de conexão, nesse caso.
3. Crie um hub de eventos em seu namespace dos Hubs de Eventos. Acesse o namespace e selecione + Hub
de Eventos na parte superior para criar uma instância de hub de eventos.
Criar um namespace do Barramento de Serviço
1. Crie um namespace do Barramento de Serviço no portal do Azure. Saiba mais na documentação do
Barramento de Serviço do Azure.
2. Escolha uma assinatura.
NOTE
Agora você pode exportar dados para outras assinaturas que não são a mesma usada para o aplicativo IoT Central
pago conforme o uso. Você se conectará usando uma cadeia de conexão, nesse caso.
3. Acesse o namespace do Barramento de Serviço e selecione + Fila ou + Tópico na parte superior para criar
uma fila ou um tópico para o qual exportar.
Configuração da exportação contínua de dados

Agora que você tem um destino de barramento de serviço/hubs de eventos para exportar dados para o, siga estas
etapas para configurar a exportação de dados contínuas.
1. Entre no aplicativo IoT Central.
2. No painel esquerdo, selecione exportação de dados contínuas.
NOTE
Se você não vir a exportação de dados contínua no painel esquerdo, você não é um administrador em seu aplicativo.
Contate o administrador para configurar a exportação de dados.
3. Selecione o botão + novo no canto superior direito. Escolha um dos hubs de eventos do Azure ou o
barramento de serviço do Azure como o destino de sua exportação.
NOTE
O número máximo de exportações por aplicativo é cinco.
4. Na caixa de listagem suspensa, selecione o namespace do seu namespace de hubs de
eventos/barramento de serviço. Você também pode escolher a última opção da lista, Inserir uma
cadeia de conexão.
NOTE
Você verá apenas as Contas de Armazenamento/os namespace dos Hubs de Eventos/namespaces do Barramento de
Serviço na mesma assinatura do aplicativo IoT Central. Caso deseje exportar para um destino fora dessa
assinatura, escolha Inserir uma cadeia de conexão e veja a etapa 5.
NOTE
Para aplicativos de avaliação de 7 dias, a única maneira de configurar a exportação contínua de dados é por meio de
uma cadeia de conexão. Isso ocorre porque os aplicativos de avaliação de 7 dias não têm uma assinatura do Azure
associada.
5. (Opcional) Se você escolher Inserir uma cadeia de conexão, uma nova caixa será exibida para que você
cole a cadeia de conexão. Para obter a cadeia de conexão para:
Hubs de eventos ou barramento de serviço, acesse o namespace na portal do Azure.
Em configurações, selecione políticas de acesso compartilhado
Escolha a RootManageSharedAccessKey padrão ou crie uma
Copie a cadeia de conexão primária ou secundária
6. Escolha um hub de eventos/fila ou tópico na caixa de listagem suspensa.
7. Em Dados a serem exportados, especifique cada tipo de dados a serem exportados, definindo o tipo para
Ativar.
8. Para ativar a exportação de dados contínuas, verifique se a alternância de exportação de dados está
ativada. Clique em Salvar.
9. Após alguns minutos, seus dados serão exibidos no destino escolhido.
Formato de dados
Os dados de medidas, dispositivos e modelos de dispositivo são exportados para o hub de eventos ou para uma
fila ou tópico do Barramento de Serviço quase em tempo real. Os dados de medidas contêm a totalidade da
mensagem enviada pelos dispositivos para o IoT Central, não apenas os valores das medidas propriamente ditos.
Os dados de dispositivos exportados contêm alterações em propriedades e configurações de todos os dispositivos.
Os modelos de dispositivo exportados contêm as alterações em todos os modelos de dispositivo. Os dados
exportados estão na propriedade "body" e no formato JSON.
NOTE
Ao escolher um Barramento de Serviço como destino de exportação, as filas e tópicos não podem ter Sessões ou
Detecção de Duplicidades habilitadas. Se alguma dessas opções estiver habilitada, algumas mensagens não chegarão à
sua fila ou tópico.
Medidas
Uma nova mensagem é exportada rapidamente após a IoT Central receber a mensagem de um dispositivo. Cada
mensagem exportada nos Hubs de Eventos e no Barramento de Serviço contém a mensagem completa que o
dispositivo enviou na propriedade "body" no formato JSON.
NOTE
Os dispositivos que enviaram as medidas são representados por IDs de dispositivo (veja as seções abaixo). Para obter os
nomes dos dispositivos, exporte dados do dispositivo e correlacione cada mensagem usando a connectionDeviceId que
corresponde à deviceId da mensagem do dispositivo.
O exemplo a seguir mostra uma mensagem sobre dados de medidas recebida no hub de eventos ou na fila ou
tópico do Barramento de Serviço.
{
"body": {
"humidity": 29.06963648666288,
"temp": 8.4503795661685,
"pressure": 1075.8334910110093,
"magnetometerX": 408.6966458887116,
"magnetometerY": -532.8809796603962,
"magnetometerZ": 174.70653875528205,
"accelerometerX": 1481.546749013788,
"accelerometerY": -1139.4316656437406,
"accelerometerZ": 811.6928695575307,
"gyroscopeX": 442.19879163299856,
"gyroscopeY": 123.23710975717177,
"gyroscopeZ": 708.5397575786151,
"deviceState": "DANGER"
},
"annotations": {
"iothub-connection-device-id": "<connectionDeviceId>",
"iothub-connection-auth-method": "
{\"scope\":\"hub\",\"type\":\"sas\",\"issuer\":\"iothub\",\"acceptingIpFilterRule\":null}",
"iothub-connection-auth-generation-id": "<generationId>",
"iothub-enqueuedtime": 1539381029965,
"iothub-message-source": "Telemetry",
"x-opt-sequence-number": 25325,
"x-opt-offset": "<offset>",
"x-opt-enqueued-time": 1539381030200
},
"sequenceNumber": 25325,
"enqueuedTimeUtc": "2018-10-02T21:50:30.200Z",
"offset": "<offset>",
"properties": {
"content_type": "application/json",
"content_encoding": "utf-8"
}
}
Dispositivos
Mensagens que contêm dados do dispositivo são enviadas ao seu hub de eventos ou fila ou tópico do Barramento
de Serviço em intervalos de alguns minutos. Isso significa que a cada intervalo de alguns minutos, um lote de
mensagens chegará com os dados sobre:
Novos dispositivos que foram adicionados
Dispositivos com valores alterados de propriedades e de configurações
Cada mensagem representa uma ou mais alterações em um dispositivo desde a última mensagem exportada. As
informações que serão enviadas em cada mensagem incluem:
id do dispositivo na IoT Central
name do dispositivo
deviceId do Serviço de Provisionamento de Dispositivos
Informações de modelo de dispositivo
Valores de propriedade
Valores de configuração
NOTE
Dispositivos excluídos desde o último lote não são exportados. Atualmente, não há indicadores em mensagens exportadas
para dispositivos excluídos.
O modelo de dispositivo ao qual cada dispositivo pertence é representado por uma ID de modelo de dispositivo. Para obter
o nome do modelo do dispositivo, exporte os dados do modelo de dispositivo também.
O exemplo a seguir mostra uma mensagem sobre dados do dispositivo no hub de eventos ou na fila ou tópico do
Barramento de Serviço:
{
"body": {
"id": "<id>",
"name": "<deviceName>",
"simulated": true,
"deviceId": "<deviceId>",
"deviceTemplate": {
"id": "<templateId>",
"version": "1.0.0"
},
"properties": {
"cloud": {
"location": "Seattle"
},
"device": {
"dieNumber": 5445.5862873026645
}
},
"settings": {
"device": {
"fanSpeed": 0
}
}
},
"annotations": {
"iotcentral-message-source": "devices",
"x-opt-partition-key": "<partitionKey>",
"x-opt-sequence-number": 39740,
"x-opt-offset": "<offset>",
"x-opt-enqueued-time": 1539274959654
},
"partitionKey": "<partitionKey>",
"sequenceNumber": 39740,
"enqueuedTimeUtc": "2018-10-02T16:22:39.654Z",
"offset": "<offset>",
}
Mensagens que contêm dados de modelo do dispositivo são enviadas ao seu hub de eventos ou fila ou tópico do
Barramento de Serviço em intervalos de alguns minutos. Isso significa que a cada intervalo de alguns minutos, um
lote de mensagens chegará com os dados sobre:
Novos modelos de dispositivo que foram adicionados
Modelos de dispositivo com definições de medidas, de propriedades e de configurações alteradas
Cada mensagem representa uma ou mais alterações em um modelo de dispositivo desde a última mensagem
exportada. As informações que serão enviadas em cada mensagem incluem:
id do modelo de dispositivo
name do modelo de dispositivo
version do modelo de dispositivo
Tipos de dados de medição e valores mínimos/máximos
Tipos de dados de propriedade e valores padrão
Configuração de tipos de dados e valores padrão
NOTE
Modelos de dispositivo excluídos desde o último lote não são exportados. Atualmente, não há indicadores em mensagens
exportadas para modelos de dispositivos excluídos.
O exemplo a seguir mostra uma mensagem sobre dados de modelo do dispositivo no hub de eventos ou na fila
ou tópico do Barramento de Serviço:
{
"body":{
"id":"<id>",
"version":"1.0.0",
"name":"<templateName>",
"measurements":{
"telemetry":{
"humidity":{
"dataType":"double",
"name":"humidity"
},
"pressure":{
"name":"pressure"
},
"temp":{
"name":"temperature"
}
}
},
"properties":{
"cloud":{
"location":{
"dataType":"string",
"name":"Location"
}
},
"device":{
"dieNumber":{
"name":"Die Number"
}
}
},
"settings":{
"device":{
"fanSpeed":{
"name":"Fan Speed",
"initialValue":0
}
}
}
},
"annotations":{
"iotcentral-message-source":"deviceTemplates",
"x-opt-partition-key":"<partitionKey>",
"x-opt-sequence-number":25315,
"x-opt-offset":"<offset>",
"x-opt-enqueued-time":1539274985085
},
"partitionKey":"<partitionKey>",
"sequenceNumber":25315,
"enqueuedTimeUtc":"2018-10-02T16:23:05.085Z",
"offset":"<offset>"
}
Próximos passos
Agora que você sabe como exportar seus dados para os Hubs de Eventos do Azure e o Barramento de Serviço do
Azure, continue para a próxima etapa:
Como disparar Azure Functions
Exportar dados para o Armazenamento de Blobs do
Azure
NOTE
No momento, você está exibindo a documentação do IoT Central dos modelos de aplicativos que usam a versão prévia dos
recursos. Para exibir a documentação dos modelos de aplicativo que usam os recursos em disponibilidade geral, vá para O
que é o Azure IoT Central?.

Este artigo descreve como usar o recurso de exportação de dados contínuos no Azure IoT Central para exportar
dados periodicamente para sua conta de armazenamento de BLOBs do Azure ou Azure data Lake Storage
Gen2 conta de armazenamento. Você pode exportar medidas, dispositivose modelos de dispositivo para
arquivos no formato JSON ou Apache Avro. Use os dados exportados para a análise de caminho frio, assim como
modelos de treinamento no Microsoft Azure Machine Learning ou análise de tendências de longo prazo no Power
BI.
NOTE
Ao ativar a exportação contínua de dados, você obtém apenas os dados desse momento em diante. Atualmente, não é
possível recuperar dados por um tempo quando a exportação contínua de dados for desativada. Para reter dados mais
históricos, ative a exportação contínua de dados no início.
Pré-requisitos
Você precisa ser um administrador do aplicativo IoT Central
Configurar o destino de exportação

Se você não tiver um armazenamento existente para exportar para o, siga estas etapas:
1. Crie uma conta de armazenamento no portal do Azure. Você pode saber mais sobre como criar novas
contas de armazenamento de BLOBs do Azure ou contas de armazenamento Azure data Lake Storage v2.
NOTE
Se você optar por exportar dados para uma conta de armazenamento ADLS v2, deverá escolher tipo de conta
como BlobStorage.
NOTE
Você pode exportar dados para contas de armazenamento em assinaturas diferentes daquela para seu aplicativo de
IoT Central pré-pago. Você se conectará usando uma cadeia de conexão, nesse caso.
2. Crie um contêiner em sua conta de armazenamento. Vá até sua conta de armazenamento. Em Serviço
Blob, selecione Procurar Blobs. Selecione + Contêiner na parte superior para criar um contêiner.
Configuração da exportação contínua de dados
Agora que você tem um destino de armazenamento para o qual exportar dados, siga estas etapas para configurar
a exportação de dados contínuas.
1. Entre no aplicativo IoT Central.
2. No painel esquerdo, selecione exportação de dados.
NOTE
Se você não vir a exportação de dados no painel esquerdo, você não é um administrador em seu aplicativo. Contate
o administrador para configurar a exportação de dados.
3. Selecione o botão + novo no canto superior direito. Escolha o armazenamento de BLOBs do Azure
como o destino de sua exportação.
NOTE
O número máximo de exportações por aplicativo é cinco.
4. Na caixa de listagem suspensa, selecione o namespace da conta de armazenamento. Você também pode
escolher a última opção da lista, Inserir uma cadeia de conexão.
NOTE
Você só verá namespaces de contas de armazenamento na mesma assinatura que seu aplicativo IOT central.
Caso deseje exportar para um destino fora dessa assinatura, escolha Inserir uma cadeia de conexão e veja a etapa
5.
NOTE
Para aplicativos de avaliação de 7 dias, a única maneira de configurar a exportação contínua de dados é por meio de
uma cadeia de conexão. Isso ocorre porque os aplicativos de avaliação de 7 dias não têm uma assinatura do Azure
associada.
5. (Opcional) Se você escolher Inserir uma cadeia de conexão, uma nova caixa será exibida para que você
cole a cadeia de conexão. Para obter a cadeia de conexão para sua conta de armazenamento, vá para a
conta de armazenamento no portal do Azure:-em configurações, selecione chaves de acesso – Copie a
cadeia de conexão key1 ou a cadeia de conexão Key2
6. Escolha um contêiner na caixa de listagem suspensa. Se você não tiver um contêiner, vá para sua conta de
armazenamento no portal do Azure:
Em serviço blob, selecione BLOBs. Clique em + contêiner e dê um nome ao seu contêiner. Escolha
um nível de acesso público para seus dados (qualquer um funcionará com a exportação de dados
contínua). Saiba mais nos documentos do armazenamento do Azure.
7. Escolha o formato de dados que você prefere: JSON ou formato Apache Avro .
8. Em Dados a serem exportados, especifique cada tipo de dados a serem exportados, definindo o tipo para
Ativar.
9. Para ativar a exportação de dados contínuas, verifique se a alternância de exportação de dados está
ativada. Clique em Salvar.
10. Depois de alguns minutos, seus dados aparecerão na sua conta de armazenamento.
Estrutura do caminho
Os dados de medidas, dispositivos e modelos de dispositivo são exportados para sua conta de armazenamento
uma vez por minuto, com cada arquivo contendo o lote de alterações desde o último arquivo exportado. Os dados
exportados são colocados em três pastas no formato JSON ou Avro. Os caminhos padrão em sua conta de
armazenamento são:
Mensagens: {Container}/measurements/{hubname}/{YYYY }/{MM }/{dd}/{hh}/{mm}/{filename}
Dispositivos: {Container}/devices/{YYYY }/{MM }/{dd}/{hh}/{mm}/{filename}
Modelos de dispositivo: {Container}/deviceTemplates/{YYYY }/{MM }/{dd}/{hh}/{mm}/{filename}
Você pode procurar os arquivos exportados no portal do Azure navegando até o arquivo e escolhendo a guia
Editar blob .
Formato de dados
Medidas
Os dados das medidas recebidos têm todas as novas mensagens recebidas pelo IoT Central de todos os
dispositivos durante esse período. Os arquivos exportados usam o mesmo formato que os arquivos de
mensagens exportados pelo roteamento de mensagens do Hub IoT para o Armazenamento de Blobs.
NOTE
Verifique se os dispositivos estão enviando mensagens com contentType: application/JSON e contentEncoding:utf-8
(ou utf-16`ùtf-32 ). Consulte a documentação do Hub IOT para obter um exemplo.
NOTE
Os dispositivos que enviaram as medidas são representados por IDs de dispositivo (veja as seções abaixo). Para obter os
nomes dos dispositivos, exporte os instantâneos do dispositivo. Correlacione cada registro de mensagem usando o
connectionDeviceId que corresponde ao deviceId do registro do dispositivo.
O exemplo a seguir mostra um registro em um arquivo Avro decodificado:
{
"EnqueuedTimeUtc":"2019-06-11T00:00:08.2250000Z",
"Properties":{},
"SystemProperties":{
"connectionDeviceId":"<deviceId>",
"connectionAuthMethod":"
{\"scope\":\"hub\",\"type\":\"sas\",\"issuer\":\"iothub\",\"acceptingIpFilterRule\":null}",
"connectionDeviceGenerationId":"<generationId>",
"enqueuedTime":"2019-06-11T00:00:08.2250000Z"
},
"Body":"
{\"humidity\":80.59100954598546,\"magnetometerX\":0.29451796907056726,\"magnetometerY\":0.5550332126050068,\"m
agnetometerZ\":-0.04116681874733441,\"connectivity\":\"connected\",\"opened\":\"triggered\"}"
}
Dispositivos
Ao ativar a exportação contínua pela primeira vez, um único instantâneo que contém todos os dispositivos é
exportado. Cada dispositivo inclui:
id do dispositivo na IoT Central
name do dispositivo
deviceId do Serviço de Provisionamento de Dispositivos
Informações de modelo de dispositivo
Valores de propriedade
Valores de configuração
Um novo instantâneo é gravado uma vez por minuto. O instantâneo inclui:
Novos dispositivos adicionados desde o último instantâneo.
Dispositivos com propriedade alterada e valores de configuração desde o último instantâneo.
NOTE
Dispositivos excluídos desde o último instantâneo que não foram exportados. Atualmente, os instantâneos não têm
indicadores para dispositivos excluídos.
O modelo de dispositivo ao qual cada dispositivo pertence é representado por uma ID de modelo de dispositivo. Para obter
o nome do modelo de dispositivo, exporte os instantâneos do modelo de dispositivo.
Os arquivos exportados contêm uma única linha por registro. O exemplo a seguir mostra um registro no formato
Avro, decodificado:
{
"id":"<id>",
"name":"Refrigerator 2",
"simulated":true,
"deviceId":"<deviceId>",
"deviceTemplate":{
"id":"<template id>",
"version":"1.0.0"
},
"properties":{
"cloud":{
"location":"New York",
"maintCon":true,
"tempThresh":20
},
"device":{
"lastReboot":"2018-02-09T22:22:47.156Z"
}
},
"settings":{
"device":{
"fanSpeed":0
}
}
}
Ao ativar a exportação contínua pela primeira vez, um único instantâneo com todos os dispositivos é exportado.
Cada modelo de dispositivo inclui:
id do modelo de dispositivo
name do modelo de dispositivo
version do modelo de dispositivo
Tipos de dados de medição e valores mínimos/máximos.
Tipos de dados de propriedade e valores padrão.
Configuração de tipos de dados e valores padrão.
Um novo instantâneo é gravado uma vez por minuto. O instantâneo inclui:
Os novos modelos de dispositivo adicionados desde o último instantâneo.
Modelos de dispositivo com medidas alteradas, propriedade e definições de configurações que foram alteradas
desde o último instantâneo.
NOTE
Modelos de dispositivo excluídos desde que o último instantâneo não foi exportado. Atualmente, os instantâneos não têm
indicadores para modelos excluídos.
Os arquivos exportados contêm uma única linha por registro. O exemplo a seguir mostra um registro no formato
Avro, decodificado:
{
"id":"<id>",
"name":"Refrigerated Vending Machine",
"version":"1.0.0",
"measurements":{
"telemetry":{
"humidity":{
"name":"Humidity"
},
"magnetometerX":{
"name":"Magnetometer X"
},
"magnetometerY":{
"name":"Magnetometer Y"
},
"magnetometerZ":{
"name":"Magnetometer Z"
}
},
"states":{
"connectivity":{
"dataType":"enum",
"name":"Connectivity"
}
},
"events":{
"opened":{
"name":"Door Opened",
"category":"informational"
}
}
},
"settings":{
"device":{
"fanSpeed":{
"name":"Fan Speed",
"initialValue":0
}
}
},
"properties":{
"cloud":{
"location":{
"dataType":"string",
"name":"Location",
"initialValue":"Seattle"
},
"maintCon":{
"dataType":"boolean",
"name":"Maintenance Contract",
"initialValue":true
},
"tempThresh":{
"name":"Temperature Alert Threshold",
"initialValue":30
}
},
"device":{
"lastReboot":{
"dataType":"dateTime",
"name":"Last Reboot"
}
}
}
}
Como ler arquivos Avro exportados

Avro é um formato binário, então os arquivos não podem ser lidos em seu estado bruto. Os arquivos podem ser
decodificados para o formato JSON. Os exemplos a seguir mostram como analisar os as medidas, dispositivos e
modelos de dispositivo dos arquivos Avro. Os exemplos correspondem aos exemplos descritos na seção anterior.
Ler arquivos Avro usando o Python
Instalar o pandas e o pacote pandavro
pip install pandas

pip install pandavro
Analisar um arquivo Avro de medidas
import json
import pandavro as pdx
import pandas as pd
def parse(filePath):
# Pandavro loads the Avro file into a pandas DataFrame
# where each record is a single row.
measurements = pdx.from_avro(filePath)
# This example creates a new DataFrame and loads a series

# for each column that's mapped into a column in our new DataFrame.
transformed = pd.DataFrame()
# The SystemProperties column contains a dictionary

# with the device ID located under the connectionDeviceId key.
transformed["device_id"] = measurements["SystemProperties"].apply(
lambda x: x["connectionDeviceId"])
# The Body column is a series of UTF-8 bytes that is stringified

# and parsed as JSON. This example pulls the humidity property
# from each column to get the humidity field.
transformed["humidity"] = measurements["Body"].apply(
lambda x: json.loads(bytes(x).decode('utf-8'))["humidity"])
# Finally, print the new DataFrame with our device IDs and humidities.
print(transformed)
Analisar um arquivo Avro de dispositivos

import json
import pandas as pd
devices = pdx.from_avro(filePath)

# The device ID is available in the id column.

transformed["device_id"] = devices["deviceId"]
# The template ID and version are present in a dictionary under

# the deviceTemplate column.
transformed["template_id"] = devices["deviceTemplate"].apply(
lambda x: x["id"])
transformed["template_version"] = devices["deviceTemplate"].apply(
lambda x: x["version"])
# The fanSpeed setting value is located in a nested dictionary

# under the settings column.
transformed["fan_speed"] = devices["settings"].apply(
lambda x: x["device"]["fanSpeed"])
# Finally, print the new DataFrame with our device and template
# information, along with the value of the fan speed.
print(transformed)
Analisar o arquivo Avro de modelos de dispositivo
import json
import pandas as pd
templates = pdx.from_avro(filePath)

# The template and version are available in the id and version columns.
transformed["template_id"] = templates["id"]
transformed["template_version"] = templates["version"]
# The fanSpeed setting value is located in a nested dictionary

# under the settings column.
transformed["fan_speed"] = templates["settings"].apply(
lambda x: x["device"]["fanSpeed"])
# Finally, print the new DataFrame with our device and template
# information, along with the value of the fan speed.
print(transformed)
Ler arquivos Avro usando C#

Instalar o pacote Microsoft.Hadoop.Avro
Install-Package Microsoft.Hadoop.Avro -Version 1.5.6
using Microsoft.Hadoop.Avro;
using Microsoft.Hadoop.Avro.Container;
public static async Task Run(string filePath)

{
using (var fileStream = File.OpenRead(filePath))
{
using (var reader = AvroContainer.CreateGenericReader(fileStream))
{
// For one Avro container, where a container can contain multiple blocks,
// loop through each block in the container.
while (reader.MoveNext())
{
// Loop through the Avro records in the block and extract the fields.
foreach (AvroRecord record in reader.Current.Objects)
{
var systemProperties = record.GetField<IDictionary<string, object>>("SystemProperties");
var deviceId = systemProperties["connectionDeviceId"] as string;
Console.WriteLine("Device ID: {0}", deviceId);
using (var stream = new MemoryStream(record.GetField<byte[]>("Body")))

{
using (var streamReader = new StreamReader(stream, Encoding.UTF8))
{
var body = JsonSerializer.Create().Deserialize(streamReader,
typeof(IDictionary<string, dynamic>)) as IDictionary<string, dynamic>;
var humidity = body["humidity"];
Console.WriteLine("Humidity: {0}", humidity);
}
}
}
}
}
}
}


{
{
{
{
{
// Get the field value directly. You can also yield return
// records and make the function IEnumerable<AvroRecord>.
var deviceId = record.GetField<string>("deviceId");
// The device template information is stored in a sub-record

// under the deviceTemplate field.
var deviceTemplateRecord = record.GetField<AvroRecord>("deviceTemplate");
var templateId = deviceTemplateRecord.GetField<string>("id");
var templateVersion = deviceTemplateRecord.GetField<string>("version");
// The settings and properties are nested two levels deep.

// The first level indicates settings or properties.
// The second level indicates the type of setting or property.
var settingsRecord = record.GetField<AvroRecord>("settings");
var deviceSettingsRecord = settingsRecord.GetField<IDictionary<string, dynamic>>
("device");
var fanSpeed = deviceSettingsRecord["fanSpeed"];
Console.WriteLine(
"Device ID: {0}, Template ID: {1}, Template Version: {2}, Fan Speed: {3}",
deviceId,
templateId,
templateVersion,
fanSpeed
);
}
}
}
}
}


{
{
{
{
{
// Get the field value directly. You can also yield return
// records and make the function IEnumerable<AvroRecord>.
var id = record.GetField<string>("id");
var version = record.GetField<string>("version");
// The settings and properties are nested two levels deep.

// The first level indicates settings or properties.
// The second level indicates the type of setting or property.
var settingsRecord = record.GetField<AvroRecord>("settings");
var deviceSettingsRecord = settingsRecord.GetField<IDictionary<string, dynamic>>
("device");
var fanSpeed = deviceSettingsRecord["fanSpeed"];
Console.WriteLine(
"ID: {1}, Version: {2}, Fan Speed: {3}",
id,
version,
fanSpeed
);
}
}
}
}
}
Ler arquivos Avro usando o Javascript

Instalar o pacote avsc
npm install avsc

const avro = require('avsc');
// Read the Avro file. Parse the device ID and humidity from each record.
async function parse(filePath) {
const records = await load(filePath);
for (const record of records) {
// Fetch the device ID from the system properties.
const deviceId = record.SystemProperties.connectionDeviceId;
// Convert the body from a buffer to a string and parse it.

const body = JSON.parse(record.Body.toString());
// Get the humidty property from the body.

const humidity = body.humidity;
// Log the retrieved device ID and humidity.

console.log(`Device ID: ${deviceId}`);
console.log(`Humidity: ${humidity}`);
}
}
function load(filePath) {
return new Promise((resolve, reject) => {
// The file decoder emits each record as a data event on a stream.
// Collect the records into an array and return them at the end.
const records = [];
avro.createFileDecoder(filePath)
.on('data', record => { records.push(record); })
.on('end', () => resolve(records))
.on('error', reject);
});
}

// Read the Avro file. Parse the device and template identification
// information and the fanSpeed setting for each device record.
// Fetch the device ID from the deviceId property.
const deviceId = record.deviceId;
// Fetch the template ID and version from the deviceTemplate property.

const deviceTemplateId = record.deviceTemplate.id;
const deviceTemplateVersion = record.deviceTemplate.version;
// Get the fanSpeed from the nested device settings property.

const fanSpeed = record.settings.device.fanSpeed;
// Log the retrieved device ID and humidity.

console.log(`deviceID: ${deviceId}, Template ID: ${deviceTemplateId}, Template Version:
${deviceTemplateVersion}, Fan Speed: ${fanSpeed}`);
}
}
const records = [];
});
}

// Read the Avro file. Parse the device and template identification
// information and the fanSpeed setting for each device record.
// Fetch the template ID and version from the id and verison properties.
const templateId = record.id;
const templateVersion = record.version;
// Get the fanSpeed from the nested device settings property.

const fanSpeed = record.settings.device.fanSpeed;
// Log the retrieved device id and humidity.

console.log(`Template ID: ${templateId}, Template Version: ${templateVersion}, Fan Speed:
${fanSpeed}`);
}
}
const records = [];
});
}
Próximos passos
Agora que você sabe como exportar seus dados, continue para a próxima etapa:
Como visualizar os dados no Power BI
Estender IoT Central do Azure com regras
personalizadas usando Stream Analytics, Azure
Functions e SendGrid
Este guia de instruções mostra, como um desenvolvedor de soluções, como estender seu aplicativo IoT Central
com regras e notificações personalizadas. O exemplo mostra o envio de uma notificação para um operador quando
um dispositivo para de enviar telemetria. A solução usa uma consulta Azure Stream Analytics para detectar quando
um dispositivo parou de enviar telemetria. O trabalho de Stream Analytics usa Azure Functions para enviar emails
de notificação usando o SendGrid.
Este guia de instruções mostra como estender IoT Central além do que ele já pode fazer com as regras e ações
internas.
Neste guia de instruções, você aprende a:
Transmita a telemetria de um aplicativo IoT Central usando a exportação de dados contínuas.
Crie uma consulta Stream Analytics que detecta quando um dispositivo parou de enviar dados.
Envie uma notificação por email usando os serviços Azure Functions e SendGrid.
Pré-requisitos
Para concluir as etapas neste guia de instruções, é necessário ter uma assinatura ativa do Azure.
Aplicativo IoT Central
Crie um aplicativo IoT Central no site do Azure IOT central Application Manager com as seguintes configurações:
Plano de Pagamento Pós-pago
Modelo de aplicativo Aplicativo herdado
Nome do aplicativo Aceite o padrão ou escolha seu próprio nome
URL Aceite o padrão ou escolha seu próprio prefixo de URL

exclusivo
Diretório Seu locatário Azure Active Directory
Assinatura do Azure Sua assinatura do Azure
Região Estados Unidos
Os exemplos e capturas de tela neste artigo usam a região Estados Unidos . Escolha um local perto de você e
certifique-se de criar todos os seus recursos na mesma região.
Grupo de recursos
Use o portal do Azure para criar um grupo de recursos chamado DetectStoppedDevices para conter os outros
recursos que você criar. Crie seus recursos do Azure no mesmo local que o aplicativo IoT Central.
Namespace do Hubs de Eventos
Use o portal do Azure para criar um namespace de hubs de eventos com as seguintes configurações:
Nome Escolha o nome do namespace
tipo de preço Básico
Subscription Sua assinatura
Grupo de recursos DetectStoppedDevices
Local Leste dos EUA
Unidades de produtividade 1
Trabalho do Stream Analytics

Use o portal do Azure para criar um trabalho de Stream Analytics com as seguintes configurações:
Nome Escolha o nome do seu trabalho
Local Leste dos EUA
Ambiente de hospedagem Nuvem
Unidades de streaming 3
Aplicativo de funções
Use o portal do Azure para criar um aplicativo de funções com as seguintes configurações:
Nome do aplicativo Escolha o nome do aplicativo de funções
SISTEMA OPERACIONAL Windows
Plano de Hospedagem Plano de consumo

Local Leste dos EUA
Pilha de runtime .NET
Armazenamento Criar Novo
Conta do SendGrid
Use o portal do Azure para criar uma conta do SendGrid com as seguintes configurações:
Nome Escolha o nome da conta do SendGrid
Senha Criar uma senha
tipo de preço F1 Gratuito
Informações de contato Preencha as informações necessárias
Quando você tiver criado todos os recursos necessários, seu grupo de recursos DetectStoppedDevices será
semelhante à captura de tela a seguir:
Criar um Hub de Evento
Você pode configurar um aplicativo de IoT Central para exportar continuamente a telemetria para um hub de
eventos. Nesta seção, você cria um hub de eventos para receber telemetria do seu aplicativo IoT Central. O Hub de
eventos fornece a telemetria para seu trabalho de Stream Analytics para processamento.
1. Na portal do Azure, navegue até o namespace de seus hubs de eventos e selecione + Hub de eventos.
2. Nomeie o centralexportdo hub de eventos e selecione criar.
O namespace dos hubs de eventos é semelhante à captura de tela a seguir:
Obter chave de API do SendGrid
Seu aplicativo de funções precisa de uma chave de API SendGrid para enviar mensagens de email. Para criar uma
chave de API do SendGrid:
1. Na portal do Azure, navegue até sua conta do SendGrid. Em seguida, escolha gerenciar para acessar sua
conta do SendGrid.
2. Em sua conta do SendGrid, escolha configuraçõese, em seguida, chaves de API. Escolha criar chave de
API:
3. Na página criar chave de API , crie uma chave chamada AzureFunctionAccess com permissões de
acesso completo .
4. Anote a chave de API, você precisará dela quando configurar seu aplicativo de funções.
Definir a função
Essa solução usa um aplicativo Azure Functions para enviar uma notificação por email quando o trabalho de
Stream Analytics detecta um dispositivo interrompido. Para criar seu aplicativo de funções:
1. Na portal do Azure, navegue até a instância do serviço de aplicativo no grupo de recursos
DetectStoppedDevices .
2. Selecione + para criar uma nova função.
3. Na página escolher um ambiente de desenvolvimento , escolha no portal e, em seguida, selecione
continuar.
4. Na página criar uma função , escolha webhook + API e, em seguida, selecione criar.
O portal cria uma função padrão chamada HttpTrigger1:
Configurar associações de função
Para enviar emails com o SendGrid, você precisa configurar as associações para a função da seguinte maneira:
1. Selecione integrar, escolha o http de saída ($Return) e, em seguida, selecione excluir.
2. Escolha + nova saída, escolha SendGride escolha selecionar. Escolha instalar para instalar a extensão
SendGrid.
3. Quando a instalação for concluída, selecione usar valor de retorno da função. Adicione um endereço de
endereçamento válido para receber notificações por email. Adicione um endereço de remetente válido para
usar como o emissor do email.
4. Selecione novo ao lado de configuração do aplicativo de chave de API do SendGrid. Insira
SendGridAPIKey como a chave e a chave de API SendGrid que você anotou anteriormente como o valor. Em
seguida, selecione Criar.
5. Escolha salvar para salvar as associações SendGrid para sua função.
As configurações de integração são parecidas com a seguinte captura de tela:
Adicionar o código de função
Para implementar sua função, adicione o C# código para analisar a solicitação HTTP de entrada e enviar os emails
da seguinte maneira:
1. Escolha a função HttpTrigger1 em seu aplicativo de funções e substitua C# o código pelo código a seguir:
#r "Newtonsoft.Json"
#r "..\bin\SendGrid.dll"
using System;
using SendGrid.Helpers.Mail;
using Microsoft.Azure.WebJobs.Host;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
public static SendGridMessage Run(HttpRequest req, ILogger log)

{
string requestBody = new StreamReader(req.Body).ReadToEnd();
log.LogInformation(requestBody);
var notifications = JsonConvert.DeserializeObject<IList<Notification>>(requestBody);
SendGridMessage message = new SendGridMessage();

message.Subject = "Contoso device notification";
var content = "The following device(s) have stopped sending telemetry:<br/><br/><table><tr>

<th>Device ID</th><th>Time</th></tr>";
foreach(var notification in notifications) {
log.LogInformation($"No message received - Device: {notification.deviceid}, Time:
{notification.time}");
content += $"<tr><td>{notification.deviceid}</td><td>{notification.time}</td></tr>";
}
content += "</table>";
message.AddContent("text/html", content);
return message;
}
public class Notification

{
public string deviceid { get; set; }
public string time { get; set; }
}
Você poderá ver uma mensagem de erro até salvar o novo código.
2. Selecione salvar para salvar a função.
Testar a função Works
Para testar a função no portal, primeiro escolha logs na parte inferior do editor de código. Em seguida, escolha
teste à direita do editor de códigos. Use o JSON a seguir como o corpo da solicitação:
[{"deviceid":"test-device-1","time":"2019-05-02T14:23:39.527Z"},{"deviceid":"test-device-2","time":"2019-05-
02T14:23:50.717Z"},{"deviceid":"test-device-3","time":"2019-05-02T14:24:28.919Z"}]
As mensagens de log de função aparecem no painel de logs :

Após alguns minutos, o endereço de email para recebe um email com o seguinte conteúdo:
The following device(s) have stopped sending telemetry:
Device ID Time
test-device-1 2019-05-02T14:23:39.527Z
test-device-2 2019-05-02T14:23:50.717Z
test-device-3 2019-05-02T14:24:28.919Z
Adicionar consulta de Stream Analytics

Essa solução usa uma consulta Stream Analytics para detectar quando um dispositivo para de enviar telemetria por
mais de 120 segundos. A consulta usa a telemetria do hub de eventos como entrada. O trabalho envia os
resultados da consulta para o aplicativo de funções. Nesta seção, você configura o trabalho de Stream Analytics:
1. No portal do Azure, navegue até o trabalho do Stream Analytics, em topologia de trabalhos selecione
entradas, escolha + Adicionar entrada de fluxoe, em seguida, selecione Hub de eventos.
2. Use as informações na tabela a seguir para configurar a entrada usando o Hub de eventos que você criou
anteriormente e, em seguida, escolha salvar:
Alias de entrada centraltelemetry
Namespace do Hub de Eventos Seu namespace do hub de eventos
Nome do Hub de Eventos Usar- centralexport existente
3. Em topologia de trabalhos, selecione saídas, escolha + Adicionare, em seguida, escolha Azure

function.
4. Use as informações na tabela a seguir para configurar a saída e, em seguida, escolha salvar:
Alias de saída emailnotification
Aplicativo de funções Seu aplicativo de funções
Função HttpTrigger1
5. Em topologia de trabalhos, selecione consulta e substitua a consulta existente pelo seguinte SQL:
with
LeftSide as
(
SELECT
-- Get the device ID from the message metadata and create a column
GetMetadataPropertyValue([centraltelemetry], '[EventHub].[IoTConnectionDeviceId]') as deviceid1,
EventEnqueuedUtcTime AS time1
FROM
-- Use the event enqueued time for time-based operations
[centraltelemetry] TIMESTAMP BY EventEnqueuedUtcTime
),
RightSide as
(
SELECT
-- Get the device ID from the message metadata and create a column
GetMetadataPropertyValue([centraltelemetry], '[EventHub].[IoTConnectionDeviceId]') as deviceid2,
EventEnqueuedUtcTime AS time2
FROM
-- Use the event enqueued time for time-based operations
[centraltelemetry] TIMESTAMP BY EventEnqueuedUtcTime
)
SELECT
LeftSide.deviceid1 as deviceid,
LeftSide.time1 as time
INTO
[emailnotification]
FROM
LeftSide
LEFT OUTER JOIN
RightSide
ON
LeftSide.deviceid1=RightSide.deviceid2 AND DATEDIFF(second,LeftSide,RightSide) BETWEEN 1 AND 120
where
-- Find records where a device didn't send a message 120 seconds
RightSide.deviceid2 is NULL
6. Clique em Salvar.
7. Para iniciar o trabalho de Stream Analytics, escolha visão geral, Iniciar, agorae Iniciar:
Configurar a exportação no IoT Central
No site do Azure IOT central Application Manager , navegue até o aplicativo IOT central que você criou por meio
do modelo da contoso. Nesta seção, você configura o aplicativo para transmitir a telemetria de seus dispositivos
simulados para o Hub de eventos. Para configurar a exportação:
1. Navegue até a página exportação de dados contínuas , selecione + novoe os hubs de eventos do
Azure.
2. Use as configurações a seguir para configurar a exportação e, em seguida, selecione salvar:
Nome de exibição Exportar para hubs de eventos
habilitado Ligar
Namespace do Hubs de Eventos Nome do namespace de seus hubs de eventos
Hub de Eventos centralexport
Medidas Ligar
Dispositivos Desligar
Modelos de Dispositivo Desligar

Aguarde até que o status de exportação seja executado antes de continuar.
Teste
Para testar a solução, você pode desabilitar a exportação de dados contínuas de IoT Central para dispositivos
interrompidos simulados:
1. No aplicativo IoT Central, navegue até a página exportação de dados contínua e selecione exportar para
a configuração de exportação dos hubs de eventos .
2. Defina habilitado como desativado e escolha salvar.
3. Após pelo menos dois minutos, o endereço de email to receberá um ou mais emails parecidos com o
seguinte conteúdo de exemplo:
The following device(s) have stopped sending telemetry:
Device ID Time
7b169aee-c843-4d41-9f25-7a02671ee659 2019-05-09T14:28:59.954Z
Limpar
Para fazer a limpeza após este procedimento e evitar custos desnecessários, exclua o grupo de recursos
DetectStoppedDevices no portal do Azure.
Você pode excluir o aplicativo IoT Central da página de Gerenciamento dentro do aplicativo.
Próximos passos
Neste guia de instruções, você aprendeu como:
Crie uma consulta Stream Analytics que detecta quando um dispositivo parou de enviar dados.
Envie uma notificação por email usando os serviços Azure Functions e SendGrid.
Agora que você sabe como criar regras e notificações personalizadas, a próxima etapa sugerida é aprender a
estender IOT central do Azure com análises personalizadas.
Estenda o IoT Central do Azure com análises
personalizadas usando Azure Databricks
Este guia de instruções mostra, como desenvolvedor de soluções, como estender seu aplicativo IoT Central com
análises e visualizações personalizadas. O exemplo usa um espaço de trabalho Azure Databricks para analisar o
fluxo de telemetria IOT central e gerar visualizações como plotagens de caixa.
Este guia de instruções mostra como estender IoT Central além do que ele já pode fazer com as ferramentas de
análise internas.
Neste guia de instruções, você aprende a:
Crie um ambiente de Azure Databricks para analisar e plotar a telemetria do dispositivo.
Pré-requisitos
Para concluir as etapas neste guia de instruções, é necessário ter uma assinatura ativa do Azure.
Aplicativo IoT Central
Crie um aplicativo IoT Central no site do Azure IOT central Application Manager com as seguintes configurações:
Plano de Pagamento Pós-pago
Modelo de aplicativo Aplicativo herdado
Nome do aplicativo Aceite o padrão ou escolha seu próprio nome
URL Aceite o padrão ou escolha seu próprio prefixo de URL

exclusivo
Diretório Seu locatário Azure Active Directory
Assinatura do Azure Sua assinatura do Azure
Região Estados Unidos
Os exemplos e capturas de tela neste artigo usam a região Estados Unidos . Escolha um local perto de você e
certifique-se de criar todos os seus recursos na mesma região.
Grupo de recursos
Use o portal do Azure para criar um grupo de recursos chamado IoTCentralAnalysis para conter os outros
recursos que você criar. Crie seus recursos do Azure no mesmo local que o aplicativo IoT Central.
Namespace do Hubs de Eventos
Use o portal do Azure para criar um namespace de hubs de eventos com as seguintes configurações:
Nome Escolha o nome do namespace
tipo de preço Básico
Grupo de recursos IoTCentralAnalysis
Local Leste dos EUA
Unidades de produtividade 1
Espaço de trabalho Azure Databricks

Use o portal do Azure para criar um serviço de Azure Databricks com as seguintes configurações:
Nome do workspace Escolha o nome do seu espaço de trabalho
Grupo de recursos IoTCentralAnalysis
Local Leste dos EUA
Camada de preços Padrão
Quando você criou os recursos necessários, o grupo de recursos IoTCentralAnalysis é semelhante à captura de
tela a seguir:
Criar um Hub de Evento
Você pode configurar um aplicativo de IoT Central para exportar continuamente a telemetria para um hub de
eventos. Nesta seção, você cria um hub de eventos para receber telemetria do seu aplicativo IoT Central. O Hub de
eventos fornece a telemetria para seu trabalho de Stream Analytics para processamento.
1. Na portal do Azure, navegue até o namespace de seus hubs de eventos e selecione + Hub de eventos.
2. Nomeie o centralexportdo hub de eventos e selecione criar.
3. Na lista de hubs de eventos em seu namespace, selecione centralexport. Em seguida, escolha políticas de
acesso compartilhado.
4. Selecione + Adicionar. Crie uma política chamada Listen com a Declaração Listen .
5. Quando a política estiver pronta, selecione-a na lista e copie o valor da chave primária da cadeia de
conexão .
6. Anote essa cadeia de conexão, você a usará mais tarde quando configurar o bloco de anotações do databricks
para ler do hub de eventos.
O namespace dos hubs de eventos é semelhante à captura de tela a seguir:
Configurar a exportação no IoT Central

No site do Azure IOT central Application Manager , navegue até o aplicativo IOT central que você criou por meio
do modelo da contoso. Nesta seção, você configura o aplicativo para transmitir a telemetria de seus dispositivos
simulados para o Hub de eventos. Para configurar a exportação:
1. Navegue até a página exportação de dados contínuas , selecione + novoe os hubs de eventos do
Azure.
2. Use as configurações a seguir para configurar a exportação e, em seguida, selecione salvar:
Nome de exibição Exportar para hubs de eventos
habilitado Ligar
Namespace do Hubs de Eventos Nome do namespace de seus hubs de eventos
Hub de Eventos centralexport
Medidas Ligar
Dispositivos Desligar
Modelos de Dispositivo Desligar
Aguarde até que o status de exportação seja executado antes de continuar.
Configurar o espaço de trabalho do databricks

Na portal do Azure, navegue até o serviço de Azure Databricks e selecione Iniciar espaço de trabalho. Uma
nova guia é aberta no navegador e você entra no espaço de trabalho.
Criar um cluster
Na página Azure Databricks , na lista de tarefas comuns, selecione novo cluster.
Use as informações na tabela a seguir para criar o cluster:
Nome do cluster centralanalysis
Modo de Cluster Padrão
Versão do Databricks Runtime 5,3 (escala 2,11, Spark 2.4.0)
Versão do Python 3
Habilitar o dimensionamento automático Não
Terminar após minutos de inatividade 30
Tipo de Trabalho Standard_DS3_v2
Trabalhos 1
Tipo de Driver Mesmo que o trabalho
A criação de um cluster pode levar vários minutos, aguarde a conclusão da criação do cluster antes de continuar.
Instalar bibliotecas
Na página clusters , aguarde até que o estado do cluster esteja em execução.
As etapas a seguir mostram como importar a biblioteca que seu exemplo precisa para o cluster:
1. Na página clusters , aguarde até que o estado do cluster interativo Centralanalysis esteja em execução.
2. Selecione o cluster e, em seguida, escolha a guia bibliotecas .
3. Na guia bibliotecas , escolha instalar novo.
4. Na página instalar biblioteca , escolha Maven como a origem da biblioteca.
5. Na caixa de texto coordenadas , insira o seguinte valor:
com.microsoft.azure:azure-eventhubs-spark_2.11:2.3.10
6. Escolha instalar para instalar a biblioteca no cluster.

7. O status da biblioteca agora está instalado:
Importar um bloco de anotações do databricks
Use as etapas a seguir para importar um bloco de anotações do databricks que contém o código Python para
analisar e visualizar sua telemetria de IoT Central:
1. Navegue até a página do espaço de trabalho em seu ambiente do databricks. Selecione o menu suspenso
ao lado do nome da sua conta e escolha importar.
2. Escolha Importar de uma URL e insira o seguinte endereço: https://github.com/Azure-Samples/iot-central-
docs-samples/blob/master/databricks/IoT%20Central%20Analysis.dbc?raw=true
3. Para importar o bloco de anotações, escolha importar.
4. Selecione o espaço de trabalho para exibir o bloco de anotações importado:
5. Edite o código na primeira célula do Python para adicionar a cadeia de conexão dos hubs de eventos que
você salvou anteriormente:
from pyspark.sql.functions import *

from pyspark.sql.types import *
###### Event Hub Connection strings ######

telementryEventHubConfig = {
'eventhubs.connectionString' : '{your Event Hubs connection string}'
}
Executar análise
Para executar a análise, você deve anexar o bloco de anotações ao cluster:
1. Selecione desanexado e, em seguida, selecione o cluster centralanalysis .
2. Se o cluster não estiver em execução, inicie-o.
3. Para iniciar o bloco de anotações, selecione o botão Executar.
Você pode ver um erro na última célula. Nesse caso, verifique se as células anteriores estão em execução, aguarde
um minuto para que alguns dados sejam gravados no armazenamento e, em seguida, execute a última célula
novamente.
Exibir dados suavizados
No bloco de anotações, role para baixo até a célula 14 para ver uma plotagem da umidade média móvel por tipo
de dispositivo. Essa plotagem é atualizada continuamente à medida que a telemetria de streaming chega:
Você pode redimensionar o gráfico no bloco de anotações.
Exibir gráficos de caixa
No bloco de anotações, role para baixo até a célula 20 para ver as plotagens da caixa. As plotagens de caixa são
baseadas em dados estáticos para que atualizá-los, você deve executar novamente a célula:
Você pode redimensionar as plotagens no bloco de anotações.
Limpar
Para fazer a limpeza após este procedimento e evitar custos desnecessários, exclua o grupo de recursos
IoTCentralAnalysis no portal do Azure.
Você pode excluir o aplicativo IoT Central da página de Gerenciamento dentro do aplicativo.
Próximos passos
Neste guia de instruções, você aprendeu como:
Crie um ambiente de Azure Databricks para analisar e plotar dados de telemetria.
Agora que você sabe como criar análises personalizadas, a próxima etapa sugerida é aprender a Visualizar e
analisar seus dados de IOT central do Azure em um painel de Power bi.
Visualize e analise seus dados do Azure IoT Central
em um painel do Power BI
NOTE
Use a solução do Power BI para Azure IoT Central para criar um dashboard avançado do Power BI para monitorar
o desempenho dos seus dispositivos IoT. No seu painel do Power BI, você pode:
Acompanhe quantos dados seus dispositivos estão enviando ao longo do tempo
Comparar o volume de dados entre telemetria, estados e eventos
Identifique dispositivos que estão relatando muitas medições
Observe as tendências históricas das medições do dispositivo
Identificar dispositivos problemáticos que enviam muitos eventos críticos
Esta solução configura o pipeline que usa os dados na sua conta de Armazenamento de Blobs do Azure da
Exportação de dados contínua. Esses dados fluem por meio do Azure Functions, Azure Data Factory e o banco de
dados SQL do Azure para processar e transformar os dados. A saída pode ser visualizada e analisada em um
relatório do Power BI que você pode baixar como um arquivo PBIX. Todos esses recursos são criados em sua
assinatura do Azure, para que você possa personalizar cada componente para atender às suas necessidades.
NOTE
A solução Power BI para o IoT Central do Azure funciona com aplicativos IoT Central que não dão suporte a Plug and Play
IoT (aplicativos de visualização hoje)
Obtenha a solução do Power BI para Azure IoT Central no Microsoft

AppSource.
Pré-requisitos
A configuração da solução requer o seguinte:
Acesso a uma assinatura do Azure
IoT Central aplicativo que não dá suporte a IoT Plug and Play (aplicativos de visualização hoje)
Exportação de dados contínua configurada para o armazenamento de BLOBs do Azure de seu aplicativo IoT
Central
Verifique se o formato de dados é Avro
Recomendamos que você ative medições, dispositivos e fluxos de modelos de dispositivos para
aproveitar ao máximo o painel do Power BI.
Saiba como configurar a exportação de dados contínuas
Power BI Desktop (versão mais recente)
Power BI Pro (se você quiser compartilhar o painel com os outros)
Relatórios
Dois relatórios são gerados automaticamente.
O primeiro relatório mostra uma visão histórica das medições relatadas pelos dispositivos e divide os diferentes
tipos de medições e dispositivos que enviaram o maior número de medições.
O segundo relatório aprofunda os eventos e mostra uma visão histórica dos erros e avisos relatados. Ele também
mostra quais dispositivos estão relatando o maior número de eventos de tudo para cima, bem como
especificamente os eventos de erro e eventos de aviso.
Arquitetura
Todos os recursos criados podem ser acessados no portal do Azure. Tudo deve estar em um grupo de recursos.
As especificidades de cada recurso e de como ele é usado são descritas abaixo.

Funções do Azure
O aplicativo Azure Functions é disparado sempre que um novo arquivo é gravado no Armazenamento de Blobs.
As funções extraem os campos dentro de cada arquivo de medidas, de dispositivos e de modelos de dispositivo e
popula várias tabelas intermediárias do SQL a serem usadas pelo Azure Data Factory.
Fábrica de dados do Azure
O Azure Data Factory se conecta ao Banco de Dados SQL como um serviço vinculado. Ele executa as atividades
de procedimento armazenado que processa os dados e os armazena nas tabelas de análise.
Banco de dados SQL do Azure
Essas tabelas são criadas automaticamente para popular os relatórios padrão. Explore esses esquemas no Power
BI e será possível criar suas próprias visualizações nesses dados.
NOME DA TABELA
[analytics].[Measurements]
[analytics].[Messages]
[stage].[Measurements]
[analytics].[Properties]
[analytics].[PropertyDefinitions]
[analytics].[MeasurementDefinitions]
[analytics].[Devices]
[analytics].[DeviceTemplates]
[dbo].[date]
[dbo].[ChangeTracking]
Custos estimados
Confira uma estimativa dos custos do Azure (Azure Functions, Data Factory, Azure SQL ) envolvidos. Todos os
preços estão em dólares. Tenha em mente que os preços variam por região, portanto, você sempre deve pesquisar
os preços mais recentes dos serviços individuais para ver os preços reais. Os padrões a seguir são definidos para
você no modelo (é possível modificar qualquer um deles após a configuração):
Azure Functions: plano do serviço de aplicativo S1, $74.40/mês
Azure SQL S1, cerca de US$ 30/mês
Incentivamos você a saber mais sobre as várias opções de preços e se ajustar às coisas para se adequar às suas
necessidades.
Implante
Acesse o AppSource para obter a Solução do Power BI para Azure IoT Central.
Próximos passos
Agora que você aprendeu a visualizar seus dados no Power BI, aqui está o próximo passo sugerido:
Como gerenciar dispositivos
Compilar a ponte de dispositivo do IoT Central para
conectar outras nuvens de IoT ao IoT Central

A ponte de dispositivo do IoT Central é uma solução de software livre que conecta o Sigfox, Particle, The Things
Network e outras nuvens ao aplicativo IoT Central. Se você estiver usando dispositivos de rastreamento de ativos
conectados à Rede de Longa Distância de baixo consumo de energia da Sigfox, usando dispositivos de
monitoramento da qualidade do ar no Particle Device Cloud ou, usando dispositivos de monitoramento de
umidade do solo no TTN, você poderá aproveitar diretamente a potência do IoT Central usando a ponte de
dispositivo do IoT Central. A ponte de dispositivo conecta outras nuvens de IoT com o IoT Central, enviando os
dados que os dispositivos enviam para outras nuvens até o aplicativo IoT Central. No aplicativo IoT Central, é
possível compilar regras e executar análises nesses dados, criar fluxos de trabalho no Microsoft Flow e Aplicativos
Lógicos do Azure, exportar esses dados, e muito mais. Obter a ponte de dispositivo do IoT Central do GitHub
O que é e como funciona?

A ponte de dispositivo do IoT Central é uma solução de software livre no GitHub. Ela está pronta para ser usada
com o botão "Implantar no Azure", que implanta um modelo personalizado do Azure Resource Manager com
vários recursos do Azure na sua assinatura do Azure. Os recursos incluem:
Aplicativo Azure Functions
Conta de Armazenamento do Azure
Plano de consumo
Azure Key Vault
O aplicativo de funções é a parte crucial da ponte do dispositivo. Ele recebe solicitações HTTP POST de outras
plataformas de IoT ou de qualquer plataforma personalizada por meio de uma integração de webhook simples.
Nós fornecemos exemplos que mostram como conectar as nuvens Sigfox, Particle e TTN. É possível estender
facilmente essa solução para conectar-se à sua nuvem de IoT personalizada, caso sua plataforma possa enviar
solicitações de HTTP POST ao aplicativo de funções. O aplicativo de funções transforma os dados em um formato
aceito pelo IoT Central e os encaminha via APIs de DPS.
Se o aplicativo IoT Central reconhecer o dispositivo por ID de dispositivo na mensagem encaminhada, uma nova
medida será exibida para esse dispositivo. Se a ID do dispositivo nunca for verificada pelo aplicativo IoT Central, o
aplicativo de funções tentará registrar um novo dispositivo com essa ID do dispositivo e ele aparecerá como um
"Dispositivo não associado" no aplicativo IoT Central.
Como fazer para configurar?

As instruções estão listadas em detalhes no arquivo LEIAME no repositório do GitHub.
Preços
Os recursos do Azure serão hospedados em sua assinatura do Azure. Obtenha mais informações sobre preços no
aquivo LEIAME.
Próximos passos
Agora que você aprendeu como compilar a ponte de dispositivo do IoT Central, a seguir está a próxima etapa
sugerida:
Gerenciar seu aplicativo IoT Central
NOTE
Este artigo descreve como, como administrador, você pode gerenciar o aplicativo alterando o nome e a URL
do aplicativo, carregando a imagem, também pode aprender a copiar e excluir um aplicativo no aplicativo IoT
Central do Azure.
Para acessar e usar a seção Administração, você deve estar na função Administrador no aplicativo Azure
IoT Central. Se você criar um aplicativo Azure IoT Central, você será automaticamente atribuído à função
Administrador desse aplicativo.
Alterar o nome do aplicativo e URL

Na página Configurações do aplicativo, você pode alterar o nome e o URL do seu aplicativo e, em seguida,
selecionar Salvar.
Se o administrador criar um tema personalizado para seu aplicativo, essa página incluirá uma opção para
ocultar o nome do aplicativo na interface do usuário. Isso será útil se o logotipo do aplicativo no tema
personalizado incluir o nome do aplicativo. Para obter mais informações, consulte Personalizar a interface do
usuário IOT central do Azure.
NOTE
Se você alterar a URL, a URL antiga poderá ser utilizada por outro cliente do Azure IoT Central. Nesse caso, a URL não
estará mais disponível para você usar. Ao alterar a URL, a URL antiga não funcionará mais e você deverá notificar os
usuários sobre a nova URL a ser utilizada.
Preparar e carregar a imagem

Para alterar a imagem do aplicativo, consulte Preparar e carregar imagens no aplicativo Microsoft IoT Central.
Copiar um aplicativo
É possível criar uma cópia de qualquer aplicativo, menos quaisquer instâncias de dispositivos, histórico de
dados do dispositivo e os dados de usuário. A cópia é um aplicativo pago conforme o uso para o qual você
será cobrado. Você não pode criar um aplicativo de avaliação dessa maneira.
Selecione copiar. Na caixa de diálogo, insira os detalhes do novo aplicativo de pagamento Conforme o Uso.
Em seguida, selecione copiar para confirmar que deseja continuar. Saiba mais sobre os campos deste
formulário em Criar um início rápido de aplicativo.
Depois que a operação de cópia do aplicativo for realizada com sucesso, você poderá navegar para o novo
aplicativo usando o link.
Copiar um aplicativo também copia a definição de regras e a ação de email. Algumas ações como fluxo,
aplicativos lógicos etc. são vinculadas a regras específicas por meio da ID de regra. Quando uma regra é
copiada para um aplicativo diferente, ela obtém sua própria ID de regra. Nesse caso, os usuários terão que
criar uma nova ação e associar a nova regra a ela. Em geral, é uma boa ideia verificar as regras e ações para
certificar-se de que elas estão atualizadas no novo aplicativo.
WARNING
Se um painel inclui blocos que exibem informações sobre dispositivos específicos, esses blocos mostram que o recurso
solicitado não foi encontrado no novo aplicativo. Você deve reconfigurar esses blocos para exibir informações sobre
dispositivos em seu novo aplicativo.
Excluir um aplicativo
Use o botão Excluir para excluir permanentemente seu aplicativo IoT Central. Essa ação exclui
permanentemente todos os dados associados ao aplicativo.
NOTE
Para excluir um aplicativo, você também deve ter as permissões para excluir recursos da assinatura do Azure escolhida
ao criar o aplicativo. Para saber mais, confira Usar o controle de acesso baseado em função para gerenciar o acesso aos
recursos de sua assinatura do Azure.
Gerenciar programaticamente
Os pacotes do SDK do IoT Central Azure Resource Manager estão disponíveis para Node, Python, C#, Ruby,
Java e Go. Você pode usar esses pacotes para criar, listar, atualizar ou excluir aplicativos IoT Central.Os
pacotes incluem auxiliares para gerenciar a autenticação e o tratamento de erros.
Veja exemplos de como usar os SDKs do Azure Resource Manager em
https://github.com/emgarten/iotcentral-arm-sdk-examples.
Para saber mais, confira os seguintes repositórios e pacotes do GitHub:
IDIOMA REPOSITÓRIO PACOTE
Nó https://github.com/Azure/azure-sdk- https://www.npmjs.com/package/azure
for-node -arm-iotcentral
Python https://github.com/Azure/azure-sdk- https://pypi.org/project/azure-mgmt-

for-python iotcentral
C# https://github.com/Azure/azure-sdk- https://www.nuget.org/packages/Micr
for-net osoft.Azure.Management.IotCentral
Ruby https://github.com/Azure/azure-sdk- https://rubygems.org/gems/azure_mg

for-ruby mt_iot_central
Java https://github.com/Azure/azure-sdk- https://search.maven.org/search?

for-java q=a:azure-mgmt-iotcentral
Go https://github.com/Azure/azure-sdk- https://github.com/Azure/azure-sdk-
for-go for-go
Próximos passos
Agora que você aprendeu sobre como administrar seu aplicativo de IoT Central do Azure, a próxima etapa
sugerida é aprender a gerenciar usuários e funções no Azure IOT central.
Gerenciar usuários e funções em seu aplicativo IoT
Central
Este artigo descreve como, como administrador, você pode adicionar, editar e excluir usuários em seu aplicativo de
IoT Central do Azure e também como gerenciar funções em seu aplicativo de IoT Central do Azure.
Para acessar e usar a seção Administração, você deve estar na função Administrador no aplicativo Azure IoT
Central. Se você criar um aplicativo Azure IoT Central, você será automaticamente atribuído à função
Adicionar usuários
Cada usuário deve ter uma conta de usuário antes de poder entrar e acessar um aplicativo Azure IoT Central. As
MSAs (Contas Microsoft) e contas do Azure AD (Azure Active Directory) têm suporte no Azure IoT Central.
Atualmente, os grupos do Azure Active Directory não têm suporte no Azure IoT Central.
Para saber mais, confira a Ajuda da Conta Microsoft e o Início Rápido: Adicionar novos usuários ao Azure Active
Directory.
1. Para adicionar um usuário a um aplicativo IoT Central, acesse a página Usuários na seção Administração.
2. Na página Usuários, escolha + Adicionar usuário para adicionar um usuário.

3. Escolha uma função para o usuário na lista suspensa Função. Saiba mais sobre as funções na seção
Gerenciar funções deste artigo.
NOTE
Para adicionar usuários em massa, insira as IDs de usuário de todos os usuários que você deseja adicionar separados
por ponto e vírgula. Escolha uma função na lista suspensa Função. Em seguida, selecione Salvar.
Editar as funções atribuídas aos usuários

As funções não podem ser alteradas após serem atribuídas. Para alterar a função atribuída a um usuário, exclua o
usuário e adicione-o novamente com uma função diferente.
NOTE
As funções atribuídas são específicas para IoT Central aplicativo e não podem ser gerenciadas no portal do Azure.
Excluir usuários
Para excluir usuários, marque uma ou mais caixas de seleção na página Usuários. Em seguida, selecione Excluir.
Gerenciar funções
As funções permitem controlar quem na sua organização pode executar várias tarefas na IoT Central. Existem três
funções que você pode atribuir aos usuários do seu aplicativo.
Administrador
Os usuários na função administrador tem acesso a toda a funcionalidade em um aplicativo.
O usuário que cria um aplicativo é automaticamente designado à função Administrador. Sempre deverá haver
pelo menos um usuário na função Administrador.
Construtor de Aplicativos
Os usuários na função Application Builder podem fazer tudo em um aplicativo, exceto administrar o aplicativo.
Os criadores podem criar, editar e excluir modelos de dispositivo e dispositivos, gerenciar conjuntos de
dispositivos e executar análises e trabalhos. Os desenvolvedores não terão acesso à seção Administração do
aplicativo.
Operador de Aplicativos
Os usuários na função Application Operator não podem fazer alterações nos modelos de dispositivo e não
podem administrar o aplicativo. Os operadores podem adicionar e excluir dispositivos, gerenciar conjuntos de
dispositivos e executar análises e trabalhos. Os operadores não terão acesso às páginas Application Builder e
Administration.
Próximos passos
Agora que você aprendeu sobre como gerenciar usuários e funções em sua IoT Central do Azure, a próxima etapa
sugerida é saber mais sobre como exibir sua fatura no Azure IOT central.
Exibir sua fatura no aplicativo IoT Central
Este artigo descreve como, como administrador, você pode exibir sua fatura no aplicativo IoT Central do Azure na
seção Administração e também como você pode converter sua versão de avaliação para pré-pago.
Para acessar e usar a seção Administração, você deve estar na função Administrador no aplicativo Azure IoT
Central. Se você criar um aplicativo Azure IoT Central, você será automaticamente atribuído à função
Exibir a fatura
Para exibir a fatura, vá até a página Cobrança na seção Administração. A página de cobrança do Azure abrirá em
uma nova guia e você poderá exibir a fatura de cada um dos aplicativos do Azure IoT Central.
Converter sua avaliação para pago pelo uso

Os aplicativos de avaliação são gratuitos por sete dias antes de expirarem. Eles podem ser convertidos em
Pagamento Conforme o Uso em qualquer momento antes de expirarem.
Os aplicativos pagos conforme o uso são cobrados por dispositivo, com os primeiros cinco dispositivos
gratuitos, por assinatura.
Saiba mais sobre os preços na página de preços do Azure IoT Central.
Na seção de cobrança, você pode converter seus aplicativos de avaliação em pré-pago.
Para concluir esse processo de autoatendimento, execute estas etapas:
1. Vá para a página Faturamento na seção Administração.
2. Selecione converter para pago conforme o uso.

3. Selecione o Microsoft Azure Active Directory apropriado do Azure e, em seguida, a assinatura do Azure a
ser usada em seu aplicativo Pagamento Conforme o Uso.
4. Depois de selecionar converter, seu aplicativo agora é um aplicativo pago conforme o uso e você começa a
ser cobrado.
Próximos passos
Agora que você aprendeu sobre como exibir sua fatura no aplicativo IoT Central do Azure, a próxima etapa
sugerida é saber mais sobre como Personalizar a interface do usuário do aplicativo no Azure IOT central.
Personalizar a interface do usuário do IoT Central do
Azure
NOTE
Este artigo descreve como, como administrador, você pode personalizar a interface do usuário do seu aplicativo
aplicando temas personalizados e modificando os links de ajuda para apontar para seus próprios recursos de
ajuda personalizados.
A captura de tela a seguir mostra uma página usando o tema padrão:
A captura de tela a seguir mostra uma página usando uma captura de tela personalizada com os elementos de
interface do usuário personalizados realçados:
Criar tema
Para criar um tema personalizado, navegue até a página personalizar seu aplicativo na seção Administração :
Nesta página, você pode personalizar os seguintes aspectos do seu aplicativo:
Logotipo do aplicativo
Uma imagem PNG, não maior que 1 MB, com um plano de fundo transparente. Este logotipo é exibido à
esquerda na barra de título do aplicativo IoT Central.
Se a sua imagem de logotipo incluir o nome do seu aplicativo, você poderá ocultar o texto do nome do aplicativo.
Para obter mais informações, consulte gerenciar seu aplicativo.
Ícone do navegador (favicon)
Uma imagem PNG, não maior que 32 x 32 pixels, com um plano de fundo transparente. Um navegador da Web
pode usar essa imagem na barra de endereços, no histórico, nos indicadores e na guia navegador.
Cores do navegador
Você pode alterar a cor do cabeçalho da página e a cor usada para botões de acentuação e outros destaques. Use
um valor de cor hexadecimal de seis caracteres no formato ##ff6347 . Para obter mais informações sobre
notação de cor de valor hexadecimal , consulte cores HTML.
NOTE
Você sempre pode reverter para as opções padrão na página personalizar seu aplicativo .
Alterações de operadores
Se um administrador criar um tema personalizado, os operadores e outros usuários do seu aplicativo não
poderão mais escolher um tema nas configurações.
Substituir links da ajuda

Para fornecer informações de ajuda personalizadas para seus operadores e outros usuários, você pode modificar
os links no menu ajuda do aplicativo.
Para modificar os links da ajuda, navegue até a página Personalizar ajuda na seção Administração :
Você também pode adicionar novas entradas ao menu ajuda e remover as entradas padrão:
NOTE
Você sempre pode reverter para os links de ajuda padrão na página Personalizar ajuda .
Próximos passos
Agora que você aprendeu como personalizar a interface do usuário em seu aplicativo IoT Central, aqui estão
algumas próximas etapas sugeridas:
Administrar o aplicativo
Adicionar blocos ao seu painel
Preparar e carregar imagens para o aplicativo Azure
IoT Central
Este artigo descreve como, um construtor, você pode personalizar o aplicativo Central do Microsoft IoT Central
fazendo o upload de imagens personalizadas. Por exemplo, é possível personalizar um painel do dispositivo com
uma imagem do dispositivo.
Antes de começar
1. Um aplicativo Azure IoT Central. Para obter mais informações, consulte criar um início rápido de aplicativo.
2. Uma ferramenta para dimensionar e redimensionar arquivos de imagens.
Escolher onde usar imagens personalizadas

É possível adicionar imagens personalizadas aos seguintes locais em um aplicativo Azure IoT Central:
A página meus aplicativos
O painel do aplicativo
Modelo de dispositivo
Bloco em um painel do dispositivo

Um bloco em um painel de conjunto de dispositivos
Preparar as imagens
Nos quatro locais, é possível usar imagens PNG, GIF ou JPEG.
A tabela a seguir resume os tamanhos de imagem que podem ser utilizados:
LOCATION TAMANHOS
Gerenciador de aplicativos 268x160 px
Modelo de dispositivo 64x64 px

LOCATION TAMANHOS
Blocos de painel O bloco de tamanho menor é 200x200 px, os blocos maiores

podem ser múltiplos retangulares ou quadrados de blocos
pequenos. Por exemplo 200x400 px, 400x200 px ou 400x400
px
Para a melhor exibição no aplicativo, é necessário criar imagens que correspondam às dimensões mostradas na
tabela anterior.
Carregar as imagens
As seções a seguir descrevem como fazer o upload das imagens nos diferentes locais:
Gerenciador de Aplicativos
Para carregar uma imagem a ser usada na página meus aplicativos , navegue até a página configurações do
aplicativo na seção Administração . Você deve ser um administrador para concluir essa tarefa:
Selecione o bloco imagem do aplicativo para carregar uma imagem (268x160 px) do computador local.
Painel do aplicativo
Para carregar uma imagem no painel do aplicativo, navegue até a página painel do seu aplicativo e selecione
Editar. Você deve ser um construtor para concluir essa tarefa:
Em Configurar imagem, selecione o bloco imagem para carregar uma imagem do computador local. O bloco
de tamanho menor é 200x200 px, os blocos maiores podem ser múltiplos retangulares ou quadrados de blocos
pequenos. Por exemplo, 200 x 400 px, x 200 a 400 px ou 400x400 px.
Salvar a imagem carregada. Você pode redimensioná-la enquanto estiver no modo de edição. Selecione
concluído quando terminar.
Modelo de dispositivo
Para fazer o upload de uma imagem em um modelo de dispositivo, navegue até Modelos de dispositivo e
escolha o modelo. Você deve ser um construtor para concluir essa tarefa:
Selecione o bloco imagem para carregar uma imagem (64 x 64 px) do computador local.
Painel do dispositivo
Para fazer o upload de uma imagem em um dashboard de dispositivo, navegue até Modelos de dispositivo e
escolha o modelo. Em seguida, escolha a guia painel . Você deve ser um construtor para concluir esta tarefa:
Em Configurar imagem, selecione o bloco imagem e, em seguida, escolha o arquivo a ser carregado em seu
computador local. O bloco de tamanho menor é 200x200 px, os blocos maiores podem ser múltiplos
retangulares ou quadrados de blocos pequenos. Por exemplo, 200 x 400 px, x 200 a 400 px ou 400x400 px.
Salvar a imagem carregada. Você pode redimensionar e reposicionar enquanto estiver no modo de edição.
Selecione concluído quando terminar.
Painel do conjunto de dispositivos
Para fazer upload de uma imagem em um painel de conjunto de dispositivos, navegue até Conjuntos de
dispositivos e escolha o conjunto de dispositivos e, em seguida, um dispositivo. Em seguida, escolha a página
painel e selecione Editar:
Em Configurar imagem, selecione o bloco imagem para carregar uma imagem do computador local. O bloco
de tamanho menor é 200x200 px, os blocos maiores podem ser múltiplos retangulares ou quadrados de blocos
pequenos. Por exemplo, 200 x 400 px, x 200 a 400 px ou 400x400 px.
Salvar a imagem carregada. Você pode redimensionar e reposicionar enquanto estiver no modo de edição.
Selecione concluído quando terminar.
Próximos passos
Agora que você aprendeu como preparar e carregar imagens para seu aplicativo IoT Central do Azure, aqui estão
as próximas etapas sugeridas:
Personalizar a interface do usuário do IoT Central do Azure
Gerenciar dispositivos no aplicativo Azure IoT Central
Configurar o painel do aplicativo
O painel é a página que é carregada quando os usuários que têm acesso ao aplicativo navegam até a URL do
aplicativo. Se você criou seu aplicativo a partir de um dos modelos de aplicativo, seu aplicativo terá um painel
predefinido para iniciar. Se você criou seu aplicativo do modelo de aplicativo de aplicativo herdado , seu painel
ficará em branco para iniciar.
NOTE
Os usuários podem criar vários painéis além do painel de aplicativo padrão. Esses painéis podem ser pessoais somente para
o usuário ou compartilhados entre todos os usuários do aplicativo.
Adicionar blocos
A captura de tela a seguir mostra o painel em um aplicativo criado a partir do modelo de aplicativo
personalizado . Para personalizar o painel padrão para seu aplicativo, selecione Editar na parte superior
esquerda da página.
A seleção de Editar abre o painel Biblioteca de painéis. A biblioteca contém os blocos e os primitivos de painel
que você pode usar para personalizar o painel.
de biblioteca do painel
Por exemplo, você pode adicionar um bloco de telemetria para a temperatura atual do dispositivo. Para fazer
isso:
1. Selecionar um modelo de dispositivo
2. Selecione uma instância de dispositivo para o dispositivo que você deseja ver em um bloco do Dashboard.
Em seguida, você verá uma lista das propriedades do dispositivo que podem ser usadas no bloco.
3. Para criar o bloco no painel, clique em temperatura e arraste-o para a área painel. Você também pode clicar
na caixa de seleção ao lado de temperatura e clicar em combinar. A captura de tela a seguir mostra a seleção
de um modelo de dispositivo e uma instância de dispositivo, criando um bloco de telemetria de temperatura
no painel.
4. Selecione salvar na parte superior esquerda para salvar o bloco no painel.
Agora, quando um operador exibir o painel de aplicativo padrão, ele verá o novo bloco com a temperatura para
o dispositivo. Cada bloco tem um gráfico pré-selecionado, um gráfico, etc. que será exibido quando o bloco for
criado. No entanto, os usuários podem optar por editar e alterar essa visualização.
Editar blocos
Para editar um bloco no painel, primeiro clique em Editar na parte superior esquerda da página, que abrirá o
modo de edição para o painel e todos os seus blocos.
tela do painel de
Em seguida, clique no ícone de engrenagem no canto superior direito do bloco que você deseja editar. Aqui você
pode editar aspectos do bloco, incluindo seu título, sua visualização, agregação, etc.
Lista suspensa de
Você também pode alterar a visualização do gráfico clicando no ícone de régua no bloco.
Tipos de bloco
A tabela a seguir resume o uso de blocos no Azure IoT Central:
BLOCO PAINEL DESCRIPTION
Conteúdo Painéis de conjunto de aplicativos e Os blocos com suporte de redução são

dispositivos blocos clicáveis que exibem texto de
título e descrição. Você também pode
usar esse bloco como um bloco de link
para permitir que um usuário navegue
para uma URL relacionada ao seu
aplicativo.
Imagem Painéis de conjunto de aplicativos e Os blocos de imagem exibem uma

dispositivos imagem personalizada e podem ser
clicáveis. Use um bloco de imagem para
adicionar elementos gráficos a um
painel e, opcionalmente, permitir que
um usuário navegue para uma URL
relevante para seu aplicativo.
Rótulo Painéis de aplicativo Blocos de rótulo exibem texto

personalizado em um painel. Você pode
escolher o tamanho do texto. Use um
bloco de rótulo para adicionar
informações relevantes ao painel, tais
descrições, detalhes de contato ou
ajuda.
Mapeamento Painéis de conjunto de aplicativos e Os blocos de mapa exibem o local e o

dispositivos estado de um dispositivo em um mapa.
Por exemplo, você pode exibir onde
está um dispositivo e se o ventilador
está ligado.
Gráfico de linhas Painéis de aplicativo e dispositivo Os blocos de gráfico de linhas exibem

um gráfico de medida de agregação
para um dispositivo por um período de
tempo. Por exemplo, você pode exibir
um gráfico de linhas que mostra a
temperatura média e a pressão de um
dispositivo na última hora.
Gráfico de Barras Painéis de aplicativo e dispositivo Os blocos de gráfico de barras exibem

um gráfico de medidas agregadas para
um dispositivo por um período de
um gráfico de barras que mostra a
temperatura média e a pressão de um
dispositivo na última hora.
Gráfico de pizza Painéis de conjunto de aplicativos e Os blocos de gráfico de pizza exibem

dispositivos um gráfico de medidas agregadas para
tempo.
Mapa de Calor Painéis de conjunto de aplicativos e Os blocos de mapa de calor exibem

dispositivos informações sobre o conjunto de
dispositivos, representadas como cores.
Histórico de Eventos Painéis de aplicativo e dispositivo Os blocos de histórico de eventos

exibem os eventos de um dispositivo
durante um período de tempo. Por
exemplo, você pode usá-lo para
mostrar todas as alterações de
temperatura de um dispositivo durante
a última hora.
Histórico de Estado Painéis de aplicativo e dispositivo Blocos de histórico de estado exibem os

valores de medida para um período de
tempo. Por exemplo, você pode usá-lo
para mostrar os valores de temperatura
de um dispositivo durante a última
hora.
KPI Painéis de aplicativo e dispositivo Os blocos de KPI exibem uma

telemetria agregada ou uma medida de
evento para um período de tempo. Por
exemplo, você pode usá-lo para
mostrar a temperatura máxima atingida
para um dispositivo durante a última
hora.
Último Valor Conhecido Painéis de aplicativo e dispositivo Os últimos blocos de valor conhecidos
exibem o valor mais recente de uma
medição de telemetria ou estado. Por
exemplo, você pode usar esse bloco
para exibir as medidas mais recentes de
temperatura, pressão e umidade de um
dispositivo.
Próximos passos
Agora que você aprendeu como configurar seu painel de aplicativo padrão do Azure IoT Central, você pode
aprender a preparar e carregar imagens.
Como usar blocos
Você pode usar blocos para personalizar painéis de aplicativo, painéis de dispositivos e painéis de conjunto de
dispositivos. Você pode adicionar vários blocos a um painel e personalizar esses blocos para mostrar informações
relevantes ao seu aplicativo. Você também pode redimensionar blocos e personalizar o layout em qualquer painel.
A captura de tela abaixo mostra o painel do aplicativo com blocos diferentes.
A tabela a seguir resume o uso de blocos no Azure IoT Central:
BLOCO PAINEL DESCRIÇÃO
Link Painéis de conjunto de aplicativos e Os blocos de link são blocos clicáveis

dispositivos que exibem o texto de título e
descrição. Use um bloco de link para
permitir que um usuário navegue para
uma URL relacionada ao seu aplicativo.
Imagem Painéis de conjunto de aplicativos e Os blocos de imagem exibem uma

dispositivos imagem personalizada e podem ser
clicáveis. Use um bloco de imagem para
adicionar elementos gráficos a um
painel e, opcionalmente, permitir que
um usuário navegue até uma URL
relevante para seu aplicativo.
Rótulo Painéis de aplicativo Blocos de rótulo exibem texto

personalizado em um painel. Você pode
escolher o tamanho do texto. Use um
bloco de rótulo para adicionar
informações relevantes ao painel, tais
descrições, detalhes de contato ou
ajuda
Mapa Painéis de conjunto de aplicativos e Os blocos de mapa exibem o local e o

dispositivos estado de um dispositivo em um mapa.
Por exemplo, você pode exibir onde
está um dispositivo e se o ventilador
está ligado.
Gráfico de linhas Painéis de aplicativo e dispositivo Os blocos de gráfico de linhas exibem

um gráfico de medida de agregação
para um dispositivo por um período de
um gráfico de linhas que mostra a
temperatura média e a pressão em um
dispositivo na última hora
Gráfico de Barras Painéis de aplicativo e dispositivo Os blocos de gráfico de barras exibem

um gráfico de medidas agregadas para
um gráfico de barras que mostra a
temperatura média e a pressão em um
dispositivo na última hora
Histórico de eventos Painéis de aplicativo e dispositivo Bloco do histórico de eventos exibe os

eventos de um dispositivo durante um
período de tempo. Por exemplo, você
pode usá-lo para mostrar todas as
alterações de temperatura ocorridas
para um dispositivo durante a última
hora.
Histórico de Estado Painéis de aplicativo e dispositivo Bloco do histórico de estado exibe os

valores de medida para um período de
tempo. Por exemplo, você pode usá-lo
para mostrar os valores de temperatura
de um dispositivo durante a última
hora.
KPI Painéis de aplicativo e dispositivo Bloco de KPI exibe uma telemetria

agregada ou medida de evento para
um período de tempo. Por exemplo,
você pode usá-lo para mostrar a
temperatura máxima atingida para um
dispositivo durante a última hora.
Último valor conhecido Painéis de aplicativo e dispositivo O último bloco de valor conhecido
exibe o valor mais recente para uma
medição de telemetria ou estado. Por
exemplo, você pode usar esse bloco
para exibir as medidas mais recentes de
temperatura, pressão e umidade de um
dispositivo.
Grade de conjunto de dispositivos Painéis de conjunto de aplicativos e A grade conjunto de dispositivos exibe
dispositivos informações sobre o conjunto de
dispositivos. Use um bloco de grade de
conjunto de dispositivos para mostrar
informações como nome, local e
modelo de todos os dispositivos no
conjunto de dispositivos.
Para saber mais sobre como configurar o painel em seu aplicativo de IoT Central do Azure, confira Adicionar
blocos ao seu painel.
Use modelos de aplicativo
NOTE
Este artigo descreve como, como um Gerenciador de soluções, criar e usar modelos de aplicativos.
Ao criar um aplicativo de IoT Central do Azure, você tem a opção de modelos de exemplo internos. Você também
pode criar seus próprios modelos de aplicativos de aplicativos IoT Central existentes. Você pode usar seus próprios
modelos de aplicativo ao criar novos aplicativos.
Quando você cria um modelo de aplicativo, ele inclui os seguintes itens de seu aplicativo existente:
O painel do aplicativo padrão, incluindo o layout do painel e todos os blocos que você definiu.
Modelos de dispositivo, incluindo medições, configurações, propriedades, comandos e painel.
Regras. Todas as definições de regra estão incluídas. No entanto, as ações, exceto as ações de email, não são
incluídas.
Conjuntos de dispositivos, incluindo suas condições e painéis.
WARNING
Se um painel inclui blocos que exibem informações sobre dispositivos específicos, esses blocos mostram que o recurso
solicitado não foi encontrado no novo aplicativo. Você deve reconfigurar esses blocos para exibir informações sobre
dispositivos em seu novo aplicativo.
Quando você cria um modelo de aplicativo, ele não inclui os seguintes itens:
Dispositivos
Usuários
Definições de trabalho
Definições de exportação de dados contínuas
Adicione esses itens manualmente a qualquer aplicativo criado a partir de um modelo de aplicativo.
Criar um modelo de aplicativo

Para criar um modelo de aplicativo a partir de um aplicativo de IoT Central existente:
1. Vá para a seção Administração em seu aplicativo.
2. Selecione Exportar modelo de aplicativo.
3. Na página exportar do modelo de aplicativo , insira um nome e uma descrição para o modelo.
4. Selecione o botão Exportar para criar o modelo de aplicativo. Agora você pode copiar o link compartilhável
que permite que alguém crie um novo aplicativo a partir do modelo:
Usar um modelo de aplicativo
Para usar um modelo de aplicativo para criar um novo aplicativo IoT Central, você precisa de um link
compartilhávelcriado anteriormente. Cole o link compartilhável na barra de endereços do navegador. A página
criar um aplicativo é exibida com o modelo de aplicativo personalizado selecionado:
Selecione seu plano de pagamento e preencha os outros campos no formulário. Em seguida, selecione criar para
criar um novo aplicativo IOT central no modelo de aplicativo.
Gerenciar modelos de aplicativos

Na página exportar do modelo de aplicativo , você pode excluir ou atualizar o modelo de aplicativo.
Se você excluir um modelo de aplicativo, não poderá mais usar o link compartilhável gerado anteriormente para
criar novos aplicativos.
Para atualizar o modelo de aplicativo, altere o nome ou a descrição do modelo na página exportar do modelo de
aplicativo . Em seguida, selecione o botão Exportar novamente. Essa ação gera um novo link compartilhável e
invalida qualquer URL de link compartilhável anterior.
Próximos passos
Agora que você aprendeu a usar modelos de aplicativos, a próxima etapa sugerida é aprender a gerenciar IOT
central da portal do Azure
Gerenciar IoT Central do portal do Azure
Em vez de criar e gerenciar aplicativos IoT Central no site do Azure IOT central Application Manager , você pode
usar o portal do Azure para gerenciar seus aplicativos.
Criar aplicativos do IoT Central

Para criar um aplicativo, navegue até a portal do Azure e selecione criar um recurso no painel principal à
esquerda.
Na barra de pesquisa, digite IoT Central.

Selecione a IOT central item de linha de aplicativo nos resultados da pesquisa.
Agora, selecione Criar.
Preencha todos os campos no formulário. Esse formulário é semelhante ao formulário que você preenche para
criar aplicativos no site do Azure IOT central Application Manager . Para obter mais informações, confira o guias
de início rápido Criar um aplicativo do IoT Central.
Você pode criar IoT Central aplicativo com recursos geralmente disponíveis selecionando aplicativo herdado
como modelo de aplicativo, todos os outros modelos de aplicativo usam recursos de visualização pública.
A Localização é a geografia em que você deseja criar seu aplicativo. Normalmente, você deve escolher a
localização fisicamente mais próxima de seus dispositivos para obter um desempenho ideal. No momento, o
Azure IoT Central está disponível nos Estados Unidos, na Austrália, no Pacífico Asiático e na Europa. Depois
de escolher uma localização, você não poderá mover o aplicativo posteriormente para outra localização.
NOTE
Os modelos de aplicativo de visualização atualmente só estão disponíveis nos locais da Europa e Estados Unidos .
Depois de preencher todos os campos, selecione criar.
Gerenciar aplicativos do IoT Central existentes

Se você já tiver um aplicativo do Azure IoT Central, poderá excluí-lo ou movê-lo para uma assinatura ou grupo de
recursos diferente no portal do Azure.
NOTE
Você não pode ver aplicativos de avaliação no portal do Azure porque eles não estão associados com sua assinatura.
Para começar, selecione todos os recursos no painel principal à esquerda. Use a caixa de pesquisa para digitar o
nome do aplicativo para localizá-lo na lista de recursos. Em seguida, selecione o aplicativo IoT Central que você
gostaria de gerenciar.
Para navegar até o aplicativo, selecione a URL do aplicativo IoT Central.
Para mover o aplicativo para um grupo de recursos diferente, selecione alterar ao lado do grupo de recursos. Na
página Mover recursos, escolha o grupo de recursos para o qual você deseja migrar esse aplicativo.
Para mover o aplicativo para uma assinatura diferente, selecione o link alterar ao lado da assinatura. Escolha a
assinatura para a qual você deseja migrar esse aplicativo na caixa de diálogo exibida.
Próximos passos
Agora que você aprendeu a gerenciar os aplicativos do Azure IoT Central no portal do Azure, aqui está a próxima
etapa sugerida:
Gerenciar IoT Central de CLI do Azure
Em vez de criar e gerenciar IoT Central aplicativos no site do Azure IOT central Application Manager , você pode
usar CLI do Azure para gerenciar seus aplicativos.
Pré-requisitos
Usar o Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do
navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É
possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar
nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
OPÇÃO EXEMPLO/LINK
Selecione Experimente no canto superior direito de um bloco

de código. Selecionar Experimente não copia
automaticamente o código para o Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o

Cloud Shell para abri-lo no navegador.
Clique no botão Cloud Shell na barra de menus no canto

superior direito do portal do Azure.
Para executar o código neste artigo no Azure Cloud Shell:

1. Inicie o Cloud Shell.
2. Clique no botão Copiar no bloco de código para copiá-lo.
3. Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou
Cmd+Shift+V no macOS.
4. Pressione Enter para executar o código.
Se preferir executar CLI do Azure em seu computador local, consulte instalar o CLI do Azure. Ao executar CLI do
Azure localmente, use o comando AZ login para entrar no Azure antes de tentar os comandos neste artigo.
Criar um aplicativo
Use o comando AZ iotcentral app Create para criar um aplicativo IOT central em sua assinatura do Azure. Por
exemplo:
# Create a resource group for the IoT Central application
az group create --location "East US" \
--name "MyIoTCentralResourceGroup"
# Create an IoT Central application

az iotcentral app create \
--resource-group "MyIoTCentralResourceGroup" \
--name "myiotcentralapp" --subdomain "mysubdomain" \
--sku S1 --template "iotc-demo@1.0.0" \
--display-name "My Custom Display Name"
Esses comandos primeiro criam um grupo de recursos no local leste dos EUA para o aplicativo. A tabela a seguir
descreve os parâmetros usados com o comando AZ iotcentral app Create :
PARÂMETRO DESCRIPTION
resource-group O grupo de recursos que contém o aplicativo. Esse grupo de

recursos já precisa existir na sua assinatura.
local Por padrão, esse comando usa o local do grupo de recursos.

No momento, você pode criar um aplicativo IoT Central no
Estados Unidos, na austrália, no Pacífico Asiáticoou nos
locais da Europa .
name Digite o nome do aplicativo no portal do Azure.
subdomínio O subdomínio na URL do aplicativo. No exemplo, a URL do

aplicativo é https://mysubdomain.azureiotcentral.com.
sku Atualmente, o único valor é S1 (camada standard). Confira

Preço do Azure IoT Central.
template O modelo de aplicativo a usar. Para obter mais informações,

confira a tabela a seguir:
nome de exibição O nome do aplicativo, conforme exibido na interface do

usuário.
Modelo de aplicativo com recursos disponíveis para o público geral
NOME DO MODELO DESCRIPTION
iotc-default@1.0.0 Cria um aplicativo vazio para você preencher com seus

Modelos de aplicativos com recursos de visualização pública
iotc-pnp-preview@1.0.0 Cria um aplicativo de visualização de plug and Play vazio para

popular com seus próprios dispositivos e modelos de
dispositivo.
iotc-condition@1.0.0 Cria um aplicativo com um modelo de monitoramento de

condição em uma análise na loja. Use este modelo para
conectar e monitorar o ambiente de armazenamento.
iotc-consumption@1.0.0 Cria um aplicativo com o modelo de monitoramento de

consumo de água. Use este modelo para monitorar e
controlar o fluxo de água.
iotc-distribution@1.0.0 Cria um aplicativo com um modelo de distribuição digital. Use

este modelo para melhorar a eficiência da saída do depósito
ao digitalização de ativos e ações de chave.
iotc-inventory@1.0.0 Cria um aplicativo com um modelo de gerenciamento de

inventário inteligente. Use este modelo para automatizar o
recebimento, movimentação de produtos, contagem de ciclos
e acompanhamento de sensores.
iotc-logistics@1.0.0 Cria um aplicativo com um modelo de logística conectado.

Use este modelo para acompanhar sua remessa em tempo
real entre ar, água e terreno com monitoramento de local e
condição.
iotc-meter@1.0.0 Cria um aplicativo com o modelo de monitoramento do

medidor inteligente. Use este modelo para monitorar o
consumo de energia, o status da rede e identificar as
tendências para melhorar o atendimento ao cliente e o
gerenciamento de medidor inteligente.
iotc-patient@1.0.0 Cria um aplicativo com o modelo de monitoramento contínuo

do paciente. Use este modelo para estender o atendimento ao
paciente, renovações e gerenciar doenças.
iotc-power@1.0.0 Cria um aplicativo com o modelo de monitoramento de painel

solar. Use este modelo para monitorar o status do painel solar,
as tendências de geração de energia.
iotc-quality@1.0.0 Cria um aplicativo com o modelo de monitoramento de

qualidade de água. Use este modelo para monitorar
digitalmente a qualidade da água.
iotc-store@1.0.0 Cria um aplicativo com um modelo de check-out de análise no

repositório. Use este modelo para monitorar e gerenciar o
fluxo de check-out dentro de seu repositório.
iotc-waste@1.0.0 Cria um aplicativo com um modelo de gerenciamento de

resíduos conectado. Use este modelo para monitorar os
operadores de lixo e de campo de expedição.
NOTE
Exibir seus aplicativos

Use o comando AZ iotcentral app List para listar seus aplicativos IOT central e exibir metadados.
Modificar um aplicativo
Use o comando AZ iotcentral app Update para atualizar os metadados de um aplicativo IOT central. Por exemplo,
para alterar o nome de exibição do aplicativo:
az iotcentral app update --name myiotcentralapp \

--resource-group MyIoTCentralResourceGroup \
--set displayName="My new display name"
Remover um aplicativo
Use o comando AZ iotcentral app Delete para excluir um aplicativo IOT central. Por exemplo:
az iotcentral app delete --name myiotcentralapp \

--resource-group MyIoTCentralResourceGroup
Próximos passos
Agora que você aprendeu a gerenciar os aplicativos do Azure IoT Central do CLI do Azure, aqui está a próxima
etapa sugerida:
Gerenciar o IoT Central do Azure PowerShell
Em vez de criar e gerenciar IoT Central aplicativos no site do Azure IOT central Application Manager , você pode
usar Azure PowerShell para gerenciar seus aplicativos.
Pré-requisitos
Usar o Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do
navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É
possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar
nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
OPÇÃO EXEMPLO/LINK
Selecione Experimente no canto superior direito de um bloco

de código. Selecionar Experimente não copia
automaticamente o código para o Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o

Cloud Shell para abri-lo no navegador.
Clique no botão Cloud Shell na barra de menus no canto

superior direito do portal do Azure.
Para executar o código neste artigo no Azure Cloud Shell:

1. Inicie o Cloud Shell.
2. Clique no botão Copiar no bloco de código para copiá-lo.
3. Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou
Cmd+Shift+V no macOS.
4. Pressione Enter para executar o código.
Se você preferir executar o Azure PowerShell em seu computador local, confira Instalar o módulo do Azure
PowerShell. Quando você executar o Azure PowerShell localmente, use o cmdlet AzAccount Connect para
entrar antes de experimentar os cmdlets neste artigo.
Instalar o módulo do IoT Central

Execute o seguinte comando para verificar se o módulo do IoT Central está instalado em seu ambiente do
PowerShell:
Get-InstalledModule -name Az.I*
Se a lista de módulos instalados não incluir Az.IotCentral, execute o seguinte comando:
Install-Module Az.IotCentral
Criar um aplicativo
Use o cmdlet New -AzIotCentralApp para criar um aplicativo do IoT Central na sua assinatura do Azure. Por
exemplo:
# Create a resource group for the IoT Central application

New-AzResourceGroup -ResourceGroupName "MyIoTCentralResourceGroup" `
-Location "East US"
# Create an IoT Central application

New-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `
-Name "myiotcentralapp" -Subdomain "mysubdomain" `
-Sku "S1" -Template "iotc-demo@1.0.0" `
-DisplayName "My Custom Display Name"
O script cria primeiro um grupo de recursos no local leste dos EUA para o aplicativo. A tabela a seguir descreve os
parâmetros usados com o comando New-AzIotCentralApp:
PARÂMETRO DESCRIPTION
ResourceGroupName O grupo de recursos que contém o aplicativo. Esse grupo de

recursos já precisa existir na sua assinatura.
Local Por padrão, esse cmdlet usa a localização do grupo de

recursos. No momento, você pode criar um aplicativo IoT
Central no Estados Unidos, na austrália, no Pacífico
Asiáticoou nos locais da Europa .
Nome Digite o nome do aplicativo no portal do Azure.
Subdomínio O subdomínio na URL do aplicativo. No exemplo, a URL do

aplicativo é https://mysubdomain.azureiotcentral.com.
SKU Atualmente, o único valor é S1 (camada standard). Confira

Preço do Azure IoT Central.
Modelo O modelo de aplicativo a usar. Para obter mais informações,

confira a tabela a seguir:
DisplayName O nome do aplicativo, conforme exibido na interface do

usuário.
Modelo de aplicativo com recursos disponíveis para o público geral

iotc-default@1.0.0 Cria um aplicativo vazio para você preencher com seus

Modelos de aplicativos com recursos de visualização pública
iotc-pnp-preview@1.0.0 Cria um aplicativo de visualização de plug and Play vazio para

popular com seus próprios dispositivos e modelos de
dispositivo.
iotc-condition@1.0.0 Cria um aplicativo com um modelo de monitoramento de

condição em uma análise na loja. Use este modelo para
conectar e monitorar o ambiente de armazenamento.
iotc-consumption@1.0.0 Cria um aplicativo com o modelo de monitoramento de

consumo de água. Use este modelo para monitorar e
controlar o fluxo de água.
iotc-distribution@1.0.0 Cria um aplicativo com um modelo de distribuição digital. Use

este modelo para melhorar a eficiência da saída do depósito
ao digitalização de ativos e ações de chave.
iotc-inventory@1.0.0 Cria um aplicativo com um modelo de gerenciamento de

inventário inteligente. Use este modelo para automatizar o
recebimento, movimentação de produtos, contagem de ciclos
e acompanhamento de sensores.
iotc-logistics@1.0.0 Cria um aplicativo com um modelo de logística conectado.

Use este modelo para acompanhar sua remessa em tempo
real entre ar, água e terreno com monitoramento de local e
condição.
iotc-meter@1.0.0 Cria um aplicativo com o modelo de monitoramento do

medidor inteligente. Use este modelo para monitorar o
consumo de energia, o status da rede e identificar as
tendências para melhorar o atendimento ao cliente e o
gerenciamento de medidor inteligente.
iotc-patient@1.0.0 Cria um aplicativo com o modelo de monitoramento contínuo

do paciente. Use este modelo para estender o atendimento ao
paciente, renovações e gerenciar doenças.
iotc-power@1.0.0 Cria um aplicativo com o modelo de monitoramento de painel

solar. Use este modelo para monitorar o status do painel solar,
as tendências de geração de energia.
iotc-quality@1.0.0 Cria um aplicativo com o modelo de monitoramento de

qualidade de água. Use este modelo para monitorar
digitalmente a qualidade da água.
iotc-store@1.0.0 Cria um aplicativo com um modelo de check-out de análise no

repositório. Use este modelo para monitorar e gerenciar o
fluxo de check-out dentro de seu repositório.
iotc-waste@1.0.0 Cria um aplicativo com um modelo de gerenciamento de

resíduos conectado. Use este modelo para monitorar os
operadores de lixo e de campo de expedição.
NOTE
Exibir seus aplicativos do IoT Central

Use o cmdlet Get-AzIotCentralApp para listar seus aplicativos do IoT Central e exibir os metadados.
Modificar um aplicativo
Use o cmdlet AzIotCentralApp conjunto para atualizar os metadados de um aplicativo do IoT Central. Por
exemplo, para alterar o nome de exibição do aplicativo:
Set-AzIotCentralApp -Name "myiotcentralapp" `

-ResourceGroupName "MyIoTCentralResourceGroup" `
-DisplayName "My new display name"
Remover um aplicativo
Use o cmdlet Remove-AzIotCentralApp para excluir um aplicativo do IoT Central. Por exemplo:
Remove-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `

-Name "myiotcentralapp"
Próximos passos
Agora que você aprendeu a gerenciar os aplicativos do Azure IoT Central no Azure PowerShell, aqui está a
próxima etapa sugerida:
Criar e gerenciar um aplicativo de IoT Central do
Azure no portal do CSP
O programa Microsoft CSP (Provedor de Soluções na Nuvem) é um programa de Revendedor da Microsoft. Seu
objetivo é fornecer a nossos parceiros de canal um programa único para revender todos os Serviços Comerciais
Online da Microsoft. Saiba mais sobre o Programa do Fornecedor de Soluções na Nuvem.
Como um CSP, você pode criar e gerenciar aplicativos do Microsoft Azure IoT Central em nome de seus clientes
por meio da Microsoft Partner Center. Quando os aplicativos do Azure IoT Central são criados em nome dos
clientes por CSPs, assim como com outros serviços do Azure gerenciados por CSPs, os CSPs gerenciam a
cobrança para os clientes. Um encargo para o Azure IoT Central aparecerão na sua fatura total no Microsoft
Partner Center.
Para começar, entre em sua conta no Portal de parceiros da Microsoft e selecione um cliente para o qual você
deseja criar um aplicativo do Azure IoT Central. Navegue até gerenciamento de serviços para o cliente na barra de
navegação à esquerda.
O Azure IoT Central está listado como um serviço disponível para administrar. Selecione o link IoT Central do
Azure na página para criar novos aplicativos ou gerenciar aplicativos existentes para esse cliente.
Você é direcionado para a página do Gerenciador de Aplicativos do Azure IoT Central. O Azure IoT Central sabe
que você veio do Microsoft Partner Center e que você veio para gerenciar esse cliente em particular. Você verá isso
confirmado no cabeçalho da página do Gerenciador de Aplicativos. A partir daqui, você pode navegar para um
aplicativo existente que você criou anteriormente para esse cliente gerenciar ou criar um novo aplicativo para o
cliente.
Para criar um aplicativo de IoT Central do Azure, selecione Compilar no menu à esquerda. Escolha um dos
modelos do setor ou escolha aplicativo herdado para criar um aplicativo do zero. Isso carregará a página de
Criação de Aplicativos. Você precisa preencher todos os campos dessa página e, em seguida, escolher Criar. Você
encontrará mais informações sobre cada um desses campos abaixo.
Plano de Pagamento
Você só pode criar aplicativos Pay-As-You-Go como CSP. Para demonstrar o Azure IoT Central para o seu cliente,
você pode criar um aplicativo de avaliação separadamente. Saiba mais sobre os aplicativos Trial e Pay-As-You-Go
na página de preços da Microsoft IoT Central do Azure.
Nome do Aplicativo
O nome do aplicativo é exibido na página Gerenciador de Aplicativos e em cada aplicativo Azure IoT Central. É
possível escolher qualquer nome para o aplicativo Azure IoT Central. Escolha um nome que faça sentido a você e
às outras pessoas na organização.
URL do Aplicativo
A URL do aplicativo é o link para o aplicativo. Você pode salvar um indicador no navegador ou compartilhá-lo com
outras pessoas.
Quando você insere o nome para seu aplicativo, a URL do aplicativo é gerado automaticamente. Se preferir, você
pode escolher uma URL diferente para o aplicativo. Cada URL do Azure IoT Central deverá ser exclusiva dentro do
Azure IoT Central. Se a URL escolhida já tiver sido utilizada, uma mensagem de erro será exibida.
Diretório
Como o Azure IoT Central tem contexto fornecidas para gerenciar o cliente selecionado no Portal de parceiros da
Microsoft, você pode ver apenas o locatário do Azure Active Directory para esse cliente no campo de diretório.
Um locatário do Azure Active Directory contém identidades de usuário, credenciais e outras informações
organizacionais. Várias assinaturas do Azure podem ser associadas a um único locatário do Azure Active Directory.
Para saber mais, consulte Azure Active Directory.
Assinatura do Azure
Uma assinatura do Azure permite que você crie instâncias de serviços do Azure. O Azure IoT Central localiza
automaticamente todas as Assinaturas do Azure do cliente às quais você tem acesso e as exibe em uma lista
suspensa na página Criar Aplicativo. Escolha uma assinatura do Azure para criar um novo aplicativo Azure IoT
Central.
Se você não tiver uma assinatura do Azure, poderá criar uma no Microsoft Partner Center. Após criar a assinatura
do Azure, navegue de volta para a página Criar Aplicativo. A nova assinatura aparece na lista suspensa
Assinatura do Azure.
Para saber mais, consulte Assinaturas do Azure.
Região
Escolha a região ou geografia onde você gostaria de criar seu aplicativo de IOT central do Azure. Normalmente,
você deve escolher a região mais próxima fisicamente em seus dispositivos para obter o desempenho ideal.
NOTE
Para saber mais, confira regiões do Azure e geografias do Azure.

É possível visualizar as regiões nas quais o Azure IoT Central está disponível, na página Produtos disponíveis por
região.
NOTE
Após escolher uma região, não será mais possível mover posteriormente o aplicativo para uma região diferente.
Modelo de aplicativo
Você pode escolher o modelo de aplicativo abaixo para seu novo aplicativo de IoT Central do Azure.
MODELO DE APLICATIVO DESCRIPTION
Aplicativo herdado Cria um aplicativo vazio para você preencher com seus
Próximos passos
Agora que você aprendeu como criar um aplicativo Azure IoT Central como um CSP, a próxima etapa sugerida é
apresentada:
Criar e gerenciar vários dashboards
O painel é a página que carrega quando você navega pela primeira vez para seu aplicativo. Um Construtor em
seu aplicativo define o painel do aplicativo padrão para todos os usuários. Você pode substituir esse painel padrão
por seu próprio painel de aplicativo personalizado. Você pode ter vários painéis que exibem dados diferentes e
alternam entre eles.
Se você for um administrador do aplicativo, também poderá criar até 10 painéis de nível de aplicativo para
compartilhar com outros usuários do aplicativo. Somente os Administradores têm a capacidade de criar, editar e
excluir painéis de nível de aplicativo.
Criar painel
A captura de tela a seguir mostra o painel em um aplicativo criado a partir do modelo de aplicativo
personalizado . Você pode substituir o painel do aplicativo padrão por um painel pessoal, ou se você for um
administrador, outro painel de nível de aplicativo. Para fazer isso, selecione + novo na parte superior esquerda da
página.
Selecionar + novo abre o editor de painel. No editor, você pode dar um nome ao seu painel e escolher itens da
biblioteca. A biblioteca contém os blocos e os primitivos de painel que você pode usar para personalizar o painel.
de biblioteca do painel
Se você for um administrador do aplicativo, terá a opção de alternar se quiser criar um painel de nível pessoal ou
um painel de nível de aplicativo. Se você criar um painel de nível pessoal, apenas você poderá vê-lo. Se você criar
um painel de nível de aplicativo, todos os usuários do aplicativo poderão vê-lo. Depois de inserir um título e
selecionar o tipo de painel que você deseja criar, você pode salvar e adicionar blocos posteriormente. Ou, se você
estiver pronto agora e tiver adicionado um modelo de dispositivo e uma instância de dispositivo, poderá criar seu
primeiro bloco.
formulário
de temperatura
Por exemplo, você pode adicionar um bloco de telemetria para a temperatura atual do dispositivo. Para fazer
isso:
1. Selecionar um modelo de dispositivo
2. Selecione uma instância de dispositivo para o dispositivo que você deseja ver em um bloco do Dashboard.
Em seguida, você verá uma lista das propriedades do dispositivo que podem ser usadas no bloco.
3. Para criar o bloco no painel, clique em temperatura e arraste-o para a área painel. Você também pode clicar
na caixa de seleção ao lado de temperatura e clicar em combinar. A captura de tela a seguir mostra a seleção
de um modelo de dispositivo e uma instância de dispositivo, criando um bloco de telemetria de temperatura
no painel.
4. Selecione salvar na parte superior esquerda para salvar o bloco no painel.
guia
Agora, quando você exibir seu painel pessoal, verá o novo bloco com a configuração de temperatura para o
dispositivo:
guia
Você pode explorar outros tipos de bloco na biblioteca para descobrir como personalizar ainda mais seus painéis
pessoais.
Para saber mais sobre como usar blocos no Azure IoT Central, confira Adicionar blocos ao seu painel.
Gerenciar painéis
Você pode ter vários painéis pessoais e alternar entre eles ou escolher um dos painéis de aplicativo padrão:
Você pode editar seus painéis pessoais e excluir os painéis que não são mais necessários. Se você for um
administrador, também terá a capacidade de editar ou excluir painéis de nível de aplicativo também.
Próximos passos
Agora que você aprendeu como criar e gerenciar painéis pessoais, você pode aprender a gerenciar suas
preferências de aplicativo
Gerenciar suas preferências de aplicativo pessoal

O IoT Central fornece a flexibilidade para personalizar seus aplicativos de acordo com suas necessidades. Nós
também fornecemos alguma flexibilidade em uma base por usuário para personalizar sua própria exibição. Este
artigo descreve as várias opções de personalização que um usuário pode aplicar ao seu perfil.
Alterar idioma
Há suporte para IoT Central em vários idiomas. Você pode alternar o idioma preferencial usando o seletor de
idioma no ícone de configurações na barra de navegação superior. Depois de alterar seu idioma, IoT Central
lembra sua seleção e a aplica em todos os seus aplicativos. A personalização dentro do aplicativo, tais imagens do
painel, não estão localizadas.
Alterando o tema
Temos suporte para o tema escuro e o tema claro. Embora o tema claro seja o padrão, você pode alterar o tema
selecionando o ícone de configurações na barra de navegação superior.
NOTE
A opção de escolher entre os temas claro e escuro não estará disponível se o administrador tiver configurado um tema
personalizado para o aplicativo.
Próximas etapas
Agora que você aprendeu como gerenciar seu perfil no Azure IoT Central, veja a próxima etapa sugerida:
Este artigo de instruções mostra como alternar o chat ao vivo em seu aplicativo IoT Central. Você pode usar o chat
ao vivo para acessar o suporte técnico.
NOTE
A opção de chat está disponível somente para assinaturas de avaliação.
Converse conosco no chat

Para obter suporte técnico, abra o aplicativo IoT Central e selecione conversar conosco.
Você pode digitar uma pergunta, conforme mostrado na seguinte captura de tela:
Ocultar o chat
Para ocultar o chat, escolha ocultar chat no painel de ajuda :
Habilitar o chat
Para mostrar o chat, escolha Mostrar chat no painel de ajuda :
Próximas etapas
Agora que você aprendeu a ativar o chat ao vivo no Azure IoT Central, aqui está a próxima etapa sugerida:
Resumo dos recursos de solicitação de dados do
cliente
O Azure IoT Central é uma solução de software como serviço de IoT (Internet das Coisas) totalmente gerenciada
que facilita a conexão, o monitoramento, o gerenciamento de seus ativos de IoT em escala e a criação de insights
detalhados com base nos dados de IoT, possibilitando que você tome decisões informadas.
NOTE
Este artigo mostra as etapas de como excluir dados pessoais do dispositivo ou serviço e pode ser usado para dar suporte às
suas obrigações de acordo com o GDPR. Se você estiver buscando informações gerais sobre o GDPR, confira a Seção do
GDPR do portal de Confiança do Serviço.
Identificando os dados do cliente

As IDs de Objeto do Azure Active Directory são usadas para identificar usuários e atribuir funções. O portal do
Azure IoT Central exibe os endereços de email do usuário para as atribuições de função, mas apenas a ID de
Objeto do Azure Active Directory é armazenada; o endereço de email é consultado dinamicamente por meio do
Azure Active Directory. Os administradores do Azure IoT Central podem exibir, exportar e excluir os usuários do
aplicativo na seção de administração do usuário de um aplicativo do Azure IoT Central.
No aplicativo, os endereços de email podem ser configurados para receber alertas. Nesse caso, os endereços de
email são armazenados no IoT Central e precisam ser gerenciados na página de administração de conta no
aplicativo.
Com relação aos dispositivos, a Microsoft não mantém nenhuma informação e não tem acesso aos dados que
permitem a correlação entre dispositivos e usuários. Muitos dos dispositivos gerenciados no Azure IoT Central não
são dispositivos pessoais, por exemplo, uma máquina de vendas ou uma cafeteira elétrica. No entanto, os clientes
podem considerar que alguns dispositivos contêm informações de identificação pessoal e, a seu critério, manter
seus próprios sistemas de acompanhamento de ativos ou inventário que vinculam dispositivos a indivíduos. O
Azure IoT Central gerencia e armazena todos os dados associados a dispositivos como se fossem dados pessoais.
Quando você usa os serviços corporativos da Microsoft, a Microsoft gera algumas informações, conhecidas como
logs gerados pelo sistema. Esses logs constituem ações reais conduzidas no serviço e dados de diagnóstico
relacionados a dispositivos individuais e não estão relacionados à atividade do usuário. Os logs gerados pelo
sistema do Azure IoT Central não são acessíveis nem exportáveis por administradores de aplicativos.
Excluindo os dados do cliente

A capacidade de excluir os dados do usuário só é fornecida por meio da página de administração do IoT Central.
Os administradores de aplicativos podem selecionar o usuário a ser excluído e selecionar excluir no canto superior
direito do aplicativo para excluir o registro. Os administradores de aplicativos também podem remover contas
individuais que não estão mais associadas ao aplicativo em questão.
Depois que um usuário é excluído, nenhum alerta adicional é enviado por email a ele. No entanto, seu endereço de
email precisa ser removido individualmente de cada alerta configurado.
Para obter mais informações, consulte Configurar regras e ações para seu dispositivo.
Exportando os dados do cliente
A capacidade de exportar os dados só é fornecida por meio da página de administração do IoT Central. Os dados
do cliente, incluindo as funções atribuídas, podem ser selecionados, copiados e colados por um administrador de
aplicativos.
Links para documentação adicional

Para obter mais informações sobre a administração de conta, incluindo definições de função, consulte Como
administrar seu aplicativo.
Navegadores compatíveis com o Azure IoT Central
Este artigo se aplica a operadores, construtores e administradores.

O Azure IoT Central pode ser acessado na maioria dos navegadores, tablets e desktops modernos. O artigo a
seguir descreve a lista de navegadores com suporte e a conectividade necessária.
Navegadores com suporte

É recomendável que você use o navegador mais atualizado compatível com o sistema operacional. Há suporte para
os seguintes navegadores:
Microsoft Edge (última versão)
Safari (última versão, apenas Mac)
Chrome (última versão)
Firefox (última versão)
Protocolos necessários
O Azure IoT Central exige que sua rede dê suporte a protocolos HTTPS e WebSocket para conectividade de saída.

Iot Central

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Iot Central

Enviado por

Direitos autorais:

Formatos disponíveis

Contents

Documentação do Azure IoT Central

Criar seu aplicativo do Azure IoT Central

Conecte seus dispositivos

Gerenciar seu aplicativo

Usar o painel esquerdo

Pesquisa, ajuda e suporte

Exportação contínua de dados

Em seguida, selecione Aplicativo personalizado.

MODELO DE APLICATIVO DESCRIÇÃO

3. Escolha um plano de pagamento:

Crie um modelo de dispositivo

Adicionar um modelo de dispositivo

2. A página mostra os modelos que você pode escolher.

4. No modelo de dispositivo Ar-condicionado Conectado, verifique se você está na guia Medidas, na

Nome de exibição Temperatura

Nome do campo temperatura

Adicionar uma medida de evento

Nome de exibição Erro do motor do ventilador

Nome do campo fanmotorerr

Para salvar a definição de evento, selecione Salvar:

4. Para ver detalhes adicionais sobre o evento, selecione o evento no gráfico:

Nome de exibição Modo ventilação

Nome do campo fanmode

Rótulo de exibição Operacional

Rótulo de exibição Parado

Para salvar a definição de medida de estado, selecione Salvar:

Configurações, propriedades e comandos

Nome de exibição Temperatura definida

Nome do campo setTemperature

Valor máximo 200

DESCRIÇÃO Defina a temperatura de destino para o ar-condicionado

Em seguida, selecione Salvar:

4. Personalize o layout da guia Configurações movendo e redimensionando os blocos de configurações:

Nome de exibição Location

Nome do campo location

Valor inicial Seattle, WA

DESCRIÇÃO Localização do dispositivo

Deixe os outros campos com os seus respectivos valores padrão.

Nome de exibição Data do Último Serviço

Nome do campo serviceDate

Valor inicial 1/1/2019

DESCRIÇÃO Atendido por último

Nome de exibição Versão do firmware

Nome do campo firmwareVersion

Tipo de Dados text

DESCRIÇÃO A versão de firmware de ar-condicionado

Nome de exibição Número de série

Nome do campo serialNumber

Tipo de Dados text

DESCRIÇÃO O número de série do ar-condicionado

Nome de exibição Comando echo

Nome do campo echo

Tempo limite padrão 30

Tipo de Dados text

DESCRIÇÃO Comando do dispositivo

É possível adicionar entradas adicionais ao comando, selecionando + para Campos de Entrada.

Exibir seu dispositivo simulado

Intervalo de tempo Últimos 30 minutos

Medidas Temperatura (selecione Visibilidade ao lado de

Em seguida, selecione Salvar.

Title Eventos do Motor do Ventilador