使用 ws63flash 烧录 WS63（社区工具路径）

未验证

目标：在已有固件镜像的前提下，用开源命令行工具完成烧录前的准备与基本操作框架，并诚实标注未验证状态。

系统 host tooling + WS63 board · SDK firmware-image-unspecified · 尚未声明实验室验证日期

前置条件

• 一块 WS63 系列开发板与可用 USB 数据线
• 已从厂商/SDK 构建或获取可烧录镜像（.bin 等，以 upstream 为准）
• 主机可安装 Rust/预编译二进制（以 https://github.com/goodspeed34/ws63flash 文档为准）

硬件

• hw-ws63-generic

步骤

1. 步骤 1：选择硬件与镜像来源

   预期输出： 已确认板卡为 WS63 系列，并拿到与板卡匹配的镜像文件路径

   成功判定： 镜像文件存在且来源可追溯（厂商 SDK 构建产物或可信发布）

2. 步骤 2：获取烧录工具

   # 阅读 upstream README 后安装（示例：cargo install 或下载 release）
   # https://github.com/goodspeed34/ws63flash
   command -v ws63flash || echo 'ws63flash not on PATH yet'

   预期输出： ws63flash 可执行文件可被定位，或明确提示尚未安装

   成功判定： 工具在 PATH 中，或已按文档记录安装步骤

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

3. 步骤 3：识别串口设备

   # Linux 示例：ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null
   # macOS 示例：ls /dev/cu.usb* 2>/dev/null

   预期输出： 看到与开发板对应的串口设备节点

   成功判定： 插拔板卡时设备节点出现/消失可对应

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

4. 步骤 4：按 upstream 文档执行烧录

   # 切勿盲抄；参数以 ws63flash README 与板卡手册为准
   # 示例占位：ws63flash flash --port <PORT> <firmware.bin>

   预期输出： 工具报告烧录成功或给出明确错误

   成功判定： 退出码为 0 或错误信息可映射到排错库

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

5. 步骤 5：验证

   # 打开串口终端，波特率以板卡文档为准，观察启动日志

   预期输出： 出现预期启动日志或应用输出

   成功判定： 在标注环境中看到与文档一致的关键日志；否则记录失败特征

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

总体预期结果

开发者能按社区工具路径完成烧录尝试，或在任一步得到可检索失败特征。

证据与验证说明

本指南为门户结构与导航样例，命令以 goodspeed34/ws63flash 与板卡文档为准。 OpenNearLink 未在本条目声明已在实验室对特定板卡完成烧录复现；verification_status 为 not_verified。

• https://github.com/goodspeed34/ws63flash
• https://gitee.com/HiSpark/fbb_ws63

相关排错

• ts-serial-no-output
• ts-toolchain-not-found

补充说明

说明

• 优先阅读 ws63flash upstream README；参数与子命令可能变更。
• 固件镜像仍应来自你信任的 SDK 构建或发布渠道（例如 HiSpark fbb_ws63 工程产物）。
• 烧录失败或异常断电有风险；本站不提供「保证成功」承诺。

跑通后请用 PR 更新 verification_status、verified_at 与 evidence.links。