<ph type="x-smartling-placeholder"></ph> Consulter le code source sur GitHub
Comment créer OpenThread
Les étapes de compilation d'OpenThread varient en fonction de la chaîne d'outils, de la machine de l'utilisateur et la plate-forme cible.
Le workflow le plus courant est le suivant:
- Configurez l'environnement de compilation et installez la chaîne d'outils souhaitée:
<ph type="x-smartling-placeholder">
- </ph>
- Pour compiler directement sur une machine,consultez l'atelier de programmation sur la simulation afin d'obtenir des instructions détaillées.
- Pour utiliser un conteneur Docker avec un environnement préconfiguré,
Téléchargez et exécutez l'image
environment
OpenThread:docker pull openthread/environment:latest
docker run -it --rm openthread/environment bash
- Dans l'environnement de votre choix, clonez le dépôt Git OpenThread spécifique à la plate-forme. Prenons l'exemple de CC2538:
git clone https://github.com/openthread/ot-cc2538.git --recursive
- À partir du répertoire racine du dépôt cloné:
<ph type="x-smartling-placeholder">
- </ph>
- Installez la chaîne d'outils:
./script/bootstrap
- Créez la configuration:
./script/build platform-specific-args cmake-options
- Installez la chaîne d'outils:
- Flashez le binaire souhaité sur la plate-forme cible. Tous les binaires générés sont
situé dans le pays suivant :
./build/bin
.
Configuration
Vous pouvez configurer OpenThread pour différentes fonctionnalités et comportements pendant le le processus de compilation. Les options de configuration disponibles sont détaillées dans emplacements:
Type | Lieu |
---|---|
Constantes compile-time | Répertorié dans tous les fichiers d'en-tête de /src/core/config |
Options de compilation cmake | Répertorié dans openthread/examples/README.md |
Exemples de compilation
Utilisez les options de compilation cmake pour activer les fonctionnalités de la plate-forme. Par exemple, pour Créez le binaire de la plate-forme CC2538 en activant la prise en charge de Commissioner and Joiner:
./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON
Ou, pour créer la plate-forme nRF52840 avec la détection de confiture, Jam Detection fonctionnalité activée dans son dépôt:
./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON
Binaires
Les binaires suivants sont générés dans ./build/bin
à partir du processus de compilation. Pour déterminer les binaires générés, utilisez des options avec la commande ./script/build
. Par exemple, pour compiler OpenThread et générer uniquement le binaire de la CLI FTD:
./script/build -DOT_APP_CLI=ON -DOT_FTD=ON -DOT_MTD=OFF -DOT_APP_NCP=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF
Binaire | Description | Options |
---|---|---|
ot-cli-ftd |
Appareil full-thread pour les SoC | -DOT_APP_CLI=ON -DOT_FTD=ON |
ot-cli-mtd |
Appareil Thread minimal pour les conceptions SoC | -DOT_APP_CLI=ON -DOT_MTD=ON |
ot-ncp-ftd |
Appareil full-thread pour les conceptions de co-processeur de réseau (NCP) | -DOT_APP_NCP=ON -DOT_FTD=ON |
ot-ncp-mtd |
Appareil Thread minimal pour les conceptions NCP | -DOT_APP_NCP=ON -DOT_MTD=ON |
ot-rcp |
Conception RCP (Radio Co-Processor) | -DOT_APP_RCP=ON -DOT_RCP=ON |
Par défaut, tous les indicateurs ci-dessus sont activés. Si vous désactivez explicitement tous les indicateurs, les applications ne sont pas
compilé, mais les fichiers de bibliothèque OpenThread sont toujours générés dans ./build/lib
pour être utilisés dans un projet.
Consultez le répertoire examples/platforms
pour connaître les options disponibles pour chaque plate-forme.
compatibles. Pour en savoir plus sur les FTD et les MTD, consultez le
Apprêt Thread : Pour
Pour en savoir plus sur les conceptions SoC et NCP, consultez la page Plates-formes.
Le processus de flashage de ces binaires varie selon les plates-formes. Consultez le dans les fichiers README de chaque plate-forme dossier d'exemple pour obtenir des instructions détaillées.
Daemon OpenThread
Le daemon OpenThread (démon OT) est un mode de compilation POSIX OpenThread qui s'exécute OpenThread en tant que service et est utilisé avec la conception RCP. Pour en savoir plus sur comment le compiler et l'utiliser, voir Daemon OpenThread.
Créer des formules d'assistance
Les packages d'assistance pour la compilation (BSP) se trouvent dans
/third_party
Les BSP sont du code tiers supplémentaire utilisé par OpenThread sur chaque plateforme respective, généralement inclus lors du portage d'OpenThread vers une nouvelle plateforme matérielle.