Files
2026-08-31 15:12:19 +00:00

100 lines
4.8 KiB
Markdown

[![项目演示视频封面](封面.jpg)](https://www.bilibili.com/video/BV1fw846DErT/)
![输入图片说明](SPI%20Flash%E5%86%85%E5%AD%98%E5%88%86%E5%8C%BA%E5%B8%83%E5%B1%80%E5%9B%BE.png)
# 白头佬 多系统工具 & Betula Multi-System Tool
#### 更新说明
20260719 完善了写入写出固件功能,增加配套工具功能。本次更新只需在Ichi模式把“03-bl2_1.1.uf2”文件拖入磁盘即可完成更新
## 一、机型与工具总述
### 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/)