建構 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 中的所有標頭檔案中
建立建構作業選項 列於「openthread/examples/README.md

建構範例

使用 cmake 建構選項啟用平台的功能。舉例來說,如要針對啟用佣金和彙整人員支援的 CC2538 平台建構二進位檔,請按照下列指示操作:

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

或者,如要建構已啟用存放區中的 Jam Detection 功能的 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 設計的全執行緒裝置 -DOT_APP_CLI=ON
-DOT_FTD=ON
ot-cli-mtd 用於 SoC 設計的最小執行緒裝置 -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd 網路輔助處理器 (NCP) 設計的完整執行緒裝置 -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd 用於 NCP 設計的最小執行緒裝置 -DOT_APP_NCP=ON
-DOT_MTD=ON
ot-rcp 無線電處理器 (RCP) 設計 -DOT_APP_RCP=ON
-DOT_RCP=ON

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

請參閱各個平台的 Makefiles 範例,瞭解每個平台支援的旗標。如要進一步瞭解 FTD 和 MTD,請參閱執行緒基本資訊。如要進一步瞭解 SoC 和 NCP 設計,請參閱平台相關說明。

這些二進位檔的 Flash 處理程序會因範例平台而異, 如需詳細操作說明,請參閱各平台的範例資料夾

OpenThread Daemon

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

建構支援方案

您可以在 /third_party 中找到建構支援套件 (BSP)。BSP 是各平台在其他平台上使用的 Open 第三方程式碼,通常將 OpenThread 移植到新的硬體平台時即可使用。