Applicazioni demo Bluetooth Low Energy

Per configurare AWS IoT

1. Configura un AWS account su https://aws.amazon.com/.

2. Aprire la console AWS IoT e dal riquadro di navigazione scegliere Manage (Gestisci), quindi scegliere Things (Oggetti).

3. Scegliere Create (Crea), quindi scegliere Create a single thing (Crea un singolo oggetto).

4. Immettere un nome per il dispositivo, quindi scegliere Next (Avanti).

5. Se si sta collegando il microcontroller al cloud mediante un dispositivo mobile, scegliere Create thing without certificate (Crea oggetto senza certificato). Poiché gli SDK per dispositivi mobili utilizzano Amazon Cognito per l'autenticazione dei dispositivi, non è necessario creare un certificato del dispositivo per le demo che utilizzano Bluetooth Low Energy.

   Se si sta collegando il microcontroller al cloud direttamente tramite Wi-Fi, scegliere Create certificate (Crea certificato), scegliere Activate (Attiva), quindi scaricare il certificato, la chiave pubblica e la chiave privata dell'oggetto.

6. Scegliere l'oggetto appena creato dall'elenco degli oggetti registrati e quindi scegliere Interact (Interazione) dalla pagina dell'oggetto. Prendi nota dell'endpoint dell'API AWS IoT REST.

Per creare un pool di utenti Amazon Cognito

1. Apri la console Amazon Cognito e scegli Gestisci pool di utenti.

2. Scegli Create a User Pool (Crea un bacino d'utenza).

3. Fornire al pool di utenti un nome, quindi scegliere Review defaults (Esamina impostazioni predefinite).

4. Nel riquadro di navigazione scegliere App clients (Client app) e quindi scegliere Add an app (Aggiungi un'app).

5. Immettere il nome del client dell'app, quindi scegliere Create app client (Crea client dell'app).

6. Dal riquadro di navigazione, scegliere Review (Verifica) e quindi selezionare Create pool (Crea pool).

   Annotare l'ID del pool visualizzato nella pagina General Settings (Impostazioni generali) del pool di utenti.

7. Nel riquadro di navigazione, scegliere App clients (Client app) e quindi scegliere Show details (Mostra dettagli). Annotare l'ID e il segreto del client dell'app.

Per creare un pool di identità Amazon Cognito

1. Apri la console Amazon Cognito e scegli Gestisci pool di identità.

2. Immettere un nome per il pool di identità.

3. Espandere Authentication providers (Provider di autenticazione), scegliere la scheda Cognito, quindi immettere l'ID del pool di utenti e l'ID del client dell'app.

4. Seleziona Create Pool (Crea pool).

5. Espandere View Details (Visualizza dettagli) e annotare i due nomi di ruolo IAM. Scegli Consenti per creare i ruoli IAM per identità autenticate e non autenticate per accedere ad Amazon Cognito.

6. Scegli Modifica pool di identità. Annotare l'ID del pool di identità. Il formato è simile al seguente us-west-2:12345678-1234-1234-1234-123456789012.

Per creare e allegare una policy IAM all'identità autenticata

1. Apri la console IAM e dal pannello di navigazione, scegli Ruoli.

2. Trovare e scegliere il ruolo dell'identità autenticata, scegliere Attach policies (Allega policy), quindi scegliere Add inline policy (Aggiungi policy inline).

3. Scegliere la scheda JSON e incollare il file JSON seguente:

   {
      "Version":"2012-10-17",
      "Statement":[
         {
            "Effect":"Allow",
            "Action":[
               "iot:AttachPolicy",
               "iot:AttachPrincipalPolicy",
               "iot:Connect",
               "iot:Publish",
               "iot:Subscribe",
               "iot:Receive",
               "iot:GetThingShadow",
               "iot:UpdateThingShadow",
               "iot:DeleteThingShadow"
            ],
            "Resource":[
               "*"
            ]
         }
      ]
   }

4. Scegliere Review policy (Esamina policy), immettere un nome per la policy, quindi scegliere Create policy (Crea policy).

Per configurare l'ambiente del tuo microcontrollore con FreerTOS Bluetooth Low Energy

1. Scarica o clona FreerTOS da. GitHub Consultare il file README.md per le istruzioni.

2. Configura FreerTOS sul tuo microcontrollore.

   Per informazioni su come iniziare a usare FreerTOS su un microcontrollore certificato FreeRTOS, consulta la guida per la tua scheda in Getting Started with FreerTOS.

   Nota

   Puoi eseguire le demo su qualsiasi microcontrollore abilitato a Bluetooth Low Energy con FreeRTOS e librerie FreeRTOS Bluetooth Low Energy con porte. Attualmente, il progetto demo MQTT su Bluetooth Low Energy FreerTOS è completamente adattato ai seguenti dispositivi Bluetooth Low Energy:

   • Espressif ESP32- C e l'ESP-WROVER-KIT DevKit

   • Nordic nRF52840-DK

Per configurare l'applicazione demo per SDK iOS

Quando definisci le variabili di configurazione, utilizza il formato dei valori segnaposto forniti nei file di configurazione.

1. Verifica che sia installato SDK iOS per dispositivi Bluetooth FreerTOS.

2. Invia il comando seguente da amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/:

   $ pod install

3. Aprire il progetto amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo.xcworkspace con Xcode e modificare l'account sviluppatore di firma nell'account dell'utente.

4. Crea una AWS IoT politica nella tua regione (se non l'hai già fatto).

   Nota

   Questa policy è diversa dalla policy IAM creata per l'identità autenticata di Amazon Cognito.

   1. Apri la AWS IoT console.

   2. Nel riquadro di navigazione, selezionare Secure (Sicurezza), scegliere Policies (Policy) e poi Create (Crea). Inserire un nome per identificare la policy. 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 AWS la tua regione e l'ID dell'account.

      {
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "iot:Connect",
                  "Resource":"arn:aws:iot:region:account-id:*"
              }, 
              {
                  "Effect": "Allow",
                  "Action": "iot:Publish",
                  "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Subscribe",
                   "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Receive",
                   "Resource": "arn:aws:iot:region:account-id:*"
              }
          ]
      }

   3. Scegli Crea.

5. Apri amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift e ridefinisci le seguenti variabili:

   • region: La tua regione. AWS

   • iotPolicyName: il nome AWS IoT della tua polizza.

   • mqttCustomTopic: l'argomento MQTT in cui effettuare la pubblicazione.

6. Aprire amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Support/awsconfiguration.json.

   In CognitoIdentity ridefinisci le seguenti variabili:

   • PoolId: l'ID del tuo pool di identità di Amazon Cognito.

   • Region: La tua AWS regione.

   In CognitoUserPool ridefinisci le seguenti variabili:

   • PoolId: l'ID del tuo pool di utenti di Amazon Cognito.

   • AppClientId: l'ID del client dell'app.

   • AppClientSecret: il segreto del client dell'app.

   • Region: La tua AWS regione.

Per configurare l'applicazione demo per SDK Android

Quando definisci le variabili di configurazione, utilizza il formato dei valori segnaposto forniti nei file di configurazione.

1. Verifica che sia installato Android SDK per dispositivi Bluetooth FreerTOS.

2. Crea una AWS IoT politica nella tua regione (se non l'hai già fatto).

   Nota

   Questa policy è diversa dalla policy IAM creata per l'identità autenticata di Amazon Cognito.

   1. Apri la AWS IoT console.

   2. Nel riquadro di navigazione, selezionare Secure (Sicurezza), scegliere Policies (Policy) e poi Create (Crea). Inserire un nome per identificare la policy. 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 AWS la tua regione e l'ID dell'account.

      {
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "iot:Connect",
                  "Resource":"arn:aws:iot:region:account-id:*"
              }, 
              {
                  "Effect": "Allow",
                  "Action": "iot:Publish",
                  "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Subscribe",
                   "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Receive",
                   "Resource": "arn:aws:iot:region:account-id:*"
              }
          ]
      }

   3. Scegli Crea.

3. Apri https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/ DemoConstants .java e ridefinisci le seguenti variabili:

   • AWS_IOT_POLICY_NAME: il nome della tua AWS IoT politica.

   • AWS_IOT_REGION: La tua AWS regione.

4. Apri https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/res/raw/awsconfiguration.json.

   In CognitoIdentity ridefinisci le seguenti variabili:

   • PoolId: l'ID del tuo pool di identità di Amazon Cognito.

   • Region: La tua AWS regione.

   In CognitoUserPool ridefinisci le seguenti variabili:

   • PoolId: l'ID del tuo pool di utenti di Amazon Cognito.

   • AppClientId: l'ID del client dell'app.

   • AppClientSecret: il segreto del client dell'app.

   • Region: La tua AWS regione.

Per individuare e stabilire connessioni sicure con il microcontroller su Bluetooth Low Energy

1. Per associare il microcontrollore e il dispositivo mobile in modo sicuro (fase 6), è necessario un emulatore di terminale seriale con funzionalità di input e output (ad esempio). TeraTerm Configura il terminale per la connessione alla scheda tramite una connessione seriale come indicato in Installazione di un emulatore di terminale.

2. Eseguire il progetto demo Bluetooth Low Energy sul microcontroller.

3. Eseguire l'applicazione demo SDK Bluetooth Low Energy Mobile sul dispositivo mobile.

   Per avviare un'applicazione demo di SDK Android dalla riga di comando, eseguire il comando seguente:

   $ ./gradlew installDebug

4. Verificare che il microcontroller sia visualizzato in Devices (Dispositivi) nell'applicazione demo SDK Bluetooth Low Energy Mobile.

   

   Nota

   Nell'elenco vengono visualizzati tutti i dispositivi con FreerTOS e il servizio di informazioni sul dispositivo freertos/.../device_information () che si trovano nell'intervallo.

5. Scegliere il microcontroller dall'elenco di dispositivi. L'applicazione stabilisce una connessione con la scheda e una riga verde viene visualizzata accanto al dispositivo connesso.

   

   È possibile disconnettersi dal microcontrollore trascinando la linea verso sinistra.

   

6. Se richiesto, abbinare il microcontroller e il dispositivo mobile.

   Scheda FreerTOS

   

   Dispositivo mobile

   

   Se il codice per i confronti numerici è identico su entrambi i dispositivi, accoppiare i dispositivi.

Per effettuare la sottoscrizione a un argomento MQTT demo

1. Accedi alla console. AWS IoT

2. Nel pannello di navigazione, scegli Test, quindi scegli MQTT test client per aprire il client MQTT.

3. In Argomento sottoscrizione, digitare thing-name/example/topic1, quindi scegliere Effettua sottoscrizione all'argomento.

Per abilitare la demo tramite Bluetooth Low Energy

1. Aprire vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h e definire CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED.

2. Apri demos/include/aws_clientcredential.h e configura clientcredentialMQTT_BROKER_ENDPOINT con l'endpoint del AWS IoT broker. Configura clientcredentialIOT_THING_NAME con il nome dell'oggetto per il dispositivo microcontrollore BLE. L'endpoint del AWS IoT broker può essere ottenuto dalla AWS IoT console scegliendo Impostazioni nel riquadro di navigazione a sinistra o tramite la CLI eseguendo il comando:. aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   Nota

   L'endpoint del AWS IoT broker e il nome dell'oggetto devono trovarsi entrambi nella stessa regione in cui sono configurati l'identità cognito e il pool di utenti.

Per eseguire la demo

1. Compilare ed eseguire il progetto demo sul microcontroller.

2. Assicurati di aver accoppiato la scheda e il dispositivo mobile utilizzando la Applicazione dimostrativa FreerTOS Bluetooth Low Energy Mobile SDK.

3. Dall'elenco Devices (Dispositivi) nell'applicazione demo per dispositivi mobili, scegliere il microcontroller, quindi selezionare MQTT Proxy (Proxy MQTT) per aprire le impostazioni proxy MQTT.

   

4. Dopo aver abilitato il proxy MQTT, i messaggi MQTT vengono visualizzati sull'argomento thing-name/example/topic1 e i dati vengono stampati sul terminale UART.

Per abilitare la demo

1. Abilitare il servizio di provisioning Wi-Fi. Aprire vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h e impostare #define IOT_BLE_ENABLE_WIFI_PROVISIONING su 1 (dove vendor è il nome del fornitore e board è il nome della scheda che si sta utilizzando per eseguire le demo).

   Nota

   Per impostazione predefinita, il servizio di provisioning Wi-Fi è disabilitato.

2. Configurare Network Manager per abilitare Bluetooth Low Energy e Wi-Fi.

Per eseguire la demo

1. Compilare ed eseguire il progetto demo sul microcontroller.

2. Assicurati di aver associato il microcontrollore e il dispositivo mobile utilizzando il. Applicazione dimostrativa FreerTOS Bluetooth Low Energy Mobile SDK

3. Dall'elenco Devices (Dispositivi) nell'app demo per dispositivi mobili, scegliere il microcontroller, quindi selezionare Network Config (Configurazione rete) per aprire le impostazioni di configurazione della rete.

   

4. Dopo aver scelto Network Config (Configurazione rete) per la scheda, il microcontroller invia un elenco delle reti che si trovano vicino al dispositivo mobile. Le reti Wi-Fi disponibili vengono visualizzate in un elenco in Scanned Networks (Reti scansite).

   

   Dall'elenco Scanned Networks (Reti scansite), scegliere la rete, quindi immettere l'SSID e la password, se richiesti.

   

   Il microcontrollore si connette alla rete e la salva. La rete viene visualizzata in Saved Networks (Reti salvate).

   

Per abilitare la demo

1. Abilitare la demo GATT Bluetooth Low Energy. In vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h (dove vendor è il nome del fornitore e board è il nome della scheda che si sta utilizzando per eseguire le demo), aggiungere #define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 ) all'elenco di istruzioni "define".

   Nota

   La demo GATT Bluetooth Low Energy è disabilitata per impostazione predefinita.

2. Aprire freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h, commentare #define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED e definire CONFIG_BLE_GATT_SERVER_DEMO_ENABLED.

Per eseguire la demo

1. Compilare ed eseguire il progetto demo sul microcontroller.

2. Assicurati di aver accoppiato la scheda e il dispositivo mobile utilizzando la Applicazione dimostrativa FreerTOS Bluetooth Low Energy Mobile SDK.

3. Dall'elenco Devices (Dispositivi) nell'applicazione, scegliere la scheda, quindi selezionare MQTT Proxy (Proxy MQTT) per aprire le opzioni proxy MQTT.

   

4. Tornare all'elenco Devices (Dispositivi), scegliere la scheda, quindi selezionare Custom GATT MQTT (MQTT GATT personalizzato) per aprire le opzioni del servizio GATT personalizzato.

5. Scegliere Start Counter (Avvia contatore) per iniziare a pubblicare dati nell'argomento your-thing-name/example/topic MQTT.

   Dopo aver abilitato il proxy MQTT, i messaggi Hello World e di incremento del contatore vengono visualizzati sull'argomento your-thing-name/example/topic.