MUSIChub 素材工具
未连接

设备

正在初始化…

第一步 · 选择固件

网页里自带两份固件，点一下就选好了，不用去电脑里翻文件。 其中测试版是专门用来验证烧录是否成功的： 烧进去、设备重启之后，屏幕会从红色变成蓝色并显示 TEST。

或者，用你自己编译的 .bin

要的是链接在 0x8000 的 App 二进制（例如 MusicHub-App_0x8000.bin）。不要传 .hex， 也不要把 Bootloader 一起打包进来 —— Bootloader 是出厂时用下载器烧一次就固定的， OTA 只搬 App。

第二步 · 确认并写入

还没有选择固件。
写入过程中请不要断电、不要拔线。 流程是：固件先整包写进 W25Q 的暂存区，写完校验通过后设备自己重启， 由 Bootloader 把暂存区搬进内部 flash（这一步不需要你拔插 USB）。 设备重启时网页会短暂显示"已断开"，那是正常的 —— 页面会自动把它接回来， 并把设备自报的新版本号读出来给你核对。中途真断电的话，设备会停在 Bootloader 里， 用下载器重烧一次即可，不会变砖。
第一次拿到板子怎么烧？（只需做一次）
  1. 用 WCH-Link 接上板子，打开 MounRiver Studio 自带的下载工具。
  2. 先烧 Bootloader（MusicHub-Boot 工程）—— 它的链接地址是 0x00000000，占用前 32KB。
  3. 再烧 App（MusicHub-0920 工程）—— 它的链接地址是 0x00008000。 两个都是烧到内部 flash，Bootloader 会把 App 的起始位置跳对。
  4. 以后升级就只用这个网页了：烧 MusicHub-0920.bin， Bootloader 负责搬运，不需要再动下载器。

验证有没有烧对：插上 USB 后，设备管理器里应该能同时看到 键盘、鼠标、以及一个厂商自定义接口。 如果只有前两个，说明烧的是旧固件或者 App 起始地址没改对。

第一步 · 拖一个音频文件进来

支持 mp3 / m4a / wav / ogg / flac。浏览器会自动把它 重采样到 16 kHz、混成单声道、转成 16 位 PCM， 这是设备唯一认识的格式，所以设备端不需要做任何转码。

🎵
把音频拖到这里
或者

第三步 · 音效库

同一个样段可以分配给很多个键（库里的"键位映射"只是索引）， 所以多个键共用一个声音并不会多占空间。 真正占地方的是这里有多少段、每段多长。

声音小通常是源音频自己的电平就低（不是设备坏了）—— 每段样段都能单独调音量，右边的「拉满」会把它调到不削波的最大值。 峰值超过 100% 的部分会被削平，听感是破音，所以别硬加。 改完音量要重新点一次「写入音效库到设备」才生效 （放大后的数据才算数）。

还没有任何样段。在上面截好一段、点「加进音效库」，它就会出现在这里。

第四步 · 选键位，把声音分配过去

先在音效库里点一个样段把它设为当前样段， 再到键盘上点键把它选中（点已选的键可以取消）。 选好之后按下面的按钮一次性分配。 点某个键时如果它已经有声音，会当场放一遍给你听。

当前样段：未选择 已选 0 个键
没配音 已配音效 已选中

第五步 · 写入设备

—
写入过程中请不要断电、不要拔线。 整库是先整片擦掉再重写的，擦写期间掉电会留下一份"未提交"的半截库， 设备会判它无效并保持静音（不会出噪声，也不会变砖）—— 重新连上再写一次就好了。 写完不用重启：设备当场就认这份新库，敲键立刻出声。

拖一张图片进来

支持 jpg / png / webp / gif / bmp。图片会在浏览器里缩放到屏幕原生尺寸， 并转成 RGB565 之后才写进设备的 flash —— 设备端不做任何图像处理。

🖼
把图片拖到这里
或者

上屏效果预览

缩放方式
模拟屏幕

预览是从转换后的字节流反着画出来的，所以渐变色带这类问题 在上屏之前就能看出来。屏幕是 142 × 428 的竖条，横图会被裁掉两侧。

日志

出问题的时候把这里的内容截图发出来就行