Ottenere i file JSON del dispositivo per il provisioning - Wireless AWS IoT
Ottenere il file JSON (console)Ottenere il file JSON (CLI)Passaggi successivi

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 nella documentazione di Amazon Sidewalk.

Ottenere il file JSON (console)

Per ottenere il file JSON per il provisioning del dispositivo Sidewalk:

  1. Passa all'hub Dispositivi Sidewalk.

  2. Scegli il dispositivo aggiunto ad AWS IoT Core per Amazon Sidewalk per visualizzarne i relativi dettagli.

  3. 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 il 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"
}

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 wireless_device.json e device_profile.json temporaneamente. Potrai utilizzarli in seguito per effettuare il provisioning del dispositivo Sidewalk.

Di seguito viene illustrato come recuperare i file JSON.

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 wireless_device.json e device_profile.jsontemporaneamente, 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 finale nella documentazione di Amazon Sidewalk.