betula-multi-system-tool/README.md

白头佬 多系统工具 & Betula Multi-System Tool

一、机型与工具总述

1. 适用设备

泉盛UV-K5 V3版及同系列变种对讲机

2. 配套工具

Betula Multi-System Tool：专为UV-K5 V3打造的多系统固件切换管理工具

3. 三种核心开机模式（关机状态，仅单独按住单键开机，多键同按只会正常启动，无法进入特殊模式）

开机长按按键	进入模式	电脑识别特征	用途
仅PTT侧边发射键	Moto DFU刷机模式	弹出MOTO移动磁盘	刷写/备份主固件、更新底层引导BL1
仅上侧S1键	BL2多固件切换菜单	对讲机屏幕显示固件选择菜单	多固件槽位切换、固件备份至外置存储、启动工具
无按键/任意多键组合	正常固件启动	直接进入对讲操作界面	日常使用对讲机

二、主固件刷写（日常升级最常用）

1. 设备关机，单独按住PTT键开机，屏幕出现Moto标识、手电点亮，电脑加载MOTO磁盘
2. 将官方提供后缀为.uf2的固件文件复制、拖拽至MOTO磁盘内
3. 设备背光快速闪烁代表刷写进行中，闪烁停止自动重启加载新固件
4. 固件损坏/不兼容时，设备会自动退回Moto刷机模式，不会变砖

三、固件备份（操作前必做）

1. 单独长按PTT开机进入Moto DFU模式，打开MOTO磁盘
2. 将磁盘内CURRENT.UF2文件复制保存至电脑，为整机完整固件备份

四、BL2多固件菜单操作（多固件存储、切换管理）

BL2是外置SPI存储搭载的多固件切换程序，可存储4套固件自由切换

1. 进入方式

关机，单独长按S1开机，直接调出BL2操作菜单

2. 菜单控制按键

按键	功能
S1	光标向下移动
S2	光标向上移动
PTT	确认，启动选中槽位固件/执行功能

3. 主菜单功能说明

1. 1~4 Switch FW 1~4：读取外置存储1-4号槽位固件并启动
2. 5 Ichi Flash Tool：启动Ichi底层烧录工具
3. 6 Save FW to Flash：固件写入子菜单，将当前运行固件存入指定槽位

4. 固件写入子菜单

1. 1~4：选定1-4号槽位，执行固件写入（注意避免覆盖已有固件）
2. 5 Cancel Writing：取消写入，返回BL2主菜单

菜单底部状态栏可查看当前光标对应槽位的标注信息（由电脑提前写入外置文本）

五、底层引导BL1（Moto引导）升级重装

仅更新底层引导程序时使用，常规固件升级无需操作

1. PTT开机进入Moto模式，将Ichi工具.uf2固件写入MOTO磁盘，完成后重启设备
2. 开机不按任何按键，设备启动Ichi程序，电脑弹出ICHI磁盘
3. 将基地址0x08000000的Moto引导.uf2文件拖入ICHI磁盘，写入完成即更新底层引导

六、BL2程序安装说明

BL2程序存放于设备外置SPI闪存，不占用主控芯片存储空间，需要借助Ichi工具写入完整镜像包完成部署。

七、刷机排错与安全注意事项

1. 全程保持USB线材稳定连接，刷写阶段严禁断电、拔线
2. 误进入错误模式直接关机重启即可，无设备损坏风险
3. 开机未按PTT却自动进入Moto刷机模式：设备无有效主固件，需重新刷写固件
4. 特殊模式触发规则：必须单独单键长按，PTT+S1等组合按键只会正常开机
5. BL2写入固件槽位前核对目标编号，防止覆盖留存的可用固件

八、Betula Multi-System Tool 工具说明

1. 工具介绍

专门适配泉盛UV-K5 V3及衍生机型的可视化多系统固件切换管理工具，简化多固件刷写、槽位管理流程。

2. 软件架构

（待补充完整架构说明）

3. 安装教程

1. xxxx
2. xxxx
3. xxxx

4. 使用说明

1. xxxx
2. xxxx
3. xxxx

5. 开源仓库贡献流程

1. Fork 项目仓库
2. 新建 Feat_xxx 功能分支
3. 本地修改后提交代码
4. 提交 Pull Request 合并至主仓库

6. Gitee平台配套资源

1. 多语言文档支持：通过Readme_语言代码.md区分，如Readme_zh.md中文、Readme_en.md英文
2. Gitee官方博客：blog.gitee.com
3. 开源项目广场：https://gitee.com/explore
4. GVP优质开源项目认证：GVP
5. Gitee官方使用手册：https://gitee.com/help
6. Gitee创作者展示栏目：https://gitee.com/gitee-stars/