QMK固件的工具箱伴侣

【实例简介】

QMK Toolbox是一组打包到一个应用程序中的烧录工具。它支持键盘固件的自动检测和自动烧录。

烧录

QMK Toolbox支持以下启动加载程序：

• ARM DFU（APM32、Kiibohd、STM32、STM32duino），使用dfu-util
• Atmel/LUFA/QMK DFU，使用dfu-programmer
• Atmel SAM-BA（Massdrop），使用Massdrop Loader
• BootloadHID（Atmel、PS2AVRGB），使用bootloadHID
• Caterina（Arduino、Pro Micro），使用avrdude
• HalfKay（Teensy、Ergodox EZ），使用Teensy Loader
• LUFA/QMK HID，使用hid_bootloader_cli
• WB32 DFU（WB32），使用wb32-dfu-updater_cli
• LUFA Mass Storage

以及以下ISP烧录器：

• AVRISP（Arduino ISP）
• USBasp（AVR ISP）
• USBTiny（AVR Pocket）

如果对其他启动加载程序感兴趣，只要了解它们的命令，就可以添加。

HID控制台

该工具箱还监听使用页面0xFF31和使用0x0074的HID消息，与PJRC的hid_listen兼容。如果在键盘的rules.mk中启用了CONSOLE_ENABLE = yes，则可以使用xprintf()打印消息，用于调试：

有关更多信息，请参阅QMK文档。

安装

系统要求

macOS 12（Monterey）或更高版本
Windows 10 2020年5月更新（20H1）或更高版本

依赖项

在Windows上使用QMK Toolbox时，首次运行时会提示安装必要的驱动程序。如果在烧录时遇到“设备未找到”的问题，则可能需要使用Zadig来解决该问题。

【实例截图】
【核心代码】
文件清单
└── qmk_toolbox-e9d0a6274cf8e10e7eb6bb5130307672aa8c1dfa
    ├── common
    │   ├── avrdude.conf
    │   ├── mcu-list.txt
    │   ├── reset.eep
    │   ├── reset_left.eep
    │   └── reset_right.eep
    ├── LICENSE.md
    ├── macos
    │   ├── QMK Toolbox
    │   │   ├── AppDelegate.swift
    │   │   ├── Assets.xcassets
    │   │   │   ├── AppIcon.appiconset
    │   │   │   │   ├── Contents.json
    │   │   │   │   ├── icon-128x128@2x.png
    │   │   │   │   ├── icon-128x128.png
    │   │   │   │   ├── icon-16x16@2x.png
    │   │   │   │   ├── icon-16x16.png
    │   │   │   │   ├── icon-256x256@2x.png
    │   │   │   │   ├── icon-256x256.png
    │   │   │   │   ├── icon-32x32@2x.png
    │   │   │   │   ├── icon-32x32.png
    │   │   │   │   ├── icon-512x512@2x.png
    │   │   │   │   └── icon-512x512.png
    │   │   │   └── Contents.json
    │   │   ├── Base.lproj
    │   │   │   └── Main.storyboard
    │   │   ├── Colors.xcassets
    │   │   │   ├── Contents.json
    │   │   │   ├── LogBoxBackground.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogBoxSelection.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogMessageBootloader.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogMessageDefault.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogMessageError.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogMessageHID.colorset
    │   │   │   │   └── Contents.json
    │   │   │   ├── LogMessageHIDOutput.colorset
    │   │   │   │   └── Contents.json
    │   │   │   └── LogMessageInfo.colorset
    │   │   │       └── Contents.json
    │   │   ├── HID
    │   │   │   ├── HIDConsoleDevice.swift
    │   │   │   ├── HIDConsoleViewController.swift
    │   │   │   └── HIDListener.swift
    │   │   ├── Info.plist
    │   │   ├── KeyTester
    │   │   │   ├── Base.lproj
    │   │   │   │   └── KeyView.xib
    │   │   │   ├── KeyTesterViewController.swift
    │   │   │   └── KeyView.swift
    │   │   ├── LogTextView.swift
    │   │   ├── MainViewController.swift
    │   │   ├── MainWindow.swift
    │   │   ├── MessageType.swift
    │   │   ├── MicrocontrollerSelector.swift
    │   │   ├── Resources
    │   │   │   ├── avrdude
    │   │   │   ├── bootloadHID
    │   │   │   ├── dfu-programmer
    │   │   │   ├── dfu-util
    │   │   │   ├── hid_bootloader_cli
    │   │   │   ├── libavrdude.1.0.0.dylib
    │   │   │   ├── libftdi1.2.5.0.dylib
    │   │   │   ├── libhidapi.0.14.0.dylib
    │   │   │   ├── libusb-0.1.4.dylib
    │   │   │   ├── libusb-1.0.0.dylib
    │   │   │   ├── mdloader
    │   │   │   ├── teensy_loader_cli
    │   │   │   └── wb32-dfu-updater_cli
    │   │   ├── USB
    │   │   │   ├── Bootloader
    │   │   │   │   ├── APM32DFUDevice.swift
    │   │   │   │   ├── AtmelDFUDevice.swift
    │   │   │   │   ├── AtmelSAMBADevice.swift
    │   │   │   │   ├── AVRISPDevice.swift
    │   │   │   │   ├── BootloaderDevice.swift
    │   │   │   │   ├── BootloaderType.swift
    │   │   │   │   ├── BootloadHIDDevice.swift
    │   │   │   │   ├── CaterinaDevice.swift
    │   │   │   │   ├── GD32VDFUDevice.swift
    │   │   │   │   ├── HalfKayDevice.swift
    │   │   │   │   ├── KiibohdDevice.swift
    │   │   │   │   ├── LUFAHIDDevice.swift
    │   │   │   │   ├── LUFAMSDevice.swift
    │   │   │   │   ├── STM32DFUDevice.swift
    │   │   │   │   ├── STM32DuinoDevice.swift
    │   │   │   │   ├── USBAspDevice.swift
    │   │   │   │   ├── USBTinyISPDevice.swift
    │   │   │   │   └── WB32DFUDevice.swift
    │   │   │   ├── USBDevice.swift
    │   │   │   └── USBListener.swift
    │   │   └── WindowState.swift
    │   ├── QMK Toolbox.pkgproj
    │   ├── QMK Toolbox.xcodeproj
    │   │   ├── project.pbxproj
    │   │   ├── project.xcworkspace
    │   │   │   ├── contents.xcworkspacedata
    │   │   │   └── xcshareddata
    │   │   │       ├── IDEWorkspaceChecks.plist
    │   │   │       └── WorkspaceSettings.xcsettings
    │   │   └── xcshareddata
    │   │       └── xcschemes
    │   │           └── QMK Toolbox.xcscheme
    │   └── QMK Toolbox.xcworkspace
    │       ├── contents.xcworkspacedata
    │       └── xcshareddata
    │           └── IDEWorkspaceChecks.plist
    ├── readme.md
    └── windows
        ├── install_compiler.iss
        ├── QMK Toolbox
        │   ├── AboutBox.cs
        │   ├── AboutBox.Designer.cs
        │   ├── AboutBox.resx
        │   ├── App.config
        │   ├── BetterComboBox.cs
        │   ├── BindableToolStripMenuItem.cs
        │   ├── ComboBoxPlaceholder.cs
        │   ├── FodyWeavers.xml
        │   ├── FodyWeavers.xsd
        │   ├── Helpers
        │   │   ├── DriverInstaller.cs
        │   │   └── EmbeddedResourceHelper.cs
        │   ├── Hid
        │   │   ├── HidConsoleDevice.cs
        │   │   ├── HidConsoleWindow.cs
        │   │   ├── HidConsoleWindow.Designer.cs
        │   │   ├── HidConsoleWindow.resx
        │   │   └── HidListener.cs
        │   ├── KeyTester
        │   │   ├── KeyControl.cs
        │   │   ├── KeyControl.Designer.cs
        │   │   ├── KeyControl.resx
        │   │   ├── KeyTesterWindow.cs
        │   │   ├── KeyTesterWindow.Designer.cs
        │   │   └── KeyTesterWindow.resx
        │   ├── LogTextBox.cs
        │   ├── MainWindow.cs
        │   ├── MainWindow.Designer.cs
        │   ├── MainWindow.resx
        │   ├── MessageType.cs
        │   ├── MicrocontrollerSelector.cs
        │   ├── Program.cs
        │   ├── Properties
        │   │   ├── app.manifest
        │   │   ├── DataSources
        │   │   │   └── WindowState.datasource
        │   │   ├── Resources.Designer.cs
        │   │   ├── Resources.resx
        │   │   ├── Settings.Designer.cs
        │   │   └── Settings.settings
        │   ├── QMK Toolbox.csproj
        │   ├── Resources
        │   │   ├── avrdude.exe
        │   │   ├── bootloadHID.exe
        │   │   ├── dfu-programmer.exe
        │   │   ├── dfu-util.exe
        │   │   ├── drivers.txt
        │   │   ├── hid_bootloader_cli.exe
        │   │   ├── libftdi1.dll
        │   │   ├── libhidapi-0.dll
        │   │   ├── libusb-0-1-4.dll
        │   │   ├── libusb-1.0.dll
        │   │   ├── libwinpthread-1.dll
        │   │   ├── mdloader.exe
        │   │   ├── output.ico
        │   │   ├── qmk_driver_installer.exe
        │   │   ├── teensy_loader_cli.exe
        │   │   └── wb32-dfu-updater_cli.exe
        │   ├── Usb
        │   │   ├── Bootloader
        │   │   │   ├── Apm32DfuDevice.cs
        │   │   │   ├── AtmelDfuDevice.cs
        │   │   │   ├── AtmelSamBaDevice.cs
        │   │   │   ├── AvrIspDevice.cs
        │   │   │   ├── BootloaderDevice.cs
        │   │   │   ├── BootloaderType.cs
        │   │   │   ├── BootloadHidDevice.cs
        │   │   │   ├── CaterinaDevice.cs
        │   │   │   ├── Gd32VDfuDevice.cs
        │   │   │   ├── HalfKayDevice.cs
        │   │   │   ├── KiibohdDfuDevice.cs
        │   │   │   ├── LufaHidDevice.cs
        │   │   │   ├── LufaMsDevice.cs
        │   │   │   ├── Stm32DfuDevice.cs
        │   │   │   ├── Stm32DuinoDevice.cs
        │   │   │   ├── UsbAspDevice.cs
        │   │   │   ├── UsbTinyIspDevice.cs
        │   │   │   └── Wb32DfuDevice.cs
        │   │   ├── IUsbDevice.cs
        │   │   ├── UsbDevice.cs
        │   │   └── UsbListener.cs
        │   └── WindowState.cs
        └── QMK Toolbox.sln

39 directories, 160 files