# Notifiche di eventi per Wireless AWS IoT Wireless AWS IoT può pubblicare messaggi per segnalarti eventi per i dispositivi LoRaWAN e Sidewalk per cui hai eseguito l'onboarding in AWS IoT Core. Ad esempio, puoi ricevere una notifica di eventi quando i dispositivi Sidewalk nel tuo account sono stati sottoposti a provisioning o sono stati registrati. ## In che modo le tue risorse possono essere informate sugli eventi Le notifiche degli eventi vengono pubblicate quando si verificano determinati eventi. Ad esempio, gli eventi vengono generati quando viene eseguito il provisioning del dispositivo Sidewalk. Ogni evento comporta l'invio di una notifica di evento univoca. Le notifiche di evento vengono pubblicate su MQTT con un payload JSON. Il contenuto del payload dipende dal tipo di evento. **Nota** Le notifiche degli eventi vengono pubblicate almeno una volta. È anche possibile che vengano pubblicate più di una volta. L'ordine delle notifiche di evento non è garantito. ### Eventi e tipi di risorse Nella tabella seguente vengono illustrati i diversi tipi di eventi per i quali si ricevono le notifiche. I tipi di evento variano a seconda che il tipo di risorsa sia un dispositivo wireless, un gateway wireless o un account Sidewalk. Puoi anche abilitare gli eventi a livello di risorsa, che si applica a tutte le risorse di un determinato tipo, oppure per risorse selezionate, come descritto nella sezione seguente. Per ulteriori informazioni sui diversi tipi di eventi, consulta [Notifiche di eventi per le risorse LoRaWAN](iot-lorawan-events.md) e [Notifiche di eventi per le risorse Sidewalk](iot-sidewalk-events.md). **Tipi di evento basati sulle risorse** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) ### Policy per la ricezione delle notifiche degli eventi wireless Per ricevere notifiche di evento, il dispositivo deve usare una policy appropriata che gli permetta di connettersi al gateway dei dispositivi AWS IoT e di sottoscrivere argomenti di evento MQTT. Devi anche sottoscrivere i filtri di argomenti appropriati. Di seguito viene mostrato un esempio della policy necessaria per la ricezione delle notifiche per i vari eventi wireless. ``` { "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":[ "iot:Subscribe", "iot:Receive" ], "Resource":[ "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*", "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*" "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*" ] }] } ``` ### Formato degli argomenti MQTT per eventi wireless Per inviarti notifiche di eventi per le tue risorse wireless, AWS IoT utilizza argomenti riservati MQTT che iniziano con il simbolo del dollaro (\$1). Effettua la sottoscrizione e pubblica gli argomenti riservati. Tuttavia, non è possibile creare nuovi argomenti che inizino con un simbolo del dollaro. **Nota** Gli argomenti MQTT sono specifici per il tuo Account AWS e utilizzano il formato `arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic`. Per ulteriori informazioni, consultare [Argomenti MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella *Guida per gli sviluppatori di AWS IoT*. Gli argomenti MQTT riservati per i dispositivi wireless utilizzano il seguente formato: + **Argomenti a livello di risorsa** Questi argomenti si applicano a tutte le risorse di un determinato tipo nel tuo Account AWS sottoposto a onboarding in Wireless AWS IoT. `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources` + **Argomenti a livello di identificatore** Questi argomenti si applicano a risorse selezionate di un determinato tipo nel tuo Account AWS sottoposto a onboarding in Wireless AWS IoT, specificato dall'identificatore della risorsa. `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}` Per ulteriori informazioni sugli argomenti a livello di risorsa e identificatore, consulta [Configurazioni degli eventi](iot-wireless-control-events.md#iot-wireless-control-events-config). La tabella seguente mostra esempi di argomenti MQTT per i vari eventi: **Eventi e argomenti MQTT** | Evento | Argomento MQTT | Note | | --- | --- | --- | | Stato di registrazione del dispositivo Sidewalk | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | | Prossimità Sidewalk | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | | Join LoRaWAN | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | | Stato della connessione del gateway LoRaWAN | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/iot-wireless/latest/developerguide/iot-wireless-events.html) | Per ulteriori informazioni sui diversi eventi, consulta [Notifiche di eventi per le risorse LoRaWAN](iot-lorawan-events.md) e [Notifiche di eventi per le risorse Sidewalk](iot-sidewalk-events.md). Se hai sottoscritto questi argomenti, riceverai una notifica quando viene pubblicato un messaggio su uno degli argomenti di notifica dell'evento. Per ulteriori informazioni, consultare [Argomenti riservati MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/reserved-topics.html) nella *Guida per gli sviluppatori di AWS IoT*. ## Prezzi degli eventi wireless Per informazioni sui prezzi per la sottoscrizione di eventi e per la ricezione di notifiche, consulta [Prezzi di AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). # Abilitazione degli eventi per le risorse wireless Prima che i sottoscrittori agli argomenti riservati possano ricevere messaggi, è necessario abilitare le notifiche degli eventi. Per fare ciò, è possibile utilizzare la Console di gestione AWS, l'API Wireless AWS IoT o AWS CLI. ## Configurazioni degli eventi Puoi configurare gli eventi per inviare notifiche a tutte le risorse appartenenti a un determinato tipo o per singole risorse wireless. Il tipo di risorsa può essere un gateway wireless, un account partner Sidewalk o un dispositivo wireless, che può essere un dispositivo LoRaWAN o Sidewalk. Per informazioni sul tipo di eventi che è possibile abilitare per i dispositivi wireless, consulta [Tipi di evento per le risorse LoRaWAN](iot-lorawan-events.md#iot-lorawan-event-types) e [Tipi di evento per le risorse Sidewalk](iot-sidewalk-events.md#iot-sidewalk-event-types). **Tutte le risorse** Puoi abilitare gli eventi in modo che tutte le risorse presenti nel tuo Account AWS che appartengono a un determinato tipo di risorse ricevano le notifiche. Ad esempio, è possibile abilitare un evento che notifichi le modifiche dello stato della connessione per tutti i gateway LoRaWAN che hai sottoposto all'onboarding con AWS IoT Core per LoRaWAN. Il monitoraggio di questi eventi ti aiuterà a ricevere le notifiche nei casi in cui i gateway LoRaWAN del tuo parco istanze di risorse vengano disconnessi o un beacon venga perso per un certo numero di dispositivi Sidewalk nel tuo Account AWS. **Risorse individuali** È anche possibile aggiungere singole risorse LoRaWAN e Sidewalk alla configurazione dell'evento e abilitare le notifiche per queste risorse. In tal modo puoi monitorare le singole risorse di un determinato tipo. Ad esempio, puoi aggiungere determinati dispositivi LoRaWAN e Sidewalk alla configurazione e ricevere le notifiche per gli eventi di join o stato di registrazione del dispositivo per queste risorse. ## Prerequisiti La risorsa LoRaWAN o Sidewalk deve disporre di una policy appropriata che consenta di ricevere le notifiche degli eventi. Per ulteriori informazioni, consultare [Policy per la ricezione delle notifiche degli eventi wireless](iot-wireless-events.md#iot-wireless-events-policy). ## Abilitazione delle notifiche tramite Console di gestione AWS Per abilitare i messaggi di evento dalla console, accedi alla scheda [Settings](console.aws.amazon.com/iot/home/settings/) (Impostazioni) della console AWS IoT e vai nella sezione **LoRaWAN and Sidewalk event notification** (Notifica evento LoRaWAN e Sidewalk). Puoi abilitare le notifiche per tutte le risorse del tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle. **Per abilitare le notifiche per tutte le risorse** 1. Nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk), vai nella scheda **All resources** (Tutte le risorse), seleziona **Action** (Operazione) e quindi scegli **Manage events** (Gestione eventi). 1. Abilita gli eventi da monitorare e scegli **Update events** (Aggiorna eventi). Se non vuoi più monitorare determinati eventi, scegli **Action** (Operazione), seleziona **Manage events** (Gestione eventi) e quindi disabilita gli eventi. Puoi anche abilitare le notifiche per le singole risorse nel tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle. **Per abilitare le notifiche per singole risorse** 1. Nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk), scegli **Action** (Operazione) e quindi seleziona **Add resources** (Aggiungi risorse). 1. Seleziona le risorse e gli eventi per i quali desideri ricevere le notifiche: 1. Scegli se desideri monitorare gli eventi per le **LoRaWAN resources** (risorse LoRaWAN) o per le **Sidewalk resources** (risorse Sidewalk). 1. Puoi scegliere gli eventi da abilitare per le risorse a seconda del tipo di risorsa. Puoi quindi iscriverti a questi eventi e ricevere le notifiche. Se scegli: + Le **risorse LoRaWAN**: puoi abilitare gli eventi di **join** per i tuoi dispositivi LoRaWAN o gli eventi di **stato della connessione** per i tuoi gateway LoRaWAN. + Le risorse Sidewalk: puoi abilitare gli eventi di **stato di registrazione del dispositivo** o di **prossimità** o entrambi per gli account partner Sidewalk e i dispositivi Sidewalk. 1. A seconda del tipo di risorsa e degli eventi scelti, seleziona i dispositivi wireless o i gateway da monitorare. Puoi selezionare fino a 250 risorse per tutte le risorse combinate. 1. Scegli **Submit** (Invia) per aggiungere le risorse. Le risorse aggiunte verranno visualizzate con i relativi argomenti MQTT nella scheda per il tipo di risorsa nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk) della console. + Gli eventi di **join LoRaWAN** e gli eventi per i tuoi dispositivi Sidewalk vengono visualizzati nella sezione **Wireless devices** (Dispositivi wireless) della console. + Gli eventi di **stato della connessione** per i gateway LoRaWAN vengono visualizzati nella sezione **Wireless gateways** (Gateway wireless). + Gli eventi di **stato di registrazione del dispositivo** e di **prossimità** per gli account Sidewalk vengono visualizzati nella scheda **Sidewalk accounts** (Account Sidewalk). **Sottoscrizione agli argomenti tramite il client MQTT** A seconda che siano stati abilitati per tutte le risorse o per singoli tipi di risorse, gli eventi vengono visualizzati nella console con i relativi argomenti MQTT nella scheda **All resources** (Tutte le risorse) o nella scheda per il tipo di risorsa specificato. + Se scegli un argomento MQTT, puoi accedere al client MQTT per sottoscrivere l'argomento e ricevere messaggi. + Se hai aggiunto più eventi, puoi sottoscrivere più argomenti dell'evento e ricevere le relative notifiche. Per sottoscrivere più argomenti, scegli gli argomenti e seleziona **Action** (Operazione) e quindi **Subscribe** (Sottoscrivi). ## Abilitazione delle notifiche tramite AWS CLI Puoi configurare gli eventi e aggiungere le risorse alla configurazione utilizzando l'API Wireless AWS IoT o AWS CLI. **Abilitazione delle notifiche per tutte le risorse** Puoi abilitare le notifiche per tutte le risorse del tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle utilizzando l'API [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) o il comando [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html) dell'interfaccia a riga di comando. Ad esempio: ``` aws iotwireless update-event-configuration-by-resource-types \ --cli-input-json input.json ``` **Contenuto di input.json** ``` { "DeviceRegistrationState": { "Sidewalk": { "AmazonIdEventTopic": "Enabled" } }, "ConnectionStatus": { "LoRaWAN": { "WirelessGatewayEventTopic": "Enabled" } } } ``` **Nota** Tutte le virgolette doppie (") sono precedute dal carattere di escape barra rovesciata (\$1). Puoi ottenere la configurazione degli eventi corrente chiamando l'API [GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o utilizzando il comando [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html) dell'interfaccia a riga di comando. Ad esempio: ``` aws iotwireless get-event-configuration-by-resource-types ``` **Abilitazione delle notifiche per singole risorse** Per aggiungere singole risorse alla configurazione dell'evento e controllare quali eventi vengono pubblicati utilizzando l'API o l'interfaccia a riga di comando, chiama l'API [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) o usa il comando [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html) dell'interfaccia a riga di comando. Ad esempio: ``` aws iotwireless update-resource-event-configuration \ --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ --identifier-type WirelessDeviceId \ --cli-input-json input.json ``` **Contenuto di input.json** ``` { "Join": { "LoRaWAN": { "DevEuiEventTopic": "Disabled" }, "WirelessDeviceIdEventTopic": "Enabled" } } ``` **Nota** Tutte le virgolette doppie (") sono precedute dal carattere di escape barra rovesciata (\$1). Puoi ottenere la configurazione degli eventi corrente chiamando l'API [GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o utilizzando il comando CLI [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html). Ad esempio: ``` aws iotwireless get-resource-event-configuration \ --identifier-type WirelessDeviceId \ --identifier 1ffd32c8-8130-4194-96df-622f072a315f ``` **Elenco delle configurazioni di eventi** Puoi utilizzare l'API Wireless AWS IoT o AWS CLI per elencare le configurazioni degli eventi in cui è stato abilitato almeno un argomento. Per elencare le configurazioni, utilizza l'operazione API [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) o il comando [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html) dell'interfaccia a riga di comando. Ad esempio: ``` aws iotwireless list-event-configurations --resource-type WirelessDevice ``` # Notifiche di eventi per le risorse LoRaWAN Puoi utilizzare le operazioni API Console di gestione AWS o Wireless AWS IoT per ricevere le notifiche degli eventi per i dispositivi e i gateway LoRaWAN. Per informazioni sulle notifiche di eventi e su come abilitarle, consulta [Notifiche di eventi per Wireless AWS IoT](iot-wireless-events.md) e [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). ## Tipi di evento per le risorse LoRaWAN Gli eventi che puoi abilitare per le risorse LoRaWAN sono: + Eventi di join che ti notificano gli eventi di join del tuo dispositivo LoRaWAN. Ricevi le notifiche quando un dispositivo esegue il join con AWS IoT Core per LoRaWAN o quando viene ricevuta una richiesta di rejoin di tipo 0 o di tipo 2. + Eventi di stato della connessione che ti notificano quando lo stato della connessione del gateway LoRaWAN cambia in connesso o disconnesso. Le sezioni seguenti contengono ulteriori informazioni sugli eventi per le risorse LoRaWAN: **Topics** + [ ## Tipi di evento per le risorse LoRaWAN ](#iot-lorawan-event-types) + [ # Eventi di join LoRaWAN ](iot-lorawan-join-events.md) + [ # Eventi di stato della connessione ](iot-lorawan-gateway-events.md) # Eventi di join LoRaWAN AWS IoT Core per LoRaWAN può pubblicare messaggi per notificarti gli eventi per i dispositivi LoRaWAN di cui hai eseguito l'onboarding in AWS IoT. Gli eventi di join ti notificano quando viene ricevuta una richiesta di join o di rejoin di tipo 0 o di tipo 2 e il dispositivo è stato sottoposto al join con AWS IoT Core per LoRaWAN. ## Come funzionano gli eventi di join Quando esegui l'onboarding dei dispositivi LoRaWAN con AWS IoT Core per LoRaWAN, AWS IoT Core per LoRaWAN esegue una procedura di *join* per il tuo dispositivo con AWS IoT Core per LoRaWAN. Il dispositivo viene quindi attivato per l'uso e può inviare un messaggio di uplink per indicare che è disponibile. Una volta eseguito il join del dispositivo, i messaggi di uplink e downlink possono essere scambiati tra il dispositivo e AWS IoT Core per LoRaWAN. Per informazioni su come eseguire l'onboarding del dispositivo, consulta [Integra i tuoi dispositivi su AWS IoT Core per LoRaWAN](lorawan-onboard-end-devices.md). Puoi abilitare gli eventi per ricevere la notifica di quando viene eseguito il join del tuo dispositivo con AWS IoT Core per LoRaWAN. Ricevi una notifica anche quando l'evento di join non riesce, quando viene ricevuta una richiesta di rejoin di tipo 0 o di tipo 2 e quando viene accettata. ## Abilitazione degli eventi di join LoRaWAN Prima che sottoscrittori agli argomenti riservati di join LoRaWAN possano ricevere messaggi, è necessario abilitare le notifiche degli eventi dalla Console di gestione AWS o utilizzando l'API o l'interfaccia a riga di comando. Puoi abilitare questi eventi per tutte le risorse LoRaWAN nel tuo Account AWS o per risorse selezionate. Per ulteriori informazioni su come abilitare gli eventi, consulta [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). ## Formato degli argomenti MQTT per eventi LoRaWAN Gli argomenti MQTT riservati per i dispositivi LoRaWAN utilizzano il seguente formato. Se hai sottoscritto questi argomenti, tutti i dispositivi LoRaWAN registrati nel tuoAccount AWS possono ricevere la notifica: + **Argomenti a livello di risorsa** `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_devices` + **Argomenti identificatore** `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_devices/{resourceID}/{id}` Dove: **\$1eventName\$1** \$1eventName\$1 deve essere `join`. **\$1eventType\$1** \$1eventType\$1 può essere: + `join_req_received` + `rejoin_req_0_received` + `rejoin_req_2_received` + `join_accepted` **\$1resourceID\$1** \$1resourceID\$1 può essere `dev_eui` o `wireless_device_id`. Ad esempio, puoi sottoscrivere i seguenti argomenti per ricevere una notifica di evento quando AWS IoT Core per LoRaWAN ha accettato una richiesta di join dai tuoi dispositivi. `$aws/iotwireless/events/join/join_accepted/lorawan/wireless_devices/wireless_device_id/{id}` È possibile utilizzare anche il carattere jolly `+` per sottoscrivere più argomenti contemporaneamente. Il carattere jolly `+` corrisponde a qualsiasi stringa nel livello che contiene il carattere, come il seguente argomento: `$aws/iotwireless/events/join/join_req_received/lorawan/wireless_devices/wireless_device_id/+` **Nota** Non è possibile utilizzare il carattere jolly `#` per sottoscrivere argomenti riservati. Per ulteriori informazioni sull'utilizzo del carattere jolly `+` quando si sottoscrivono gli argomenti, consulta [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) nella *Guida per gli sviluppatori di AWS IoT*. ## Payload dei messaggi per l'evento di join LoRaWAN Di seguito viene illustrato il payload dei messaggi per l'evento di join LoRaWAN. ``` { // General fields "eventId": "string", "eventType": "join_req_received|rejoin_req_0_received|rejoin_req_2_received|join_accepted", "WirelessDeviceId": "string", "timestamp": "timestamp", // Event-specific fields "LoRaWAN": { "DevEui": "string", // The fields below are optional indicating that it can be a null value. "DevAddr": "string", "JoinEui": "string", "AppEui": "string", } } ``` Il payload contiene gli attributi seguenti: **eventId** ID evento univoco generato da AWS IoT Core per LoRaWAN (stringa). **eventType** Il tipo di evento che si è verificato. Può essere uno dei seguenti valori: + `join_req_received`: questo campo mostra i parametri EUI `JoinEui` o `AppEui` + `rejoin_req_0_received` + `rejoin_req_2_received` + `join_accepted`: questo campo mostra `NetId` e `DevAddr`. **wirelessDeviceId** ID del dispositivo LoRaWAN. **timestamp** Timestamp Unix del momento in cui si è verificato l'evento. **DevEui** Identificatore univoco del dispositivo trovato sull'etichetta del dispositivo o sulla documentazione del dispositivo. **DevAddr e EUI (facoltativo)** Questi campi rappresentano l'indirizzo del dispositivo facoltativo e i parametri EUI `JoinEUI` o `AppEUI`. # Eventi di stato della connessione AWS IoT Core per LoRaWAN può pubblicare messaggi per segnalarti eventi di stato della connessione per i gateway LoRaWAN per cui hai eseguito l'onboarding in AWS IoT. Gli eventi di stato della connessione segnalano quando lo stato della connessione di un gateway LoRaWAN cambia in connesso o disconnesso. ## Come funzionano gli eventi di stato della connessione Dopo aver eseguito l'onboarding del gateway in AWS IoT Core per LoRaWAN, puoi connettere il gateway a AWS IoT Core per LoRaWAN e verificare lo stato della connessione. Questo evento ti avvisa quando lo stato della connessione del gateway cambia in connesso o disconnesso. Per ulteriori informazioni su come eseguire l'onboarding e sulla connessione del gateway a AWS IoT Core per LoRaWAN, consulta [Integrare i gateway per AWS IoT Core per LoRaWAN](lorawan-onboard-gateways.md) e [Connetti il tuo gateway LoRaWAN e verifica lo stato della connessione](lorawan-gateway-connection-status.md). ## Formato degli argomenti MQTT per gateway LoRaWAN Gli argomenti MQTT riservati per i gateway LoRaWAN utilizzano il seguente formato. Se hai sottoscritto questi argomenti, tutti i gateway LoRaWAN registrati nel tuo Account AWS possono ricevere la notifica: + Per argomenti a livello di risorsa: `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways` + Per argomenti identificatore: `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}` Dove: **\$1eventName\$1** \$1eventName\$1 deve essere `connection_status`. **\$1eventType\$1** \$1eventType\$1 può essere `connected` o `disconnected`. **\$1resourceID\$1** \$1resourceID\$1 può essere `gateway_eui` o `wireless_gateway_id`. Ad esempio, puoi sottoscrivere i seguenti argomenti per ricevere una notifica di evento quando tutti i gateway si sono connessi a AWS IoT Core per LoRaWAN: `$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/{id}` È possibile utilizzare anche il carattere jolly `+` per sottoscrivere più argomenti contemporaneamente. Il carattere jolly `+` corrisponde a qualsiasi stringa nel livello che contiene il carattere, come il seguente argomento: `$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/+` **Nota** Non è possibile utilizzare il carattere jolly `#` per sottoscrivere argomenti riservati. Per ulteriori informazioni sull'utilizzo del carattere jolly `+` quando si sottoscrivono gli argomenti, consulta [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) nella *Guida per gli sviluppatori di AWS IoT*. ## Payload dei messaggi per eventi di stato della connessione Di seguito viene illustrato il payload dei messaggi per l'evento di stato della connessione. ``` { // General fields "eventId": "string", "eventType": "connected|disconnected", "WirelessGatewayId": "string", "timestamp": "timestamp", // Event-specific fields "LoRaWAN": { "GatewayEui": "string" } } ``` Il payload contiene gli attributi seguenti: **eventId** ID evento univoco generato da AWS IoT Core per LoRaWAN (stringa). **eventType** Il tipo di evento che si è verificato. Può essere `connected` o `disconnected`. **wirelessGatewayId** L'ID del gateway LoRaWAN. **timestamp** Timestamp Unix del momento in cui si è verificato l'evento. **GatewayEui** Identificatore univoco del gateway trovato sull'etichetta del gateway o nella documentazione del gateway. # Notifiche di eventi per le risorse Sidewalk Puoi utilizzare le operazioni API Console di gestione AWS o Wireless AWS IoT per ricevere le notifiche degli eventi per i dispositivi Sidewalk e gli account partner. Per informazioni sulle notifiche di eventi e su come abilitarle, consulta [Notifiche di eventi per Wireless AWS IoT](iot-wireless-events.md) e [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). ## Tipi di evento per le risorse Sidewalk Gli eventi che puoi abilitare per le risorse Sidewalk sono: + Eventi del dispositivo che segnalano modifiche allo stato del dispositivo Sidewalk, ad esempio quando il dispositivo è stato registrato ed è pronto per l'uso. + Eventi di prossimità quando Wireless AWS IoT riceve una notifica da Amazon Sidewalk per segnalare che un beacon è stato individuato o perso. Le sezioni seguenti contengono ulteriori informazioni sugli eventi per le risorse Sidewalk: **Topics** + [ ## Tipi di evento per le risorse Sidewalk ](#iot-sidewalk-event-types) + [ # Eventi sullo stato di registrazione del dispositivo ](iot-sidewalk-device-events.md) + [ # Eventi di prossimità ](iot-sidewalk-proximity-events.md) # Eventi sullo stato di registrazione del dispositivo Gli eventi dello stato di registrazione del dispositivo pubblicano le notifiche degli eventi in caso di modifica dello stato di registrazione del dispositivo, (ad esempio, in caso di provisioning o registrazione di un dispositivo Sidewalk). Gli eventi forniscono informazioni sui diversi stati del dispositivo dal momento in cui viene eseguito il provisioning al momento della registrazione. ## Come funzionano gli eventi sullo stato di registrazione del dispositivo Quando esegui l'onboarding del dispositivo Sidewalk con Amazon Sidewalk e Wireless AWS IoT, Wireless AWS IoT esegue un'operazione `create` e aggiunge il dispositivo Sidewalk al tuo Account AWS. Il dispositivo entra quindi nello stato di provisioning e `eventType` diventa `provisioned`. Per informazioni su come eseguire l'onboarding del dispositivo, consulta [Nozioni di base sull'utilizzo di AWS IoT Core per Amazon Sidewalk](sidewalk-getting-started.md). Una volta che lo stato del dispositivo è `provisioned`, Amazon Sidewalk esegue un'operazione `register` per registrare il dispositivo Sidewalk con Wireless AWS IoT. Il processo di registrazione inizia dove vengono configurate le chiavi di crittografia e di sessione con AWS IoT. Quando il dispositivo è registrato, `eventType` diventa `registered`, e il dispositivo è pronto per l'uso. Una volta che lo stato del dispositivo è `registered`, Sidewalk può inviare una richiesta per `deregister` il dispositivo. Wireless AWS IoT quindi soddisfa la richiesta e modifica lo stato del dispositivo in `provisioned`. Per ulteriori informazioni sullo stato del dispositivo, consulta [DeviceState (Stato Dispositivo)](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SidewalkDeviceMetadata.html#iotwireless-Type-SidewalkDeviceMetadata-DeviceState). ## Abilita le notifiche per gli eventi di stato della registrazione del dispositivo Prima che i sottoscrittori dello stato di registrazione del dispositivo, possano ricevere messaggi, è necessario abilitare per loro le notifiche degli eventi, dalla Console di gestione AWS o utilizzando l'API o la CLI. Puoi abilitare questi eventi per tutte le risorse Sidewalk nel tuo Account AWS o per risorse selezionate. Per ulteriori informazioni su come abilitare gli eventi, consulta [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). ## Formato degli argomenti MQTT per eventi di stato di registrazione del dispositivo Per ricevere avvisi sugli eventi di stato di registrazione del dispositivo, puoi sottoscrivere gli argomenti riservati MQTT che iniziano con un simbolo del dollaro (\$1). Per ulteriori informazioni, consultare [Argomenti MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella *Guida per gli sviluppatori di AWS IoT*. Gli argomenti MQTT riservati per gli eventi di stato di registrazione del dispositivo Sidewalk utilizzano il seguente formato: + Per argomenti a livello di risorsa: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices` + Per argomenti identificatore: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}` Dove: **\$1eventName\$1** \$1eventName\$1 deve essere `device_registation_state`. **\$1eventType\$1** \$1eventType\$1 può essere `provisioned` o `registered`. **\$1resourceType\$1** \$1resourceType\$1 può essere `sidewalk_accounts` o `wireless_devices`. **\$1resourceID\$1** \$1resourceID\$1 è `amazon_id` per \$1resourceType\$1 di `sidewalk_accounts` e `wireless_device_id` per \$1resourceType\$1 di`wireless_devices`. È possibile utilizzare anche il carattere jolly `+` per sottoscrivere più argomenti contemporaneamente. Il carattere jolly `+` corrisponde a qualsiasi stringa nel livello che contiene il carattere. Ad esempio, se vuoi ricevere notifiche su tutti i tipi di evento possibili (`provisioned` e `registered`) e per tutti i dispositivi registrati su un particolare ID Amazon, puoi utilizzare il filtro di argomenti che segue: `$aws/iotwireless/events/device_registration_state/+/sidewalk/sidewalk_accounts/amazon_id/+` **Nota** Non è possibile utilizzare il carattere jolly `#` per sottoscrivere argomenti riservati. Per ulteriori informazioni sui filtri per argomento, consulta [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) nella *Guida per gli sviluppatori di AWS IoT*. ## Payload dei messaggi per eventi di stato di registrazione del dispositivo Dopo aver abilitato notifiche per eventi di stato di registrazione del dispositivo, le notifiche degli eventi vengono pubblicate su MQTT con un payload JSON. Questi eventi contengono il payload di esempio seguente: ``` { "eventId": "string", "eventType": "provisioned|registered", "WirelessDeviceId": "string", "timestamp": "timestamp", // Event-specific fields "operation": "create|deregister|register", "Sidewalk": { "AmazonId": "string", "SidewalkManufacturingSn": "string" } } ``` Il payload contiene gli attributi seguenti: **eventId** ID evento univoco (stringa). **eventType** Il tipo di evento che si è verificato. Può essere `provisioned` o `registered`. **wirelessDeviceId** Identificatore del dispositivo wireless. **timestamp** Timestamp Unix del momento in cui si è verificato l'evento. **operazione** Operazione che ha attivato l'evento. I valori validi sono `create`, `register` e `deregister`. **sidewalk** L'ID Amazon Sidewalk o `SidewalkManufacturingSn` per cui vuoi ricevere le notifiche di evento. # Eventi di prossimità Gli eventi di prossimità pubblicano notifiche degli eventi quando AWS IoT riceve un beacon dal dispositivo Sidewalk. Quando il dispositivo Sidewalk si avvicina ad Amazon Sidewalk, i beacon inviati dal dispositivo vengono filtrati da Amazon Sidewalk a intervalli regolari e ricevuti da Wireless AWS IoT. Wireless AWS IoT quindi ti notifica questi eventi quando viene ricevuto un beacon. ## Come funzionano gli eventi di prossimità Gli eventi di prossimità ti segnalano quando AWS IoT riceve un beacon, i dispositivi Sidewalk possono emettere beacon in qualsiasi momento. Quando il tuo dispositivo è vicino ad Amazon Sidewalk, Sidewalk riceve i beacon e li inoltra a Wireless AWS IoT a intervalli di tempo regolari. Amazon Sidewalk ha impostato questo intervallo di tempo a 10 minuti. Quando Wireless AWS IoT riceve il beacon da Sidewalk, riceverai una notifica dell'evento. Gli eventi di prossimità ti avviseranno quando un beacon viene scoperto o perso. È possibile configurare gli intervalli con cui viene notificato l'evento di prossimità. ## Abilita le notifiche per eventi di prossimità Prima che i sottoscrittori degli argomenti riservati di prossimità Sidewalk possano ricevere i messaggi, è necessario abilitare le notifiche di eventi, dalla Console di gestione AWS o utilizzando l'API o l'interfaccia a riga di comando. Puoi abilitare questi eventi per tutte le risorse Sidewalk nel tuo Account AWS o per risorse selezionate. Per ulteriori informazioni su come abilitare gli eventi, consulta [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). ## Formato degli argomenti MQTT per eventi di prossimità Per ricevere avvisi sugli eventi di prossimità, puoi sottoscrivere gli argomenti riservati MQTT che iniziano con un simbolo del dollaro (\$1). Per ulteriori informazioni, consultare [Argomenti MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella *Guida per gli sviluppatori di AWS IoT*. Gli argomenti MQTT riservati per gli eventi di prossimità Sidewalk utilizzano il formato: + Per argomenti a livello di risorsa: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices` + Per argomenti identificatore: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}` Dove: **\$1eventName\$1** \$1eventName\$1 deve essere `proximity`. **\$1eventType\$1** \$1eventType\$1 può essere `beacon_discovered` o `beacon_lost`. **\$1resourceType\$1** \$1resourceType\$1 può essere `sidewalk_accounts` o `wireless_devices`. **\$1resourceID\$1** \$1resourceID\$1 è `amazon_id` per \$1resourceType\$1 di `sidewalk_accounts` e `wireless_device_id` per \$1resourceType\$1 di`wireless_devices`. È possibile utilizzare anche il carattere jolly `+` per sottoscrivere più argomenti contemporaneamente. Il carattere jolly `+` corrisponde a qualsiasi stringa nel livello che contiene il carattere. Ad esempio, se vuoi ricevere notifiche su tutti i tipi di evento possibili (`beacon_discovered` e `beacon_lost`) e per tutti i dispositivi registrati su un particolare ID Amazon, puoi utilizzare il filtro di argomenti che segue: `$aws/iotwireless/events/proximity/+/sidewalk/sidewalk_accounts/amazon_id/+` **Nota** Non è possibile utilizzare il carattere jolly `#` per sottoscrivere argomenti riservati. Per ulteriori informazioni sui filtri per argomento, consulta [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) nella *Guida per gli sviluppatori di AWS IoT*. ## Payload dei messaggi per eventi di prossimità Dopo aver abilitato le notifiche per eventi di prossimità, i messaggi di evento vengono pubblicati su MQTT con un payload JSON. Questi eventi contengono il payload di esempio seguente: ``` { "eventId": "string", "eventType": "beacon_discovered|beacon_lost", "WirelessDeviceId": "string", "timestamp": "1234567890123", // Event-specific fields "Sidewalk": { "AmazonId": "string", "SidewalkManufacturingSn": "string" } } ``` Il payload contiene gli attributi seguenti: **eventId** Un ID evento univoco, rappresentato da una stringa. **eventType** Il tipo di evento che si è verificato. Può essere `beacon_discovered` o `beacon_lost`. **WirelessDeviceId** Identificatore del dispositivo wireless. **timestamp** Timestamp Unix del momento in cui si è verificato l'evento. **sidewalk** L'ID Amazon Sidewalk o `SidewalkManufacturingSn` per cui vuoi ricevere le notifiche di evento.