环境搭建
本文档介绍如何在 Windows 系统上搭建 WS63 系列开发环境，包括安装 IDE、配置工具链、获取 SDK 以及验证环境。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | 64位 Windows 10 或 Windows 11 |
| VS Code | 1.80.2 及以上 |
| 硬盘空间 | 至少 900MB（安装 HiSpark Studio 插件） |
| 内存 | 最低 1GB RAM，建议 4GB 及以上 |
| CPU | 1.6GHz 或更高 |
| C盘空间 | 建议至少 1GB 剩余空间 |
| 网络 | 需要网络连接（下载工具链和 SDK） |
选择开发板
选择适合您需求的 WS63/WS63E 系列开发板。WS63系列支持多种开发板，包括润和软件、小熊派、华清远见、鼎云物联、明裕丰、深开鸿、利尔达等厂商的开发板详细的开发板信息请参考 开发板。
| 推荐开发板 | 简介 | 适用场景 |
|---|---|---|
| HiHope_NearLink_DK3863E_V03 | WS63E 解决方案，支持雷达人体活动检测 | 智能家居、物联网设备开发 |
| BearPi-Pico_H3863 | 小巧便携，适合物联网应用开发 | 快速原型验证 |
硬件配件
| 物品 | 用途 | 获取方式 |
|---|---|---|
| Type-C USB 数据线 | 连接开发板与电脑，用于供电和烧录 | 开发板通常自带 |
安装安全驱动
开发板通过 USB 转串口（USB-TTL）与电脑通信，用于烧录固件和串口调试。需安装 CH341SER 驱动才能使电脑识别开发板的串口。
访问 CH341SER 驱动下载 下载驱动包，双击安装。安装后可在设备管理器中确认是否出现 CH340 或 CP2102 串口设备。
安装 VS Code
-
下载并安装最新版的 Visual Studio Code。
-
安装简体中文语言包 （可选），打开 VS Code，进入扩展市场（快捷键
Ctrl+Shift+X），搜索Chinese选择中文简体插件并安装，安装完成后重启 VS Code 即可使用中文界面。本文以 VS Code 中文界面为例
安装 Git
HiSpark Studio 插件从 HiSpark 下载 SDK 功能依赖 Git 命令工具，请先确认电脑已安装 Git，如已安装可跳过此步骤。
下载安装 Git
-
访问 Git for Windows 下载安装包
-
下载完成后运行安装程序，按提示完成安装
配置环境变量
当前步骤以win11为例，图片示例内容以实际显示为准，安装完成后，需要将 Git 安装路径添加到系统环境变量 PATH 中：
-
找到 Git 安装目录（默认为
C:\Program Files\Git\cmd），点击文件夹地址栏，复制路径，以实际安装路径为准，替换以下步骤中的路径
-
使用快捷键
win + E打开文件资源管理器，右键左侧此电脑后选择属性
-
选择
高级系统设置
-
打开
环境变量配置窗口，选择Path后点击编辑
-
点击
新建，粘贴 Git 安装路径，点击确定完成配置
验证安装
打开cmd命令提示符，快捷键 win + R，输入 cmd，点击 确定，执行命令 git --version 验证 Git 是否安装成功：
安装 HiSpark Studio 插件
WS63 开发推荐使用 HiSpark Studio for VS Code 插件，提供代码编辑、编译、烧录和调试等一站式开发环境。
- 打开 VS Code
-
进入扩展市场（快捷键
Ctrl+Shift+X），搜索HiSpark Studio，然后选择安装 HiSpark Studio 插件
-
安装完成后，左侧活动栏会出现 HiSpark Studio 图标，点击即可进入插件界面。
安装工具链
HiSpark Studio 插件编译工程需要依赖工具链、Python 及 pip 依赖环境，可通过以下步骤下载安装。
-
点击左侧 HiSpark Studio 图标，进入插件界面，点击
下载工具链，弹出窗口后选择保存的目录（目录层级不要过深，不包含中文字符），点击选择保存位置开始下载
-
安装过程会依次下载以下内容：
安装项 说明 Python 3.11.4 嵌入式 Python 环境 pip 依赖 tkinter-embed、cmake、kconfiglib、pycparser、pillow、numpy、opencv_python、windows_curses 编译工具链 RISC-V 交叉编译工具链及其他 tools -
自动安装完成后，界面右下角会提示
环境准备完成
注意：
- 如果自动安装工具链时 Python 安装失败，通常是网络不通或本地代理问题，请更换网络或修改代理后重试
- 如果提示依赖下载失败，可重复操作
下载工具链进行重试- 尝试多次依旧下载失败，可尝试手动安装工具链，参考 手动安装工具链
获取 SDK
方法一：通过 HiSpark Studio 插件下载（推荐）
-
在 HiSpark Studio 插件页面点击
从 HiSpark 下载 SDK，在弹出的下载列表中选择WS63 SDK
-
选择 SDK 保存位置（建议选择空文件夹，路径不要太深，不包含中文）
-
右下角会显示下载进度提示，等待下载完成
方法二：手动下载
-
访问 fbb_ws63 代码仓页面，点击
下载zip按钮直接下载 SDK 压缩包。
-
下载完成后，需手动将 SDK 压缩包解压到本地目录（目录层级不要过深，不包含中文字符）
快速开始
环境已搭建完成，快速开始第一个程序：快速开始
附录
项目结构
fbb_ws63/
├── docs/ # 文档目录
├── src/ # 源代码目录（SDK主目录）
│ ├── application/ # 应用层
│ │ ├── samples/ # 示例代码
│ │ │ ├── bt/ # BLE/SLE 示例
│ │ │ ├── radar/ # 雷达示例
│ │ │ └── wifi/ # Wi-Fi 示例
│ │ └── ws63/ # 应用代码
│ ├── bootloader/ # Bootloader
│ ├── build/ # 构建脚本
│ │ └── script/ # 编译脚本
│ ├── drivers/ # 驱动层
│ │ ├── chips/ws63/ # WS63 芯片驱动
│ │ └── hal/ # 硬件抽象层
│ ├── include/ # 头文件目录
│ ├── kernel/ # 内核
│ │ └── liteos/ # LiteOS 内核
│ ├── middleware/ # 中间件
│ │ ├── services/ # 服务组件
│ │ └── utils/ # 工具组件
│ ├── build.py # 构建脚本入口（关键文件）
│ └── config.in # 配置文件
├── tools/ # 工具目录
└── vendor/ # 第三方依赖
编译产物
编译完成后，产物存放在以下位置：
fbb_ws63/
└── out/ # 输出根目录
└── ws63-liteos-app/ # 目标配置目录
├── build/ # 构建中间文件
├── config/ # 配置文件
├── image/ # 镜像文件
│ ├── ws63_liteos_app.bin # 主固件（烧录用）
│ ├── ws63_liteos_app.elf # ELF 文件（调试用）
│ ├── ws63_liteos_app.map # 内存映射文件
│ └── bootloader.bin # Bootloader 固件
└── lib/ # 库文件
关键文件说明：
ws63_liteos_app.bin：主固件，用于烧录到开发板ws63_liteos_app.elf：ELF 格式文件，用于调试和分析ws63_liteos_app.map：内存映射文件，用于定位代码位置
常见问题
Q: "端口无法识别？"
A: 确保驱动安装成功，尝试重新插拔 USB 线，重启设备管理器。检查设备管理器中是否出现 CH340 或 CP2102 设备。
Q: "烧录失败？"
A: 根据错误信息，尝试以下步骤：
1. 确认开发板已进入烧录模式
2. 检查串口连接是否正确
3. 确认串口驱动已正确安装
4. 尝试更换 USB 线或端口
提示：如需更详细的工具使用说明，请参考 HiSpark Studio for VS Code 使用指南