Fase iniziale

Per creare un AWS IoT policy

1. Per creare una policy IAM, devi conoscere la tua AWS regione e il numero di AWS account.

   Per trovare il numero del tuo AWS account, apri la console di AWS gestione, individua ed espandi il menu sotto il nome del tuo account nell'angolo in alto a destra e seleziona Il mio account. Il tuo ID account viene visualizzato in Account Settings (Impostazioni account).

   Per trovare la AWS regione del tuo AWS account, usa il. AWS Command Line Interface Per installare il AWS CLI, segui le istruzioni contenute nella Guida AWS Command Line Interface per l'utente. Dopo aver installato AWS CLI, aprite una finestra del prompt dei comandi e immettete il seguente comando:

   aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   L'output dovrebbe essere simile al seguente:

   {
       "endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
   }

   Nell'esempio, la regione è us-west-2.

   Nota

   Consigliamo di utilizzare gli endpoint ATS come illustrato nell'esempio.

2. Passare alla console AWS IoT.

3. Nel riquadro di navigazione, selezionare Secure (Sicurezza), scegliere Policies (Policy) e poi Create (Crea).

4. Inserire un nome per identificare la policy.

5. Nella sezione Add statements (Aggiungi istruzioni), scegliere Advanced mode (Modalità avanzata). Copiare e incollare il seguente JSON nella finestra dell'editor policy. Sostituisci aws-region e aws-account con la tua AWS regione e l'ID dell'account.

   JSON

   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iot:Connect",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Publish",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Receive",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           }
       ]
   }
   

   La policy concede le seguenti autorizzazioni:

   iot:Connect

   Concede al dispositivo l'autorizzazione a connettersi al broker di AWS IoT messaggi con qualsiasi ID cliente.

   iot:Publish

   Concede al dispositivo l'autorizzazione per pubblicare un messaggio MQTT su qualsiasi argomento MQTT.

   iot:Subscribe

   Concede al dispositivo l'autorizzazione per eseguire la sottoscrizione a qualsiasi filtro di argomenti MQTT.

   iot:Receive

   Concede al dispositivo l'autorizzazione per ricevere messaggi dal broker di messaggi AWS IoT su qualsiasi argomento MQTT.

6. Scegli Create (Crea).

Per creare un oggetto IoT, una chiave privata e un certificato per il tuo dispositivo

1. Passare alla console AWS IoT.

2. Nel riquadro di navigazione scegliere Manage (Gestisci), quindi Things (Oggetti).

3. Se non si dispone di oggetti IoT registrati nel proprio account, compare la pagina You don't have any things yet (Non hai ancora oggetti). Se si consulta questa pagina, scegliere Register a thing (Registra un oggetto). In caso contrario, scegliere Create (Crea).

4. Nella pagina Creazione di AWS IoT oggetti, scegli Crea una singola cosa.

5. Sulla pagina Add your device to the thing registry (Aggiungi il tuo dispositivo al registro degli oggetti), immettere un nome per il proprio oggetto, quindi scegliere Next (Successivo).

6. Nella pagina Aggiungi un certificato per il tuo oggetto, in Creazione One-click del certificato, scegli Crea certificato.

7. Scaricare la chiave privata e il certificato scegliendo i link Download (Scarica) per ognuno.

8. Scegliere Activate (Attiva) per attivare il certificato. I certificati devono essere attivati prima dell'uso.

9. Scegli Allega una policy per allegare al tuo certificato una policy che consenta al tuo dispositivo di accedere alle AWS IoT operazioni.

10. Scegliere la policy appena creata e poi Register thing (Registra l'oggetto).

Per configurare il AWS IoT endpoint

Devi fornire a FreerTOS AWS IoT il tuo endpoint in modo che l'applicazione in esecuzione sulla tua scheda possa inviare richieste all'endpoint corretto.

1. Passare alla console AWS IoT.

2. Nel riquadro di navigazione a sinistra scegliere Impostazioni.

   L'endpoint viene visualizzato nell' AWS IoT endpoint Device data. L'URL dovrebbe essere del tipo 1234567890123-ats.iot.us-east-1.amazonaws.com. Prendere nota di questo endpoint.

3. Nel riquadro di navigazione scegliere Manage (Gestisci), quindi Things (Oggetti).

   Il dispositivo dovrebbe avere un nome AWS IoT . Prendere nota di questo nome.

4. Aprire demos/include/aws_clientcredential.h.

5. Specificare i valori per le seguenti costanti :

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

   • #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"

Per configurare il tuo Wi-Fi

Se la tua scheda si connette a Internet tramite una Wi-Fi connessione, devi fornire a FreerTOS le credenziali per Wi-Fi connettersi alla rete. Se la tua scheda non supporta Wi-Fi, puoi saltare questi passaggi.

1. demos/include/aws_clientcredential.h.

2. Specificare i valori per le seguenti costanti #define:

   • #define clientcredentialWIFI_SSID "The SSID for your Wi-Fi network"

   • #define clientcredentialWIFI_PASSWORD "The password for your Wi-Fi network"

   • #define clientcredentialWIFI_SECURITY The security type of your Wi-Fi network

     I tipi di sicurezza validi sono:

     • eWiFiSecurityOpen (Aperto, nessuna protezione)

     • eWiFiSecurityWEP (Sicurezza WEP)

     • eWiFiSecurityWPA (Sicurezza WPA)

     • eWiFiSecurityWPA2 (Sicurezza WPA2)

Per formattare il tuo AWS IoT credenziali

FreerTOS deve avere AWS IoT il certificato e le chiavi private associati all'oggetto registrato e alle relative politiche di autorizzazione per comunicare AWS IoT con successo per conto del dispositivo.

FreerTOS è un progetto in linguaggio C e il certificato e la chiave privata devono essere formattati in modo speciale per essere aggiunti al progetto.

1. In una finestra del browser, aprire tools/certificate_configuration/CertificateConfigurator.html.

2. In File PEM del certificato, scegliere ID-certificate.pem.crt scaricato dalla console AWS IoT .

3. In File PEM della chiave privata, scegliere la ID-private.pem.key scaricata dalla console AWS IoT .

4. Scegliere Generate and save aws_clientcredential_keys.h (Genera e salva aws_clientcredential_keys.h) e salvare il file in demos/include. Questa operazione sovrascrive il file esistente nella directory.

   Nota

   Il certificato e la chiave privata sono codificati solo a scopo dimostrativo. Production-level le applicazioni devono archiviare questi file in un luogo sicuro.