Provisioning dei dispositivi Sidewalk mediante attività di importazione - Wireless AWS IoT
Funzionamento del provisioning in blocco SidewalkConsiderazioni chiave per il provisioning in blocco di SidewalkFormato di file CSVCome utilizzare il provisioning in blocco Sidewalk

Provisioning dei dispositivi Sidewalk mediante attività di importazione

In questa sezione viene illustrato come effettuare il provisioning in blocco di dispositivi Sidewalk utilizzando la console AWS IoT, le operazioni API AWS IoT Core per Amazon Sidewalk o la AWS CLI. Nelle sezioni seguenti viene descritto come eseguire il provisioning in blocco dei dispositivi Sidewalk.

Argomenti

Funzionamento del provisioning in blocco Sidewalk

Nella procedura seguente viene illustrato il funzionamento del provisioning in blocco.

  1. Avvio dell'attività di importazione di dispositivi wireless

    Per effettuare il provisioning in blocco dei dispositivi Sidewalk, è necessario creare un'attività di importazione e fornire il numero di serie di produzione Sidewalk (SMSN) dei dispositivi di cui eseguire l'onboarding in AWS IoT Core per Amazon Sidewalk. Il numero di serie di produzione Sidewalk (SMSN) dei dispositivi è stato ottenuto come un file CSV nella casella e-mail dopo che il produttore ha caricato i log di controllo in Amazon Sidewalk. Per ulteriori informazioni sul flusso di lavoro e come ottenere il log di controllo, consultare la pagina relativa alla produzione di dispositivi Amazon Sidewalk nella documentazione di Amazon Sidewalk.

  2. Esecuzione del processo di importazione in background

    Quando AWS IoT Core per Amazon Sidewalk riceve la richiesta di attività di importazione, inizia a configurare gli oggetti e avvia un processo in background che esegue il polling del sistema frequentemente. Dopo che il processo in background riceve le istruzioni dell'attività di importazione, inizia a leggere il file CSV. AWS IoT Core per Amazon Sidewalk verifica contemporaneamente se i log di controllo sono stati ricevuti da Amazon Sidewalk.

  3. Creazione di record di dispositivi wireless

    Quando il log di controllo viene ricevuto da Amazon Sidewalk, AWS IoT Core per Amazon Sidewalk verifica se i numeri di serie nel log di controllo corrispondono ai valori SMSN nel file CSV. Se i numeri di serie corrispondono, AWS IoT Core per Amazon Sidewalk inizierà a creare record di dispositivi wireless per i dispositivi Sidewalk che corrispondono a questi numeri di serie. Dopo che è stato eseguito l'onboarding di tutti i dispositivi, l'attività di importazione viene contrassegnata come Completata.

Considerazioni chiave per il provisioning in blocco di Sidewalk

Di seguito sono riportate alcune considerazioni chiave quando si esegue il provisioning in blocco dei dispositivi Sidewalk in AWS IoT Core per Amazon Sidewalk.

  • Il provisioning in blocco deve essere eseguito utilizzando la console AWS IoT o le operazioni API AWS IoT Core per Amazon Sidewalk nello stesso Account AWS in cui è stato creato il profilo del dispositivo.

  • Prima di eseguire il provisioning in blocco dei dispositivi Sidewalk, il profilo del dispositivo deve già contenere informazioni sulla DAK che indicano il supporto di fabbrica. In caso contrario, il provisioning in blocco mediante la console AWS IoT o le operazioni API di provisioning in blocco potrebbero non andare a buon fine.

  • Dopo aver avviato un'attività di importazione, possono essere necessari almeno 10 minuti per elaborare il file CSV, importare i dispositivi wireless ed eseguire l'onboarding in AWS IoT Core per Amazon Sidewalk.

  • L'attività di importazione dei dispositivi wireless verrà eseguita per 90 giorni, una volta avviata. Durante questo periodo di tempo, viene verificato se i log di controllo sono stati ricevuti da Amazon Sidewalk. Se il log di controllo non viene ricevuto da Amazon Sidewalk entro 90 giorni, l'attività verrà contrassegnata come Completata con un messaggio che indica che è scaduta quando si visualizzano i dettagli dell'attività. Lo stato di onboarding dei dispositivi nell'attività di importazione che erano in attesa del log di controllo verrà contrassegnato come Non riuscito.

  • Quando tenti di aggiornare un'attività di importazione già creata, puoi aggiungere solo ulteriori dispositivi all'attività. Puoi aggiungere nuovi dispositivi in qualsiasi momento dopo la creazione di un'attività di importazione e prima che l'attività venga avviata sui dispositivi che erano già stati aggiunti all'attività di importazione. Se il file di aggiornamento contiene numeri di serie di dispositivi che esistono già nell'attività di importazione originale, questi numeri di serie verranno ignorati.

  • Quando richiedi un'operazione di aggiornamento, lo stesso ruolo IAM utilizzato durante la creazione dell'attività di importazione verrà assunto per accedere al file CSV nel bucket Amazon S3.

  • Un'attività di importazione può essere eliminata solo se è già stata completata o se l'aggiornamento dell'attività non è riuscito. L'aggiornamento di un'attività potrebbe non riuscire quando, ad esempio, è stato fornito un ruolo IAM errato o quando non è stato trovato un file bucket Amazon S3. Un'attività di importazione non può essere aggiornata o eliminata se si trova nello stato PENDING.

  • Il file CSV importato nell'attività deve utilizzare il formato descritto nella sezione seguente.

Formato di file CSV

Il file CSV contenuto in un bucket Amazon S3 specificato per l'attività di importazione deve utilizzare il formato seguente:

  • La riga 1 deve utilizzare la parola chiave smsn, che indica che il file CSV in corso di importazione contiene l'SMSN dei dispositivi da importare.

  • La riga 2 e quelle successive devono contenere l'SMSN dei dispositivi di cui eseguire l'onboarding. L'SMSN del dispositivo deve essere nel formato a 64 caratteri esadecimali.

Il file JSON seguente mostra un formato di file CSV di esempio.

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Come utilizzare il provisioning in blocco Sidewalk

Nella procedura seguente viene illustrato come utilizzare il provisioning in blocco Amazon Sidewalk.

  1. Fornire i numeri di serie del dispositivo

    Per eseguire il provisioning in blocco dei dispositivi Sidewalk, occorre fornire i numeri di serie dei dispositivi di cui eseguire l'onboarding. Puoi eseguire il provisioning dei dispositivi utilizzando uno dei seguenti metodi.

    • Effettua il provisioning di ciascun dispositivo singolarmente utilizzando il numero di serie di produzione Sidewalk (SMSN). Questo metodo è utile quando desideri eseguire il test del flusso di lavoro ed eseguire l'onboarding del dispositivo più rapidamente senza dover caricare un file CSV con il ruolo IAM appropriato o attendere che i dispositivi siano pronti per eseguirne l'onboarding nell'attività.

    • Effettua il provisioning in blocco dei dispositivi fornendo un URL del bucket Amazon S3 contenente l'SMSN dei dispositivi di cui effettuare il provisioning in un file CSV. Questo metodo è particolarmente utile quando disponi di un numero elevato di dispositivi di cui eseguire l'onboarding. In questo caso, l'onboarding di ciascun dispositivo singolarmente può essere noioso. Invece, è sufficiente fornire il percorso del file CSV che è stato caricato in un bucket Amazon S3 e il ruolo IAM per accedere al file.

  2. Ottenere l'attività di importazione e lo stato di onboarding dei dispositivi

    Per ogni attività di importazione creata, puoi recuperare informazioni sullo stato di onboarding dell'attività e sullo stato di onboarding dei dispositivi aggiunti all'attività. Puoi anche visualizzare ulteriori informazioni sullo stato, ad esempio un motivo per cui l'onboarding di un'attività o di un dispositivo non è andato a buon fine. Per ulteriori informazioni, consulta la pagina

  3. (Facoltativo) Aggiornamento o eliminazione dell'attività di importazione

    Puoi aggiornare o eliminare l'attività di importazione creata in precedenza.

    • Puoi aggiornare un'attività di importazione e aggiungere ulteriori dispositivi all'attività in qualsiasi momento prima che l'attività venga avviata sui dispositivi che sono già stati aggiunti. AWS IoT Core per Amazon Sidewalk assume lo stesso ruolo IAM utilizzato durante la creazione dell'attività di importazione. Quando crei l'attività, specifica il nuovo file CSV contenente i numeri di serie dei dispositivi che desideri aggiungere all'attività.

      Nota

      Durante l'aggiornamento di un'attività di importazione esistente, puoi solo aggiungere dispositivi all'attività. AWS IoT Core per Amazon Sidewalk esegue un'operazione di unione tra i dispositivi già presenti nell'attività di importazione e i dispositivi che stai tentando di aggiungere all'attività. Se il nuovo file contiene numeri di serie di dispositivi che esistono già nell'attività di importazione, questi numeri di serie verranno ignorati.

    • Puoi eliminare un'attività di importazione che è già stata completata o un'attività di importazione che non è stato possibile aggiornare come quando le informazioni sul ruolo IAM non sono corrette o quando un file del bucket S3 non è disponibile durante la creazione o l'aggiornamento di un'attività.

Argomenti