Provisioning in blocco di dispositivi Sidewalk - Wireless AWS IoT

Provisioning in blocco di dispositivi Sidewalk

In questa sezione viene illustrato come effettuare il provisioning in blocco di dispositivi Sidewalk in AWS IoT Core per Amazon Sidewalk, utilizzando la console AWS IoT e la AWS CLI.

Provisioning in blocco di dispositivi Sidewalk (console)

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

  1. Scelta del metodo di importazione

    Specifica la modalità di importazione dei dispositivi di cui eseguire l'onboarding in blocco in AWS IoT Core per Amazon Sidewalk.

    • Per effettuare il provisioning di singoli dispositivi utilizzando il relativo SMSN, scegli Effettua il provisioning di singoli dispositivi supportati in fabbrica.

    • Per effettuare il provisioning in blocco dei dispositivi fornendo un file CSV contenente un elenco di dispositivi e i relativi SMS, scegli Usa bucket S3.

  2. Specifica dei dispositivi di cui eseguire l'onboarding

    A seconda del metodo scelto per eseguire l'onboarding dei dispositivi, aggiungi le informazioni sul dispositivo e i relativi numeri di serie.

    1. Se hai scelto Effettua il provisioning di singoli dispositivi supportati in fabbrica, specifica le seguenti informazioni:

      1. Un Nome per ciascun dispositivo di cui eseguire l'onboarding. Il nome deve essere univoco in Account AWS e Regione AWS.

      2. Il relativo numero di serie di produzione Sidewalk (SMSN) nel campo Inserisci SMSN.

      3. Una Destinazione che descrive la regola IoT per instradare i messaggi dal dispositivo ad altri Servizi AWS.

    2. Se hai scelto Usa bucket S3:

      1. Fornisci le informazioni sulla Destinazione del bucket S3, costituite dalle informazioni sull'URL S3. Per fornire il file CSV, scegli Sfoglia S3, quindi seleziona il file CSV che desideri utilizzare.

        AWS IoT Core per Amazon Sidewalk popola automaticamente l'URL S3, ovvero il percorso del file CSV nel bucket S3. Il formato del percorso è s3://bucket_name/file_name. Per visualizzare il file nella console Amazon Simple Storage Service, scegli View (Visualizza).

      2. Fornisci il ruolo S3 Provisioning, che consente ad AWS IoT Core per Amazon Sidewalk di accedere al file CSV nel bucket S3 per tuo conto. Puoi creare un nuovo ruolo di servizio o scegliere un ruolo esistente.

        Per creare un nuovo ruolo, puoi fornire un Nome del ruolo o lasciare il campo vuoto per generare automaticamente un nome casuale.

      3. Fornisci una Destinazione che descrive la regola IoT per instradare i messaggi dal dispositivo ad altri Servizi AWS.

  3. Avvio dell'attività di importazione

    Fornisci eventuali tag opzionali come coppie nome-valore e scegli Invia per avviare l'attività di importazione dei dispositivi wireless.

Provisioning in blocco di dispositivi Sidewalk (CLI)

Per eseguire l'onboarding dei dispositivi Sidewalk nell'account per AWS IoT Core per Amazon Sidewalk, utilizza una delle seguenti operazioni API a seconda che si desideri aggiungere dispositivi singolarmente o fornendo il file CSV contenuto in un bucket S3.

  • Caricamento di dispositivi in blocco utilizzando un file CSV S3

    Per caricare i dispositivi in blocco fornendo il file CSV in un bucket S3, utilizza l'operazione API StartWirelessDeviceImportTask o il comando start-wireless-device-import-task AWS CLI. Durante la creazione dell'attività, specifica il percorso del file CSV nel bucket Amazon S3 e il ruolo IAM che concede ad AWS IoT Core per Amazon Sidewalk le autorizzazioni per accedere al file CSV.

    Una volta avviata l'esecuzione dell'attività, AWS IoT Core per Amazon Sidewalk inizierà a leggere il file CSV e confronterà i numeri di serie (SMSN) nel file con le informazioni corrispondenti nel log di controllo ricevuto da Amazon Sidewalk. Quando i numeri di serie corrispondono, inizierà a creare record di dispositivi wireless corrispondenti a questi numeri di serie.

    Il seguente comando mostra un esempio di creazione di un'attività di importazione:

    aws iotwireless start-wireless-device-import-task \ --cli-input-json "file://task.json"

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

    Contenuto di task.json

    { "DestinationName": "Sidewalk_Destination", "Sidewalk": { "DeviceCreationFile": "s3://import_task_bucket/import_file1", "Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI" } }

    L'esecuzione di questo comando restituisce un ID e un ARN per l'attività di importazione.

    { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a" "Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a" }
  • Provisioning dei dispositivi singolarmente utilizzando il relativo SMSN

    Per effettuare il provisioning dei dispositivi singolarmente utilizzando il relativo SMSN, utilizza l'operazione API StartSingleWirelessDeviceImportTask o il comando start-single-wireless-device-import-task AWS CLI. Durante la creazione dell'attività, specifica la destinazione Sidewalk e il numero di serie del dispositivo di cui desideri eseguire l'onboarding.

    Quando il numero di serie corrisponde alle informazioni corrispondenti contenute nel log di controllo ricevuto da Amazon Sidewalk, l'attività verrà eseguita e creerà il record del dispositivo wireless.

    Il seguente comando mostra un esempio di creazione di un'attività di importazione:

    aws iotwireless start-single-wireless-device-import-task \ --destination-name sidewalk_destination \ --sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'

    L'esecuzione di questo comando restituisce un ID e un ARN per l'attività di importazione.

    { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f" "Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f" }

Aggiornamento o eliminazione di attività di importazione

Se desideri aggiungere ulteriori dispositivi a un'attività di importazione, puoi aggiornare l'attività. Inoltre, puoi eliminare un'attività se non è più richiesta o se non è andata a buon fine. Per informazioni su quando aggiornare o eliminare un'attività, consultare Come utilizzare il provisioning in blocco Sidewalk.

avvertimento

Le operazioni di eliminazione sono permanenti e non possono essere annullate. L'eliminazione di un'attività di importazione già completata non rimuoverà i dispositivi finali di cui è già stato eseguito l'onboarding utilizzando l'attività.

Per aggiornare o eliminare attività di importazione:

  • Utilizzo della console di AWS IoT

    Nella procedura seguente viene illustrato come aggiornare o eliminare le attività di importazione mediante la console AWS IoT.

    Per aggiornare un'attività di importazione:
    1. Passa all'hub di Dispositivi Sidewalk della console AWS IoT.

    2. Scegli l'attività di importazione che desideri aggiornare, quindi seleziona Modifica.

    3. Fornisci un altro file S3 contenente i numeri di serie dei dispositivi che desideri aggiungere all'attività, quindi scegli Invia.

    Per eliminare un'attività di importazione:
    1. Passa all'hub di Dispositivi Sidewalk della console AWS IoT.

    2. Scegli l'attività che desideri eliminare, quindi seleziona Elimina.

  • Utilizzo dell'API Wireless AWS IoT o della AWS CLI

    Utilizza le seguenti operazioni API Wireless AWS IoT o i comandi dell'interfaccia a riga di comando per aggiornare o eliminare l'attività di importazione.