diff --git a/README.md b/README.md index 7220fd8..2d5fa67 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,87 @@ -# Betula Multi-System Tool - -#### 介绍 -针对泉盛UV-K5 V3版及其变种机型设计的多系统固件切换工具 - -#### 软件架构 -软件架构说明 -#### 安装教程 - -1. xxxx -2. xxxx -3. xxxx - -#### 使用说明 - -1. xxxx -2. xxxx -3. xxxx - -#### 参与贡献 - -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request -#### 特技 +# 泉盛UV-K5 V3版及其变种机型 固件刷机、多固件管理 & 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. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md -2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 -5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) +## 二、主固件刷写（日常升级最常用） +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/) \ No newline at end of file