overdub
FirmwareM-VAVE FM-1

M1n1Le55

ZzpsS/M1n1Le55 · ★ 1

M-VAVE FM-1 的 Tab5 固件管理器与扩展控制台 · Firmware manager & control console

README from GitHub, MIT

M1n1Le55

简体中文 · English

为M-vave FM-1 打造 M5Stack Tab5触屏固件管理器与扩展控制台。 (你听说过一家叫做miniless的独立唱片厂牌吗)

选择固件、完成安装，再进入与该固件结构对应的工作台。M1n1Le55 将固件管理、音色控制与设备操作集中在一块触屏上，以极简布局、像素图标和受 SLOOP 启发的配色，呈现当前设备与可用功能。

当前版本：0.31 · firmware-grid-1（预发布）

下载 Tab5 安装包 · 新玩家说明 · 版本说明 · 构建说明

M1n1Le55 0.31 固件管理页面：两列图标卡片与顶部安装按钮

固件管理界面预览，来自离线模拟。

一块屏幕，四个入口

入口可以做什么
固件管理用两列图标卡片浏览固件，选中后查看详情并安装；需要 V15 中转时自动处理
工作台页面结构跟随当前固件切换，控制已有协议支持的音色参数、效果、演奏、编排与工程功能
音色集中音色与可选采样功能；采样需要实现 Open/FM1S 协议的兼容固件
设备查看连接、进行备份、查阅操作记录

这次更新

  • 固件更容易辨认： 优先使用发布者图标，其余按对应固件的界面风格绘制像素图标；图标下方直接显示名称。
  • 列表更紧凑： 两列卡片，八款正式固件同屏；展开实验固件后按行吸附滚动。
  • 安装入口更直接： “刷新 SD → 显示实验固件 → 安装该固件”集中在顶部，右侧保留所选固件的详情。

开始使用

准备一台 M5Stack Tab5、一台 M-VAVE FM-1、数据线与稳定供电。更换 FM-1 固件时，再准备一张 FAT32 microSD 卡。

  1. 安装到 Tab5。 下载并解压安装包，用电脑连接 Tab5 的 USB-C，按新玩家说明完成安装。包内包含引导程序、分区表和应用，无须安装 ESP-IDF。
  2. 连接 FM-1。 将 FM-1 接到 Tab5 的 USB-A，在“设备 → 连接”确认识别，再打开“工作台”。
  3. 按需换固件。 从原作者处取得受支持的固件，用随包 SD 工具准备卡，在“固件管理”中选择并安装。

从原厂 FM-1 开始使用工作台，不需要先刷 V15，也不需要先连蓝牙或插 SD 卡。换固件需要 V15 中转时，将 V15 与目标包一并放入固件库，程序自动安排顺序。

声音由 FM-1 的音频输出送到耳机、音箱或声卡；Tab5 负责管理与控制。

当前适配

当前适配以下固定版本：原厂 V15、Felucca 1.6.1、SLOOP 2.7、FM-1+VA 101、FoMni 0.4、X0X 1.1.0、Jangada 1.0、FM1 Open V12。

工作台能力以各固件实际开放的协议为准。安装适配不代表每项功能都能远程控制，也不代表所有迁移路线均已完成实机验证。下载来源和准备步骤见新玩家说明；本仓库不附带这些第三方 FM-1 固件。

仓库内容

firmware/              安装包下载入口；完整安装包在 GitHub Releases
assets/screens/        首页界面预览
main/                  ESP-IDF 固件源码与生成好的字体
tools/prepare_build.py  必需的构建准备入口
docs/                  新玩家说明、构建说明和版本说明
licenses/              第三方许可证原文
dependencies.lock.template  不含开发者本机路径的依赖锁模板
sdkconfig.defaults     构建配置
LICENSE                项目自有代码的 MIT 许可证

版本状态与兼容性

本版为预发布，已完成构建、离线回归，以及一台已有 M1n1Le55 的 Tab5 升级启动检查：版本读取、四个主页面切换和 SD 固件库读取通过。全新出厂设备首装、自动 V15 中转及不同硬件批次仍需进一步实机验收，具体记录见版本说明。

目标硬件是原版 M5Stack Tab5（ESP32-P4，16 MB Flash / 32 MB PSRAM）+ M-VAVE FM-1，不是任意 ESP32-P4 开发板。镜像支持的 P4 修订为 v0.1–v1.99；应用要求 eFuse block 版本不高于 0.99。屏幕代码覆盖 ILI9881C/GT911、ST7123 和 ST7121/ST712x，目前已有实机记录只覆盖 ST7121 / P4 v1.3。

首装只更新 Tab5 的 P4，不更新其 C6 无线固件。蓝牙依赖 C6 的 ESP-Hosted 兼容性；USB 工作台可独立使用。SD 准备工具目前仅支持 Windows FAT32 盘符根目录。详细范围见 版本说明。

反馈与参与

欢迎提交问题复现、兼容性记录与功能改进。反馈时请附版本、屏幕型号、FM-1 固件身份、操作步骤和错误文字；公开日志前移除设备地址、个人路径与音色内容。

开发从构建说明开始，源码位于 main/。安装器与 SD 准备工具随 Releases 安装包提供。

许可证与致谢

项目自有代码采用 MIT，第三方内容保留各自许可。

感谢以下 FM-1 固件提供者：M-VAVE、hugelton / Felucca、isod89 / SLOOP、Baud Girl / FM-1+VA、Charles Vestal / FoMni 与 X0X、zednaked / Jangada、FM1 Open。这些第三方 FM-1 固件需从原作者处取得，下载时请使用本版列明的兼容版本。

第三方许可与来源见第三方声明。