如何构建 OpenThread
构建 OpenThread 的步骤因工具链、用户机器和目标平台而异。
最常见的工作流程是:
- 设置构建环境并安装所需的工具链:
- 如需直接在计算机上构建,请参阅模拟 Codelab,了解详细说明
- 如需将 Docker 容器用于预配置的环境,请下载并运行 OpenThread
environment
映像:docker pull openthread/environment:latest
docker run -it --rm openthread/environment bash
- 在您选择的环境中,克隆特定于平台的 OpenThread Git 代码库。以 CC2538 为例:
git clone https://github.com/openthread/ot-cc2538.git --recursive
- 在克隆的代码库的根目录中:
- 安装工具链:
./script/bootstrap
- 构建配置:
./script/build platform-specific-args cmake-options
- 安装工具链:
- 将所需的二进制文件刷写到目标平台。所有生成的二进制文件都位于
./build/bin
中。
配置
您可以在构建流程中针对不同的功能和行为配置 OpenThread。以下位置详细介绍了可用的配置选项:
类型 | 位置 |
---|---|
编译时常量 | 列在 /src/core/config 中的所有头文件中 |
cmake 构建选项 | openthread/examples/README.md 中已列出 |
build 示例
使用 cmake build 选项为平台启用功能。例如,如需在启用“调试器”和“联接器”支持的情况下为 CC2538 平台构建二进制文件,请运行以下命令:
./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON
或者,如需构建 nRF52840 平台并在其代码库中启用 Jam 检测功能,请执行以下操作:
./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 |
默认情况下,上述所有标志均处于启用状态。如果您明确停用所有标志,系统就不会构建应用,但会在 ./build/lib
中生成 OpenThread 库文件以用于项目。
查看 examples/platforms
目录,看看每个平台支持的标志。如需详细了解 FTD 和 MTD,请参阅 Thread Primer。如需详细了解 SoC 和 NCP 设计,请参阅平台。
刷写这些二进制文件的过程因示例平台而异。有关详细说明,请参阅每个平台的示例文件夹中的自述文件。
OpenThread 守护程序
OpenThread 守护程序 (OT Daemon) 是一种 OpenThread POSIX 构建模式,将 OpenThread 作为服务运行,并与 RCP 设计结合使用。如需详细了解如何构建和使用它,请参阅 OpenThread 守护程序。
构建支持套餐
build 支持软件包 (BSP) 可在 /third_party
中找到。BSP 是 OpenThread 在每个平台上使用的附加第三方代码,通常在将 OpenThread 移植到新的硬件平台时包含。