Obter arquivo JSON (console)Obter arquivo JSON (CLI)Próximas etapas

Obtenha os arquivos JSON do dispositivo para provisionamento

Depois de adicionar o dispositivo Sidewalk ao AWS IoT Core para Amazon Sidewalk, baixe o arquivo JSON que contém as informações necessárias para provisionar o dispositivo final. Você pode recuperar essas informações usando o console de AWS IoT ou a AWS CLI. Para mais informações sobre como provisionar o dispositivo, consulte Provisionamento e registro do seu dispositivo final na documentação do Amazon Sidewalk.

Obter arquivo JSON (console)

Para obter o arquivo JSON para provisionar o dispositivo do Sidewalk:

Acesse o Hub de dispositivos do Sidewalk.
Para visualizar detalhes, escolha o dispositivo adicionado ao AWS IoT Core para Amazon Sidewalk.

Obtenha o arquivo JSON escolhendo Baixar arquivo JSON do dispositivo, na página de detalhes do dispositivo que você adicionou.

Um arquivo certificate.json que contém as informações necessárias para provisionar seu dispositivo final será baixado. A seguir, um arquivo JSON de amostra. Ele contém os certificados do dispositivo, chaves privadas, o número de série de fabricação do Sidewalk (SMSN) e o DeviceTypeID.


{
  "p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
  "eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
  "metadata": {    
    "devicetypeid": "fe98",
    "applicationDeviceArn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/897ce68e-3ca2-4ed0-85a2-30b0666c4052",
    "applicationDeviceId": "897ce68e-3ca2-4ed0-85a2-30b0666c4052",
    "smsn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A",
    "devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
    "devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
  },
  "applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}

Na página de detalhes do dispositivo Sidewalk, você também verá informações sobre:

O ID do dispositivo, o nome do recurso da Amazon (ARN) e detalhes sobre qualquer coisa de AWS IoT a que o dispositivo esteja associado.
O perfil do dispositivo e os detalhes do destino.
A hora em que a última mensagem de uplink foi recebida do dispositivo.
O status que indica se seu dispositivo foi provisionado ou registrado.

Obter arquivo JSON (CLI)

Para obter os arquivos JSON para provisionar o dispositivo final do Sidewalk utilizando a API do AWS IoT Core para Amazon Sidewalk ou a AWS CLI, salve temporariamente a resposta da API ao recuperar informações sobre o perfil do dispositivo e sobre o dispositivo sem fio como arquivos JSON, como wireless_device.json e device_profile.json. Eles serão utilizados para provisionar seu dispositivo do Sidewalk.

A seguir, é mostrado como recuperar os arquivos JSON.

Tópicos

Etapa 1: Obter informações do perfil do dispositivo como arquivo JSON
Etapa 2: Obter informações do dispositivo do Sidewalk como arquivo JSON

Etapa 1: Obter informações do perfil do dispositivo como arquivo JSON

Utilize a operação de API GetDeviceProfile ou o comando get-device-profile da CLI para obter informações sobre o perfil do dispositivo adicionado à sua conta para o AWS IoT Core para Amazon Sidewalk. Para recuperar informações sobre o perfil do dispositivo, especifique o ID do perfil.

A API retornará informações sobre o perfil do dispositivo que correspondem ao identificador especificado e ao ID do dispositivo. Você salva essas informações de resposta como um arquivo e as nomeia como device_profile.json.

Um exemplo de um comando da CLI é mostrado a seguir:


aws iotwireless get-device-profile \ 
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json

A execução desse comando retorna os parâmetros do perfil do seu dispositivo, a chave pública do servidor de aplicativos e o DeviceTypeID. É apresentado a seguir um arquivo JSON contendo um exemplo de informações de resposta da API. Para obter mais informações sobre os parâmetros na resposta da API, consulte GetDeviceProfile.

Resposta da API GetDeviceProfile (Conteúdo de device_profile.json)


{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Name": "Sidewalk_profile",
    "LoRaWAN": null,
    "Sidewalk":
    {        
        "ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
        "DAKCertificateMetadata": [
            {                
                "DeviceTypeId: "fe98",
                "CertificateId": "43564A6D2D50524F544F54595045",
                "FactorySupport": false,
                "MaxAllowedSignature": 1000                
            }
        ],
        "QualificationStatus": false
    }
}

Etapa 2: Obter informações do dispositivo do Sidewalk como arquivo JSON

Utilize a operação de API GetWirelessDevice ou o comando get-wireless-device da CLI para obter informações sobre o dispositivo Sidewalk adicionado à sua conta para o AWS IoT Core para Amazon Sidewalk. Para obter informações sobre o dispositivo final, forneça o identificador do dispositivo sem fio obtido ao adicionar seu dispositivo.

A API retornará informações sobre o dispositivo que correspondem ao identificador especificado e ao ID do dispositivo. Salve essas informações de resposta como um arquivo JSON. Dê ao arquivo um nome significativo, como wireless_device.json.

O exemplo a seguir mostra a execução do comando usando a CLI:


aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \ 
    --identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json

A execução desse comando retorna os detalhes do dispositivo, certificados do dispositivo, chaves privadas e o número de série de fabricação do Sidewalk (SMSN). O exemplo a seguir mostra a saída de execução desse comando. Para obter mais informações sobre os parâmetros na resposta da API, consulte GetWirelessDevice.

Resposta da API GetWirelessDevice (Conteúdo de wireless_device.json)


{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678",
    "DestinationName": "SidewalkDestination",   
    "Type": "Sidewalk",
    "Sidewalk": {        
        "CertificateId": "4C7438772D50524F544F54595045",
        "DeviceCertificates": [
            {
                "SigningAlg": "Ed25519",
                "Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNl7NKe4ounb5UMQtLjnm7zOUPYOqghCeVOLCBUiQe2ZiMBEW18JDUXIhffPobqZgohK91+LKFJ10X/F+GeltcafZcFKhS+O5NPcVNR/fHYaf/cn5iUbRwlz/T+ODXvGdwkBkgDyFgoUJgn7JdzFjaneE5qzTWXUbL79i1sXToGGjP8hiD9jJhidPWhIswleydAWgO1OZGA4CjzIaSGVM1VtaLB0VDphAkEpjMkZrtVDH3S8U1vDZTVi6YSbnkYZgfWv/uMMBfgAeL8Tdv5LkFIPIB3ZX9zt8zzmAuFRzI4MuNjWfIDnOF6AKu37WWU6/QYhZoQrW9D/wndiCcsRGl+ANn367r/HE02Re4DOiCfs9f2rjc4LT1LKt7g/KW2ii+W+9HYvvY0bBAI+AHx6Cx4j+djabTsvrgW2k6NU2zUSM7bdDP3z2a2+Z4WzBji/jYwt/OP8rpsy5Ee4ywXUfCsfQ0rKOr0zay6yh27p3I3MZle2oCO4JIlqK0VbIQqsXzSSyp6XXS0lhmuGugZ1AAADGz+gFBeX/ZNN8VJwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHhU79Z+oAAYAAAzsnf9SDIZPoDXF0TdC9POqTgld0oXDl2XPaVD4CvvLearrOSlFv+lsNbC4rgZn23MtIBM/7YQmJwmQ+FXRup6Tkubg1hpz04J/09dxg8UiZmntHiUr1GfkTOFMYqRB+Aw=="
            },
            {
                "SigningAlg": "P256r1",
                "Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNmHmGU8a+SOqDXWwDNt3VSntpbTTQl7cMIusqweQo+JPXXWElbGh7eaxPGz4ZeF5yM2cqVNUrQr1lX/6lZ+OLuycrFrLzzB9APi0NIMLqV/Rt7XJssHQs2RPcT1ul/2XVpa6ztULJeQi2JwhTb/k48wbh/EvafG/ibrIBIx9v7/dwGRAPKHq7Uwb9hHnhpa8qNOUtjeUdIwJNh9vCBFX9s22t4PdortoFxbXo9C149PDDD4wqUHJGYlCsVX/Sqqjf7Aug3h5dwdYN6cDgsuuiOm0+aBcXBGpkh7OxVxlwXkIP+11dt23TkrSUKd0B01sc9Mc/0yEBCzx5RutKBwsefzyOl4vQX3AHgV7oD/XV73THMgGiDxQ55CPaaxN/pm791VkQ76BSZaBeF+Su6tg0k/eQneklt8Du5uqkyBHVxy8MvxsBIMZ73vIFwUrLHjDeq3+nOOyQqSBMnrHKU2mAwN3zb2LolwjPkKNOh1+NNnv99L2pBcNCnhnoBULWmWAZNXJpMx9QrcSwI9AHylcgUbGQJgf9Ryun+BgewzYNdWrXyKkp4O3ZDa4f+5SVWvbY5eyDDXcohvz/OcCtuRjAkzKBCvIjBDnCv1McjVdCO3+utizGntfhAo1RZstnOoRkgVF2WuMT9IrUmzYximuTXUmWtjyFSTqgNBZwHWUTlMmjlpLCVzZQWM4zOisXUAAALPsP34BS6EzJO5AsS5pC7QTpjBtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBjtvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4UrVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4AhsyjMvKCsZQiKgiI8ECwjfXBaSZdY4zYsRlO3FC428H1atrFChFCZT0Bqt5LPXD38bMSB+vAUJiP8XqiEdXeqf2mYMJ5ykoDpwkve/cUQfPpjzFQlQfvwjBwiJDANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw=="
            }
        ],
        "DeviceProfileId": "0ff5b0c6-f149-4498-af34-21993acd52a7",
        "PrivateKeys": [
            {
                "SigningAlg": "Ed25519",
                "Value": "2c24d4572327f23b9bef38097137c29224a9e979081b3d90124ac9dfa477934e"
            },
            {
                "SigningAlg": "P256r1",
                "Value": "38d526f29cfaf142f596deca187bd809ef71bc13435eedc885b63bb825d63def"
            }
        ],        
        "SidewalkManufacturingSn": "843764270F4BDAE3023918C89A3307AB3351EA761887A40A9DC4A5E46B6140D9",
        "Status": "PROVISIONED"
    },
    
    ...
    
}

Próximas etapas

Armazene temporariamente os arquivos JSON, wireless_device.json e device_profile.json, porque eles serão utilizados na próxima etapa de provisionamento e registro do seu dispositivo final para a conexão com a plataforma de hardware. Para obter mais informações, consulte Provisionamento e registro do seu dispositivo final na documentação do Amazon Sidewalk.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

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

Adicionar um destino para o dispositivo do Sidewalk