在 Linux 上配置 WS53 开发环境

使用 Linux 配置 WS53 开发环境时，根据实际场景选择一种配置方式。CLI 方式由工具自动准备 SDK、工具链和构建依赖；手动方式由用户分别安装和维护这些依赖。

准备条件

场景	适用情况	配置入口
使用 CLI 配置	新环境，或希望自动准备 SDK、工具链和构建依赖	本节的 CLI 配置步骤
手动配置	已有 SDK，或需要自行管理 Python、CMake 和构建依赖	本页“手动配置环境”

更新软件包索引并安装系统工具：

sudo apt-get update

sudo apt-get install -y curl ca-certificates git make

安装 CLI：

curl -fsSL https://dl.hispark.hisilicon.com/bootstrap.sh | sh

重新打开终端后检查版本：

fbb -V

WS53 SDK 要求 fbb 不低于 1.1.0。

使用 CLI 获取 SDK：

fbb sdk install ws53

已有 SDK 时，进入 SDK 的 src 目录，将 <SDK安装目录> 替换为实际路径：

cd "<SDK安装目录>/src"

准备工具链和构建依赖：

fbb setup --sdk-dir .

检查环境：

fbb doctor

fbb describe --json

以下适用于已有 SDK、需要自行管理构建依赖的环境。使用 Bash，准备 CMake 3.14.1 以上和 Python 3.8 以上版本。

在 Linux 终端安装 CMake：

sudo apt install cmake

安装 Python、pip 和虚拟环境支持：

sudo apt-get install -y python3 python3-pip python3-venv

检查 Python 版本：

python3 -V

版本不满足要求时，参考 Python 安装指南。

创建专用虚拟环境：

python3 -m venv ~/.venvs/ws53

激活环境，每次打开新的构建终端时执行：

source ~/.venvs/ws53/bin/activate

安装 Kconfig 和签名工具使用的 Python 依赖：

python -m pip install setuptools "kconfiglib>=14.1,<15" "pycparser>=2.21,<3"

检查 CMake：

cmake --version

检查 Python 依赖，正常时无输出且退出码为 0：

python -c "import kconfiglib, pycparser"

确认 Python 和 CMake 满足版本要求。依赖导入失败时，检查当前终端是否已激活上述虚拟环境。