Ottenere i file JSON del dispositivo per il provisioning
Dopo aver aggiunto il dispositivo Sidewalk ad AWS IoT Core per Amazon Sidewalk, scarica il file JSON contenente le informazioni necessarie per effettuare il provisioning del dispositivo finale. Puoi recuperare queste informazioni utilizzando la console AWS IoT o AWS CLI. Per ulteriori informazioni su come effettuare il provisioning del dispositivo, consultare la pagina relativa al provisioning e alla registrazione del dispositivo finale
Ottenere il file JSON (console)
Per ottenere il file JSON per il provisioning del dispositivo Sidewalk:
-
Passa all'hub Dispositivi Sidewalk
. -
Scegli il dispositivo aggiunto ad AWS IoT Core per Amazon Sidewalk per visualizzarne i relativi dettagli.
-
Ottieni il file JSON scegliendo Scarica il file JSON del dispositivo nella pagina dei dettagli del dispositivo aggiunto.
Verrà scaricato un file
certificate.json
contenente le informazioni richieste per il provisioning del dispositivo finale. Di seguito è riportato un file JSON di esempio. Contiene i certificati dei dispositivi, le chiavi private, il numero di serie di produzione Sidewalk (SMSN) e ilDeviceTypeID
.{ "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
" }
Nella pagina dei dettagli del dispositivo Sidewalk, verranno anche visualizzate le informazioni relative a:
-
L'ID dispositivo, il nome della risorsa Amazon (ARN) e i dettagli relativi a qualsiasi oggetto AWS IoT a cui il dispositivo è associato.
-
Il profilo del dispositivo e i dettagli della destinazione.
-
L'ora di ricezione dell'ultimo messaggio in uplink dal dispositivo.
-
Lo stato che indica se è stato effettuato il provisioning del dispositivo o se è stato registrato.
Ottenere il file JSON (CLI)
Per ottenere i file JSON per il provisioning del dispositivo finale Sidewalk utilizzando l'API AWS IoT Core per Amazon Sidewalk o AWS CLI, salva la risposta API recuperando le informazioni sul profilo del dispositivo e sul dispositivo wireless come file JSON, ad esempio
e wireless_device.json
temporaneamente. Potrai utilizzarli in seguito per effettuare il provisioning del dispositivo Sidewalk.device_profile.json
Di seguito viene illustrato come recuperare i file JSON.
Argomenti
Fase 1: Ottenere le informazioni sul profilo del dispositivo come file JSON
Utilizza l'operazione API GetDeviceProfile
o il comando dell'interfaccia a riga di comando get-device-profile
per ottenere informazioni sul profilo del dispositivo aggiunto all'account per AWS IoT Core per Amazon Sidewalk. Per recuperare informazioni sul profilo del dispositivo, specifica l'ID del profilo.
L'API restituirà quindi le informazioni sul profilo del dispositivo corrispondenti all'identificatore specificato e all'ID dispositivo. Salva queste informazioni di risposta come un file e assegna un nome come
.device_profile.json
Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando:
aws iotwireless get-device-profile \ --id "
12345678-a1b2-3c45-67d8-e90fa1b2c34d
" >device_profile.json
L'esecuzione di questo comando restituisce i parametri del profilo del dispositivo, la chiave pubblica del server di applicazioni e il DeviceTypeID
. Di seguito viene mostrato un file JSON contenente informazioni di risposta di esempio dall'API. Per ulteriori informazioni sui parametri nella risposta API, consultare GetDeviceProfile
.
Risposta API GetDeviceProfile
(contenuto di
)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 } }
Fase 2: Ottenere informazioni sul dispositivo Sidewalk come un file JSON
Utilizza l'operazione API GetWirelessDevice
o il comando dell'interfaccia a riga di comando get-wireless-device
per ottenere informazioni sul dispositivo Sidewalk aggiunto all'account per AWS IoT Core per Amazon Sidewalk. Per ottenere informazioni sul dispositivo finale, fornisci l'identificatore del dispositivo wireless ottenuto durante l'aggiunta del dispositivo.
L'API restituirà quindi le informazioni sul dispositivo corrispondenti all'identificatore specificato e all'ID dispositivo. Salva queste informazioni di risposta come un file JSON. Assegna al file un nome significativo, ad esempio
.wireless_device.json
Di seguito viene illustrato un esempio dell'esecuzione del comando mediante l'interfaccia a riga di comando:
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \ --identifier
"23456789-abcd-0123-bcde-fabc012345678"
>wireless_device.json
L'esecuzione di questo comando restituisce i dettagli del dispositivo, i certificati dei dispositivi, le chiavi private e il numero di serie di produzione Sidewalk (SMSN). Nell'esempio seguente viene illustrato un output di esempio di esecuzione di questo comando. Per ulteriori informazioni sui parametri nella risposta API, consultare GetWirelessDevice
.
Risposta API GetWirelessDevice
(contenuto di
)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" }, ... }
Passaggi successivi
Archivia i file JSON
e wireless_device.json
temporaneamente, poiché verranno utilizzati nel passaggio successivo per effettuare il provisioning e registrare il dispositivo finale per la connessione alla piattaforma hardware. Per ulteriori informazioni, consultare la pagina relativa al provisioning e alla registrazione del dispositivo finaledevice_profile.json