Provisionamento de dispositivos do Sidewalk usando tarefas de importação - AWS IoT Wireless
Como funciona o provisionamento em massa do SidewalkPrincipais considerações sobre o provisionamento em massa do SidewalkFormato de arquivo CSVComo utilizar o provisionamento em massa do Sidewalk

Provisionamento de dispositivos do Sidewalk usando tarefas de importação

Esta seção mostra como provisionar dispositivos Sidewalk em massa utilizando o console do AWS IoT, as operações de API do AWS IoT Core para Amazon Sidewalk ou a AWS CLI. As seções a seguir explicam como provisionar seus dispositivos do Sidewalk em massa.

Tópicos

Como funciona o provisionamento em massa do Sidewalk

As etapas a seguir ilustram como funciona o provisionamento em massa.

  1. Iniciar a tarefa de importação de dispositivos sem fio

    Para provisionar dispositivos Sidewalk em massa, crie uma tarefa de importação e forneça o número de série de fabricação do Sidewalk (SMSN) dos dispositivos a serem integrados ao AWS IoT Core para Amazon Sidewalk. Você obteve o número de série de fabricação do Sidewalk (SMSN) dos dispositivos como um arquivo CSV em seu e-mail depois que o fabricante fez o upload dos logs de controle para o Amazon Sidewalk. Para obter mais informações sobre o fluxo de trabalho e como obter o log de controle, consulte Fabricação de dispositivos Amazon Sidewalk na documentação do Amazon Sidewalk.

  2. Executar o processo de importação em segundo plano

    Quando o AWS IoT Core para Amazon Sidewalk recebe a solicitação da tarefa de importação, ele inicia a configuração de coisas e um processo em segundo plano que pesquisa o sistema com frequência. Depois que o processo em segundo plano recebe a instrução da tarefa de importação, ele começa a ler o arquivo CSV. Ao mesmo tempo, o AWS IoT Core para Amazon Sidewalk verifica se os logs de controle foram recebidos do Amazon Sidewalk.

  3. Criar registros de dispositivos sem fio

    Quando o log de controle é recebido do Amazon Sidewalk, o AWS IoT Core para Amazon Sidewalk verifica se os números de série no log de controle correspondem aos valores SMSN no arquivo CSV. Se os números de série corresponderem, o AWS IoT Core para Amazon Sidewalk começará a criar registros de dispositivos sem fio para os dispositivos Sidewalk que corresponderem a esses números de série. Depois que todos os dispositivos estiverem integrados, a tarefa de importação será marcada como Concluída.

Principais considerações sobre o provisionamento em massa do Sidewalk

Ao provisionar os dispositivos Sidewalk em massa para o AWS IoT Core para Amazon Sidewalk, observe algumas considerações importantes a seguir.

  • Execute o provisionamento em massa utilizando o console do AWS IoT ou as operações de API do AWS IoT Core para Amazon Sidewalk na mesma Conta da AWS em que o perfil do dispositivo foi criado.

  • Antes de provisionar em massa seus dispositivos do Sidewalk, seu perfil de dispositivo já deve conter informações do DAK que indiquem o suporte de fábrica. Caso contrário, o provisionamento em massa usando o console de AWS IoT ou as operações da API de provisionamento em massa podem falhar.

  • Depois que você inicia a tarefa de importação, são necessários 10 minutos ou mais para processar o arquivo CSV, importar os dispositivos sem fio e integrá-los ao AWS IoT Core para Amazon Sidewalk.

  • Quando iniciada, a tarefa de importação do dispositivo sem fio será executada por 90 dias. Durante esse período, ela verifica se os logs de controle foram recebidos do Amazon Sidewalk. Se o log de controle não for recebido do Amazon Sidewalk antes de 90 dias, a tarefa será marcada como Concluída, com uma mensagem indicando que ela expirou, quando você visualizar os detalhes da tarefa. O status de integração dos dispositivos na tarefa de importação que estavam aguardando o log de controle será marcado como Falha.

  • Ao tentar atualizar uma tarefa de importação criada, você só pode incluir dispositivos adicionais à tarefa. Você pode adicionar novos dispositivos a qualquer momento após criar uma tarefa de importação e antes do início dela em dispositivos que já foram adicionados à tarefa de importação. Se o arquivo de atualização contiver números de série de dispositivos que já existem na tarefa de importação original, esses números de série serão ignorados.

  • Quando você solicita uma operação de atualização, o mesmo perfil do IAM utilizado ao criar a tarefa de importação será considerado para acessar o arquivo CSV no bucket do Amazon S3.

  • Uma tarefa de importação só poderá ser excluída se a tarefa já tiver sido concluída com êxito ou se houver uma falha em sua atualização. A atualização de uma tarefa pode falhar em casos em que um perfil do IAM incorreto é fornecido ou quando um arquivo de bucket do Amazon S3 não é encontrado. Uma tarefa de importação não poderá ser atualizada ou excluída se estiver no estado PENDING.

  • O arquivo CSV que você importa para a tarefa deve usar o formato descrito na seção a seguir.

Formato de arquivo CSV

O arquivo CSV contido em um bucket do Amazon S3 que você especificar para a tarefa de importação deve usar o seguinte formato:

  • A linha 1 deve usar a palavra-chave smsn, que indica que o arquivo CSV sendo importado contém o SMSN dos dispositivos a serem importados.

  • As linhas 2 e posteriores devem conter o SMSN dos dispositivos a serem integrados. O SMSN do dispositivo deve estar no formato de 64 caracteres hexadecimais.

Esse arquivo JSON mostra um exemplo de formato de arquivo CSV.

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Como utilizar o provisionamento em massa do Sidewalk

As etapas a seguir mostram como usar o provisionamento em massa do Amazon Sidewalk.

  1. Forneça os números de série do dispositivo

    Para provisionar os dispositivos do Sidewalk, é preciso fornecer os números de série dos dispositivos a serem integrados. Você pode provisionar seus dispositivos usando qualquer um dos métodos a seguir.

    • Provisione cada dispositivo individualmente usando o número de série de fabricação do Sidewalk (SMSN). Esse método é útil quando você quer testar o fluxo de trabalho e integrar seu dispositivo mais rapidamente sem precisar carregar um arquivo CSV com o perfil do IAM apropriado ou esperar que os dispositivos estejam prontos para serem integrados à tarefa.

    • Provisione os dispositivos em massa fornecendo um URL do bucket do Amazon S3 que contenha o SMSN dos dispositivos a serem provisionados, em um arquivo CSV. Esse método é especialmente útil quando você tem um grande número de dispositivos a serem integrados. Nesse caso, integrar cada dispositivo individualmente pode ser um trabalho maçante. Em vez disso, basta fornecer o caminho para o arquivo CSV que foi carregado em um bucket do Amazon S3 e o perfil do IAM para acessar o arquivo.

  2. Obter o status de integração da tarefa de importação e do dispositivo

    Para cada tarefa de importação criada, você pode recuperar informações sobre o status de integração da tarefa e o status de integração dos dispositivos adicionados a ela. Você também pode ver informações adicionais de status, como o motivo pelo qual a integração de uma tarefa ou dispositivo falharam. Para obter mais informações, consulte

  3. (Opcional) Atualizar ou excluir uma tarefa de importação

    Você pode atualizar ou excluir uma tarefa de importação criada.

    • É possível atualizar uma tarefa de importação e adicionar outros dispositivos à tarefa a qualquer momento antes de iniciá-la com os dispositivos já adicionados. O AWS IoT Core para Amazon Sidewalk presume que o perfil do IAM é o mesmo utilizado ao criar a tarefa de importação. Ao criar a tarefa, especifique o novo arquivo CSV que contém os números de série dos dispositivos que você deseja adicionar à tarefa.

      nota

      Ao atualizar uma tarefa de importação, só é possível adicionar dispositivos. O AWS IoT Core para Amazon Sidewalk executa uma operação de união entre os dispositivos que já estão na tarefa de importação e aqueles que você está tentando adicionar a ela. Se o novo arquivo contiver números de série de dispositivos que já existem na tarefa de importação, esses números de série serão ignorados.

    • Você pode excluir uma tarefa de importação que já foi concluída com êxito ou uma tarefa de importação cuja atualização falhou, em casos como quando as informações do perfil do IAM estão incorretas ou quando um arquivo do bucket do S3 não está disponível quando a tarefa é criada ou atualizada.

Tópicos