建構 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。

設定

您可以在建構程序中為不同的功能和行為設定 OpenThread。以下提供設定選項的詳細說明：

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

建構範例

使用 cmake 建構選項啟用平台的功能。例如，如要為已啟用佣金與彙整工具支援的 CC2538 平台建構二進位檔：

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

或者，如要建構 JRF52840 平台，並啟用其存放區中的 Jam Detection 功能：

./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) 設計的完整執行緒裝置	-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

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

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

刷新這些二進位檔的程序因範例平台而異。如需詳細操作說明，請參閱各平台範例資料夾中的 README。

OpenThread Daemon

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

建構支援套件

/third_party 內提供建構支援套件 (BSP)。BSP 是 OpenThread 在各個平台上使用的額外第三方程式碼，通常在將 OpenThread 移植至新的硬體平台時納入。