QMK Toolbox 安装与配置完全指南

QMK Toolbox 安装与配置完全指南

qmk_toolbox A Toolbox companion for QMK Firmware 项目地址: https://gitcode.com/gh_mirrors/qm/qmk_toolbox

项目基础介绍及编程语言

QMK Toolbox 是一个专为 QMK Firmware 设计的一站式键盘固件闪存工具。它集成了多种键盘固件刷新功能，支持自动检测和一键闪存，极大地简化了定制机械键盘固件的过程。此项目广泛应用于机械键盘爱好者和开发者中，使得修改和升级键盘固件变得更加便捷。主要编程语言包括 C#、Swift 和部分使用 Inno Setup 编写的安装脚本。

关键技术和框架

• Bootloader 支持: 包含对多种Bootloader的支持，如ARM DFU、Atmel/LUFA/QMK DFU、BootloadHID等，以及ISP闪存器如AVRISP、USBasp。
• 跨平台: 使用不同技术和接口确保在Windows和macOS上都能运行无阻。
• HID Console集成: 具备接收HID消息的能力，兼容特定的调试信息传输，便于开发时进行调试。
• 自动生成驱动安装: 在Windows系统上提供简单的驱动程序安装体验，通过Zadig解决设备未找到的问题。

准备工作与详细安装步骤

系统要求

• Windows: 至少需要Windows 10 May 2020 Update（版本20H1）或更高。
• macOS: 需要macOS 12（Monterey）或更高版本。

步骤一：获取QMK Toolbox

1. 访问项目主页：https://github.com/qmk/qmk_toolbox
2. 根据您的操作系统选择下载方式：
   • Windows用户：点击“Releases”标签页，下载最新的Windows Standalone Installer。
   • macOS用户：同样从“Releases”下载最新版的macOS Standalone Installer，或者如果您是Homebrew用户，可以通过终端命令brew install qmk-toolbox来安装。

步骤二：安装与驱动配置

对于Windows用户：

• 运行下载的安装包进行安装。
• 第一次运行QMK Toolbox时，如果系统提示缺少驱动，按照提示操作，可能会自动安装或引导您使用Zadig工具手动安装特定设备驱动。

对于macOS用户：

• 下载的DMG文件双击打开后，将应用程序拖到 Applications 文件夹以安装。
• macOS通常不需要额外的驱动配置。

步骤三：使用QMK Toolbox

1. 打开QMK Toolbox。
2. 连接您想要刷新固件的机械键盘。
3. 工具箱应自动检测到键盘并列出可选的操作。
4. 选择适当的固件文件（通常是.hex文件），该文件可以从QMK Firmware仓库的构建目录获得。
5. 点击“Flash”按钮进行固件刷写。等待过程完成，并遵循任何可能出现的指示。

步骤四：测试

固件刷新完成后，断开并重新连接键盘以验证新固件是否成功加载。有些键盘还提供了内置的键测试功能，可进一步确认每个按键的功能正常。

至此，您已经完成了QMK Toolbox的安装与配置，可以自由地探索和个性化您的机械键盘了。记得在遇到问题时，可以参考QMK的官方文档或社区寻求帮助。

qmk_toolbox A Toolbox companion for QMK Firmware 项目地址: https://gitcode.com/gh_mirrors/qm/qmk_toolbox