Technical articles are still primarily Chinese. UI is English. English content PRs welcome.

WS63 + LiteOS：从官方示例仓到最小构建路径

未验证

Goal: 按「硬件与系统 → 环境 → 编译 → 烧录 → 验证」五步，从 HiSpark 公开示例仓定位源码并完成首次构建尝试；失败时落到可检索排错条目。

System LiteOS · SDK hispark-fbb_ws63-unpinned · no lab verification date claimed

Prerequisites

一块 WS63 系列开发板与可用的 USB 线
可访问 Gitee：https://gitee.com/HiSpark/fbb_ws63
主机系统（Linux 或 Windows）满足厂商/SDK 文档中的工具链要求
可选：社区烧录工具 https://github.com/goodspeed34/ws63flash

Hardware

hw-ws63-generic

Steps

步骤 1：选择硬件与系统

预期输出： 已确认芯片为 WS63 系列，目标系统为 LiteOS/SDK 文档指定系统

成功判定： 板卡丝印/文档与条目 hardware_ids 一致；已打开 fbb_ws63 仓库说明

步骤 2：准备环境

# 1) 克隆官方示例入口（Gitee 可能需登录/镜像加速，以你的网络为准）
git clone https://gitee.com/HiSpark/fbb_ws63.git
# 2) 按仓库 README / docs 安装交叉工具链后检查 PATH
command -v arm-none-eabi-gcc || echo 'toolchain missing — see vendor docs'

预期输出： 仓库克隆成功；工具链可执行文件可被定位，或明确提示 missing

成功判定： 已安装工具链，或已记录缺失项并停止（不要假装成功）

常见失败： ts-toolchain-not-found

步骤 3：编译

# 进入 fbb_ws63 中文档指定的示例工程目录
# 执行仓库文档中的 build 命令（名称因版本而异，禁止虚构成功日志）
# 示例占位：./build.sh  或  make -C <sample_dir>

预期输出： 构建日志以 success/无 error 结束（以仓库文档为准）

成功判定： 生成可烧录镜像文件，路径可记录

常见失败： ts-toolchain-not-found

步骤 4：烧录

# 方案 A：厂商/SDK 自带烧录工具（优先遵循仓库文档）
# 方案 B：社区工具路径见 /quickstart/guide-ws63-flash-with-ws63flash/
# 示例占位：ws63flash flash --port <PORT> <firmware.bin>

预期输出： 烧录工具报告 success

成功判定： 工具退出码为 0 或 UI 显示成功

常见失败： ts-serial-no-output

步骤 5：验证
```
# 打开串口（波特率以板卡/SDK 文档为准）观察启动日志
```
预期输出： 串口出现预期启动日志或示例应用输出

成功判定： 在标注环境中看到与文档一致的关键日志行

常见失败： ts-serial-no-output

Expected result

开发者完成五步流程或在任一步得到可检索的失败特征并进入排错库。

Evidence

本指南将步骤锚定到公开的 HiSpark fbb_ws63 入口与社区烧录工具链接。 OpenNearLink 未在本条目中声明已在实验室对某一固定 SDK 标签完整跑通； verification_status 保持 not_verified，直至出现可引用的构建日志或实机证据。

Related troubleshooting

Notes

说明

本页满足产品对「五步快速开始」的信息结构要求，并尽量给出真实可点击的源码入口，但不用虚构成功日志换取「已验证」状态。

论坛

环境与编译问题请到入门与开发环境提问；工具链类可参考排错库 command not found。

当你在真实环境跑通后，应通过 PR 更新：

verification_status
verified_at
evidence.links（构建日志、串口记录或讨论链接）
精确的 sdk_version 与命令