建構 OpenThread

前往 GitHub 查看原始碼

如何建構 OpenThread

建構 OpenThread 的步驟會因工具鍊、使用者機器和 目標廣告平台

最常見的工作流程如下：

  1. 設定建構環境並安裝所需的工具鍊：
    1. 如要直接在電腦上建構，請參閱模擬程式碼研究室的詳細說明。
    2. 如要使用含有預先設定的環境的 Docker 容器， 下載並執行 OpenThread environment 映像檔： 
      docker pull openthread/environment:latest
docker run -it --rm openthread/environment bash
  2. 在您選擇的環境中，複製平台專屬的 OpenThread Git 存放區。以 CC2538 為例： 
    git clone https://github.com/openthread/ot-cc2538.git --recursive
  3. 從複製的存放區根目錄中：
    1. 安裝工具鍊： 
      ./script/bootstrap
    2. 建構設定： 
      ./script/build platform-specific-args cmake-options
  4. 將所需的二進位檔刷新至目標平台。所有產生的二進位檔 位於./build/bin。
，瞭解如何調查及移除這項存取權。

設定

您可以在 建構程序以下將詳細說明可用的設定選項 地區：

類型 位置
編譯時間常數 列在 /src/core/config 的所有標頭檔案中
cmake 建構選項 已列在openthread/examples/README.md中

建構範例

使用 cmake 建構選項啟用平台的功能。舉例來說 為 CC2538 平台 (已啟用委員會和彙整器支援功能) 建構二進位檔：

./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON

或者，如要使用 Jam 偵測功能來建構 nRF52840 平台 功能：

./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON

二進位檔

下列二進位檔是透過建構程序在 ./build/bin 中產生。如要決定要產生哪些二進位檔，請搭配 ./script/build 指令使用旗標。舉例來說，如要建構 OpenThread 並只產生 FTD CLI 二進位檔：

./script/build -DOT_APP_CLI=ON -DOT_FTD=ON -DOT_MTD=OFF -DOT_APP_NCP=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF
二進位 說明 選項
ot-cli-ftd 適用於 SoC 設計的全 Thread 裝置 -DOT_APP_CLI=ON
-DOT_FTD=ON
ot-cli-mtd 適合 SoC 設計的最小 Thread 裝置 -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd 適用於網路共同處理器 (NCP) 設計的全 Thread 裝置 -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd NCP 設計的最小 Thread 裝置 -DOT_APP_NCP=ON
-DOT_MTD=ON
ot-rcp 無線電合作處理器 (RCP) 設計 -DOT_APP_RCP=ON
-DOT_RCP=ON

根據預設，系統會啟用上述所有標記。如果您明確停用所有旗標，應用程式 但 OpenThread 程式庫檔案仍會在 ./build/lib 中產生以供專案使用。

請查看 examples/platforms 目錄，瞭解每個平台有哪些標記 支援。如要進一步瞭解 FTD 和 MTD，請參閱 Thread Primer：適用對象 如要進一步瞭解 SoC 和 NCP 設計的，請參閱平台。

刷新這些二進位檔的程序會因範例平台而異。詳情請參閱 各平台的 README 檔案 範例資料夾。

OpenThread Daemon

OpenThread Daemon (OT Daemon) 是 OpenThread POSIX 建構模式，能執行 OpenThread 式服務，與 RCP 設計搭配使用。如要進一步瞭解 想瞭解如何建構及使用，請參閱 OpenThread Daemon。

建構支援方案

建構支援套件 (BSP) 位於 /third_party。BSP 是 OpenThread 在每個平台上使用的額外第三方程式碼，通常包含在將 OpenThread 移植到新硬體平台時。