# AWS IoT Core per Amazon Sidewalk
AWS IoT Core per Amazon Sidewalk fornisce i servizi cloud che è possibile utilizzare per connettere i dispositivi finali Sidewalk ad Cloud AWS e utilizzare altri Servizio AWS.
Amazon Sidewalk è una rete sicura e condivisa che consente ai dispositivi della community di connettersi e rimanere connessi. Amazon Sidewalk trasferisce i dati tra i dispositivi finali Sidewalk e i gateway Sidewalk e tra i gateway Sidewalk e il cloud Sidewalk.
## Accesso ad AWS IoT Core per Amazon Sidewalk
È possibile eseguire l'onboarding dei dispositivi Sidewalk in AWS IoT utilizzando la console o le operazioni API Wireless AWS IoT. Dopo che è stato eseguito l'onboarding dei dispositivi, i relativi messaggi vengono inviati ad AWS IoT Core. Quindi, è possibile iniziare a sviluppare le applicazioni aziendali su AWS Cloud, che utilizza i dati dei dispositivi Amazon Sidewalk.
**Utilizzo della console**
Per eseguire l'onboarding dei dispositivi finali Sidewalk, accedi alla Console di gestione AWS e seleziona la pagina [Dispositivi](https://console.aws.amazon.com/iot/home#/wireless/devices) sulla console AWS IoT. Dopo aver eseguito l'onboarding dei dispositivi, puoi visualizzarli e gestirli in questa pagina della console IoT.
**Utilizzo dell'API o dell'interfaccia a riga di comando**
Puoi eseguire l'onboarding dei dispositivi Sidewalk e LoRaWAN utilizzando le [operazioni API Wireless AWS IoT](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/). L'API Wireless AWS IoT su cui si basa AWS IoT Core è supportata dall'SDK AWS. Per ulteriori informazioni, consulta [AWS SDKs and Toolkits (SDK e kit di strumenti )](https://aws.amazon.com/getting-started/tools-sdks/).
È possibile utilizzare la AWS CLI per eseguire comandi per l'onboarding e la gestione dei dispositivi finali Sidewalk. Per ulteriori informazioni, consulta la [documentazione di riferimento dell'interfaccia della riga di comando Wireless AWS IoT](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html).
## Regioni ed endpoint per AWS IoT Core per Amazon Sidewalk
Amazon Sidewalk è disponibile solo nella Regione AWS `us-east-1`. AWS IoT Core per Amazon Sidewalk fornisce supporto per gli endpoint API del piano di controllo (control-plane) e del piano dati in questa Regione. Gli endpoint API del piano dati sono specifici per Account AWS. Per ulteriori informazioni, consultare [Endpoint del servizio Wireless AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-wireless_region) in *Riferimenti generali di AWS*.
AWS IoT Core per Amazon Sidewalk dispone di quote applicabili ai dati del dispositivo che vengono trasmessi tra il dispositivo e Cloud AWS e il TPS massimo per le operazioni API Wireless AWS IoT. Per ulteriori informazioni, consultare [Wireless AWS IoT quotas](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#wireless-limits) in *Riferimenti generali di AWS*.
## Prezzi di AWS IoT Core per Amazon Sidewalk
Quando effettui la registrazione ad AWS, puoi iniziare a utilizzare AWS IoT Core per Amazon Sidewalk gratuitamente mediante il [Piano gratuito AWS](https://aws.amazon.com/free/).
Per ulteriori informazioni sulla panoramica generale del prodotto e sui prezzi, consulta [prezzi di AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).
# Cos'è AWS IoT Core per Amazon Sidewalk?
Con AWS IoT Core per Amazon Sidewalk, è possibile eseguire l'onboarding dei dispositivi finali Amazon Sidewalk in AWS IoT, nonché gestirli e monitorarli. Inoltre, consente di gestire le destinazioni che inviano i dati del dispositivo ad altri Servizi AWS.
## Caratteristiche di AWS IoT Core per Amazon Sidewalk
Utilizzando AWS IoT Core per Amazon Sidewalk, puoi:
+ Eseguire l'onboarding dei dispositivi finali Sidewalk in AWS IoT utilizzando la console AWS IoT, le operazioni API AWS IoT Core per Amazon Sidewalk o i comandi AWS CLI.
+ Sfruttare le funzionalità offerte da Cloud AWS.
+ Creare una destinazione che utilizza le regole AWS IoT per elaborare i messaggi di payload in entrata e interagire con altri Servizi AWS.
+ Abilitare le notifiche degli eventi per ricevere messaggi sugli eventi, ad esempio quando è stato effettuato il provisioning o la registrazione del dispositivo finale Sidewalk, o se un messaggio in downlink è stato recapitato al dispositivo.
+ Registrare e monitorare i dispositivi finali Sidewalk in tempo reale, ottenere informazioni utili, nonché identificare e risolvere gli errori.
+ Associare i dispositivi finali Sidewalk a un oggetto AWS IoT, che consente di archiviare una rappresentazione del dispositivo sul cloud. Gli oggetti in AWS IoT semplificano la ricerca e la gestione delle funzionalità e l'accesso ad altre funzionalità AWS IoT Core.
I seguenti argomenti ti aiuteranno a conoscere Amazon Sidewalk e AWS IoT Core per Amazon Sidewalk.
**Topics**
+ [Caratteristiche di AWS IoT Core per Amazon Sidewalk](#sidewalk-features)
+ [Cos'è Amazon Sidewalk?](amazon-sidewalk-overview.md)
+ [Come funziona AWS IoT Core per Amazon Sidewalk](iot-sidewalk-works.md)
# Cos'è Amazon Sidewalk?
Amazon Sidewalk è una rete di community sicura che utilizza Amazon Sidewalk Bridges, come dispositivi Amazon Echo e Ring compatibili, per fornire connettività cloud per dispositivi IoT. Amazon Sidewalk consente una connettività a bassa larghezza di banda e a lungo raggio in casa e oltre utilizzando Bluetooth LE per comunicazioni a breve distanza e protocolli radio LoRa e FSK a frequenze di 900 MHz per coprire distanze più lunghe.
Quando Amazon Sidewalk è abilitata, questa rete può supportare altri dispositivi finali Sidewalk nella community e può essere utilizzata per applicazioni come il rilevamento dell'ambiente. Amazon Sidewalk consente ai dispositivi di connettersi e rimanere connessi.
## Caratteristiche di Amazon Sidewalk
Di seguito sono riportate le caratteristiche di Amazon Sidewalk.
+ Amazon Sidewalk crea una rete a bassa larghezza di banda utilizzando gateway Sidewalk che includono dispositivi Ring ed Echo. Utilizzando i gateway, è possibile condividere una parte della larghezza di banda di Internet, che viene quindi utilizzata per connettere i dispositivi finali alla rete.
+ Amazon Sidewalk offre un meccanismo di rete sicuro con più livelli di crittografia e sicurezza.
+ Amazon Sidewalk offre un meccanismo semplice per abilitare o disabilitare la partecipazione a Sidewalk.
## Concetti di Amazon Sidewalk
Di seguito sono elencati alcuni concetti chiave di Amazon Sidewalk.
**Gateway Sidewalk**
I gateway Sidewalk, o bridge Amazon Sidewalk, instradano i dati tra i dispositivi finali Sidewalk e il cloud. I gateway sono dispositivi Amazon, come il dispositivo Echo o Ring Floodlight Cam, che supportano SubG-CSS (asincrono, LDR), SubG-FSK (sincrono, HDR) o Bluetooth LE per la comunicazione Sidewalk. I gateway Sidewalk condividono una parte della larghezza di banda di Internet con la community Sidewalk per fornire connettività a un gruppo di dispositivi abilitati per Sidewalk.
**Dispositivi finali Sidewalk**
I dispositivi finali Sidewalk eseguono il roaming su Amazon Sidewalk collegandosi ai gateway Sidewalk. I dispositivi finali sono prodotti intelligenti a bassa larghezza di banda e basso consumo, come luci o serrature abilitati per Sidewalk.
Alcuni gateway Sidewalk possono anche fungere da dispositivi finali.
**Sidewalk Network Server**
Il Sidewalk Network Server, gestito da Amazon, verifica i pacchetti in entrata e instrada i messaggi in uplink e in downlink alla destinazione desiderata, mantenendo la rete Sidewalk sincronizzata nel tempo.
## Ulteriori informazioni su Amazon Sidewalk
Per ulteriori informazioni su Amazon Sidewalk, consulta le pagine Web seguenti:
+ [Amazon Sidewalk](https://www.amazon.com/Amazon-Sidewalk/b?ie=UTF8&node=21328123011)
+ [Documentazione Amazon Sidewalk](https://docs.sidewalk.amazon/introduction/)
+ [AWS IoT Core per Amazon Sidewalk](https://aws.amazon.com/iot-core/sidewalk/)
# Come funziona AWS IoT Core per Amazon Sidewalk
Con AWS IoT Core per Amazon Sidewalk, è possibile eseguire l'onboarding dei dispositivi finali Amazon Sidewalk in AWS IoT, nonché gestirli e monitorarli. Inoltre, consente di gestire le destinazioni che inviano i dati del dispositivo ad altri Servizio AWS.
AWS IoT Core per Amazon Sidewalk fornisce i servizi cloud che è possibile utilizzare per connettere i dispositivi finali Sidewalk ad Cloud AWS e utilizzare altri Servizio AWS. È anche possibile utilizzare AWS IoT Core per Amazon Sidewalk per gestire i dispositivi Sidewalk e monitorare e creare applicazioni su di essi.
I dispositivi finali Sidewalk comunicano con AWS IoT Core tramite i gateway Sidewalk. AWS IoT Core per Amazon Sidewalk gestisce le policy dei servizi e dei dispositivi richiesti da AWS IoT Core per gestire e comunicare con i dispositivi finali e i gateway Sidewalk. Inoltre, consente di gestire le destinazioni che inviano i dati del dispositivo ad altri Servizio AWS.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/iot-sidewalk.png)
## Nozioni di base sull'utilizzo di AWS IoT Core per Amazon Sidewalk
È possibile utilizzare la console AWS IoT, l'API AWS IoT Core per Amazon Sidewalk o AWS CLI per creare ed eseguire l'onboarding dei dispositivi finali Sidewalk e collegarli alla rete Sidewalk. Per informazioni sulle nozioni di base sull'utilizzo di Amazon Sidewalk e sull'onboarding di dispositivi finali in AWS IoT, consulta gli argomenti seguenti.
+
**[Nozioni di base sull'utilizzo di AWS IoT Core per Amazon Sidewalk](sidewalk-getting-started.md)**
In questo argomento vengono descritti i prerequisiti per l'onboarding dei dispositivi finali Sidewalk, viene illustrato il flusso di lavoro utilizzando un'applicazione di monitoraggio dei sensori e viene fornita una panoramica su come eseguire l'onboarding del dispositivo mediante i comandi AWS CLI.
+
**[Connessione a AWS IoT Core per Amazon Sidewalk](iot-sidewalk-onboard.md)**
In questa sezione vengono descritti i diversi passaggi nell'introduzione al flusso di lavoro di onboarding e illustrato l'onboarding dei dispositivi finali mediante la console e le operazioni API. Verrà anche collegato il dispositivo e visualizzati i messaggi scambiati tra il dispositivo e AWS IoT Core per Amazon Sidewalk.
+
**[Dispositivi di provisioning in blocco con AWS IoT Core per Amazon Sidewalk](sidewalk-bulk-provisioning.md)**
In questa sezione viene fornito un tutorial dettagliato per il provisioning in blocco dei dispositivi finali Sidewalk utilizzando AWS IoT Core per Amazon Sidewalk. Verranno fornite informazioni sul flusso di lavoro di provisioning in blocco e su come eseguire l'onboarding di un numero elevato di dispositivi Sidewalk.
## Ulteriori informazioni su AWS IoT Core per Amazon Sidewalk
Per ulteriori informazioni su AWS IoT Core per Amazon Sidewalk, consulta le pagine Web seguenti:
+ [Amazon Sidewalk](https://www.amazon.com/Amazon-Sidewalk/b?ie=UTF8&node=21328123011)
+ [Documentazione Amazon Sidewalk](https://docs.sidewalk.amazon/introduction/)
+ [AWS IoT Core per Amazon Sidewalk](https://aws.amazon.com/iot-core/sidewalk/)
# Nozioni di base sull'utilizzo di AWS IoT Core per Amazon Sidewalk
In questa sezione viene illustrato come iniziare a connettere i dispositivi finali Sidewalk ad AWS IoT Core per Amazon Sidewalk. Viene descritto come connettere un dispositivo finale ad Amazon Sidewalk e scambiare messaggi tra di essi. Verranno fornite informazioni sull'applicazione di esempio Sidewalk e una panoramica su come eseguire il monitoraggio dei sensori utilizzando AWS IoT Core per Amazon Sidewalk. L'applicazione di esempio fornisce un pannello di controllo per visualizzare e monitorare le modifiche alla temperatura del sensore.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/sidewalk-getting-started.png)
I seguenti argomenti ti forniscono le nozioni di base per iniziare a utilizzare AWS IoT Core per Amazon Sidewalk.
**Topics**
+ [Prova del tutorial sul monitoraggio dei sensori](sidewalk-gs-tutorial.md)
+ [Introduzione all'onboarding dei dispositivi Sidewalk](sidewalk-gs-workflow.md)
# Prova del tutorial sul monitoraggio dei sensori
In questa sezione viene fornita una panoramica dell'applicazione di esempio Amazon Sidewalk su GitHub che mostra come monitorare la temperatura di un sensore. In questo tutorial vengono utilizzati script che creano in modo programmatico le risorse wireless richieste, effettuano il provisioning del dispositivo finale e memorizzano nella flash i file binari, quindi collegano il dispositivo finale all'applicazione. Gli script che utilizzano AWS CLI e i comandi Python creano uno stack AWS CloudFormation e risorse wireless, quindi memorizzano nella flash i file binari e distribuiscono l'applicazione sul kit di sviluppo dell'hardware (HDK).
Nel diagramma seguente vengono illustrati i passaggi coinvolti quando si esegue l'[applicazione di esempio](https://github.com/aws-samples/aws-iot-core-for-amazon-sidewalk-sample-app) e si collega il dispositivo finale Sidewalk all'applicazione. Per istruzioni dettagliate, inclusi i prerequisiti e la configurazione per questo tutorial, consultare il [documento README](https://github.com/aws-samples/amazon-sidewalk-sample-iot-app/blob/main/README.md) in *GitHub*.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/sidewalk-sensor-monitoring.png)
# Introduzione all'onboarding dei dispositivi Sidewalk
In questa sezione viene illustrato come eseguire l'onboarding dei dispositivi finali Sidewalk in AWS IoT Core per Amazon Sidewalk. Per eseguire l'onboarding dei dispositivi, aggiungi innanzitutto il dispositivo Sidewalk, effettua il provisioning del dispositivo e la registrazione, quindi connetti l'hardware all'applicazione cloud. Prima di eseguire questo tutorial, rivedi e completa [Installazione di Python e della AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq).
Nella procedura seguente viene illustrato come eseguire l'onboarding e collegare i dispositivi finali Sidewalk in AWS IoT Core per Amazon Sidewalk. Se desideri eseguire l'onboarding dei dispositivi utilizzando AWS CLI, puoi fare riferimento ai comandi di esempio forniti in questa sezione. Per informazioni sull'onboarding dei dispositivi mediante la console AWS IoT, consultare [Connessione a AWS IoT Core per Amazon Sidewalk](iot-sidewalk-onboard.md).
**Importante**
Per eseguire l'intero flusso di lavoro di onboarding, viene anche effettuato il provisioning e la registrazione del dispositivo finale e il collegamento del kit di sviluppo dell'hardware (HDK). Per ulteriori informazioni, consultare la pagina relativa al [provisioning e alla registrazione del dispositivo finale](https://docs.sidewalk.amazon/provisioning/) nella *documentazione di Amazon Sidewalk*.
**Topics**
+ [Fase 1: Aggiunta del dispositivo Sidewalk ad AWS IoT Core per Amazon Sidewalk](#iot-sidewalk-qsg-step1)
+ [Fase 2: Creazione di una destinazione per il dispositivo finale Sidewalk](#iot-sidewalk-qsg-step2)
+ [Fase 3: Effettuare il provisioning e registrare il dispositivo finale](#iot-sidewalk-qsg-step2)
+ [Fase 4: Connessione a un dispositivo finale Sidewalk e scambio di messaggi](#iot-sidewalk-qsg-step4)
## Fase 1: Aggiunta del dispositivo Sidewalk ad AWS IoT Core per Amazon Sidewalk
Di seguito viene fornita una panoramica della procedura eseguita per aggiungere il dispositivo finale Sidewalk ad AWS IoT Core per Amazon Sidewalk. Archivia le informazioni ottenute sul profilo del dispositivo e sul dispositivo wireless che viene creato. Utilizzerai queste informazioni per effettuare il provisioning e la registrazione del dispositivo finale. Per ulteriori informazioni su questa procedura, consultare [Aggiunta del dispositivo ad AWS IoT Core per Amazon Sidewalk](iot-sidewalk-create-device.md).
1.
**Creazione di un profilo del dispositivo**
Crea un profilo del dispositivo contenente le configurazioni condivise per i dispositivi Sidewalk. Durante la creazione del profilo, specifica un `name` per il profilo come una stringa alfanumerica. Per creare un profilo, vai alla [scheda Sidewalk dell'hub Profili](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) nella console AWS IoT e scegli **Crea profilo** oppure utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html) come mostrato in questo esempio.
```
// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}
```
1.
**Creazione del dispositivo finale Sidewalk**
Crea il tuo dispositivo finale Sidewalk con AWS IoT Core per Amazon Sidewalk. Specifica un nome destinazione e l'ID del profilo del dispositivo ottenuto nella fase precedente. Per aggiungere un dispositivo, vai alla [scheda Sidewalk dell'hub Dispositivi](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) nella console AWS IoT e scegli **Provisioning del dispositivo** oppure utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) come mostrato in questo esempio.
**Nota**
Specifica un nome per la destinazione che sia univoco per Account AWS e Regione AWS. Lo stesso nome destinazione verrà utilizzato quando si aggiunge la destinazione ad AWS IoT Core per Amazon Sidewalk.
```
// Add your Sidewalk device by using the device profile ID.
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \
--destination-name SidewalkDestination \
--sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"
```
1.
**Ottenere informazioni sul profilo del dispositivo e sul dispositivo wireless**
Ottieni le informazioni sul profilo del dispositivo e sul dispositivo wireless come un file JSON. Il file JSON contiene informazioni sui dettagli del dispositivo, i certificati dei dispositivi, le chiavi private, `DeviceTypeId` e il numero di serie di produzione Sidewalk (SMSN).
+ Se stai usando la console AWS IoT, puoi utilizzare la [scheda Sidewalk dell'hub Dispositivi](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) per scaricare un file JSON combinato per il dispositivo finale Sidewalk.
+ Se stai usando le operazioni API, archivia le risposte ottenute dalle operazioni API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) e [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) come file JSON separati, ad esempio *`device_profile.json`* e `wireless_device.json`.
```
// Store device profile information as a JSON file.
aws iotwireless get-device-profile \
--id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json
// Store wireless device information as a JSON file.
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json
```
## Fase 2: Creazione di una destinazione per il dispositivo finale Sidewalk
Di seguito viene fornita una panoramica della procedura che verrà eseguita per aggiungere la destinazione ad AWS IoT Core per Amazon Sidewalk. Utilizzando la Console di gestione AWS, le operazioni API Wireless AWS IoT o AWS CLI, esegui i seguenti passaggi per creare una regola AWS IoT e una destinazione. Puoi quindi eseguire la connessone alla piattaforma hardware e visualizzare e scambiare messaggi. Per un esempio di ruolo IAM e regola AWS IoT utilizzati per gli esempi AWS CLI di questa sezione, consultare [Creazione di un ruolo IAM e della regola IoT per la destinazione](sidewalk-destination-rule-role.md).
1.
**Creazione di un ruolo IAM**
Crea un ruolo IAM che concede l'autorizzazione AWS IoT Core per Amazon Sidewalk per inviare dati alla regola AWS IoT. Per creare il ruolo, utilizza l'operazione API [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role). Puoi assegnate al ruolo il nome *`SidewalkRole`*.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
1.
**Creazione di una regola per la destinazione**
Crea una regola AWS IoT che elabora i dati del dispositivo e specifica l'argomento in cui vengono pubblicati i messaggi. I messaggi su questo argomento verranno visualizzati dopo la connessione alla piattaforma hardware. Utilizza l'operazione API AWS IoT Core, [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html) o il comando AWS CLI, [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), per creare una regola per la destinazione.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
1.
**Creazione di una destinazione**
Crea una destinazione che associa il dispositivo Sidewalk alla regola IoT utilizzata per elaborarlo per l'uso con altri Servizi AWS. Puoi aggiungere una destinazione utilizzando l'[hub Destinazioni](https://console.aws.amazon.com/iot/home#/wireless/destinations) della console AWS IoT, l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html).
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
## Fase 3: Effettuare il provisioning e registrare il dispositivo finale
Utilizzando i comandi Python, è possibile effettuare il provisioning e la registrazione del dispositivo finale. Lo script di provisioning utilizza i dati JSON del dispositivo ottenuti per generare un'immagine binaria di produzione, che viene memorizzata nella flash sulla scheda hardware. Il dispositivo finale viene quindi registrato per la connessione alla piattaforma hardware. Per ulteriori informazioni, consultare la pagina relativa al [provisioning e alla registrazione del dispositivo finale](https://docs.sidewalk.amazon/provisioning/) nella *documentazione di Amazon Sidewalk*.
**Nota**
Durante la registrazione del dispositivo finale Sidewalk, il gateway deve fornire il consenso esplicito ad Amazon Sidewalk e il gateway e il dispositivo devono trovarsi entro una determinata distanza tra loro.
## Fase 4: Connessione a un dispositivo finale Sidewalk e scambio di messaggi
Dopo aver registrato il dispositivo finale, è possibile connetterlo e iniziare a scambiare messaggi e dati del dispositivo.
1.
**Connessione del dispositivo finale Sidewalk**
Collega l'HDK al computer e segui le istruzioni fornite dalla documentazione del fornitore per connetterti all'HDK. Per ulteriori informazioni, consultare la pagina relativa al [provisioning e alla registrazione del dispositivo finale](https://docs.sidewalk.amazon/provisioning/) nella *documentazione di Amazon Sidewalk*.
1.
**Visualizzazione e scambio di messaggi**
Utilizza il client MQTT per effettuare la sottoscrizione all'argomento specificato nella regola e visualizzare il messaggio ricevuto. Puoi anche utilizzare l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html) o il comando della riga di comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html) per inviare un messaggio in downlink al dispositivo e verificare lo stato della connettività.
(Facoltativo) Puoi abilitare gli eventi sullo stato di consegna dei messaggi per verificare se il messaggio in downlink è stato ricevuto correttamente.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```
# Connessione a AWS IoT Core per Amazon Sidewalk
In questa sezione viene illustrato come eseguire l'onboarding del dispositivo finale Sidewalk e quindi connetterlo alla rete Sidewalk. Vengono descritti i passaggi eseguiti nel tutorial di onboarding, come indicato in [Introduzione all'onboarding dei dispositivi Sidewalk](sidewalk-gs-workflow.md). Verranno fornite informazioni su come eseguire l'onboarding dei dispositivi mediante la console AWS IoT per Amazon Sidewalk e le operazioni API AWS IoT Core. Inoltre, verranno fornite informazioni sui comandi AWS CLI che eseguono queste operazioni.
## Prerequisiti
Per aggiungere il dispositivo finale e la destinazione ad AWS IoT Core per Amazon Sidewalk, devi configurare Account AWS. Per eseguire queste operazioni mediante l'API Wireless AWS IoT o i comandi AWS CLI, devi anche configurare AWS CLI. Per ulteriori informazioni sui prerequisiti e la configurazione, consultare [Installazione di Python e della AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq).
**Nota**
Per eseguire l'intero flusso di lavoro di onboarding per il provisioning e la registrazione del dispositivo finale e la connessione al kit di sviluppo dell'hardware (HDK), devi anche configurare il gateway Sidewalk e HDK. Per ulteriori informazioni, consultare le pagine relative alla [configurazione del kit di sviluppo dell'hardware (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) e alla [configurazione di un gateway Sidewalk](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) nella *documentazione di Amazon Sidewalk*.
## Descrizione delle risorse Sidewalk
Prima di iniziare a creare le risorse, è consigliabile considerare la convenzione di denominazione dei dispositivi finali Sidewalk, dei profili dei dispositivi e delle destinazioni. AWS IoT Core per Amazon Sidewalk assegna un identificatore univoco alle risorse create. Tuttavia, puoi assegnare nomi più descrittivi, aggiungere una descrizione o aggiungere tag opzionali per facilitare l'identificazione e la gestione.
**Nota**
Il nome della destinazione non può essere modificato dopo che è stato creato. Utilizza un nome univoco per Account AWS e Regione AWS.
Per ulteriori informazioni, consultare [Descrizione delle risorse Wireless AWS IoT](iotwireless-describe-resources.md).
**Topics**
+ [Prerequisiti](#sidewalk-connect-prereq)
+ [Descrizione delle risorse Sidewalk](#sidewalk-connect-resources)
+ [Aggiunta del dispositivo ad AWS IoT Core per Amazon Sidewalk](iot-sidewalk-create-device.md)
+ [Aggiunta di una destinazione per il dispositivo finale Sidewalk](iot-sidewalk-qsg-destination.md)
+ [Connetti il tuo dispositivo Sidewalk e visualizza il formato dei metadati uplink](iot-sidewalk-connect-uplink-metadata.md)
# Aggiunta del dispositivo ad AWS IoT Core per Amazon Sidewalk
Prima di creare un dispositivo wireless, crea innanzitutto un profilo del dispositivo. I profili dei dispositivi definiscono le funzionalità del dispositivo e altri parametri per i dispositivi Sidewalk. Un singolo profilo del dispositivo può essere associato a più dispositivi.
Dopo che hai creato un profilo del dispositivo, quando recuperi informazioni sul profilo, viene restituito un `DeviceTypeId`. Quando effettui il provisioning del dispositivo finale, utilizzerai questo ID, i certificati dei dispositivi, la chiave pubblica del server di applicazioni e l'SMSN.
## Come creare e aggiungere il dispositivo
1. Crea un profilo del dispositivo per i dispositivi finali Sidewalk. Specifica un nome del profilo da utilizzare per i dispositivi Sidewalk come una stringa alfanumerica. Il profilo consentirà di identificare i dispositivi a cui associarlo.
+ (Console) Durante l'aggiunta del dispositivo Sidewalk, puoi anche creare un nuovo profilo. Questo consente di aggiungere rapidamente il dispositivo ad AWS IoT Core per Amazon Sidewalk e associarlo a un profilo.
+ (API) Utilizza l'operazione API `CreateDeviceProfile` specificando un nome del profilo e l'oggetto Sidewalk, `sidewalk {}`. La risposta API conterrà un ID profilo e un ARN (Amazon Resource Name).
1. Aggiunta del dispositivo wireless ad AWS IoT Core per Amazon Sidewalk. Specifica un nome di destinazione e scegli il profilo del dispositivo creato nella fase precedente.
+ (Console) Durante l'aggiunta del dispositivo Sidewalk, inserisci un nome di destinazione e scegli il profilo creato.
+ (API) Utilizza l'operazione API `CreateWirelessDevice`. Specifica un nome di destinazione e l'ID del profilo del dispositivo ottenuto in precedenza.
**Parametri dei dispositivi wireless**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-sidewalk-create-device.html)
1. Ottieni il file JSON contenente le informazioni richieste per il provisioning del dispositivo finale.
+ (Console) Scarica questo file dalla pagina dei dettagli del dispositivo Sidewalk creato.
+ (API) Utilizza le operazioni API `GetDeviceProfile` e `GetWirelessDevice` per recuperare informazioni sul profilo del dispositivo e sul dispositivo wireless. Archivia le informazioni della risposta API come file JSON, ad esempio *`device_profile.json`* e *`wireless_device.json`*.
# 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), scegli **Provisioning del dispositivo**, quindi esegui la procedura seguente.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/iot-sidewalk-provision-device.PNG)
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.
1. 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](https://console.aws.amazon.com/iot/home#/wireless/profiles), quindi modifica il profilo per aggiungere queste informazioni.
1. 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](https://console.aws.amazon.com/iot/home#/wireless/destinations) per crearla. Puoi quindi scegliere tale destinazione per il dispositivo Sidewalk. Per ulteriori informazioni, consultare [Aggiunta di una destinazione per il dispositivo finale Sidewalk](iot-sidewalk-qsg-destination.md).
1. Scegli **Avanti** per continuare ad aggiungere il dispositivo Sidewalk.
1.
**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.
1. 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.
1. 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.
**Topics**
+ [Fase 1: Creazione di un profilo del dispositivo](#iot-sidewalk-profile-create)
+ [Fase 2: Aggiunta del dispositivo Sidewalk](#iot-sidewalk-device-create)
### Fase 1: Creazione di un profilo del dispositivo
Per creare un profilo del dispositivo in Account AWS, utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html). 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html). 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html).
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"
}
```
# 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](https://docs.sidewalk.amazon/provisioning/) 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk).
1. Scegli il dispositivo aggiunto ad AWS IoT Core per Amazon Sidewalk per visualizzarne i relativi dettagli.
1. 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.
**Topics**
+ [Fase 1: Ottenere le informazioni sul profilo del dispositivo come file JSON](#iot-sidewalk-profile-get)
+ [Fase 2: Ottenere informazioni sul dispositivo Sidewalk come un file JSON](#iot-sidewalk-get-device)
### Fase 1: Ottenere le informazioni sul profilo del dispositivo come file JSON
Utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html) 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html).
**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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html).
**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.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 finale](https://docs.sidewalk.amazon/provisioning/) nella *documentazione di Amazon Sidewalk*.
# Aggiunta di una destinazione per il dispositivo finale Sidewalk
Utilizza regole AWS IoT per elaborare i dati e i messaggi dei dispositivi e instradarli ad altri servizi. Puoi anche definire regole per elaborare i messaggi binari ricevuti da un dispositivo e convertire i messaggi in altri formati per essere utilizzati da altri servizi. Destinazioni associano il dispositivo finale Sidewalk alla regola che elabora i dati del dispositivo da inviare ad altri Servizio AWS.
## Come creare e utilizzare una destinazione
1. Crea una regola AWS IoT e un ruolo IAM per la destinazione. La regola AWS IoT specifica le regole che elaborano i dati del dispositivo e li instrada per essere utilizzati da altri Servizio AWS e dalle applicazioni. Il ruolo IAM concede l'autorizzazione per accedere alla regola.
1. Crea una destinazione per i dispositivi Sidewalk utilizzando l'operazione API `CreateDestination`. Specifica il nome della destinazione, il nome della regola, il nome del ruolo ed eventuali parametri facoltativi. L'API restituirà un identificatore univoco per la destinazione, che puoi specificare durante l'aggiunta del dispositivo finale ad AWS IoT Core per Amazon Sidewalk.
Di seguito viene illustrato come creare una destinazione, una regola AWS IoT e un ruolo IAM per la destinazione.
**Topics**
+ [Come creare e utilizzare una destinazione](#iot-sidewalk-destination-how)
+ [Creazione di una destinazione per il dispositivo Sidewalk](iot-sidewalk-destination-create.md)
+ [Creazione di un ruolo IAM e della regola IoT per la destinazione](sidewalk-destination-rule-role.md)
# Creazione di una destinazione per il dispositivo Sidewalk
Puoi aggiungere una destinazione all'account per AWS IoT Core per Amazon Sidewalk mediante l'[hub Destinazioni](https://console.aws.amazon.com/iot/home#/wireless/destinations) o `CreateDestination`. Durante la creazione della destinazione, specifica:
+ Un nome univoco per la destinazione da utilizzare per il dispositivo finale Sidewalk.
**Nota**
Se aggiungi già il dispositivo utilizzando un nome della destinazione, devi usare tale nome quando crei la destinazione. Per ulteriori informazioni, consultare [Fase 2: Aggiunta del dispositivo Sidewalk](iot-sidewalk-add-device.md#iot-sidewalk-device-create).
+ Il nome della regola AWS IoT che elabora i dati del dispositivo e l'argomento in cui vengono pubblicati i messaggi.
+ Il ruolo IAM che concede l'autorizzazione ai dati del dispositivo per accedere alla regola.
Nelle sezioni seguenti viene descritto come creare la regola AWS IoT e il ruolo IAM per la destinazione.
## Creazione di una destinazione (console)
Per creare una destinazione utilizzando la console AWS IoT, passa all'[hub Destinazioni](https://console.aws.amazon.com/iot/home#/wireless/destinations) e scegli **Aggiungi destinazione**.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/iot-sidewalk-add-destination.PNG)
Per elaborare i dati di un dispositivo, specifica i seguenti campi durante la creazione di una destinazione, quindi scegli **Aggiungi destinazione**.
+
**Dettagli della destinazione**
Inserisci un **Nome della destinazione** e una descrizione facoltativa per la destinazione.
+
**Nome regola**
La regola AWS IoT configurata per valutare i messaggi inviati dal tuo dispositivo ed elaborare i dati del dispositivo. Il nome della regola verrà mappato alla tua destinazione. La destinazione richiede la regola per elaborare i messaggi ricevuti. È possibile scegliere se elaborare i messaggi richiamando una regola AWS IoT o pubblicando sul broker di messaggi AWS IoT.
+ Se scegli **Ente a rule name (Inserisci il nome di una regola)**, inserisci un nome, e quindi scegli **Copy (Copia)** per copiare il nome di una regola che inserirai quando crei la regola AWS IoT. Puoi scegliere **Create a rule (Crea una regola)** per creare la regola ora o passare all'hub [ Rules (Regole)](https://console.aws.amazon.com/iot/home#/create/rule) della console AWS IoT e creare una regola con quel nome.
Puoi anche inserire una regola e utilizzare impostazione **Advanced (Avanzata)** per specificare un nome dell'argomento. Il nome dell'argomento viene fornito durante l'invocazione della regola e si accede utilizzando l'espressione `topic` all'interno della regola. Per ulteriori informazioni sulle regole AWS IoT, consultare [Regole AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html).
+ Se scegli **Publish to AWS IoT message broker** (Pubblica sul broker di messaggi IoT), inserisci un nome di argomento. È quindi possibile copiare il nome dell'argomento MQTT e più sottoscriventi possono iscriversi a questo argomento per ricevere messaggi pubblicati su tale argomento. Per ulteriori informazioni, consultare [Argomenti MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).
Per ulteriori informazioni sulle regole AWS IoT per le destinazioni, consultare [Creare regole per elaborare i messaggi del dispositivo LoRaWAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
+
**Nome ruolo**
Il ruolo IAM che fornisce al dispositivo l'autorizzazione ai dati per accedere alla regola denominata in **Rule name (Nome regola)**. Nella console puoi creare un nuovo ruolo di servizio o selezionare un ruolo di servizio già esistente. Se stai creando un nuovo ruolo di servizio, puoi inserire un nome di ruolo (ad esempio, **SidewalkDestinationRole**), o lasciare vuoto per consentire a AWS IoT Core per LoRaWAN di generare un nuovo nome ruolo. AWS IoT Core per LoRaWAN creerà automaticamente il ruolo IAM con le autorizzazioni appropriate per tuo conto.
## Creazione di una destinazione (interfaccia a riga di comando)
Per creare una destinazione, utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html). Ad esempio, il comando seguente crea una destinazione per il dispositivo finale Sidewalk:
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
L'esecuzione di questo comando restituisce i dettagli della destinazione, che includono il nome della risorsa Amazon (ARN) e il nome della destinazione.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination",
"Name": "SidewalkDestination"
}
```
Per ulteriori informazioni sulla creazione di una destinazione, consultare [Creare regole per elaborare i messaggi del dispositivo LoRaWAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
# Creazione di un ruolo IAM e della regola IoT per la destinazione
Le regole AWS IoT inviano messaggi del dispositivo ad altri servizi. Le regole AWS IoT possono anche elaborare i messaggi binari ricevuti da un dispositivo finale Sidewalk per l'utilizzo in altri servizi. Le destinazioni AWS IoT Core per Amazon Sidewalk associano un dispositivo wireless alla regola che elabora i dati dei messaggi del dispositivo da inviare ad altri servizi. La regola agisce sui dati del dispositivo non appena vengono ricevuti da AWS IoT Core per Amazon Sidewalk. Per tutti i dispositivi che inviano i propri dati allo stesso servizio, è possibile creare una destinazione che può essere condivisa da tutti i dispositivi. È inoltre necessario creare un ruolo IAM che conceda l'autorizzazione per inviare dati alla regola.
## Creazione di un ruolo IAM per la destinazione
Crea un ruolo IAM che concede l'autorizzazione AWS IoT Core per Amazon Sidewalk per inviare dati alla regola AWS IoT. Per creare il ruolo, utilizza l'operazione API [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role). Puoi denominare il ruolo come *`SidewalkRole`*.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
```
È inoltre possibile definire la policy di affidabilità per il ruolo utilizzando un file JSON.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document file://trust-policy.json
```
Nell'esempio seguente viene mostrato il contenuto del file JSON.
**Contenuto di trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Creazione di una regola per la destinazione
Utilizza l'operazione API AWS IoT Core, [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html) o il comando AWS CLI, [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), per creare una regola. La regola dell'argomento verrà utilizzata dalla destinazione per instradare i dati ricevuti dal dispositivo finale Sidewalk ad altri Servizi AWS. Ad esempio, è possibile creare un'operazione della regola che invia un messaggio a una funzione Lambda. È possibile definire la funzione Lambda in modo che riceva i dati dell'applicazione dal dispositivo e utilizzi base64 per decodificare i dati del payload in modo da poter essere utilizzati da altre applicazioni.
Nelle fasi seguenti viene illustrato come creare la funzione Lambda e quindi una regola dell'argomento che invia un messaggio a questa funzione.
1.
**Creazione del ruolo di esecuzione e della policy**
Crea il ruolo IAM che concede alla funzione l'autorizzazione per accedere alle risorse AWS. È inoltre possibile definire la policy di affidabilità per il ruolo utilizzando un file JSON.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
Nell'esempio seguente viene mostrato il contenuto del file JSON.
**Contenuto di lambda-trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
1.
**Creazione e verifica della funzione Lambda**
Esegui la procedura seguente per creare una funzione AWS Lambda che esegue la decodifica base64 dei dati del payload.
1. Scrivi il codice per decodificare i dati del payload. Ad esempio, puoi utilizzare il seguente codice Python di esempio. Specifica un nome per lo script, ad esempio *`base64_decode.py`*.
**Contenuto di base64\$1decode.py**
```
// -----------------------------------------------------------
// ----- Python script to decode incoming binary payload -----
// -----------------------------------------------------------
import json
import base64
def lambda_handler(event, context):
message = json.dumps(event)
print (message)
payload_data = base64.b64decode(event["PayloadData"])
print(payload_data)
print(int(payload_data,16))
```
1. Crea un pacchetto di implementazione come un file zip contenente il file Python e assegna un nome come `base64_decode.zip`. Utilizza l'API `CreateFunction` o il comando dell'interfaccia a riga di comando `create-function` per creare una funzione Lambda per il codice di esempio, *`base64_decode.py`*.
1.
```
aws lambda create-function --function-name my-function \
--zip-file fileb://base64_decode.zip --handler index.handler \
--runtime python3.9 --role arn:aws:iam::123456789012:role/lambda-ex
```
Vedrai il seguente output. Durante la creazione della regola dell'argomento, utilizzerai il valore nome della risorsa Amazon (ARN) dell'output, `FunctionArn`.
```
{
"FunctionName": "my-function",
"FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function",
"Runtime": "python3.9",
"Role": "arn:aws:iam::123456789012:role/lambda-ex",
"Handler": "index.handler",
"CodeSha256": "FpFMvUhayLkOoVBpNuNiIVML/tuGv2iJQ7t0yWVTU8c=",
"Version": "$LATEST",
"TracingConfig": {
"Mode": "PassThrough"
},
"RevisionId": "88ebe1e1-bfdf-4dc3-84de-3017268fa1ff",
...
}
```
1. Per ottenere i log per una chiamata dalla riga di comando, utilizza l'opzione `--log-type` con il comando `invoke`. La risposta include un campo LogResult contenente fino a 4 KB di log con codifica base64 dalla chiamata.
```
aws lambda invoke --function-name my-function out --log-type Tail
```
La risposta ricevuta deve contenere un `StatusCode` di 200. Per ulteriori informazioni sulla creazione e l'utilizzo di funzioni Lambda da AWS CLI, consultare [Utilizzo di Lambda con AWS CLI](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-awscli.html).
1. Creazione di una regola dell'argomento
Utilizza l'API `CreateTopicRule` o il comando dell'interfaccia a riga di comando `create-topic-rule` per creare una regola dell'argomento che invia un messaggio a questa funzione Lambda. Puoi anche aggiungere una seconda operazione della regola che ripubblica su un argomento AWS IoT. Assegna a questa regola dell'argomento un nome come `Sidewalkrule`.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
Puoi utilizzare il file `myrule.json` per specificare ulteriori dettagli relativi alla regola. Ad esempio, il seguente file JSON mostra come ripubblicare su un argomento AWS IoT e inviare un messaggio a una funzione Lambda.
```
{
"sql": "SELECT * ",
"actions": [
{
// You obtained this functionArn when creating the Lambda function using the
// create-function command.
"lambda": {
"functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
}
},
{
// This topic can be used to observe messages exchanged between the device and
// AWS IoT Core for Amazon Sidewalk after the device is connected.
"republish": {
"roleArn": "arn:aws:iam::123456789012:role/service-role/SidewalkRepublishRole",
"topic": "project/sensor/observed"
}
}
],
}
```
# Connetti il tuo dispositivo Sidewalk e visualizza il formato dei metadati uplink
In questo tutorial, verrà utilizzato il client di test MQTT per testare la connettività e visualizzare i messaggi scambiati tra il dispositivo finale e Cloud AWS. Per ricevere messaggi, nel client di test MQTT, effettua la sottoscrizione all'argomento specificato durante la creazione della regola IoT per la destinazione. Puoi anche inviare un messaggio in downlink da AWS IoT Core per Amazon Sidewalk al dispositivo utilizzando l'operazione API `SendDataToWirelessDevice`. Puoi verificare che il messaggio sia stato recapitato abilitando la notifica eventi per lo stato della consegna del messaggio.
**Nota**
Per informazioni sulla connessione della piattaforma hardware e la relativa configurazione, consultare le pagine relative al [provisioning e alle registrazione del dispositivo finale](https://docs.sidewalk.amazon/provisioning/) e alla [configurazione del kit di sviluppo dell'hardware (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) nella *documentazione di Amazon Sidewalk*.
## Invio di messaggi in downlink al dispositivo finale
Utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html) per inviare messaggi in downlink da AWS IoT Core per Amazon Sidewalk al dispositivo finale Sidewalk. Di seguito viene illustrato un esempio di come eseguire questo comando. I dati del payload sono i dati binari da inviare, codificati in base64.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```
Di seguito viene mostrato un output di esempio di esecuzione di questo comando, che è un ID del messaggio in downlink inviato al dispositivo.
```
{
MessageId: "6011dd36-0043d6eb-0072-0008"
}
```
**Nota**
L'API `SendDataToWirelessDevice` può restituire un ID messaggio, ma il messaggio potrebbe non essere recapitato correttamente. Per verificare lo stato del messaggio inviato al dispositivo, è possibile abilitare gli eventi sullo stato della consegna del messaggio per gli account e i dispositivi Sidewalk. Per ulteriori informazioni su come abilitare questo evento, consultare [Notifiche di eventi per le risorse Sidewalk](iot-sidewalk-events.md). Per ulteriori informazioni su questo tipo di evento, consultare [Eventi di consegna dei messaggi](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk-message-delivery-events.html).
## Visualizzazione del formato dei messaggi in uplink dal dispositivo
Dopo aver collegato il dispositivo, è possibile effettuare la sottoscrizione all'argomento (ad esempio, *`project/sensor/observed`*) specificato durante la creazione della regola di destinazione e osservare i messaggi in uplink dal dispositivo.
Se durante la creazione della destinazione è stato specificato il nome di un argomento, è possibile eseguire la sottoscrizione all'argomento per monitorare i messaggi in uplink dal dispositivo finale. Passa a [Client di test MQTT](https://console.aws.amazon.com/iot/home#/test) nella pagina **Test** della console AWS IoT, inserisci il nome dell'argomento (ad esempio, *`project/sensor/observed`*), quindi scegli **Sottoscrizione**.
Nell'esempio seguente viene illustrato il formato dei messaggi di uplink inviati da dispositivi Sidewalk ad AWS IoT. `WirelessMetadata` contiene metadati relativi alla richiesta di messaggio.
```
{
"PayloadData":"ZjRlNjY1ZWNlNw==",
"WirelessDeviceId":"wireless_device_id",
"WirelessMetadata":{
"Sidewalk":{
"CmdExStatus":"Cmd",
"SidewalkId":"device_id",
"Seq":0,
"MessageType":"messageType"
}
}
}
```
Nella tabella seguente viene illustrata una definizione dei diversi parametri nei metadati uplink. `device-id` è l'ID del dispositivo wireless, ad esempio `ABCDEF1234`, e `messageType` è il tipo di messaggio in uplink ricevuto dal dispositivo.
**Parametri dei metadati uplink di Sidewalk**
| Parametro | Descrizione | Type | Richiesto |
| --- | --- | --- | --- |
| PayloadData | Il payload del messaggio inviato dal dispositivo wireless. | Stringa | Sì |
| WirelessDeviceID | L'identificatore del dispositivo wireless che invia i dati | Stringa | Sì |
| Sidewalk.CmdExStatus | Stato del comando runtime. I messaggi del tipo di risposta devono includere il codice di stato, `COMMAND_EXEC_STATUS_SUCCESS`. Tuttavia, le notifiche potrebbero non includere il codice di stato. | Enumerazione | No |
| Sidewalk.NackExStatus | Stato del nack di risposta, che può essere `RADIO_TX_ERROR` o `MEMORY_ERROR`. | Gamma di stringhe | No |
# Dispositivi di provisioning in blocco con AWS IoT Core per Amazon Sidewalk
È possibile utilizzare il provisioning in blocco per eseguire l'onboarding di un numero elevato di dispositivi finali in AWS IoT Core per Amazon Sidewalk in blocco. Il provisioning in blocco è utile soprattutto quando si produce un numero elevato di dispositivi in una fabbrica e si desidera eseguirne l'onboarding in AWS IoT. Per ulteriori informazioni sulla produzione di dispositivi, consultare la pagina relativa alla [produzione di dispositivi Amazon Sidewalk](https://docs.sidewalk.amazon/manufacturing/) nella *documentazione di Amazon Sidewalk*.
Negli argomenti riportati di seguito viene illustrato il funzionamento del provisioning in blocco.
+
**[Flusso di lavoro del provisioning in blocco Amazon Sidewalk](sidewalk-bulk-provisioning-workflow.md)**
In questo argomento vengono illustrati alcuni concetti chiave del provisioning in blocco e del relativo funzionamento. Vengono anche illustrati i passaggi che devono essere eseguiti per poter importare i dispositivi in AWS IoT Core per Amazon Sidewalk.
+
**[Creazione dei profili dei dispositivi con supporto di fabbrica](sidewalk-provision-profile.md)**
In questo argomento viene descritto come creare un profilo del dispositivo e ottenere il supporto di fabbrica corrispondente. Verranno inoltre fornite informazioni su come recuperare la chiave YubiHSM e inviarla al produttore per ottenere il log di controllo dopo che i dispositivi sono stati prodotti.
+
**[Provisioning dei dispositivi Sidewalk mediante attività di importazione](sidewalk-provision-bulk-import.md)**
In questo argomento viene illustrato come eseguire il provisioning in blocco dei dispositivi Sidewalk creando e utilizzando attività di importazione. Verrà anche descritto come aggiornare o eliminare le attività di importazione e visualizzare lo stato dell'attività di importazione e dei dispositivi nell'attività.
**Topics**
+ [Flusso di lavoro del provisioning in blocco Amazon Sidewalk](sidewalk-bulk-provisioning-workflow.md)
+ [Creazione dei profili dei dispositivi con supporto di fabbrica](sidewalk-provision-profile.md)
+ [Provisioning dei dispositivi Sidewalk mediante attività di importazione](sidewalk-provision-bulk-import.md)
# Flusso di lavoro del provisioning in blocco Amazon Sidewalk
Nelle sezioni seguenti vengono illustrati i concetti chiave del provisioning in blocco e il relativo funzionamento. Le fasi coinvolte nel provisioning in blocco includono:
1. Creazione di un profilo del dispositivo mediante AWS IoT Core per Amazon Sidewalk.
1. Richiesta al team Amazon Sidewalk di una chiave YubiHSM e aggiornamento del profilo del dispositivo con supporto di fabbrica.
1. Invio della chiave YubiHSM al produttore affinché AWS IoT Core per Amazon Sidewalk possa ottenere il log di controllo una volta che i dispositivi sono stati prodotti.
1. Creazione di un'attività di importazione e fornitura dei numeri di serie (SMSN) dei dispositivi per cui eseguire l'onboarding in AWS IoT Core per Amazon Sidewalk.
## Componenti del provisioning in blocco
I concetti seguenti illustrano alcuni componenti chiave del provisioning in blocco e come utilizzarli come parte del provisioning in blocco di dispositivi Sidewalk.
### Chiave YubiHSM
Amazon crea uno o più HSM (moduli di sicurezza hardware) per ciascuno dei prodotti Sidewalk. Ogni HSM dispone di un numero di serie univoco, chiamato chiave YubiHSM, stampato sul modulo hardware. È possibile acquistare questa chiave dalla [pagina web di Yubico](https://www.yubico.com/product/yubihsm-2/).
La chiave è univoca per ciascun HSM e legata a ogni profilo del dispositivo creato con AWS IoT Core per Amazon Sidewalk. Per ottenere la chiave YubiHSM, contatta il team di Amazon Sidewalk. Se si invia la chiave YubiHSM al produttore, dopo che i dispositivi Sidewalk sono stati prodotti in fabbrica, AWS IoT Core per Amazon Sidewalk riceverà un file di log di controllo contenente i numeri di serie dei dispositivi. Queste informazioni vengono confrontate con il file CSV di input per eseguire l'onboarding dei dispositivi in AWS IoT.
### Chiave di attestazione del dispositivo (`DAK`)
Quando un dispositivo finale Sidewalk partecipa alla rete Sidewalk, occorre assegnare un certificato dispositivo Sidewalk. I certificati utilizzati per configurare il dispositivo includono un certificato privato specifico del dispositivo e i certificati dei dispositivi pubblici, che corrispondono alla catena di certificati Sidewalk. Quando i dispositivi Sidewalk vengono prodotti, YubiHSM firma i certificati dei dispositivi.
Di seguito viene illustrato un file JSON di esempio contenente i certificati dei dispositivi e le chiavi private. Per ulteriori informazioni, consultare [Ottenere i file JSON del dispositivo per il provisioning](sidewalk-json-get.md).
```
{
"p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
"eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
"metadata": {
"devicetypeid": "fe98",
...
"devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
"devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
},
"applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}
```
La chiave di attestazione del dispositivo (DAK) è una chiave privata ottenuta durante la creazione del profilo del dispositivo. Corrisponde al certificato del prodotto, che è un certificato univoco rilasciato per ciascun prodotto Sidewalk. Quando contatti il team di Amazon Sidewalk, riceverai la catena di certificati Sidewalk, la chiave YubiHSM e un HSM con assegnata la chiave di attestazione del dispositivo (DAK) del prodotto.
Il profilo del dispositivo viene inoltre aggiornato con la nuova chiave di attestazione del dispositivo (DAK) e con il supporto di fabbrica abilitato. Le informazioni sui metadati DAK del profilo del dispositivo forniscono dettagli come il nome DAK, l'ID certificato, l'APId (Advertised Product ID), se il supporto di fabbrica è abilitato e il numero massimo di firme che possono essere apportate dal DAK.
### Advertised product ID (`ApId`)
Il parametro `ApId` è una stringa alfanumerica che identifica il prodotto pubblicizzato. Questo campo deve essere specificato quando si desidera utilizzare un determinato profilo del dispositivo per i dispositivi Sidewalk di cui si esegue il provisioning in blocco. AWS IoT Core per Amazon Sidewalk genera quindi la DAK e la fornisce all'utente tramite la chiave YubiHSM. Le informazioni DAK correlate verranno presentate nel profilo del dispositivo.
Per ottenere il `ApId`, dopo aver recuperato le informazioni relative al profilo del dispositivo creato, contatta il team di supporto di Amazon Sidewalk. Le informazioni sul profilo del dispositivo possono essere ottenute dalla console AWS IoT o mediante l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html).
## Funzionamento del provisioning in blocco
Questo diagramma illustra il funzionamento del provisioning in blocco con AWS IoT Core per Amazon Sidewalk.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision-flow.png)
Nella procedura seguente vengono descritte le diverse fasi del processo di provisioning in blocco.
1.
**Creazione del profilo del dispositivo per il dispositivo Sidewalk**
Prima di portare il dispositivo finale in fabbrica, crea innanzitutto un profilo del dispositivo. Puoi utilizzare questo profilo per effettuare il provisioning di singoli dispositivi come descritto in [Aggiunta del profilo del dispositivo e del dispositivo finale Sidewalk](iot-sidewalk-add-device.md).
1.
**Richiesta del supporto di fabbrica per il profilo**
Quando sei pronto per portare il dispositivo finale in fabbrica, richiedi al team di Amazon Sidewalk la chiave YubiHSM e il supporto di fabbrica per il profilo del dispositivo.
1.
**Ottenere DAK e profilo supportato in fabbrica**
Il team di supporto di Amazon Sidewalk aggiornerà il profilo del dispositivo con la chiave di attestazione del dispositivo (DAK) del prodotto e il supporto di fabbrica. Il profilo del dispositivo verrà aggiornato automaticamente con un APId (advertised product ID) e una nuova DAK e informazioni sul certificato, come l'ID certificato. I dispositivi Sidewalk che utilizzano questo profilo dispongono dei requisiti per l'utilizzo con il provisioning di massa.
1.
**Invio della chiave YubiHSM al produttore (CM)**
Il dispositivo finale è ora qualificato, pertanto puoi inviare la chiave YubiHSM al produttore per conto terzi (CM) per avviare il processo di produzione. Per ulteriori informazioni, consultare la pagina relativa alla [produzione di dispositivi Amazon Sidewalk](https://docs.sidewalk.amazon/manufacturing/) nella *documentazione di Amazon Sidewalk*.
1.
**Produzione di dispositivi e invio di log di controllo e numeri di serie**
Il CM produce i dispositivi e genera log di controllo. Il CM fornisce inoltre un file CSV contenente un elenco di dispositivi da produrre e i relativi numeri di serie di produzione Sidewalk (SMSN). Nel codice seguente viene illustrato un log di controllo di esempio. Contiene i numeri di serie del dispositivo, l'APID e i certificati dei dispositivi pubblici.
```
{
"controlLogs": [
{
"version": "4-0-1",
"device":
{
"serialNumber": "device1",
"productIdentifier": {
"advertisedProductId": "abCD"
},
"sidewalkData": {
"SidewalkED25519CertificateChain": "...",
"SidewalkP256R1CertificateChain": "..."
}
}
}
]
}
```
1.
**Passaggio delle informazioni del log di controllo ad AWS IoT Core per Amazon Sidewalk**
Il cloud Amazon Sidewalk recupera le informazioni del log di controllo dal produttore e le passa ad AWS IoT Core per Amazon Sidewalk. I dispositivi possono quindi essere creati insieme ai relativi numeri di serie.
1.
**Verifica della corrispondenza del numero di serie e avvio del provisioning in blocco**
Quando utilizzi la console AWS IoT o l'operazione API `StartWirelessDeviceImportTask` AWS IoT Core per Amazon Sidewalk, AWS IoT Core confronta il numero di serie di produzione Sidewalk (SMSN) di ogni dispositivo ottenuto da Amazon Sidewalk con i numeri di serie corrispondenti nel file CSV. Se queste informazioni corrispondono, il processo di provisioning in blocco viene avviato e vengono creati i dispositivi da importare in AWS IoT Core per Amazon Sidewalk.
# Creazione dei profili dei dispositivi con supporto di fabbrica
Prima di poter eseguire il provisioning in blocco dei dispositivi Amazon Sidewalk, è necessario creare un profilo del dispositivo e quindi contattare il team di supporto di Amazon Sidewalk per richiedere il supporto di fabbrica. Il team di Amazon Sidewalk aggiornerà il profilo del dispositivo con una nuova chiave di attestazione del dispositivo (DAK), aggiungendo il relativo supporto di fabbrica. I dispositivi Sidewalk che utilizzano questo profilo sono quindi qualificati per l'utilizzo con AWS IoT Core per Amazon Sidewalk ed è possibile eseguire l'onboarding per il provisioning in blocco.
Nella procedura seguente viene illustrato come creare un profilo del dispositivo supportato in fabbrica.
1.
**Creazione di un profilo del dispositivo**
Crea innanzitutto un profilo del dispositivo. Quando crei un profilo, specifica un nome e dei tag opzionali come coppie nome-valore. Per ulteriori informazioni sui parametri richiesti, nonché la creazione e l'utilizzo dei profili, consultare [Come creare e aggiungere il dispositivo](iot-sidewalk-create-device.md#iot-sidewalk-device-how).
1.
**Ottenere il supporto di fabbrica per il profilo**
Ottieni il supporto di fabbrica per il profilo del dispositivo affinché sia possibile qualificare i dispositivi che utilizzano questo profilo. Per la qualifica, crea un ticket con il team di Amazon Sidewalk. Dopo la conferma da parte del team, riceverai un ApId (advertised product ID) e il profilo verrà aggiornato con una DAK rilasciata in fabbrica. I dispositivi finali Sidewalk che utilizzano questo profilo saranno qualificati.
È possibile creare un profilo del dispositivo utilizzando la console AWS IoT, le operazioni API AWS IoT Core per Amazon Sidewalk o la AWS CLI.
**Topics**
+ [Creazione di un profilo (console)](#provision-profile-console)
+ [Creazione di un profilo (interfaccia a riga di comando)](#provision-profile-cli)
+ [Passaggi successivi](#provision-profile-next)
## Creazione di un profilo (console)
Per creare un profilo del dispositivo utilizzando la console AWS IoT, passa alla [scheda Sidewalk dell'hub Profili](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) e scegli **Crea profilo**.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/iot-sidewalk-create-profiles.PNG)
Per creare un profilo, specifica i campi seguenti, quindi scegli **Invia**.
+
**Nome**
Inserisci un **Nome** per il profilo.
+
**Tag**
Inserisci tag opzionali come coppie nome-valore per semplificare l'identificazione del profilo. I tag semplificano inoltre il monitoraggio dei costi di fatturazione.
**Visualizzazione delle informazioni sul profilo e qualifica dei profili**
Il profilo creato verrà visualizzato nell'[hub Profili](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk). Seleziona il profilo per visualizzare i relativi dettagli. Verranno visualizzate le informazioni seguenti:
+ Il nome e l'identificatore univoco del profilo del dispositivo, nonché gli eventuali tag opzionali specificati come coppie nome-valore.
+ La chiave pubblica del server di applicazioni e l'ID tipo dispositivo del profilo.
+ Lo stato di qualifica, che indica che stai utilizzando un profilo del dispositivo non supportato in fabbrica. Per qualificare il profilo del dispositivo in modo che sia supportato in fabbrica, contatta il supporto Amazon Sidewalk.
+ Le informazioni sulla chiave di attestazione del dispositivo (DAK). Dopo che il dispositivo è stato qualificato, verrà emessa una nuova DAK e il profilo verrà aggiornato automaticamente con le nuove informazioni DAK.
## Creazione di un profilo (interfaccia a riga di comando)
Per creare un profilo del dispositivo, utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html). Ad esempio, il comando seguente crea un profilo per il dispositivo finale Sidewalk.
```
aws iotwireless create-device-profile \
--name sidewalk_device_profile --sidewalk {}
```
L'esecuzione di questo comando restituisce i dettagli del profilo, che includono il nome della risorsa Amazon (ARN) e l'ID del profilo.
```
{
"DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
**Visualizzazione delle informazioni sul profilo e qualifica dei profili**
Utilizza l'operazione API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) o il comando dell'interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html) 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.
Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando:
```
aws iotwireless get-device-profile \
--id "12345678-234a-45bc-67de-e8901234f0a1" > device_profile.json
```
L'esecuzione di questo comando restituisce i parametri del profilo del dispositivo, la chiave pubblica del server di applicazioni, il `DeviceTypeId`, `ApId`, lo stato di qualifica e le informazioni `DAKCertificate`.
In questo esempio, lo stato di qualifica e le informazioni DAK indicano che il profilo del dispositivo non è qualificato. Per qualificare il profilo, contattare il supporto Amazon Sidewalk. Verrà emesso una nuova DAK per il profilo senza limite dispositivo.
```
{
"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
}
}
```
Dopo che il team di supporto di Amazon Sidewalk conferma queste informazioni, riceverai l'APID e una DAK supportata in fabbrica, come mostrato nell'esempio seguente.
**Nota**
Il `MaxAllowedSignature` di `-1` indica che la DAK non contiene un limite del dispositivo. Per informazioni sui parametri DAK, consultare [DAKCertificateMetadata](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DAKCertificateMetadata.html).
```
{
"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": [
{
"ApId": "GZBd",
"CertificateId": "43564A6D2D50524F544F54595045",
"FactorySupport": true,
"MaxAllowedSignature": -1
}
],
"QualificationStatus": true
}
}
```
## Passaggi successivi
Dopo aver creato un profilo del dispositivo che dispone di una DAK supportata in fabbrica, fornisci al produttore la chiave YubiHSM ottenuta dal team. I dispositivi verranno quindi prodotti in fabbrica e le informazioni del log di controllo verranno passate ad Amazon Sidewalk, che contiene i numeri di serie (SMSN) dei dispositivi. Per ulteriori informazioni su questo flusso di lavoro, consultare la pagina relativa alla [produzione di dispositivi Amazon Sidewalk](https://docs.sidewalk.amazon/manufacturing/) nella *documentazione di Amazon Sidewalk*.
È quindi possibile effettuare il provisioning in blocco dei dispositivi Sidewalk fornendo ad AWS IoT Core per Amazon Sidewalk i numeri di serie dei dispositivi di cui eseguire l'onboarding. Quando AWS IoT Core per Amazon Sidewalk riceve il log di controllo, confronta i numeri di serie nel log di controllo con i numeri di serie forniti. Se i numeri di serie corrispondono, l'attività di importazione avvia l'onboarding dei dispositivi in AWS IoT Core per Amazon Sidewalk. Per ulteriori informazioni, consultare [Provisioning dei dispositivi Sidewalk mediante attività di importazione](sidewalk-provision-bulk-import.md).
# 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.
**Topics**
+ [Funzionamento del provisioning in blocco Sidewalk](#provision-bulk-works)
+ [Considerazioni chiave per il provisioning in blocco di Sidewalk](#provision-bulk-considerations)
+ [Formato di file CSV](#provision-csv-format)
+ [Come utilizzare il provisioning in blocco Sidewalk](#provision-bulk-use)
+ [Provisioning in blocco di dispositivi Sidewalk](sidewalk-bulk-provision-how.md)
+ [Visualizzazione dell'attività di importazione e dello stato di onboarding dei dispositivi](sidewalk-bulk-provision-status.md)
## 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](https://docs.sidewalk.amazon/manufacturing/) nella *documentazione di Amazon Sidewalk*.
1.
**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.
1.
**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.
1.
**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
1.
**(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à.
**Topics**
+ [Funzionamento del provisioning in blocco Sidewalk](#provision-bulk-works)
+ [Considerazioni chiave per il provisioning in blocco di Sidewalk](#provision-bulk-considerations)
+ [Formato di file CSV](#provision-csv-format)
+ [Come utilizzare il provisioning in blocco Sidewalk](#provision-bulk-use)
+ [Provisioning in blocco di dispositivi Sidewalk](sidewalk-bulk-provision-how.md)
+ [Visualizzazione dell'attività di importazione e dello stato di onboarding dei dispositivi](sidewalk-bulk-provision-status.md)
# 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), scegli **Dispositivi con provisioning in blocco**, quindi esegui la procedura seguente.
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision.PNG)
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**.
1.
**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.
1. Il relativo numero di serie di produzione Sidewalk (SMSN) nel campo **Inserisci SMSN**.
1. Una **Destinazione** che descrive la regola IoT per instradare i messaggi dal dispositivo ad altri Servizi AWS.
1. 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](https://console.aws.amazon.com/s3/), scegli **View** (Visualizza).
1. 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.
1. Fornisci una **Destinazione** che descrive la regola IoT per instradare i messaggi dal dispositivo ad altri Servizi AWS.
1. 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html) o il comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html) 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html) o il comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html) 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](sidewalk-provision-bulk-import.md#provision-bulk-use).
**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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) della console AWS IoT.
1. Scegli l'attività di importazione che desideri aggiornare, quindi seleziona **Modifica**.
1. 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) della console AWS IoT.
1. 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.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html) o interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html)**
Questa operazione API aggiunge il contenuto di un file CSV Amazon S3 a un'attività di importazione esistente. Puoi aggiungere solo numeri di serie di dispositivi che in precedenza non erano inclusi nell'attività.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html) o interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html)**
Questa operazione API elimina l'attività di importazione contrassegnata per l'eliminazione utilizzando l'ID dell'attività di importazione.
# Visualizzazione dell'attività di importazione e dello stato di onboarding dei dispositivi
Le attività di importazione dei dispositivi wireless e i dispositivi Sidewalk che sono stati aggiunti all'attività possono avere uno dei seguenti messaggi di stato. Questi messaggi verranno visualizzati nella console AWS IoT o quando si utilizza una delle operazioni API Wireless AWS IoT o i comandi AWS CLI per recuperare informazioni su queste attività e i relativi dispositivi.
## Visualizzazione delle informazioni sullo stato dell'attività di importazione
Dopo aver creato un'attività di importazione, puoi visualizzare l'attività di importazione creata e lo stato di onboarding dei dispositivi aggiunti all'attività. Lo stato di onboarding indica il numero di dispositivi in attesa di onboarding, il numero di dispositivi di cui è stato eseguito l'onboarding e il numero di dispositivi il cui onboarding non è andato a buon fine.
Quando un'attività di importazione è appena stata creata, l'opzione **Conteggio in sospeso** visualizzerà un valore che corrisponde al numero di dispositivi aggiunti. Quando l'attività viene avviata e il file CSV viene letto per creare i record di dispositivi wireless, il **Conteggio in sospeso** diminuisce e il **Conteggio operazioni riuscite** aumenta man mano che viene eseguito l'onboarding dei dispositivi. Se l'onboarding di un dispositivo non va a buon fine, il **Conteggio non riuscito** aumenta.
Per visualizzare l'attività di importazione e lo stato di onboarding dei dispositivi:
+
**Utilizzo della console di AWS IoT**
Nell'[hub di Dispositivi Sidewalk](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) della console AWS IoT, puoi visualizzare le attività di importazione create e un conteggio di riepilogo delle informazioni sullo stato di onboarding dei dispositivi. Se visualizzi i dettagli di una qualsiasi delle attività di importazione create, vengono mostrate informazioni aggiuntive sullo stato di onboarding dei dispositivi.
+
**Utilizzo dell'API Wireless AWS IoT o della AWS CLI**
Per visualizzare lo stato di onboarding dei dispositivi, utilizza una delle seguenti operazioni API Wireless AWS IoT o il comando AWS CLI corrispondente.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html) o interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html)**
Questa operazione API restituisce informazioni su tutte le attività di importazione che sono state aggiunte all'account per Wireless AWS IoT e il relativo stato. Restituisce inoltre un conteggio del riepilogo dello stato di onboarding dei dispositivi Sidewalk in queste attività.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) o interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html)**
Questa operazione API restituisce informazioni sull'attività di importazione specificata e sul relativo stato e informazioni su tutti i dispositivi Sidewalk che sono stati aggiunti all'attività di importazione e le relative informazioni sullo stato di onboarding.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) o interfaccia a riga di comando [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html)**
Questa operazione API restituisce informazioni sull'attività di importazione specificata e sul relativo stato e un conteggio del riepilogo dello stato di onboarding dei dispositivi Sidewalk in tale attività.
## Stato dell'attività di importazione
Le attività di importazione create in Account AWS possono avere uno dei seguenti messaggi di stato. Lo stato indica se l'attività di importazione ha avviato l'elaborazione, è stata completata o non è andata a buon fine. Puoi anche utilizzare la console AWS IoT o il parametro `StatusReason` di una qualsiasi delle operazioni API Wireless AWS IoT per recuperare dettagli sullo stato aggiuntivi.
+
**INIZIALIZZAZIONE**
AWS IoT Core per Amazon Sidewalk ha ricevuto la richiesta di attività di importazione dei dispositivi wireless e sta configurando l'attività.
+
**INIZIALIZZATO**
AWS IoT Core per Amazon Sidewalk ha completato la configurazione dell'attività di importazione ed è in attesa dell'arrivo del log di controllo in modo da poter importare i dispositivi utilizzando i relativi numeri di serie (SMSN) e continuare l'elaborazione dell'attività.
+
**PENDING**
L'operazione di importazione è in attesa in coda per essere elaborata. AWS IoT Core per Amazon Sidewalk sta valutando altre attività presenti nella coda di elaborazione.
+
**COMPLETA**
L'attività di importazione è stata elaborata e completata.
+
**Non riuscito**
L'attività di importazione o l'attività del dispositivo non è riuscita. Puoi utilizzare il parametro `StatusReason` per identificare il motivo della mancata riuscita dell'attività di importazione, ad esempio un'eccezione di convalida.
+
**ELIMINAZIONE IN CORSO**
L'attività di importazione è stata contrassegnata per l'eliminazione ed è in fase di eliminazione.
## Stato di onboarding del dispositivo
I dispositivi Sidewalk che sono stati aggiunti all'attività possono avere uno dei seguenti messaggi di stato. Lo stato indica se i dispositivi sono pronti per eseguire l'onboarding, se l'onboarding è stato effettuato o se l'onboarding non è andato a buon fine. Puoi anche utilizzare la console AWS IoT o il parametro `OnboardingStatusReason` di una qualsiasi delle operazioni API Wireless AWS IoT, `ListDevicesForWirelessDeviceImportTask`, per recuperare dettagli sullo stato aggiuntivi.
+
**INIZIALIZZATO**
AWS IoT Core per Amazon Sidewalk ha completato la configurazione dell'attività di importazione ed è in attesa dell'arrivo del log di controllo in modo da poter importare i dispositivi utilizzando i relativi numeri di serie (SMSN) e continuare l'elaborazione dell'attività.
+
**PENDING**
L'attività di importazione è in attesa in coda per essere elaborata e per avviare l'onboarding dei dispositivi nell'attività. AWS IoT Core per Amazon Sidewalk sta valutando altre attività presenti nella coda di elaborazione.
+
**ONBOARDING COMPLETATO**
L'onboarding del dispositivo Sidewalk è stato correttamente eseguito nell'attività di importazione.
+
**Non riuscito**
L'attività di importazione o l'attività del dispositivo non è andata a buon fine e l'onboarding del dispositivo Sidewalk nell'attività non è riuscito. È possibile utilizzare il parametro `OnboardingStatusReason` per recuperare ulteriori dettagli sul motivo per cui l'onboarding del dispositivo non è riuscito.