Aggiunta del profilo del dispositivo e del dispositivo finale Sidewalk - Wireless AWS IoT
Aggiunta del dispositivo Sidewalk (console)Aggiunta del dispositivo Sidewalk (interfaccia a riga di comando)

Aggiunta del profilo del dispositivo e del dispositivo finale Sidewalk

In questa sezione viene illustrato come creare un profilo del dispositivo. Inoltre, viene illustrato come utilizzare la console AWS IoT e la AWS CLI per aggiungere il dispositivo finale Sidewalk ad AWS IoT Core per Amazon Sidewalk.

Aggiunta del dispositivo Sidewalk (console)

Per aggiungere il dispositivo Sidewalk mediante la console AWS IoT, passa alla scheda Sidewalk dell'hub Dispositivi, scegli Provisioning del dispositivo, quindi esegui la procedura seguente.

  1. Specifica dei dettagli dispositivo

    Specifica le informazioni di configurazione per il dispositivo Sidewalk. Puoi anche creare un nuovo profilo del dispositivo o scegliere un profilo esistente per il dispositivo Sidewalk.

    1. Specifica un nome del dispositivo e una descrizione facoltativa. La descrizione può contenere un massimo di 2048 caratteri. Questi campi possono essere modificati dopo che il dispositivo è stato creato.

    2. Scegli un profilo del dispositivo da associare al dispositivo Sidewalk. Se disponi già di profili dei dispositivi esistenti, puoi scegliere il tuo profilo. Per creare un nuovo profilo, scegli Crea nuovo profilo, quindi inserisci un nome per il profilo.

      Nota

      Per collegare tag al profilo del dispositivo, dopo che crei il profilo, passa all'hub Profili, quindi modifica il profilo per aggiungere queste informazioni.

    3. Specifica il nome della destinazione che instraderà i messaggi dal dispositivo ad altri Servizi AWS. Se non hai già creato una destinazione, passa all'hub Destinazioni per crearla. Puoi quindi scegliere tale destinazione per il dispositivo Sidewalk. Per ulteriori informazioni, consultare Aggiunta di una destinazione per il dispositivo finale Sidewalk.

    4. Scegli Avanti per continuare ad aggiungere il dispositivo Sidewalk.

  2. Associazione del dispositivo Sidewalk all'oggetto AWS IoT (opzionale)

    Facoltativamente, puoi associare il dispositivo Sidewalk a un oggetto AWS IoT. Gli oggetti IoT sono voci nel registro dei dispositivi AWS IoT. Gli oggetti semplificano la ricerca e la gestione dei dispositivi. L'associazione di un oggetto al dispositivo consente al dispositivo di accedere ad altre funzionalità di AWS IoT Core.

    Per associare il dispositivo ad un oggetto, scegli Registrazione automatica degli oggetti.

    1. Inserisci un nome univoco per l'oggetto IoT che desideri associare al dispositivo Sidewalk. I nomi degli oggetti fanno distinzione tra maiuscole e minuscole e devono essere univoci in Account AWS e nella Regione AWS.

    2. Fornisci eventuali configurazioni aggiuntive per l'oggetto IoT, ad esempio utilizzando un tipo di oggetto o attributi ricercabili, che possono essere utilizzati per filtrare da un elenco di oggetti.

    3. Scegli Avanti e verifica le informazioni sul dispositivo Sidewalk, quindi seleziona Crea.

Aggiunta del dispositivo Sidewalk (interfaccia a riga di comando)

Per aggiungere il dispositivo Sidewalk e scaricare i file JSON che verranno utilizzati per effettuare il provisioning del dispositivo Sidewalk, esegui le seguenti operazioni API.

Fase 1: Creazione di un profilo del dispositivo

Per creare un profilo del dispositivo in Account AWS, utilizza l'operazione API CreateDeviceProfile o il comando dell'interfaccia a riga di comando create-device-profile. Durante la creazione del profilo del dispositivo, specifica il nome e fornisci eventuali tag opzionali come coppie nome-valore.

Ad esempio, il comando seguente crea un profilo del dispositivo per i dispositivi Sidewalk:

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

L'esecuzione di questo comando restituisce il nome della risorsa Amazon (ARN) e l'ID del profilo del dispositivo come output.

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

Fase 2: Aggiunta del dispositivo Sidewalk

Per aggiungere il dispositivo Sidewalk all'account per AWS IoT Core per Amazon Sidewalk, utilizza l'operazione API CreateWirelessDevice o il comando dell'interfaccia a riga di comando create-wireless-device. Durante la creazione del dispositivo, specifica i seguenti parametri, in aggiunta a un nome e una descrizione facoltativi per il dispositivo Sidewalk.

Nota

Se desideri associare il dispositivo Sidewalk a un oggetto AWS IoT, utilizza l'operazione API AssociateWirelessDeviceWithThing o il comando dell'interfaccia a riga di comando associate-wireless-device-with-thing.

Il comando seguente mostra un esempio di creazione di un dispositivo Sidewalk:

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

Nell'esempio seguente viene mostrato il contenuto del file device.json.

Contenuto di device.json

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

L'esecuzione di questo comando restituisce l'ID dispositivo e il nome della risorsa Amazon (ARN) come output.

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