极客星闪 | 内功:烧录还得下载软件?这套开源网页烧录器,让浏览器直接给 WS63/BS2X 传功

海星（StarFish）社区出品的网页在线烧录库，纯前端、零依赖、开箱即用。

TL;DR (核心摘要)

面向星闪 WS63 / BS2x（BS21 / BS21E）系列芯片的网页在线烧录库 nearlink-web-flasher：基于浏览器原生 Web Serial API，无需安装任何烧录软件，在 Chrome / Edge / Opera 里直接完成 .fwpkg 固件的解析、握手、传输与烧录。Apache 2.0 开源。

1. 为什么烧录需要这套「轻功」？

在嵌入式江湖里，烧录这门功夫，门槛一直不低：

• 重兵器：先要下载、安装对应的烧录工具，还常常只认 Windows；
• 门派林立：不同芯片、不同系统，工具各不相同；
• 入门难：拿到一块新板子，光配环境就要折腾半天；
• 传功难：想给用户发一个固件，用户还得先学会用烧录软件。

有没有一种方式，打开浏览器就能烧录？

就像轻功高手——不搬重兵器，隔空一点，内力直达芯片。

nearlink-web-flasher，就是这套「轻功」。

👉 在线体验：不用写代码，直接打开 https://hinearlink.com/firmware，浏览器里就能给星闪芯片烧录固件。

2. 核心心法：三条内功经脉

整套烧录流程，拆开就是三步内功：

2.1 解析 `.fwpkg`（固件包）

.fwpkg 是海思（HiSilicon）的固件封装格式，把引导程序（LoaderBoot）和多个固件分区打包成一个文件。解析器会做魔数校验、CRC 校验、分区表解析，一步到位。

2.2 LoaderBoot 握手

基于串口的烧录握手协议：握手、切换波特率、发送分区、复位，WS63 / BS2x 通用。

2.3 YMODEM 传输

经典文件传输协议，CRC 模式、1024 字节数据块，稳定可靠。

这三条经脉都在 src/ 目录里，docs/ 还有完整的协议文档与格式说明，想深入研究的开发者可以直接看源码。

3. 快速上手：三招入门

第一招：安装

1
npm install nearlink-web-flasher

第二招：调用

1
2
3
4
5
6
7
8
9
import { NearLinkFlasher } from 'nearlink-web-flasher';const flasher = new NearLinkFlasher();const file = document.querySelector('#firmware').files[0];await flasher.flash(file, {  baudRate: 115200,               // 可设 460800 / 921600 / 2000000 / 4000000  onProgress: ({ percent, message }) => console.log(`[${percent}%] ${message}`),});