IoT Platform:Criar vários dispositivos simultaneamente

Pré-requisitos

Crie um produto. Para mais informações, consulte Criar um produto.

Procedimento

1. Faça login no console do IoT Platform.

2. Na página Overview, localize a instância a ser gerenciada e clique em ID ou no nome da instância.

3. No painel de navegação à esquerda, escolha Devices > Devices.

4. Na página Devices, clique em Batch Add.

5. Selecione um produto. Os novos dispositivos herdarão os recursos desse produto.

   Importante

   Se o produto estiver associado a outras plataformas, verifique se sua conta tem cota suficiente de códigos de ativação para criar os dispositivos.

   Defina Add Method como Auto Generate, configure Device Quantity para 100 e clique em OK.

6. Escolha um método para especificar os DeviceNames.

   • Auto Generate: Insira a quantidade de dispositivos. O IoT Platform gera um DeviceName aleatório, composto por letras e dígitos, para cada dispositivo.

   • Batch Upload: Especifique um nome para cada dispositivo. Clique em Download .csv Template, preencha o DeviceName e o Nickname de cada dispositivo no modelo e envie o arquivo para o console do IoT Platform.

     Importante

     • Não modifique a primeira linha. Comece a inserir os dados a partir da célula A2.

     • O DeviceName deve ter entre 4 e 32 caracteres e pode conter letras, dígitos, hifens (-), sublinhados (_), arrobas (@), pontos (.) e dois-pontos (:). O DeviceName deve ser único dentro de um produto.

     • Nickname é um alias opcional para o dispositivo. O alias deve ter entre 4 e 64 caracteres e pode conter caracteres chineses, japoneses, letras, dígitos e sublinhados (_). Cada caractere chinês ou japonês conta como dois caracteres.

     • Um arquivo pode conter até 10.000 registros e não deve exceder 2 MB.

7. Clique em OK.

   Se a lista enviada contiver nomes de dispositivo inválidos, uma mensagem de erro será exibida. Clique em Download Invalid Device Name List para visualizar os nomes inválidos, corrigi-los e enviar o arquivo novamente.

8. Após a criação dos dispositivos, clique em Download Device Certificate para baixar os certificados correspondentes. Grave esses certificados nos dispositivos.

   Um certificado de dispositivo consiste em ProductKey, DeviceName e DeviceSecret. O dispositivo precisa dessa credencial para se comunicar com o IoT Platform. Armazene o certificado com segurança.

   Parâmetro	Descrição
   ProductKey	O ProductKey do produto ao qual o dispositivo pertence. Trata-se do GUID emitido pelo IoT Platform para o produto.
   DeviceName	O DeviceName do dispositivo, que funciona como identificador único dentro do produto. A combinação de DeviceName e ProductKey serve como identificador do dispositivo. O IoT Platform usa esse identificador para autenticar e se comunicar com o dispositivo.
   DeviceSecret	O DeviceSecret do dispositivo, emitido pelo IoT Platform para autenticação e criptografia. Use-o obrigatoriamente em conjunto com o DeviceName.

Resultado

Depois que os dispositivos forem criados, acesse a aba Batch Management na página Devices. Localize o produto correspondente e clique em uma das opções abaixo:

• Details: Visualize o Number of Added Devices e a lista de dispositivos do lote. A lista inclui informações como certificados e status dos dispositivos.

  Se houver falha na criação de alguns dispositivos, os códigos e as causas do erro aparecerão na lista. A tabela a seguir descreve os códigos de erro.

  Código de erro	Mensagem	Descrição
  460	duplicated deviceName	O nome do dispositivo está duplicado.
  	invalid deviceName	O nome do dispositivo é inválido.
  6251	device exist	O dispositivo já existe.
  6760	insufficient activation code	Não há códigos de ativação suficientes.
  64003	device creation failed	O dispositivo não foi criado devido a operações simultâneas.
  6293	device has been distributed	O dispositivo já foi distribuído.

• DownloadCSV: Baixe os certificados dos dispositivos deste lote.

Próximos passos

Visualize as informações do dispositivo. Para mais detalhes, consulte Visualizar informações do dispositivo.

Para saber mais sobre como conectar um dispositivo ao IoT Platform, consulte os seguintes tópicos:

• Conectar um dispositivo ao IoT Platform usando MQTT.fx

• Conectar hardware Android Things ao IoT Platform

Operações de API relacionadas

BatchRegisterDevice: Registra vários dispositivos simultaneamente.