Notifiche di eventi per AWS IoT Wireless

AWS IoT Wireless 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 e Notifiche di eventi per le risorse Sidewalk.

Tipi di evento basati sulle risorse
Risorsa	Tipo di risorsa	Tipo di evento
Dispositivo wireless	LoRaWAN	Join
	Sidewalk	Stato di registrazione del dispositivo Prossimità
Gateway wireless	LoRaWAN	Stato della connessione
Account Sidewalk	Sidewalk	Stato di registrazione del dispositivo Prossimità

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 ($). 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 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 AWS IoT Wireless.

  $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 AWS IoT Wireless, 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.

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	Argomento a livello di risorsa $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices Argomento a livello di identificatore $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} può essere registered o provisioned {resourceType} può essere sidewalk_accounts o wireless_devices {resourceID} è l'amazon_id per sidewalk_accounts e l'wireless_device_id per wireless_devices
Prossimità Sidewalk	Argomento a livello di risorsa $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices Argomento a livello di identificatore $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} può essere beacon_discovered o beacon_lost {resourceType} può essere sidewalk_accounts o wireless_devices {resourceID} è l'amazon_id per sidewalk_accounts e l'wireless_device_id per wireless_devices
Join LoRaWAN	Argomento a livello di risorsa $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices Argomento a livello di identificatore $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}	{eventType} può essere join_req_0_received o join_req_2_received o join_accepted {resourceID} può essere wireless_device_id o dev_eui
Stato della connessione del gateway LoRaWAN	Argomento a livello di risorsa $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways Argomento a livello di identificatore $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}	{eventType} può essere connected o disconnected {resourceID} può essere wireless_gateway_id o gateway_eui

Per ulteriori informazioni sui diversi eventi, consulta Notifiche di eventi per le risorse LoRaWAN e Notifiche di eventi per le risorse Sidewalk.

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 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.