Compiler OpenThread

<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:

  1. Configurez l'environnement de compilation et installez la chaîne d'outils souhaitée: <ph type="x-smartling-placeholder">
      </ph>
    1. Pour compiler directement sur une machine,consultez l'atelier de programmation sur la simulation afin d'obtenir des instructions détaillées.
    2. 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
      
  2. 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
    
  3. À partir du répertoire racine du dépôt cloné: <ph type="x-smartling-placeholder">
      </ph>
    1. Installez la chaîne d'outils:
      ./script/bootstrap
      
    2. Créez la configuration:
      ./script/build platform-specific-args cmake-options
      
  4. 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.