

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Applications de démonstration Bluetooth Low Energy
<a name="ble-demo"></a>

**Important**  <a name="deprecation-message-demo"></a>
Cette démo est hébergée sur le référentiel Amazon-FreeRTOS qui est obsolète. Nous vous recommandons de [commencer ici](freertos-getting-started-modular.md) lorsque vous créez un nouveau projet. Si vous possédez déjà un projet FreeRTOS basé sur le référentiel Amazon-FreeRTOS, désormais obsolète, consultez le. [Guide de migration du référentiel Github d'Amazon-FreeRTOS](github-repo-migration.md)

## Présentation de
<a name="ble-demo-overview"></a>

FreeRTOS Bluetooth Low Energy inclut trois applications de démonstration :
+ Démonstration [MQTT sur Bluetooth Low Energy](#ble-demo-mqtt) 

  Cette application montre comment utiliser le MQTT sur le service Bluetooth Low Energy.
+ Démonstration [Mise en service Wi-Fi](#ble-demo-wifi)

  Cette application explique comment utiliser le service Bluetooth Low Energy Wi-Fi Provisioning.
+ Démonstration [Serveur d'attributs générique (GATT)](#ble-demo-server)

  Cette application montre comment utiliser le APIs middleware Bluetooth Low Energy FreeRTOS pour créer un serveur GATT simple.

**Note**  
Pour configurer et exécuter les démos de FreeRTOS, suivez les étapes décrites dans. [Commencez avec FreeRTOS](freertos-getting-started.md)

## Conditions préalables
<a name="ble-demo-prereqs"></a>

Pour suivre ces démonstrations, vous avez besoin d'un microcontrôleur équipé de fonctionnalités Bluetooth Low Energy. Vous avez également besoin du [SDK iOS pour appareils Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-ios) ou du [SDK Android pour appareils Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-android).

### Configuration AWS IoT et Amazon Cognito pour FreeRTOS Bluetooth Low Energy
<a name="set-up-ble-demo-aws"></a>

Pour connecter vos AWS IoT appareils à MQTT, vous devez configurer Amazon AWS IoT Cognito.

**Pour configurer AWS IoT**

1. Créez un AWS compte sur [https://aws.amazon.com/](https://aws.amazon.com/).

1. Ouvrez la [console AWS IoT](https://console.aws.amazon.com/iot/), puis, dans le volet de navigation, choisissez **Gérer**, puis **Objets**.

1. Choisissez **Créer**, puis **Créer un seul objet**.

1. Entrez un nom pour votre appareil, puis choisissez **Suivant**.

1. Si vous connectez votre microcontrôleur au cloud via un appareil mobile, choisissez **Créer un objet sans certificat**. Étant donné que le mobile SDKs utilise Amazon Cognito pour l'authentification des appareils, il n'est pas nécessaire de créer un certificat d'appareil pour les démonstrations utilisant Bluetooth Low Energy.

   Si vous connectez votre microcontrôleur au cloud directement par Wi-Fi, choisissez **Créer un certificat**, puis **Activer**, puis téléchargez le certificat, la clé publique et la clé privée de l'objet.

1. Choisissez l'objet que vous venez de créer dans la liste des objets enregistrés, puis choisissez **Interagir** à partir de la page de l'objet. Notez le point de terminaison de l' AWS IoT API REST.

Pour plus d'informations sur la configuration, consultez la section [Getting Started with AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).

**Pour créer un groupe d'utilisateurs Amazon Cognito**

1. Ouvrez la console Amazon Cognito et choisissez **Gérer les groupes d'utilisateurs**.

1. Sélectionnez **Create a user pool**.

1. Attribuez un nom au groupe d'utilisateurs, puis choisissez **Consulter les valeurs par défaut**.

1. Dans le volet de navigation, choisissez **Clients d'application**, puis **Ajouter un client d'application**.

1. Tapez un nom pour le client d'application, puis cliquez sur **Créer un client d'application**.

1. Dans le volet de navigation, sélectionnez **Vérification**, puis **Créer un groupe**.

   Prenez note de l'ID du groupe qui s'affiche sur la page **Paramètres généraux** de votre groupe d'utilisateurs.

1. Dans le volet de navigation, choisissez **Clients d'application**, puis **Afficher les détails**. Notez l'ID et le code secret du client d'application.

**Pour créer un pool d'identités Amazon Cognito**

1. Ouvrez la console Amazon Cognito et choisissez **Manage Identity** Pools.

1. Saisissez un nom pour le groupe d'identités.

1. Développez **Fournisseurs d'authentification**, choisissez l'onglet **Cognito**, puis entrez l'ID de votre groupe d'utilisateurs et l'ID du client d'application.

1. Sélectionnez **Créer une réserve**.

1. Développez **Afficher les détails** et notez les deux noms de rôle IAM. Choisissez **Autoriser** pour créer les rôles IAM pour les identités authentifiées et non authentifiées afin d'accéder à Amazon Cognito.

1. Choisissez **Edit identity groupe (Modifier le groupe d'identités)**. Prenez note de l'ID du groupe d'identités. Il devrait avoir la forme `us-west-2:12345678-1234-1234-1234-123456789012`.

Pour plus d'informations sur la configuration d'Amazon Cognito, consultez la section [Getting Started with Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-getting-started.html).

**Pour créer et associer une politique IAM à l'identité authentifiée**

1. Ouvrez la console IAM, puis dans le volet de navigation, sélectionnez **Rôles**.

1. Recherchez et choisissez le rôle de votre identité authentifiée, choisissez **Attacher des stratégies**, puis **Ajouter une stratégie en ligne**.

1. Choisissez l'onglet **JSON**, puis collez le JSON suivant :

------
#### [ 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. Choisissez **Examiner une stratégie**, entrez un nom pour la stratégie, puis choisissez **Créer une stratégie**.

Gardez vos informations AWS IoT et celles d'Amazon Cognito à portée de main. Vous avez besoin du point de terminaison et IDs de l'authentification de votre application mobile auprès du AWS Cloud.

### Configurez votre environnement FreeRTOS pour Bluetooth Low Energy
<a name="ble-demo-set-up"></a>

Pour configurer votre environnement, vous devez télécharger FreeRTOS sur votre microcontrôleur, puis télécharger et configurer [Bibliothèque Bluetooth Low Energy](freertos-ble-library.md) le SDK mobile pour les appareils Bluetooth FreeRTOS sur votre appareil mobile.

**Pour configurer l'environnement de votre microcontrôleur avec FreeRTOS Bluetooth Low Energy**

1. Téléchargez ou clonez FreeRTOS depuis. [GitHub](https://github.com/aws/amazon-freertos) Consultez le fichier [README.md](https://github.com/aws/amazon-freertos/blob/main/README.md) pour obtenir des instructions.

1. Configurez FreeRTOS sur votre microcontrôleur.

   [Pour plus d'informations sur la prise en main de FreeRTOS sur un microcontrôleur compatible FreeRTOS, consultez le guide de votre carte dans Getting Started with FreeRTOS.](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-getting-started.html)
**Note**  
Vous pouvez exécuter les démos sur n'importe quel microcontrôleur compatible Bluetooth Low Energy doté de FreeRTOS et de bibliothèques FreeRTOS Bluetooth Low Energy portées. Actuellement, le projet de démonstration [MQTT sur Bluetooth Low Energy](#ble-demo-mqtt) FreeRTOS est entièrement porté sur les appareils Bluetooth Low Energy suivants :  
[Espressif ESP32 - DevKit C et le ESP-WROVER-KIT](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_espressif.html)
[Nordic en RF52840 -DK](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_nordic.html)

## Composants communs
<a name="ble-demo-common"></a>

Les applications de démonstration FreeRTOS ont deux composants communs :
+ Network Manager
+ Application de démonstration du kit SDK pour appareils mobiles Bluetooth Low Energy

### Network Manager
<a name="ble-demo-network-manager"></a>

Le gestionnaire de réseau gère la connexion réseau de vos microcontrôleurs. Il se trouve dans votre répertoire FreeRTOS à l'adresse. `demos/network_manager/aws_iot_network_manager.c` Si le gestionnaire de réseau est activé pour Wi-Fi et Bluetooth Low Energy, les démonstrations commencent avec Bluetooth Low Energy par défaut. Si la connexion Bluetooth Low Energy est interrompue et que votre carte mère l'est Wi-Fi-enabled, le gestionnaire de réseau passe à une connexion Wi-Fi disponible pour vous empêcher de vous déconnecter du réseau.

Pour activer un type de connexion réseau avec le Network Manager, ajoutez le type de connexion réseau au `configENABLED_NETWORKS` paramètre dans `vendors/vendor/boards/board/aws_demos/config_files/aws_iot_network_config.h` (où *vendor* il s'agit du nom du fournisseur et du nom de la carte que vous utilisez pour exécuter les démos). *board*

Par exemple, si Bluetooth Low Energy et le Wi-Fi sont tous les deux activés, la ligne qui commence par `#define configENABLED_NETWORKS` dans `aws_iot_network_config.h` se présente comme suit :

```
#define  configENABLED_NETWORKS  ( AWSIOT_NETWORK_TYPE_BLE | AWSIOT_NETWORK_TYPE_WIFI )
```

Pour obtenir une liste des types de connexion réseau actuellement pris en charge, consultez les lignes qui commencent par `#define AWSIOT_NETWORK_TYPE` dans `aws_iot_network.h`.

### Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile
<a name="ble-sdk-app"></a>

[L'application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile se trouve GitHub sur le SDK [Android pour les appareils Bluetooth FreeRTOS sous et `amazon-freertos-ble-android-sdk/app` sur le SDK iOS pour les appareils Bluetooth FreeRTOS sous](https://github.com/aws/amazon-freertos-ble-android-sdk).](https://github.com/aws/amazon-freertos-ble-ios-sdk) `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo` Dans cet exemple, nous utilisons des captures d'écran de la version iOS de l'application de démonstration pour mobile.

**Note**  
Si vous utilisez un appareil iOS, vous avez besoin de Xcode pour générer l’application de démonstration pour mobile. Si vous utilisez un appareil Android, vous pouvez utiliser Android Studio pour générer l’application de démonstration pour mobile.

**Pour configurer l'application de démonstration du kit SDK iOS**

Lorsque vous définissez des variables de configuration, utilisez le format des valeurs d'espace réservé prévu dans les fichiers de configuration.

1. Confirmez que le [SDK iOS pour appareils Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-ios) est installé.

1. Exécutez la commande suivante à partir de `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/` :

   ```
   $ pod install
   ```

1. Ouvrez le projet `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo.xcworkspace` avec Xcode et remplacez le compte développeur de signature par votre compte.

1. Créez une AWS IoT politique dans votre région (si ce n'est pas déjà fait).
**Note**  
Cette politique est différente de la politique IAM créée pour l'identité authentifiée Amazon Cognito.

   1. Ouvrez la [AWS IoT console](https://console.aws.amazon.com/iot/).

   1. Dans le volet de navigation, choisissez successivement **Sécurisé**, **Stratégies** et **Créer**. Entrez un nom pour identifier votre stratégie. Dans la section **Ajouter des instructions**, choisissez **Mode avancé**. Copiez et collez le code JSON suivant dans la fenêtre de l'éditeur de stratégie. Remplacez *aws-region* et *aws-account* par votre AWS région et votre numéro de compte.

   1. Choisissez **Créer**.

1. Ouvrez `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift` et redéfinissez les variables suivantes :
   + `region`: Votre AWS région.
   + `iotPolicyName`: le nom AWS IoT de votre police.
   + `mqttCustomTopic` : la rubrique MQTT dans laquelle vous voulez publier.

1. Ouvrir `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Support/awsconfiguration.json`.

   Sous `CognitoIdentity`, redéfinissez les variables suivantes :
   + `PoolId`: l'identifiant de votre pool d'identités Amazon Cognito.
   + `Region`: Votre AWS région.

   Sous `CognitoUserPool`, redéfinissez les variables suivantes :
   + `PoolId`: l'identifiant de votre groupe d'utilisateurs Amazon Cognito.
   + `AppClientId` : ID de votre client d'application.
   + `AppClientSecret` : clé secrète de votre client d'application.
   + `Region`: Votre AWS région.

**Pour configurer l'application de démonstration du kit SDK Android**

Lorsque vous définissez des variables de configuration, utilisez le format des valeurs d'espace réservé prévu dans les fichiers de configuration.

1. Confirmez que le [SDK Android pour appareils Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-android) est installé.

1. Créez une AWS IoT politique dans votre région (si ce n'est pas déjà fait).
**Note**  
Cette politique est différente de la politique IAM créée pour l'identité authentifiée Amazon Cognito.

   1. Ouvrez la [AWS IoT console](https://console.aws.amazon.com/iot/).

   1. Dans le volet de navigation, choisissez successivement **Sécurisé**, **Stratégies** et **Créer**. Entrez un nom pour identifier votre stratégie. Dans la section **Ajouter des instructions**, choisissez **Mode avancé**. Copiez et collez le code JSON suivant dans la fenêtre de l'éditeur de stratégie. Remplacez *aws-region* et *aws-account* par votre AWS région et votre numéro de compte.

   1. Choisissez **Créer**.

1. Ouvrez [ https://github.com/aws/amazon-freertos-ble-android- sdk/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) et redéfinissez les variables suivantes :
   + `AWS_IOT_POLICY_NAME`: le nom AWS IoT de votre police.
   + `AWS_IOT_REGION`: Votre AWS région.

1. Ouvrez [ 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) 

   Sous `CognitoIdentity`, redéfinissez les variables suivantes :
   + `PoolId`: l'identifiant de votre pool d'identités Amazon Cognito.
   + `Region`: Votre AWS région.

   Sous `CognitoUserPool`, redéfinissez les variables suivantes :
   + `PoolId`: l'identifiant de votre groupe d'utilisateurs Amazon Cognito.
   + `AppClientId` : ID de votre client d'application.
   + `AppClientSecret` : clé secrète de votre client d'application.
   + `Region`: Votre AWS région.

**Pour découvrir et établir des connexions sécurisées avec votre microcontrôleur sur Bluetooth Low Energy**

1. Pour coupler votre microcontrôleur et votre appareil mobile en toute sécurité (étape 6), vous avez besoin d'un émulateur de terminal série doté à la fois de capacités d'entrée et de sortie (par exemple). TeraTerm Configurez le terminal pour vous connecter à votre carte via une connexion série, comme indiqué dans [Installation d'un émulateur de terminal](gsg-troubleshooting.md#uart-term).

1. Exécutez le projet de démonstration Bluetooth Low Energy sur votre microcontrôleur.

1. Exécutez l'application de démonstration du kit SDK mobile Bluetooth Low Energy sur votre appareil mobile.

   Pour démarrer l'application de démonstration dans le kit SDK Android à partir de la ligne de commande, exécutez la commande suivante :

   ```
   $ ./gradlew installDebug
   ```

1. Confirmez que votre microcontrôleur s'affiche sous **Appareils** dans l'application de démonstration du kit SDK mobile Bluetooth Low Energy.  
![\[Page de gestion des appareils affichant un ESP32 appareil avec son identifiant unique.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list1.png)
**Note**  
Tous les appareils équipés de FreeRTOS et du service d'information sur les appareils `freertos/.../device_information` () situés à portée apparaissent dans la liste.

1. Choisissez votre microcontrôleur dans la liste d'appareils. L'application établit une connexion avec la carte, et une ligne verte s'affiche en regard de l'appareil connecté.  
![\[ESP32 ID de l'appareil affiché.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list2.png)

   Vous pouvez vous déconnecter de votre microcontrôleur en faisant glisser la ligne vers la gauche.  
![\[Page des appareils affichant un identifiant d' ESP32 appareil et un autre identifiant d'appareil.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list3.png)

1. Si vous y êtes invité, couplez votre microcontrôleur et votre appareil mobile.  
![\[Sortie de console indiquant la déconnexion de l'appareil BLE, la déconnexion du service MQTT, le démarrage de la publicité, la connexion BLE au périphérique distant et une invite de comparaison numérique.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/pairing-board.png)  
![\[Boîte de dialogue de demande de couplage Bluetooth pour l'appareil « ESP32 » affichant le code « 465520 » pour confirmer l'activation de « ». ESP32\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/pairing-mobile.png)

   Si le code de comparaison numérique est le même pour les deux appareils, associez-les.

**Note**  
L'application de démonstration du SDK Bluetooth Low Energy Mobile utilise Amazon Cognito pour l'authentification des utilisateurs. Assurez-vous que vous avez configuré un utilisateur et des groupes d'identités Amazon Cognito, et que vous avez associé des politiques IAM aux identités authentifiées.

## MQTT sur Bluetooth Low Energy
<a name="ble-demo-mqtt"></a>

Dans la démonstration MQTT over Bluetooth Low Energy, votre microcontrôleur publie des messages dans le AWS Cloud via un proxy MQTT.

**Pour vous abonner à une rubrique MQTT de démonstration**

1. Connectez-vous à la AWS IoT console.

1. Dans le volet de navigation, choisissez **Test**, puis choisissez **MQTT test client** pour ouvrir le client MQTT.

1. Dans le champ **Rubrique d'abonnement**, saisissez ***thing-name*/example/topic1**, puis choisissez **S'abonner à la rubrique**.

Si vous utilisez Bluetooth Low Energy pour associer le microcontrôleur à votre appareil mobile, les messages MQTT sont acheminés via l'application de démonstration du kit SDK Bluetooth Low Energy mobile sur votre appareil mobile.

**Pour activer la démonstration via Bluetooth Low Energy**

1. Ouvrez `vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h` et définissez `CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED`.

1. Ouvrez `demos/include/aws_clientcredential.h` et configurez `clientcredentialMQTT_BROKER_ENDPOINT` avec le point de terminaison du AWS IoT courtier. Configurez `clientcredentialIOT_THING_NAME` avec le nom de l'objet du microcontrôleur BLE. Le point de terminaison du AWS IoT broker peut être obtenu à partir de la AWS IoT console en choisissant **Paramètres** dans le volet de navigation de gauche, ou via la CLI en exécutant la commande :`aws iot describe-endpoint --endpoint-type=iot:Data-ATS`.
**Note**  
Le point de terminaison du AWS IoT courtier et le nom de l'objet doivent tous deux se trouver dans la même région où l'identité cognito et le groupe d'utilisateurs sont configurés.

**Pour exécuter la démonstration**

1. Créez et exécutez le projet de démonstration sur votre microcontrôleur.

1. Assurez-vous que vous avez associé votre carte et votre appareil mobile à l'aide de l'[Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile](#ble-sdk-app).

1. Dans la liste **Appareils** de d'application mobile de démonstration, choisissez votre microcontrôleur, puis choisissez **MQTT Proxy** pour ouvrir les paramètres de proxy MQTT.  
![\[Liste des trois ESP32 appareils IDs, avec les options MQTT Proxy, Network Config et Custom GATT MQTT ci-dessous.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list4.png)

1. Une fois que vous avez activé le proxy MQTT, les messages MQTT apparaissent dans la rubrique `thing-name/example/topic1`, et les données sont imprimées sur le terminal UART.

## Mise en service Wi-Fi
<a name="ble-demo-wifi"></a>

Wi-Fi Provisioning est un service FreeRTOS Bluetooth Low Energy qui vous permet d'envoyer en toute sécurité les informations d'identification du réseau Wi-Fi d'un appareil mobile à un microcontrôleur via Bluetooth Low Energy. Le code source de la mise en service Wi-Fi est disponible sous `freertos/.../wifi_provisioning`.

**Note**  
La démo de provisionnement Wi-Fi est actuellement prise en charge sur l'Espressif - C. ESP32 DevKit

**Pour activer la démonstration**

1. Activez le service de mise en service Wi-Fi. Ouvrez `vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h` et réglez `#define IOT_BLE_ENABLE_WIFI_PROVISIONING` sur `1` (où *vendor* il s'agit du nom du fournisseur et du *board* nom de la carte que vous utilisez pour exécuter les démos).
**Note**  
Le service de mise en service Wi-Fi est désactivé par défaut.

1. Configurez le [Network Manager](#ble-demo-network-manager) pour activer Bluetooth Low Energy et Wi-Fi.

**Pour exécuter la démonstration**

1. Créez et exécutez le projet de démonstration sur votre microcontrôleur.

1. Assurez-vous d'avoir jumelé votre microcontrôleur et votre appareil mobile à l'aide du[Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile](#ble-sdk-app).

1. Dans la liste **Devices (Appareils)** de l'application mobile de démonstration, choisissez votre microcontrôleur, puis choisissez **Network Config (Configuration réseau)** pour ouvrir les paramètres de configuration du réseau.  
![\[Liste des trois ESP32 appareils IDs, avec les options MQTT Proxy, Network Config et Custom GATT MQTT ci-dessous.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list4.png)

1. Une fois que vous avez choisi **Network Config** pour votre carte, le microcontrôleur envoie une liste des réseaux à proximité à l'appareil mobile. Les réseaux Wi-Fi disponibles s'affichent dans une liste sous **Scanned Networks**.  
![\[ESP32 interface de gestion des appareils n'affichant aucun réseau enregistré, deux réseaux Wi-Fi ouverts scannés, l'un avec WPA2 sécurité et RSSI de -29, l'autre avec sécurité ouverte et RSSI de -50.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-network-config1.png)

   Dans la liste **Scanned Networks**, choisissez votre réseau, puis saisissez le SSID et le mot de passe, le cas échéant.  
![\[Boîte de dialogue de saisie du mot de passe du réseau Wi-Fi avec champ de mot de passe vide, boutons Annuler et Enregistrer.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-wifi-password.png)

   Le microcontrôleur se connecte au réseau et l'enregistre. Le réseau s'affiche sous **Réseaux enregistrés**.  
![\[Interface réseau affichant WiFi les réseaux enregistrés et scannés, l'un sécurisé par WPA2, l'autre ouvert, avec des indicateurs de puissance du signal.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-network-config2.png)

Vous pouvez enregistrer plusieurs réseaux dans l'application mobile de démonstration. Lorsque vous redémarrez l'application et la démonstration, le microcontrôleur se connecte au premier réseau enregistré disponible, en commençant par le haut de la liste **Saved Networks**. 

Pour modifier l'ordre de priorité des réseaux ou pour supprimer des réseaux, sur la page **Network Configuration**, choisissez **Editing Mode**. Pour modifier l'ordre de priorité des réseaux, sélectionnez le côté droit du réseau dont vous souhaitez modifier la priorité, puis faites-le glisser vers le haut ou vers le bas. Pour supprimer un réseau, sélectionnez le bouton rouge sur le côté gauche du réseau que vous souhaitez supprimer.

![\[Écran des paramètres du réseau Wi-Fi affichant les réseaux enregistrés, les options de modification pour supprimer ou modifier la priorité et les réseaux scannés.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-network-editing.png)


## Serveur d'attributs générique (GATT)
<a name="ble-demo-server"></a>

Dans cet exemple, une application de serveur d'attributs génériques (GATT) de démonstration sur votre microcontrôleur envoie une simple valeur de compteur à l'[Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile](#ble-sdk-app).

À l'aide du Bluetooth Low Energy Mobile SDKs, vous pouvez créer votre propre client GATT pour un appareil mobile qui se connecte au serveur GATT sur votre microcontrôleur et fonctionne en parallèle avec l'application mobile de démonstration.

**Pour activer la démonstration**

1. Activez la démonstration GATT Bluetooth Low Energy. Dans `vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h` (où *vendor* il s'agit du nom du fournisseur et du *board* tableau que vous utilisez pour exécuter les démos), ajoutez `#define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 )` à la liste des instructions de définition.
**Note**  
La démonstration GATT Bluetooth Low Energy est désactivée par défaut.

1. Ouvrez `freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`, commentez `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED` et définissez `CONFIG_BLE_GATT_SERVER_DEMO_ENABLED`.

**Pour exécuter la démonstration**

1. Créez et exécutez le projet de démonstration sur votre microcontrôleur.

1. Assurez-vous que vous avez associé votre carte et votre appareil mobile à l'aide de l'[Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile](#ble-sdk-app).

1. Dans la liste **Appareils** de d'application, choisissez votre carte, puis choisissez **MQTT Proxy** pour ouvrir les options de proxy MQTT.  
![\[Liste des trois ESP32 appareils IDs, avec les options MQTT Proxy, Network Config et Custom GATT MQTT ci-dessous.\]](http://docs.aws.amazon.com/fr_fr/freertos/latest/userguide/images/ble-device-list4.png)

1. Revenez à la liste **Appareils**, choisissez votre carte, puis choisissez **Custom GATT MQTT** pour ouvrir les options personnalisées du service GATT.

1. Choisissez **Start Counter** pour commencer à publier des données à la rubrique MQTT ***your-thing-name*/example/topic**.

   Une fois que vous avez activé le proxy MQTT, Hello World et des messages de compteur incrémentiels s'affichent sur la rubrique `your-thing-name/example/topic`.