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.
# Débuter avec le Nordic n RF5284 0-DK
**Important**
Cette intégration de référence 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)
Ce didacticiel fournit des instructions pour démarrer avec le Nordic n RF5284 0-DK. Si vous ne possédez pas le Nordic n RF5284 0-DK, consultez le catalogue des appareils AWS partenaires pour en acheter un auprès de notre [partenaire](https://devices.amazonaws.com/detail/a3G0L00000AANtrUAH/nRF52840-Development-Kit).
Avant de commencer, vous devez effectuer la procédure [Configuration AWS IoT et Amazon Cognito pour FreeRTOS Bluetooth Low Energy](ble-demo.md#set-up-ble-demo-aws).
Pour exécuter la démo FreeRTOS Bluetooth Low Energy, vous avez également besoin d'un appareil mobile iOS ou Android doté de fonctionnalités Bluetooth et Wi-Fi.
**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.
## Présentation
Ce didacticiel comprend les instructions de mise en route suivantes :
1. Connexion de votre carte à un appareil hôte.
1. Installation de logiciels sur la machine hôte pour développer et déboguer des applications intégrées pour votre carte de microcontrôleur.
1. Compilation croisée d'une application de démonstration FreeRTOS en une image binaire.
1. Chargement de l’image binaire de l’application dans votre carte et exécution de l’application.
1. Interaction avec l’application s’exécutant sur votre carte via une connexion série, à des fins de surveillance et de débogage.
## Configurer le matériel Nordic
Connectez votre ordinateur hôte au port USB étiqueté J2, situé directement au-dessus du support de batterie de votre carte Nordic n RF5284 0.
Pour plus d'informations sur la configuration du Nordic n RF5284 0-DK, consultez le [guide de l'utilisateur du kit de développement n RF5284 0](http://infocenter.nordicsemi.com/pdf/nRF52840_DK_User_Guide_v1.2.pdf).
## Configurer votre environnement de développement.
### Télécharger et installer Segger Embedded Studio
FreeRTOS prend en charge Segger Embedded Studio en tant qu'environnement de développement pour le Nordic n 0-DK. RF5284
Pour configurer votre environnement, vous devez télécharger et installer Segger Embedded Studio sur votre ordinateur hôte.
**Pour télécharger et installer Segger Embedded Studio**
1. Accédez à la page [Segger Embedded Studio Downloads](https://www.segger.com/downloads/embedded-studio/), puis choisissez l'option Embedded Studio pour ARM pour votre système d'exploitation.
1. Exécutez le programme d'installation et suivez les instructions jusqu'à la fin.
### Configurer l'application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile
Pour exécuter le projet de démonstration FreeRTOS via Bluetooth Low Energy, vous devez exécuter l'application de démonstration FreeRTOS Bluetooth Low Energy Mobile SDK sur votre appareil mobile.
**Pour configurer l'application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile**
1. Suivez les instructions de [Mobile SDKs pour appareils Bluetooth FreeRTOS](freertos-ble-mobile.md) pour télécharger et installer le kit SDK pour votre plateforme mobile sur votre ordinateur hôte.
1. Suivez les instructions de la rubrique [Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile](ble-demo.md#ble-sdk-app) pour configurer la démonstration d'applications mobiles sur votre appareil mobile.
## Établir une connexion série
Segger Embedded Studio inclut un émulateur de terminal que vous pouvez utiliser pour recevoir des messages de journal sur une connexion série à votre carte.
**Pour établir une connexion série avec Segger Embedded Studio**
1. Ouvrez Segger Embedded Studio.
1. Dans le menu supérieur, choisissez **Target (Cible)**, **Connect J-Link (Connecter J Link)**.
1. Dans le menu supérieur, choisissez **Tools (Outils)**, **Terminal Emulator (Émulateur de terminal)**, **Properties (Propriétés)** et définissez les propriétés selon les instructions contenues dans [Installation d'un émulateur de terminal](gsg-troubleshooting.md#uart-term).
1. Dans le menu supérieur, choisissez **Tools**, **Terminal Emulator**, **Connect *port* (115200, N,8,1**).
**Note**
L'émulateur de terminal studio intégré Segger ne prend pas en charge une capacité d'entrée. Pour cela, utilisez un émulateur de terminal tel que PuTTy, Tera Term ou GNU Screen. 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).
## Téléchargez et configurez FreeRTOS
Après avoir configuré votre matériel et votre environnement, vous pouvez télécharger FreeRTOS.
### Télécharger FreeRTOS
Pour télécharger FreeRTOS pour le Nordic RF5284 n 0-DK, rendez-vous sur la page [FreeRTOS et clonez GitHub ](https://github.com/aws/amazon-freertos) le dépôt. Consultez le fichier [README.md](https://github.com/aws/amazon-freertos/blob/main/README.md) pour obtenir des instructions.
**Important**
Dans cette rubrique, le chemin d'accès au répertoire de téléchargement de FreeRTOS est appelé. `freertos`
Les espaces dans le chemin d’accès `freertos` peuvent provoquer des échecs de construction. Lorsque vous clonez ou copiez le référentiel, assurez-vous que le chemin d'accès que vous créez ne contient pas d'espaces.
La longueur maximale d'un chemin sous Microsoft Windows est de 260 caractères. Les longs chemins de répertoire de téléchargement de FreeRTOS peuvent provoquer des échecs de compilation.
Le code source pouvant contenir des liens symboliques, si vous utilisez Windows pour extraire l'archive, vous devrez peut-être :
Activez [le mode développeur](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) ou
Utilisez une console élevée en tant qu'administrateur.
Ainsi, Windows peut créer correctement des liens symboliques lors de l'extraction de l'archive. Dans le cas contraire, les liens symboliques seront écrits sous forme de fichiers normaux contenant les chemins des liens symboliques sous forme de texte ou seront vides. Pour plus d'informations, consultez le billet de blog [Symlinks in Windows 10 \$1](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .
Si vous utilisez Git sous Windows, vous devez activer le mode développeur ou vous devez :
Définissez `core.symlinks` ce paramètre sur true à l'aide de la commande suivante :
```
git config --global core.symlinks true
```
Utilisez une console élevée en tant qu'administrateur chaque fois que vous utilisez une commande git qui écrit sur le système (par exemple**git pull**,**git clone**, et**git submodule update --init --recursive**).
### Configurer votre projet
Pour activer la démo, vous devez configurer votre projet pour qu'il fonctionne avec AWS IoT. Pour configurer votre projet de manière à ce qu'il fonctionne AWS IoT, votre appareil doit être enregistré en tant qu' AWS IoT objet. Vous devez avoir enregistré votre appareil lorsque vous [Configuration AWS IoT et Amazon Cognito pour FreeRTOS Bluetooth Low Energy](ble-demo.md#set-up-ble-demo-aws).
**Pour configurer votre AWS IoT point de terminaison**
1. Connectez-vous à la [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
Votre AWS IoT point de terminaison apparaît dans la zone de texte Terminal de **données de l'appareil**. Elle doit ressembler à `1234567890123-ats.iot.us-east-1.amazonaws.com`. Prenez note de ce point de terminaison.
1. Dans le volet de navigation, choisissez **Gérer**, puis **Objets**. Notez le nom de l' AWS IoT objet pour votre appareil.
1. Avec votre AWS IoT point de terminaison et le nom de votre AWS IoT objet à portée de main, ouvrez-le `freertos/demos/include/aws_clientcredential.h` dans votre IDE et spécifiez les valeurs `#define` des constantes suivantes :
+ `clientcredentialMQTT_BROKER_ENDPOINT` *Your AWS IoT endpoint*
+ `clientcredentialIOT_THING_NAME` *Your board's AWS IoT thing name*
**Pour activer la démonstration**
1. Vérifiez que la démonstration GATT Bluetooth Low Energy est activée. Accédez à `vendors/nordic/boards/nrf52840-dk/aws_demos/config_files/iot_ble_config.h` et ajoutez `#define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 )` à la liste d'instructions de définition.
1. Ouvrez `vendors/nordic/boards/nrf52840-dk/aws_demos/config_files/aws_demo_config.h` et définissez l'un ou l'autre`CONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED`, `CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED` ou comme dans cet exemple.
```
/* To run a particular demo you need to define one of these.
* Only one demo can be configured at a time
*
* CONFIG_BLE_GATT_SERVER_DEMO_ENABLED
* CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED
* CONFIG_SHADOW_BLE_TRANSPORT_DEMO_ENABLED
* CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED
* CONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED
* CONFIG_POSIX_DEMO_ENABLED
*
* These defines are used in iot_demo_runner.h for demo selection */
#define CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED
```
1. Puisque la puce Nordic est livrée avec très peu de RAM (250 Ko), il peut être nécessaire de changer la configuration BLE pour autoriser des entrées de table GATT plus importantes par rapport à la taille de chaque attribut. De cette façon, vous pouvez ajuster la quantité de mémoire obtenue par l'application. Pour ce faire, remplacez les définitions des attributs suivants dans le fichier `freertos/vendors/nordic/boards/nrf52840-dk/aws_demos/config_files/sdk_config.h` :
+ NRF\$1SDH\$1BLE\$1VS\$1UUID\$1COUNT
Le nombre de fournisseurs spécifiques. UUIDs Augmentez ce nombre de 1 lorsque vous ajoutez un nouvel UUID spécifique au fournisseur.
+ NRF\$1SDH\$1BLE\$1GATTS\$1ATTR\$1TAB\$1SIZE
Taille de la table attributaire en octets. La taille doit être un multiple de 4. Cette valeur indique la quantité de mémoire définie dédiée à la table attributaire (y compris la taille caractéristique). Elle varie donc d'un projet à l'autre. Si vous dépassez la taille de la table attributaire, vous recevrez une erreur NRF\$1ERROR\$1NO\$1MEM. Si vous modifiez le NRF\$1SDH\$1BLE\$1GATTS\$1ATTR\$1TAB\$1SIZE, vous devez généralement également reconfigurer les paramètres de la RAM.
(Pour les tests, l'emplacement du fichier est `freertos/vendors/nordic/boards/nrf52840-dk/aws_tests/config_files/sdk_config.h`.)
## Créez et exécutez le projet de démonstration FreeRTOS
Après avoir téléchargé FreeRTOS et configuré votre projet de démonstration, vous êtes prêt à créer et exécuter le projet de démonstration sur votre carte.
**Important**
Si c'est la première fois que vous exécutez la démonstration sur cette carte, vous devez flasher le programme d'amorçage sur la carte avant que la démonstration puisse être exécutée.
Pour générer et flasher le programme d'amorçage, suivez les étapes ci-dessous, mais au lieu d'utiliser le fichier de projet `projects/nordic/nrf52840-dk/ses/aws_demos/aws_demos.emProject`, utilisez `projects/nordic/nrf52840-dk/ses/aws_demos/bootloader/bootloader.emProject`.
**Pour créer et exécuter la démo FreeRTOS Bluetooth Low Energy à partir de Segger Embedded Studio**
1. Ouvrez Segger Embedded Studio. Dans le menu supérieur, choisissez **File**, puis **Open Solution** et accédez au fichier de projet `projects/nordic/nrf52840-dk/ses/aws_demos/aws_demos.emProject`.
1. Si vous utilisez l'émulateur de terminal Segger Embedded Studio, choisissez **Tools (Outils)** dans le menu supérieur, puis choisissez **Terminal Emulator (Émulateur de terminal)**, **Terminal Emulator (Émulateur de terminal)** pour afficher les informations de votre connexion série.
Si vous utilisez un autre outil de terminal, vous pouvez surveiller la sortie de cet outil à partir de votre connexion série.
1. Cliquez avec le bouton droit de la souris sur le projet de démonstration `aws_demos` dans l'**Explorateur de projets**, puis choisissez **Build (Générer)**.
**Note**
S'il s'agit de la première fois que vous utilisez Segger Embedded Studio, vous pouvez voir l'avertissement « No license for commercial use ». Segger Embedded Studio peut être utilisé gratuitement avec les appareils semi-conducteurs Nordic. [Demandez une licence gratuite](http://license.segger.com/Nordic.cgi) puis, lors de la configuration, choisissez **Activer votre licence gratuite** et suivez les instructions.
1. Choisissez **Debug (Déboguer)**, puis **Go (OK)**.
Une fois la démonstration démarrée, elle attend d'être appairée avec un appareil mobile sur Bluetooth Low Energy.
1. Suivez les instructions de l'application de [démonstration MQTT over Bluetooth Low Energy pour terminer la démonstration avec l'application](https://docs.aws.amazon.com/freertos/latest/userguide/ble-demo.html#ble-demo-mqtt) de démonstration FreeRTOS Bluetooth Low Energy Mobile SDK en tant que proxy MQTT mobile.
## Résolution des problèmes
Pour obtenir des informations générales sur la résolution des problèmes liés à la prise en main de FreeRTOS, consultez. [Résolution des problèmes de mise en route](gsg-troubleshooting.md)