OneKey Recovery Dongle

项目概述

OneKey Recovery Dongle 是一个基于 CH552 芯片的硬件设备，通过自动发送预设的键盘组合键操作，实现对某些一体机设备的 OPS 系统的恢复和备份功能。

功能特性

• 双模式切换：支持 RESTORE（恢复）和 BACKUP（备份）两种工作模式
• 模式指示：通过 LED 颜色区分工作模式（RESTORE：绿色，BACKUP：红色）
• 组合键发送：
  • RESTORE 模式：自动发送Ctrl+F4组合键（间隔 300ms）
  • BACKUP 模式：自动发送Ctrl+F3组合键（间隔 300ms）
  • 按键触发：发送Ctrl+Alt+Delete组合键（间隔 100ms）

使用说明

1. 模式选择：

   • 直接连接 USB：进入 RESTORE 模式
   • 按住按键并连接 USB：进入 BACKUP 模式

2. 操作方法：

   • 连接 USB 后，设备会自动发送当前模式对应的组合键
   • 当按住按键时，设备会连续发送Ctrl+Alt+Delete组合键
   • BACKUP 模式下，当松开按键后，设备会切换到 RESTORE 模式

软件依赖

核心库

该项目使用了第三方库 ch55xduino，这是一个为 CH55X 系列 USB MCU 提供的 Arduino 兼容编程 API。

• 项目地址：https://github.com/DeqingSun/ch55xduino

安装与配置

1. 安装 ch55xduino 库：

   • 打开 Arduino IDE
   • 进入文件 > 首选项，在 "附加开发板管理器网址" 中添加：

     https://raw.githubusercontent.com/DeqingSun/ch55xduino/ch55xduino/package_ch55xduino_mcs51_index.json
     

   • 进入工具 > 开发板 > 开发板管理器
   • 搜索 "ch55xduino" 并安装

2. 配置开发环境：

   • 选择开发板：工具 > 开发板 > CH55x Boards > CH552 Board
   • 设置 USB RAM：工具 > USB Settings > USER CODE w/148 USB Ram
   • 选择上传方法：工具 > 上传方式（USB 或 Serial）

3. 编译与上传：

   • 连接 CH552 开发板到电脑
   • 点击 Arduino IDE 中的 "验证" 按钮编译代码
   • 点击 "上传" 按钮将代码烧录到芯片
   • 注意：除首次上传外，都需要手动进入 Bootloader 模式（断开 USB，添加 D+ 上拉电阻后重新连接）

许可证

本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件