Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Bluetooth Low Energy-Demoanwendungen **Wichtig** Diese Demo wird im Amazon-FreeRTOS-Repository gehostet, das veraltet ist. Wir empfehlen, dass Sie [hier beginnen](freertos-getting-started-modular.md), wenn Sie ein neues Projekt erstellen. Wenn Sie bereits ein vorhandenes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-FreeRTOS-Repository basiert, finden Sie weitere Informationen unter. [Leitfaden zur Migration des Amazon-FreerTOS Github-Repositorys](github-repo-migration.md) ## -Übersicht FreeRTOS Bluetooth Low Energy umfasst drei Demo-Anwendungen: + [MQTT über Bluetooth Low Energy](#ble-demo-mqtt)-Demo Diese Anwendung zeigt, wie Sie den MQTT über den Bluetooth Low Energy-Service nutzen können. + [WLAN-Bereitstellung](#ble-demo-wifi)-Demo Diese Anwendung zeigt, wie Sie den Bluetooth Low Energy Wi-Fi Provisioning Service nutzen können. + [Generic Attributes Server](#ble-demo-server)-Demo Diese Anwendung demonstriert, wie die FreeRTOS Bluetooth Low Energy-Middleware verwendet wird, um einen einfachen APIs GATT-Server zu erstellen. **Anmerkung** Folgen Sie den Schritten unter, um die FreeRTOS-Demos einzurichten und auszuführen. [Erste Schritte mit FreeRTOS](freertos-getting-started.md) ## Voraussetzungen Um diese Demos auszuführen, benötigen Sie einen Mikrocontroller mit Bluetooth Low Energy-Funktion. Sie brauchen außerdem [iOS-SDK für FreeRTOS-Bluetooth-Geräte](freertos-ble-mobile.md#freertos-ble-ios) oder [Android-SDK für FreeRTOS-Bluetooth-Geräte](freertos-ble-mobile.md#freertos-ble-android). ### Einrichtung AWS IoT und Amazon Cognito für FreeRTOS Bluetooth Low Energy Um Ihre Geräte mit AWS IoT Across MQTT zu verbinden, müssen Sie Amazon Cognito einrichten AWS IoT . **Zum Einrichten AWS IoT** 1. Richten Sie ein AWS Konto auf [https://aws.amazon.com/](https://aws.amazon.com/)ein. 1. Öffnen Sie die [AWS IoT -Konsole](https://console.aws.amazon.com/iot/) und wählen Sie im Navigationsbereich **Manage (Verwalten)** und dann **Things (Objekte)**. 1. Wählen Sie **Create (Erstellen)** und dann **Create a single thing (Einzelnes Objekt erstellen)**. 1. Geben Sie einen Namen für Ihr Gerät ein und wählen Sie dann **Next (Weiter)**. 1. Wenn Sie Ihren Mikrocontroller über ein mobiles Gerät mit der Cloud verbinden, wählen Sie **Create thing without certificate (Erstellen Sie das Objekt ohne Zertifikat)**. Da Mobile Amazon Cognito für die Geräteauthentifizierung SDKs verwendet, müssen Sie kein Gerätezertifikat für Demos erstellen, die Bluetooth Low Energy verwenden. Wenn Sie Ihren Mikrocontroller direkt über WLAN mit der Cloud verbinden, wählen Sie **Create certificate (Zertifikat erstellen)**, wählen Sie **Activate (Aktivieren)** und laden Sie dann das Zertifikat, den öffentlichen Schlüssel und den privaten Schlüssel des Objekts herunter. 1. Wählen Sie das Objekt, das Sie gerade erstellt haben, aus der Liste der registrierten Objekte aus und wählen Sie dann **Interact (Interagieren)** auf der Seite Ihres Objekts. Notieren Sie sich den AWS IoT REST-API-Endpunkt. Weitere Informationen zur Einrichtung finden Sie unter [Erste Schritte mit AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html). **So erstellen Sie einen Amazon Cognito Cognito-Benutzerpool** 1. Öffnen Sie die Amazon Cognito Cognito-Konsole und wählen Sie **Benutzerpools verwalten**. 1. Wählen Sie **Create a user pool**. 1. Geben Sie dem Benutzerpool einen Namen und wählen Sie dann **Review defaults (Standardwerte prüfen)**. 1. Wählen Sie im Navigationsbereich **App clients (App-Clients)** und wählen Sie dann **Add an app client (App-Client hinzufügen)**. 1. Geben Sie einen Namen für den App-Client ein und wählen Sie dann **Create app client (App-Client erstellen)**. 1. Wählen Sie im Navigationsbereich **Review (Prüfen)** und dann **Create pool (Pool erstellen)**. Notieren Sie sich die Pool-ID, die auf der Seite **General Settings (Allgemeine Einstellungen)** Ihres eigenen Benutzerpools angezeigt wird. 1. Wählen Sie im Navigationsbereich **App clients (App-Clients)** und wählen Sie dann **Show details (Details anzeigen)**. Notieren Sie sich die App-Client-ID und den App-Clientschlüssel. **So erstellen Sie einen Amazon Cognito Cognito-Identitätspool** 1. Öffnen Sie die Amazon Cognito Cognito-Konsole und wählen Sie **Manage Identity Pools** aus. 1. Geben Sie einen Namen für den Identitäten-Pool ein. 1. Erweitern Sie **Authentication providers (Authentifizierungsanbieter)**, wählen Sie die Registerkarte **Cognito** und geben Sie dann Ihre Benutzerpool-ID und App-Client-ID ein. 1. Wählen Sie **Pool erstellen**. 1. Erweitern Sie **View Details (Details anzeigen)** und notieren Sie sich die beiden IAM-Rollennamen. Wählen Sie **Allow**, um die IAM-Rollen für authentifizierte und nicht authentifizierte Identitäten für den Zugriff auf Amazon Cognito zu erstellen. 1. Wählen Sie **Edit identity pool (Identitäten-Pool bearbeiten)**. Notieren Sie sich die Identitätspool-ID. Sie sollte ein Format wie `us-west-2:12345678-1234-1234-1234-123456789012` haben. Weitere Informationen zur Einrichtung von Amazon Cognito finden Sie unter [Erste Schritte mit Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-getting-started.html). **Um eine IAM-Richtlinie zu erstellen und an die authentifizierte Identität anzuhängen** 1. **Öffnen Sie die IAM-Konsole und wählen Sie im Navigationsbereich Rollen aus.** 1. Finden Sie die Rolle Ihrer authentifizierten Identität und wählen Sie sie aus, wählen Sie **Attach policies (Richtlinien anfügen)** und wählen Sie dann **Add inline policy (Eingebundene Richtlinie hinzufügen)**. 1. Wählen Sie die Registerkarte **JSON** und fügen Sie die folgende JSON ein: ------ #### [ JSON ] **** ``` { "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":[ "*" ] } ] } ``` ------ 1. Wählen Sie **Review policy (Richtlinie prüfen)**, geben Sie einen Namen für die Richtlinie ein und wählen Sie dann **Create policy (Richtlinie erstellen)**. Halten Sie Ihre Daten AWS IoT und Amazon Cognito stets griffbereit. Sie benötigen den Endpunkt und IDs müssen Ihre mobile Anwendung mit der AWS Cloud authentifizieren. ### Richten Sie Ihre FreeRTOS-Umgebung für Bluetooth Low Energy ein Um Ihre Umgebung einzurichten, müssen Sie FreeRTOS mit dem [Bluetooth Low Energy-Bibliothek](freertos-ble-library.md) auf Ihrem Mikrocontroller herunterladen und das Mobile SDK für FreeRTOS Bluetooth-Geräte auf Ihr Mobilgerät herunterladen und konfigurieren. **Um die Umgebung Ihres Mikrocontrollers mit FreeRTOS Bluetooth Low Energy einzurichten** 1. Laden Sie FreeRTOS von herunter oder klonen Sie es. [GitHub](https://github.com/aws/amazon-freertos) Anweisungen finden Sie in der Datei [README.md](https://github.com/aws/amazon-freertos/blob/main/README.md). 1. Richten Sie FreeRTOS auf Ihrem Mikrocontroller ein. [Informationen zu den ersten Schritten mit FreeRTOS auf einem FreeRTOS-qualifizierten Mikrocontroller finden Sie in der Anleitung für Ihr Board unter Getting Started with FreeRTOS.](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-getting-started.html) **Anmerkung** Sie können die Demos auf jedem Bluetooth Low Energy-fähigen Mikrocontroller mit FreeRTOS und portierten FreeRTOS Bluetooth Low Energy-Bibliotheken ausführen. Derzeit ist das [MQTT über Bluetooth Low Energy](#ble-demo-mqtt) FreeRTOS-Demoprojekt vollständig auf die folgenden Bluetooth Low Energy-fähigen Geräte portiert: [Espressif - C ESP32 und der DevKit ESP-WROVER-KIT](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_espressif.html) [Nordisch n -DK RF52840](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_nordic.html) ## Gemeinsame Komponenten Die FreeRTOS-Demoanwendungen haben zwei gemeinsame Komponenten: + Network Manager + Bluetooth Low Energy Mobile SDK Demo-Anwendung für mobile Endgeräte ### Network Manager Der Network Manager verwaltet die Netzwerkverbindung Ihres Mikrocontrollers. Es befindet sich in Ihrem FreeRTOS-Verzeichnis unter. `demos/network_manager/aws_iot_network_manager.c` Wenn der Netzwerkmanager sowohl für Wi-Fi als auch für Bluetooth Low Energy aktiviert ist, beginnen die Demos standardmäßig mit Bluetooth Low Energy. Wenn die Bluetooth Low Energy-Verbindung unterbrochen ist, Ihr Motherboard aber, wechselt der Network Manager zu einer verfügbaren Wi-Fi-Verbindung Wi-Fi-enabled, um zu verhindern, dass Sie die Verbindung zum Netzwerk trennen. Um einen Netzwerkverbindungstyp mit dem Network Manager zu aktivieren, fügen Sie den Netzwerkverbindungstyp zum `configENABLED_NETWORKS` Parameter in hinzu `vendors/{{vendor}}/boards/{{board}}/aws_demos/config_files/aws_iot_network_config.h` (wobei der {{vendor}} Name des Anbieters und der Name der Karte {{board}} ist, mit der Sie die Demos ausführen). Wenn Sie beispielsweise sowohl Bluetooth Low Energy als auch Wi-Fi aktiviert haben, lautet die Zeile, die mit `#define configENABLED_NETWORKS` in `aws_iot_network_config.h` beginnt, wie folgt: ``` #define configENABLED_NETWORKS ( AWSIOT_NETWORK_TYPE_BLE | AWSIOT_NETWORK_TYPE_WIFI ) ``` Um eine Liste der aktuell unterstützten Netzwerkverbindungstypen zu erhalten, sehen Sie sich die Zeilen, die mit `#define AWSIOT_NETWORK_TYPE` beginnen, in `aws_iot_network.h` an. ### FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung Die FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung befindet sich GitHub unter [Android SDK für FreeRTOS Bluetooth-Geräte](https://github.com/aws/amazon-freertos-ble-android-sdk) unter `amazon-freertos-ble-android-sdk/app` und im [iOS SDK für FreeRTOS](https://github.com/aws/amazon-freertos-ble-ios-sdk) Bluetooth-Geräte unter. `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo` In diesem Beispiel verwenden wir Screenshots der iOS-Version der Demoanwendung für mobile Geräte. **Anmerkung** Wenn Sie ein iOS-Gerät verwenden, benötigen Sie Xcode, um die mobile Demo-Anwendung zu erstellen. Wenn Sie ein Android-Gerät verwenden, können Sie Android Studio verwenden, um die mobile Demo-Anwendung zu erstellen. **So konfigurieren Sie die iOS-SDK-Demoanwendung** Wenn Sie Konfigurationsvariablen definieren, verwenden Sie das Format der Platzhalterwerte aus den Konfigurationsdateien. 1. Vergewissern Sie sich, dass [iOS-SDK für FreeRTOS-Bluetooth-Geräte](freertos-ble-mobile.md#freertos-ble-ios) installiert ist. 1. Führen Sie den folgenden Befehl über die `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/` aus: ``` $ pod install ``` 1. Öffnen Sie das Projekt `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo.xcworkspace` mit Xcode und wechseln Sie vom Konto des signierenden Entwicklers zu Ihrem Konto. 1. Erstellen Sie eine AWS IoT Richtlinie in Ihrer Region (falls Sie dies noch nicht getan haben). **Anmerkung** Diese Richtlinie unterscheidet sich von der IAM-Richtlinie, die für die authentifizierte Amazon Cognito Cognito-Identität erstellt wurde. 1. Öffnen Sie die [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie im Navigationsbereich erst **Sicher**, dann **Richtlinien** und anschließend **Erstellen** aus. Geben Sie einen Namen zur Identifizierung Ihrer Richtlinie ein. Wählen Sie im Abschnitt **Anweisungen hinzufügen** die Option **Erweiterter Modus** aus. Kopieren Sie die folgende JSON und fügen Sie sie in das Fenster des Richtlinien-Editors ein. Ersetzen Sie {{aws-region}} und {{aws-account}} durch Ihre AWS Region und Konto-ID. 1. Wählen Sie **Erstellen** aus. 1. Öffnen Sie `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift` und definieren Sie die folgenden Variablen neu: + `region`: Deine AWS Region. + `iotPolicyName`: Name Ihrer AWS IoT Richtlinie. + `mqttCustomTopic`: Das MQTT-Thema, zu dem Sie veröffentlichen möchten 1. Öffnen Sie `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Support/awsconfiguration.json`. Definieren Sie die folgenden Variablen unter `CognitoIdentity` neu: + `PoolId`: Ihre Amazon Cognito Cognito-Identitätspool-ID. + `Region`: Ihre AWS Region. Definieren Sie die folgenden Variablen unter `CognitoUserPool` neu: + `PoolId`: Ihre Amazon Cognito Cognito-Benutzerpool-ID. + `AppClientId`: Ihre App-Client-ID + `AppClientSecret`: Ihren App-Clientschlüssel + `Region`: Ihre AWS Region. **So konfigurieren Sie die Android-SDK-Demoanwendung** Wenn Sie Konfigurationsvariablen definieren, verwenden Sie das Format der Platzhalterwerte aus den Konfigurationsdateien. 1. Vergewissern Sie sich, dass [Android-SDK für FreeRTOS-Bluetooth-Geräte](freertos-ble-mobile.md#freertos-ble-android) installiert ist. 1. Erstellen Sie eine AWS IoT Richtlinie in Ihrer Region (falls Sie dies noch nicht getan haben). **Anmerkung** Diese Richtlinie unterscheidet sich von der IAM-Richtlinie, die für die authentifizierte Amazon Cognito Cognito-Identität erstellt wurde. 1. Öffnen Sie die [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie im Navigationsbereich erst **Sicher**, dann **Richtlinien** und anschließend **Erstellen** aus. Geben Sie einen Namen zur Identifizierung Ihrer Richtlinie ein. Wählen Sie im Abschnitt **Anweisungen hinzufügen** die Option **Erweiterter Modus** aus. Kopieren Sie die folgende JSON und fügen Sie sie in das Fenster des Richtlinien-Editors ein. Ersetzen Sie {{aws-region}} und {{aws-account}} durch Ihre AWS Region und Konto-ID. 1. Wählen Sie **Erstellen** aus. 1. Öffnen Sie [ https://github.com/aws/amazon-freertos-ble-androidsdk/blob/master/app/src/main/java/software/amazon/freertos/demo/DemoConstants-.java](https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/DemoConstants.java) und definieren Sie die folgenden Variablen neu: + `AWS_IOT_POLICY_NAME`: Ihr AWS IoT Richtlinienname. + `AWS_IOT_REGION`: Ihre AWS Region. 1. Öffnen Sie [ https://github.com/aws/amazon-freertos-ble-android- sdk/blob/master/app/src/main/res/raw/awsconfiguration .json.](https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/res/raw/awsconfiguration.json) Definieren Sie die folgenden Variablen unter `CognitoIdentity` neu: + `PoolId`: Ihre Amazon Cognito Cognito-Identitätspool-ID. + `Region`: Ihre AWS Region. Definieren Sie die folgenden Variablen unter `CognitoUserPool` neu: + `PoolId`: Ihre Amazon Cognito Cognito-Benutzerpool-ID. + `AppClientId`: Ihre App-Client-ID + `AppClientSecret`: Ihren App-Clientschlüssel + `Region`: Ihre AWS Region. **So erkennen und stellen Sie sichere Verbindungen mit Ihrem Mikrocontroller über Bluetooth Low Energy her** 1. Um Ihren Mikrocontroller und Ihr Mobilgerät sicher zu koppeln (Schritt 6), benötigen Sie einen seriellen Terminal-Emulator mit Eingabe- und Ausgabefunktionen (z. B. TeraTerm). Konfigurieren Sie das Terminal für eine serielle Verbindung zu Ihrem Board gemäß den Anweisungen in [Installieren eines Terminal-Emulators](gsg-troubleshooting.md#uart-term). 1. Starten Sie das Bluetooth Low Energy Demo-Projekt auf Ihrem Mikrocontroller. 1. Starten Sie die Bluetooth Low Energy Mobile SDK-Demo-Anwendung auf Ihrem mobilen Gerät. Um die Demoanwendung im Android-SDK von der Befehlszeile aus zu starten, führen Sie den folgenden Befehl aus: ``` $ ./gradlew installDebug ``` 1. Vergewissern Sie sich, dass Ihr Mikrocontroller unter **Devides (Geräte)** in der Bluetooth Low Energy Mobile SDK Demo-Anwendung erscheint. ![Seite zur Geräteverwaltung, auf der ein ESP32 Gerät mit seiner eindeutigen Kennung angezeigt wird.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list1.png) **Anmerkung** Alle Geräte mit FreeRTOS und dem Geräteinformationsdienst (`{{freertos}}/.../device_information`), die sich in Reichweite befinden, werden in der Liste angezeigt. 1. Wählen Sie Ihren Mikrocontroller aus der Liste der Geräte aus. Die Anwendung stellt eine Verbindung mit dem Board her und eine grüne Linie wird neben dem verbundenen Gerät angezeigt. ![ESP32 Die Geräte-ID wird angezeigt.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list2.png) Sie können die Verbindung zu Ihrem Mikrocontroller trennen, indem Sie die Linie nach links ziehen. ![Geräteseite mit einer ESP32 Geräte-ID und einer anderen Geräte-ID.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list3.png) 1. Wenn Sie dazu aufgefordert werden, koppeln Sie Ihren Mikrocontroller und Ihr mobiles Gerät. ![Die Konsolenausgabe zeigt die Trennung des BLE-Geräts, die Unterbrechung des MQTT-Dienstes, den Start der Ankündigung, die BLE-Verbindung zum Remote-Gerät und eine Aufforderung zum numerischen Vergleich.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/pairing-board.png) ![Dialogfeld zur Anforderung einer Bluetooth-Kopplung für das Gerät "ESP32" mit dem Code „465520" zur Bestätigung von"“. ESP32](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/pairing-mobile.png) Wenn der Code für den numerischen Abgleich auf beiden Geräten übereinstimmt, verbinden Sie die Geräte. **Anmerkung** Die Bluetooth Low Energy Mobile SDK-Demoanwendung verwendet Amazon Cognito für die Benutzerauthentifizierung. Stellen Sie sicher, dass Sie einen Amazon Cognito Cognito-Benutzer und Identitätspools eingerichtet haben und dass Sie authentifizierten Identitäten IAM-Richtlinien angehängt haben. ## MQTT über Bluetooth Low Energy In der Demo MQTT over Bluetooth Low Energy veröffentlicht Ihr Mikrocontroller Nachrichten über einen MQTT-Proxy in der AWS Cloud. **So abonnieren Sie ein Demo-MQTT-Thema** 1. Melden Sie sich bei der Konsole an. AWS IoT 1. Wählen Sie im Navigationsbereich **Test** und dann **MQTT-Testclient aus, um den MQTT-Client** zu öffnen. 1. Geben Sie im Feld **Subscription topic (Abonnementthema)** die Option **{{thing-name}}/example/topic1** ein und wählen Sie dann **Subscribe to topic (Thema abonnieren)**. Wenn Sie den Mikrocontroller mit Bluetooth Low Energy mit Ihrem mobilen Gerät koppeln, werden die MQTT-Nachrichten über die Bluetooth Low Energy Mobile SDK-Demoanwendung auf Ihrem mobilen Gerät weitergeleitet. **Um die Demo über Bluetooth Low Energy zu aktivieren** 1. Öffnen Sie `vendors/{{vendor}}/boards/{{board}}/aws_demos/config_files/aws_demo_config.h`, und definieren Sie `CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED`. 1. Öffnen `demos/include/aws_clientcredential.h` und konfigurieren Sie `clientcredentialMQTT_BROKER_ENDPOINT` mit dem AWS IoT Broker-Endpunkt. Konfigurieren Sie `clientcredentialIOT_THING_NAME` mit dem Ding-Namen für das BLE-Mikrocontroller-Gerät. Der AWS IoT Broker-Endpunkt kann über die AWS IoT Konsole abgerufen werden, indem Sie im linken Navigationsbereich **Einstellungen** auswählen, oder über die CLI, indem Sie den folgenden Befehl ausführen:`aws iot describe-endpoint --endpoint-type=iot:Data-ATS`. **Anmerkung** Der AWS IoT Broker-Endpunkt und der Ding-Name müssen sich beide in derselben Region befinden, in der die Cognito-Identität und der Benutzerpool konfiguriert sind. **So führen Sie die Demo aus** 1. Erstellen Sie das Demoprojekt und führen Sie es auf dem Mikrocontroller aus. 1. Stellen Sie sicher, dass Sie Ihr Board und Ihr mobiles Gerät mithilfe der [FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung](#ble-sdk-app) verbunden haben. 1. Wählen Sie aus der Liste **Devices (Geräte)** in der Demoanwendung für mobile Geräte Ihren Mikrocontroller aus und wählen Sie dann **MQTT Proxy (MQTT-Proxy)**, um die MQTT-Proxy-Einstellungen zu öffnen. ![Nachfolgend finden Sie eine Liste von drei ESP32 Geräten IDs mit den Optionen MQTT Proxy, Network Config und Custom GATT MQTT.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list4.png) 1. Nachdem Sie den MQTT-Proxy aktiviert haben, werden MQTT-Nachrichten im `{{thing-name}}/example/topic1`-Thema angezeigt und die Daten werden im UART-Terminal ausgegeben. ## WLAN-Bereitstellung Wi-Fi Provisioning ist ein FreeRTOS Bluetooth Low Energy-Dienst, mit dem Sie Wi-Fi-Netzwerkanmeldedaten sicher über Bluetooth Low Energy von einem Mobilgerät an einen Mikrocontroller senden können. Den Quellcode für den WLAN-Bereitstellungsservice finden Sie unter `{{freertos}}/.../wifi_provisioning`. **Anmerkung** Die Wi-Fi Provisioning-Demo wird derzeit auf dem Espressif - C unterstützt. ESP32 DevKit **So aktivieren Sie die Demo:** 1. Aktivieren Sie den WLAN-Bereitstellungsservice. Öffnen `vendors/{{vendor}}/boards/{{board}}/aws_demos/config_files/iot_ble_config.h` Sie und stellen Sie `#define IOT_BLE_ENABLE_WIFI_PROVISIONING` auf {{vendor}} ein `1` (wobei das der Name des Anbieters und der Name des Boards {{board}} ist, auf dem Sie die Demos ausführen). **Anmerkung** Der WLAN-Bereitstellungsservice ist standardmäßig deaktiviert. 1. Konfigurieren Sie [Network Manager](#ble-demo-network-manager), um sowohl Bluetooth Low Energy als auch Wi-Fi zu aktivieren. **So führen Sie die Demo aus** 1. Erstellen Sie das Demoprojekt und führen Sie es auf dem Mikrocontroller aus. 1. Stellen Sie sicher, dass Sie Ihren Mikrocontroller und Ihr Mobilgerät mit dem gekoppelt haben. [FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung](#ble-sdk-app) 1. Wählen Sie erst aus der Liste **Devices (Geräte)** in der Demoanwendung für mobile Geräte Ihren Mikrocontroller und dann **(Nework Config) Netzwerkkonfiguration** aus, um die Netzwerkkonfiguration zu öffnen. ![Nachfolgend finden Sie eine Liste von drei ESP32 Geräten IDs mit den Optionen MQTT Proxy, Network Config und Custom GATT MQTT.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list4.png) 1. Nachdem Sie **Netzwerkkonfiguration** für Ihr Board ausgewählt haben, sendet der Mikrocontroller eine Liste der Netzwerke in der Umgebung an das mobile Gerät. Die verfügbaren WLAN-Netzwerke werden in einer Liste unter **Gescannte Netzwerke** angezeigt. ![ESP32 Geräteverwaltungsschnittstelle, die keine gespeicherten Netzwerke anzeigt, zwei gescannte offene Wi-Fi-Netzwerke, eines mit WPA2 Sicherheit und RSSI von -29, das andere mit offener Sicherheit und RSSI von -50.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-network-config1.png) Wählen Sie aus der Liste **Gescannte Netzwerke** Ihr Netzwerk aus und geben Sie dann die SSID und Ihr Passwort ein, falls erforderlich. ![Dialogfeld zur Eingabe des Wi-Fi-Netzwerkkennworts mit leerem Passwortfeld, Schaltflächen Abbrechen und Speichern.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-wifi-password.png) Der Mikrocontroller stellt eine Verbindung zum Netzwerk her und speichert es. Das Netzwerk wird unter **Saved Networks (Gespeicherte Netzwerke)** angezeigt. ![Netzwerkschnittstelle mit Anzeige der gespeicherten und gescannten WiFi Netzwerke WPA2, von denen eines gesichert und das andere geöffnet ist, mit Signalstärkeanzeigen.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-network-config2.png) Sie können mehrere Netzwerke in der Demoanwendung für mobile Geräte speichern. Wenn Sie die Anwendung und Demo neu starten, verbindet sich der Mikrocontroller mit dem ersten verfügbaren gespeicherten Netzwerk, das oben in der Liste **Gespeicherte Netzwerke** angezeigt wird. Um die Netzwerk-Prioritätsreihenfolge zu ändern oder Netzwerke zu löschen, wählen Sie auf der Seite **Netzwerkkonfiguration** die Option **Bearbeitungsmodus** aus. Um die Netzwerk-Prioritätsreihenfolge zu ändern, wählen Sie die rechte Seite des Netzwerks, das Sie anders anordnen möchten, aus und ziehen Sie das Netzwerk nach oben oder unten. Um ein Netzwerk zu löschen, wählen Sie die rote Schaltfläche auf der linken Seite des Netzwerks, das Sie löschen möchten. ![Der Bildschirm mit den WLAN-Netzwerkeinstellungen zeigt gespeicherte Netzwerke, Bearbeitungsoptionen zum Löschen oder Ändern der Priorität und gescannte Netzwerke an.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-network-editing.png) ## Generic Attributes Server In diesem Beispiel sendet eine Generic Attribute(GATT)-Demo-Serveranwendung auf Ihrem Mikrocontroller einen einfachen Zählerwert an [FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung](#ble-sdk-app). Mit dem Bluetooth Low Energy Mobile SDKs können Sie Ihren eigenen GATT-Client für ein Mobilgerät erstellen, das eine Verbindung zum GATT-Server auf Ihrem Mikrocontroller herstellt und parallel zur mobilen Demo-Anwendung läuft. **So aktivieren Sie die Demo:** 1. Aktivieren Sie die Bluetooth Low Energy GATT-Demo. Fügen Sie in `vendors/{{vendor}}/boards/{{board}}/aws_demos/config_files/iot_ble_config.h` (wobei das {{vendor}} der Name des Anbieters und der Name des Boards {{board}} ist, mit dem Sie die Demos ausführen) der Liste der `#define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 )` define-Anweisungen hinzu. **Anmerkung** Die Bluetooth Low Energy GATT-Demo ist standardmäßig deaktiviert. 1. Öffnen Sie `{{freertos}}/vendors/{{vendor}}/boards/{{board}}/aws_demos/config_files/aws_demo_config.h`, kommentieren Sie `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED` aus und definieren Sie `CONFIG_BLE_GATT_SERVER_DEMO_ENABLED`. **So führen Sie die Demo aus** 1. Erstellen Sie das Demoprojekt und führen Sie es auf dem Mikrocontroller aus. 1. Stellen Sie sicher, dass Sie Ihr Board und Ihr mobiles Gerät mithilfe der [FreeRTOS Bluetooth Low Energy Mobile SDK-Demoanwendung](#ble-sdk-app) verbunden haben. 1. Wählen Sie aus der Liste **Devices (Geräte)** in der App Ihr Board und dann **MQTT Proxy (MQTT-Proxy)**, um die MQTT-Proxy-Einstellungen zu öffnen. ![Nachfolgend finden Sie eine Liste von drei ESP32 Geräten IDs mit den Optionen MQTT Proxy, Network Config und Custom GATT MQTT.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/ble-device-list4.png) 1. Kehren Sie zur Liste **Geräte** zurück, wählen Sie erst Ihr Board und dann **Benutzerdefiniertes GATT MQTT** zum Öffnen der benutzerdefinierten GATT-Serviceoptionen aus. 1. Wählen Sie **Start Counter (Zähler starten)** aus, um die Daten im **{{your-thing-name}}/example/topic**-MQTT-Thema zu veröffentlichen. Nachdem Sie den MQTT-Proxy aktiviert haben, werden Nachrichten von Hello World und vom inkrementellen Zähler im `{{your-thing-name}}/example/topic`-Thema angezeigt.