[![项目演示视频封面](封面.jpg)](https://www.bilibili.com/video/BV1RbNZ6TEKn/)




# 白头佬 多系统工具 & 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](https://blog.gitee.com)
3. 开源项目广场：[https://gitee.com/explore](https://gitee.com/explore)
4. GVP优质开源项目认证：[GVP](https://gitee.com/gvp)
5. Gitee官方使用手册：[https://gitee.com/help](https://gitee.com/help)
6. Gitee创作者展示栏目：[https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)