設定建構環境

在 GitHub 中查看來源

如要促進免費開放開發,OpenThread 會在建構工具鍊中使用 CMake。目前必須使用此工具鍊,才能將 OpenThread 移植到新的硬體平台。

其他建構工具鍊可能在未來支援,但不在本遷移指南的涵蓋範圍內。

建立新的存放區

第一步是為硬體平台設定新的環境。在本指南中,我們將建立一個名稱為 ot-efr32 的新存放區,其中包含平台抽象層、硬體平台的 SDK 以及一些實用的指令碼。

在以下範例中,我們曾在 GitHub 建立了 SiliconLabs/ot-efr32 存放區,並複製到 ~/repos/ot-efr32

mkdir -p ~/repos
cd ~/repos
git clone git@github.com:SiliconLabs/ot-efr32.git
Cloning into 'ot-efr32'...
remote: Enumerating objects: 99, done.
remote: Counting objects: 100% (99/99), done.
remote: Compressing objects: 100% (60/60), done.
remote: Total 333 (delta 65), reused 39 (delta 39), pack-reused 234
Receiving objects: 100% (333/333), 170.78 KiB | 5.69 MiB/s, done.
Resolving deltas: 100% (194/194), done.
git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

存放區結構

為保持與 OpenThread GitHub 機構中現有平台存放區的一致性,建議您建立下列存放區結構:

tree -F -L 1 --dirsfirst
.
├── examples/
├── openthread/
├── script/
├── src/
├── third_party/
├── CMakeLists.txt
├── LICENSE
└── README.md
資料夾 說明
examples 選用範例應用程式
openthread openthread 存放區做為子模組
script 用於建構、測試和檢查的指令碼
src 平台抽象層導入
third_party 任何第三方來源的位置資訊

新增子模組

下一步是新增 openthread 以及任何其他必要存放區,做為子模組

git submodule add git@github.com:openthread/openthread.git
Cloning into '/home/user/repos/ot-efr32/openthread'...
remote: Enumerating objects: 78281, done.
remote: Counting objects: 100% (1056/1056), done.
remote: Compressing objects: 100% (488/488), done.
remote: Total 78281 (delta 639), reused 864 (delta 556), pack-reused 77225
Receiving objects: 100% (78281/78281), 76.62 MiB | 35.24 MiB/s, done.
Resolving deltas: 100% (61292/61292), done.

在這個範例中,我們將新增精簡版的 Silicon Labs Gecko SDK 做為子模組third_party的 Google Ads 新帳戶重新申請驗證。

cd third_party
git submodule add git@github.com:SiliconLabs/sdk_support.git
Cloning into '/home/user/repos/ot-efr32/third_party/sdk_support'...
remote: Enumerating objects: 32867, done.
remote: Counting objects: 100% (8181/8181), done.
remote: Compressing objects: 100% (3098/3098), done.
remote: Total 32867 (delta 4945), reused 7469 (delta 4732), pack-reused 24686
Receiving objects: 100% (32867/32867), 128.83 MiB | 30.91 MiB/s, done.
Resolving deltas: 100% (19797/19797), done.

指令碼

您可以在「script」資料夾中建立一些指令碼,以便讓工作更輕鬆。這可能包括執行提取、建構、執行程式碼瓶和 GitHub CI 測試的測試指令碼。

以下範例是大部分現有平台存放區的標準指令碼。

bootstrap

這個指令碼應安裝硬體平台所需的所有工具和套件。執行 openthread 的啟動指令碼,以確保使用者俱備建立 OpenThread 堆疊所需的一切資訊。

如需範例,請參閱 ot-efr32 中的系統啟動指令碼

build

CMake 建構指令碼必須允許使用者為您的平台建構 OpenThread 堆疊。如果您的存放區定義了任何範例應用程式,此指令碼也必須建構。這個指令碼應包含基本系統設定選項,包括任何平台專用的巨集定義。

如需範例,請參閱 ot-efr32 中的建構指令碼

test

測試指令碼對於已測試的任何測試來說,非常實用。這可以是簡單的程序,例如執行健全性檢查建構作業,或是較為單純啟動單元測試套件。

ot-efr32 中,指令碼會在 efr32 平台中的每個支援 Jamboard 執行 build 指令碼。

如需範例,請參閱 ot-efr32 中的測試指令碼

make-pretty

為維持一致的樣式設定,這個指令碼應採用程式碼、指令碼和 Markdown 檔案的格式。

您可以自行定義這個指令碼,但最簡單的做法是使用現有平台存放區使用的 make-pretty 指令碼。指令碼會呼叫 openthread 的樣式指令碼,並確保所有 OpenThread 存放區的樣式一致。

連接器指令碼設定

GNU Linker 指令碼說明如何將輸入檔案中的所有部分 (.o 的 GNU 編譯器集合 (GCC) 檔案) 對應至最終輸出檔案 (例如 .elf)。也可以決定執行程式程式的各個區段的儲存位置,以及項目地址。平台專用的連接器指令碼通常會隨附平台的 BSP。

ld 工具設為在 src/CMakeLists.txt 的平台 CMake 目標上使用 target_link_libraries 以指向特定平台的連結連接器指令碼:

set(LD_FILE "${CMAKE_CURRENT_SOURCE_DIR}/efr32mg12.ld")

target_link_libraries(openthread-efr32mg12
    PRIVATE
        ot-config
    PUBLIC
        -T${LD_FILE}
        -Wl,--gc-sections -Wl,-Map=$.map
)

工具鍊開機指令碼

工具鍊的啟動程式碼通常會與平台的 BSP 一併提供, 以下程式碼通常:

  1. 實作執行程式的進入函式 (Reset_Handler)
  2. 定義中繼向量表格
  3. 初始化堆積和堆疊
  4. .data 的部分資料從非容量記憶體複製到 RAM
  5. 跳到應用程式的主要函式以執行應用程式邏輯

必須在平台 openthread-platform-name 程式庫中加入啟動程式碼 (C 或組合原始碼),否則就無法正確用於連接器指令碼中使用的關鍵變數:

  • src/CMakeLists.txt

範例ot-cc2538startup-gcc.c - src/CMakeLists.txt

add_library(openthread-cc2538
    alarm.c
...
    startup-gcc.c
...
    system.c
    logging.c
    uart.c
    $
)