Tutorial: ripubblicazione di un messaggio MQTT

Apri l'hub Rules della AWS IoT console.

In Rules (Regole), scegli Create (Crea) e inizia a creare la nuova regola.

Nella parte superiore di Create a rule (Crea una regola):

1. In Name (Nome), inserisci il nome della regola. Per questo tutorial, rinominala republish_temp.

   Ricorda che un nome di regola deve essere univoco all'interno dell’account e della regione e che non può contenere spazi. Abbiamo usato un carattere di sottolineatura in questo nome per separare le due parole nel nome della regola.

2. In Description (Descrizione), descrivi la regola.

   Una descrizione significativa ti aiuta a ricordare cosa fa questa regola e perché l'hai creata. La descrizione può essere lunga quanto necessario, quindi sii il più dettagliato possibile.

In Rule query statement (Istruzione query regola) di Create a rule (Crea una regola):

1. In Utilizzo della SQL versione, seleziona2016-03-23.

2. Nella casella di modifica Rule query statement (Istruzione query regola), inserisci l'istruzione:

   SELECT topic(2) as device_id, temperature FROM 'device/+/data'

   Questa istruzione:

   • Ascolta i MQTT messaggi con un argomento che corrisponde al filtro degli device/+/data argomenti.

   • Seleziona il secondo elemento dalla stringa dell'argomento e lo assegna al campo device_id.

   • Seleziona il valore del campo temperature dal payload del messaggio e lo assegna al campo temperature.

In Set one or more actions (Imposta una o più operazioni):

1. Per aprire l'elenco delle azioni della regola per questa regola, scegli Add action (Aggiungi operazione).

2. In Seleziona un'azione, scegli Ripubblica un messaggio su un argomento. AWS IoT

3. Nella parte inferiore dell'elenco delle azioni, scegli Configure action (Configura operazione) per aprire la pagina di configurazione dell'azione selezionata.

In Configure action (Configura operazione):

1. In Topic (Argomento), inserisci device/data/temp. Questo è l'MQTTargomento del messaggio che verrà pubblicato da questa regola.

2. In Quality of Service (Qualità del servizio), scegli 0 - Il messaggio viene recapitato zero o più volte.

3. In Scegli o crea un ruolo a cui concedere AWS IoT l'accesso per eseguire questa azione:

   1. Selezionare Create Role (Crea ruolo). Si aprirà la finestra di dialogo Create a new role (Crea un nuovo ruolo).

   2. Inserisci un nome che descrive il nuovo ruolo. In questo tutorial, utilizza republish_role.

      Quando si crea un nuovo ruolo, le policy corrette per eseguire l'operazione della regola vengono create e associate al nuovo ruolo. Se si modifica l'argomento dell'operazione della regola o si utilizza questo ruolo in un'altra operazione della regola, è necessario aggiornare la policy per tale ruolo per autorizzare il nuovo argomento o operazione. Per aggiornare un ruolo esistente, scegli Update role (Aggiorna ruolo) in questa sezione.

   3. Scegli Create role (Crea ruolo) per creare il ruolo e chiudere la finestra di dialogo.

4. Scegli Add action (Aggiungi operazione) per aggiungere l'operazione alla regola e tornare alla pagina Create a rule (Crea una regola).

L'azione Ripubblica un messaggio su un AWS IoT argomento è ora elencata in Imposta una o più azioni.

Nel titolo della nuova azione, sotto Republish a message to an AWS IoT topic (Ripubblicazione di un messaggio in un argomento di Amazon IoT), è possibile visualizzare l'argomento in cui verrà pubblicata l'operazione di ripubblicazione.

Questa è l'unica operazione della regola che aggiungerai a questa regola.

In Create a rule (Crea una regola), scorri verso il basso e seleziona Create rule (Crea regola) per creare la regola e completare questo passaggio.

Nel MQTT client della AWS IoT console, iscriviti agli argomenti di input, in questo caso,device/+/data.

1. Nel MQTT client, in Abbonamenti, scegli Sottoscrivi a un argomento.

2. In Subscription topic (Argomento sottoscrizione), inserisci l'argomento del filtro dell’argomento di input, device/+/data.

3. Lascia gli altri campi ai valori predefiniti.

4. Scegli Subscribe to topic (Effettua sottoscrizione all'argomento).

   Nella colonna Subscriptions (Sottoscrizioni), sotto Publish to a topic (Pubblicaz in un argomento), viene visualizzato device/+/data.

Effettua la sottoscrizione all'argomento che verrà pubblicato dalla regola: device/data/temp.

1. Sotto Subscriptions (Sottoscrizioni), scegli di nuovo Subscribe to a topic (Sottoscrizione a un argomento), e in Subscription topic (Argomento sottoscrizione) inserisci l'argomento del messaggio ripubblicato, device/data/temp.

2. Lascia gli altri campi ai valori predefiniti.

3. Scegli Subscribe to topic (Effettua sottoscrizione all'argomento).

   Nella colonna Subscriptions (Sottoscrizioni), sotto device/+/data (dispositivo/+/dati), device/data/temp viene visualizzato.

Pubblicazione di un messaggio nell'argomento di input con un ID dispositivo specifico, device/22/data. Non puoi pubblicare MQTT su argomenti che contengono caratteri jolly.

1. Nel MQTT client, in Abbonamenti, scegli Pubblica su argomento.

2. Nel campo Publish (Pubblica), inserisci il nome dell'argomento di input, device/22/data.

3. Copia i dati di esempio mostrati qui e, nella casella di modifica sotto il nome dell'argomento, incolla i dati di esempio.

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Per inviare il MQTT messaggio, scegli Pubblica su argomento.

Esamina i messaggi che sono stati inviati.

1. Nel MQTT client, sotto Abbonamenti, c'è un punto verde accanto ai due argomenti a cui ti sei iscritto in precedenza.

   I punti verdi indicano che uno o più nuovi messaggi sono stati ricevuti dall'ultima volta che li hai guardati.

2. Sotto Subscriptions (Sottoscrizioni), scegli device/+/data (dispositivo/+/dati) per verificare che il payload del messaggio corrisponda a quello che hai appena pubblicato e assomigli a questo:

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. Sotto Subscriptions (Sottoscrizioni), scegli device/data/temp (dispositivo/dati/temp) per verificare che il payload del messaggio ripubblicato sia simile a questo:

   {
     "device_id": "22",  
     "temperature": 28
   }

   Nota che il valore device_id è una stringa tra virgolette e il valore temperature è numerico. Questo perché la funzione topic() ha estratto la stringa dal nome dell'argomento del messaggio di input mentre il valore temperature utilizza il valore numerico dal payload del messaggio di input.

   Se desideri rendere il valore device_id un valore numerico, sostituisci topic(2)nell'istruzione query della regola con:

   cast(topic(2) AS DECIMAL)

   Nota che la trasformazione del valore topic(2) in un valore numerico funzionerà solo se la parte dell'argomento contiene solo caratteri numerici.

Se si vede che il messaggio corretto è stato pubblicato nell’argomento device/data/temp (dispositivo/dati/temp), la regola ha funzionato. Scopri di più sull'azione Ripubblica regola nella sezione successiva.

Se non vedi che il messaggio corretto è stato pubblicato negli argomenti device/+/data (dispositivo/+/dati) o device/data/temp (dispositivo/dati/temp), consulta i suggerimenti per la risoluzione dei problemi.