在 Windows 上配置 WS53 开发环境#

根据使用方式选择开发环境配置方案:

  • VS Code 插件:通过图形界面创建工程、构建和烧录固件。

  • CLI:使用 PowerShell 命令完成环境准备和构建。

场景一:使用 VS Code 插件#

环境要求#

项目

要求

操作系统

64 位 Windows 10 或 Windows 11

VS Code

1.85.0 及以上

硬盘空间

至少 900 MB(安装 HiSpark Studio 插件)

内存

最低 1 GB RAM(Random Access Memory),建议 4 GB 及以上

CPU

1.6 GHz 或更高

C 盘空间

建议至少 1 GB 剩余空间

网络

需要网络连接,用于下载工具链和 SDK

硬件配件#

物品

用途

获取方式

Type-C USB(Universal Serial Bus)数据线

连接开发板与电脑,用于供电和烧录

开发板通常自带

安装串口驱动#

开发板通过 USB 转串口(USB-TTL)与电脑通信,用于烧录固件和串口调试。需要安装与开发板 USB 转串口芯片匹配的驱动;使用 CH340/CH341 芯片的开发板可安装 CH341SER 驱动。

访问 CH341SER 驱动下载 下载驱动包,双击进行安装。

安装 VS Code#

  1. 下载并安装最新版 Visual Studio Code。

  2. 安装简体中文语言包(可选)。打开 VS Code,进入扩展市场(快捷键 Ctrl+Shift+X),搜索 Chinese,选择中文简体插件并安装。安装完成后重启 VS Code 即可使用中文界面。本文以 VS Code 中文界面为例。

    中文简体语言包

安装 Git#

HiSpark Studio 插件的“从 HiSpark 下载 SDK”功能会优先使用本机 Git 下载 SDK。相关说明可参考 HiSpark Studio for VS Code 用户指南 - SDK下载。

如电脑尚未安装 Git,请参考 Git 官方安装说明 安装 Git。安装时建议保留将 Git 添加到命令行环境变量的默认选项;安装界面或选项变化时,以 Git 官方文档和安装向导为准。

安装完成后,关闭并重新打开命令提示符,执行以下命令确认 Git 可用:

git --version
:: 输出示例: git version 2.x.x

如果命令提示“不是内部或外部命令”,说明 Git 未加入 PATH。请参考 Git 官方安装说明重新配置,或重新运行 Git 安装程序并选择将 Git 加入命令行环境的选项。

安装 HiSpark Studio 插件#

WS53 开发推荐使用 HiSpark Studio for VS Code 插件,该插件提供代码编辑、编译、烧录和调试等一站式开发环境。

  1. 打开 VS Code。

  2. 进入扩展市场(快捷键 Ctrl+Shift+X),搜索 HiSpark Studio,安装 HiSpark Studio 插件。

    VS Code 插件市场搜索

  3. 安装完成后,左侧活动栏会出现 HiSpark Studio 图标,单击即可进入插件界面。

    HiSpark Studio 插件界面

安装工具链#

HiSpark Studio 插件编译工程需要依赖工具链、Python 和 pip 依赖环境,可通过以下步骤下载安装。

  1. 单击左侧 HiSpark Studio 图标进入插件界面,单击“下载工具链”。在弹出的窗口中选择保存目录,目录层级不要过深且不要包含中文字符,然后单击“选择保存位置”开始下载。

    下载工具链

  2. 安装过程会依次下载以下内容。

    安装项

    说明

    Python 3.11.4

    嵌入式 Python 环境

    pip 依赖

    wheel、setuptools、cmake、kconfiglib、pycparser、pillow、numpy、opencv-python、windows-curses、ffmpeg-python、pyelftools、openpyxl、pandas 和 tkinter-embed

    编译工具链

    WS53 使用的 RISC-V 交叉编译工具链及其他构建工具

  3. 自动安装完成后,界面右下角会提示“环境准备完成”。

    环境准备完成

注意:

  • 如果自动安装工具链时 Python 安装失败,通常是网络或本地代理问题,请更换网络或修改代理后重试。

  • 如果提示依赖下载失败,可重复执行“下载工具链”。

  • 多次尝试仍然失败时,切换到“CLI”标签完成环境配置。

获取 SDK#

使用 HiSpark Studio 插件下载 SDK 前,需要先完成本标签页前述的 Git 安装和环境变量配置。

Windows 11 用户如需将 SDK 存放到开发盘,可按 Windows(开发者驱动器)准备存储位置。

  1. 在 HiSpark Studio 插件页面单击“从 HiSpark 下载 SDK”,在下载列表中选择 WS53 SDK。

    从 HiSpark 下载 SDK

  2. 选择 SDK 保存位置。建议选择空文件夹,路径不要太深且不要包含中文字符。

    SDK 保存位置选择

  3. 右下角会显示下载进度,等待下载完成。

    下载 SDK 提示框

场景二:使用 CLI 配置#

安装 CLI#

在 PowerShell 中安装 CLI:

irm https://dl.hispark.hisilicon.com/bootstrap.ps1 | iex

重新打开 PowerShell 后检查版本:

fbb -V

WS53 SDK 要求 fbb 不低于 1.1.0。

获取 SDK 和准备工具链#

使用 CLI 获取 SDK:

fbb sdk install ws53

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

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

准备工具链和构建依赖:

fbb setup --sdk-dir .

检查环境:

fbb doctor
fbb describe --json

常见问题#

Q:端口无法识别?#

A:确认开发板使用的 USB 转串口芯片及对应驱动,重新插拔 USB 数据线,并检查设备管理器中是否出现串口设备。

Q:烧录失败?#

A:按以下顺序检查:

  1. 确认开发板已进入烧录模式。

  2. 检查串口连接和端口选择是否正确。

  3. 确认串口驱动已正确安装。

  4. 尝试更换 USB 数据线或 USB 端口。