Adicione o perfil do seu dispositivo e o dispositivo final do Sidewalk

Esta seção mostra como criar um perfil de dispositivo. Também mostra como é possível utilizar o console do AWS IoT e a AWS CLI para adicionar o dispositivo final do Sidewalk ao AWS IoT Core para Amazon Sidewalk.

Adicionar seu dispositivo do Sidewalk (console)

Para adicionar seu dispositivo do Sidewalk usando o console AWS IoT, acesse a guia Sidewalk do hub de dispositivos, escolha Provisionar dispositivo e execute as etapas a seguir.

1. Especifique os detalhes do dispositivo

   Especifique as informações de configuração do seu dispositivo do Sidewalk. Você também pode criar um novo perfil de dispositivo ou escolher um perfil existente para seu dispositivo do Sidewalk.

   1. Especifique um nome de dispositivo e uma descrição opcional. A descrição pode ter até 2.048 caracteres. Esses campos podem ser editados após a criação do dispositivo.

   2. Escolha um perfil de dispositivo para associar ao seu dispositivo do Sidewalk. Se você tiver algum perfil de dispositivo existente, poderá escolhê-lo. Se você criar um novo perfil, escolha Criar novo perfil e, em seguida, digite um nome para ele.

      nota

      Para anexar tags ao perfil de dispositivo depois de sua criação, acesse o Hub de perfis e edite o perfil para adicionar essas informações.

   3. Especifique o nome do destino que encaminhará as mensagens do seu dispositivo para outro Serviços da AWS. Se você ainda não criou um destino, acesse o Hub de destinos para criar seu destino. Em seguida, você pode escolher esse destino para o seu dispositivo do Sidewalk. Para ter mais informações, consulte Adicionar um destino para o dispositivo final do Sidewalk.

   4. Escolha Próximo para continuar o processo de adição do dispositivo do Sidewalk.

2. Associe o dispositivo do Sidewalk a alguma coisa da AWS IoT (opcional)

   Opcionalmente, você pode associar o dispositivo do Sidewalk a qualquer coisa da AWS IoT. Coisas da IoT são entradas no registro do dispositivo do AWS IoT. Isso facilita a pesquisa e o gerenciamento de seus dispositivos. Associar alguma coisa ao dispositivo permite que ele acesse outros recursos do AWS IoT Core.

   Para associar o dispositivo a alguma coisa, escolha Registro automático de coisas.

   1. Digite um nome exclusivo para a coisa da IoT a que você deseja associar o dispositivo do Sidewalk. Os nomes das coisas diferenciam maiúsculas de minúsculas na sua Conta da AWS e devem ser exclusivos na sua Região da AWS.

   2. Forneça qualquer configuração adicional para a coisa da IoT escolhida, por exemplo, use um tipo de coisa ou atributos pesquisáveis que possam ser usados para filtrar a partir de uma lista de itens.

   3. Escolha Próximo e verifique as informações sobre o dispositivo do Sidewalk e, em seguida, escolha Criar.

Adicionar seu dispositivo do Sidewalk (CLI)

Para adicionar o dispositivo do Sidewalk e baixar os arquivos JSON que serão usados para provisioná-lo, execute as seguintes operações da API.

Etapa 1: Criar um perfil do dispositivo

Para criar um perfil de dispositivo na sua Conta da AWS, use a operação da API CreateDeviceProfile ou o comando da CLI create-device-profile. Ao criar seu perfil de dispositivo, especifique o nome e forneça quaisquer tags opcionais como pares nome-valor.

Por exemplo, o comando a seguir cria um perfil de dispositivo para os dispositivos do Sidewalk:

aws iotwireless create-device-profile \ 
    --name sidewalk_profile --sidewalk {}         

A execução desse comando retorna o nome do recurso da Amazon (ARN) e o ID do perfil do dispositivo como saída.

{
    "DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Etapa 2: Adicionar o dispositivo do Sidewalk

Para adicionar o dispositivo do Sidewalk à sua conta para o AWS IoT Core para Amazon Sidewalk, utilize a operação de API CreateWirelessDevice ou o comando create-wireless-device da CLI. Ao criar seu dispositivo, especifique os seguintes parâmetros, além de um nome e uma descrição opcionais para o dispositivo do Sidewalk.

nota

Para associar o dispositivo Sidewalk a alguma coisa do AWS IoT, utilize a operação de API AssociateWirelessDeviceWithThing ou o comando associate-wireless-device-with-thing da CLI.

O comando a seguir mostra um exemplo de criação de um dispositivo do Sidewalk:

aws iotwireless create-wireless-device \ 
     --cli-input-json "file://device.json"

O exemplo a seguir mostra o conteúdo do arquivo device.json.

Conteúdo de device.json

{
  "Type": "Sidewalk",
  "Name": "SidewalkDevice",  
  "DestinationName": "SidewalkDestination",
  "Sidewalk": {
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"    
    }
}

A execução desse comando retorna o ID do dispositivo e o nome do recurso da Amazon (ARN) como saída.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678"
}