import { _ as _export_sfc, c as createElementBlock, o as openBlock, a8 as createStaticVNode } from "./chunks/framework.DyMmIvSC.js"; const __pageData = JSON.parse('{"title":"BootloadHID Flashing Instructions and Bootloader Information","description":"","frontmatter":{},"headers":[],"relativePath":"flashing_bootloadhid.md","filePath":"flashing_bootloadhid.md"}'); const _sfc_main = { name: "flashing_bootloadhid.md" }; const _hoisted_1 = /* @__PURE__ */ createStaticVNode('

BootloadHID Flashing Instructions and Bootloader Information ​

ps2avr(GB) boards use an ATmega32A microcontroller and a different bootloader. It is not flashable using the regular QMK methods.

General flashing sequence:

  1. Enter the bootloader using any of the following methods:
  2. Wait for the OS to detect the device
  3. Flash a .hex file
  4. Reset the device into application mode (may be done automatically)

bootloadHID Flashing Target ​

TIP

Using the QMK installation script, detailed here, the required bootloadHID tools should be automatically installed.

To flash via the command line, use the target :bootloadhid by executing the following command:

make <keyboard>:<keymap>:bootloadhid

GUI Flashing ​

Windows ​

  1. Download HIDBootFlash.
  2. Place your keyboard into reset.
  3. Ensure the configured VendorID is 16c0 and ProductID is 05df
  4. Press the Find Device button and ensure that your keyboard is found.
  5. Press the Open .hex File button and locate the .hex file you created.
  6. Press the Flash Device button and wait for the process to complete.

Command Line Flashing ​

  1. Place your keyboard into reset.
  2. Flash the board by typing bootloadHID -r followed by the path to your .hex file.

Windows Manual Installation ​

For MSYS2:

  1. Download the BootloadHID firmware package from https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz.
  2. Extract contents using a compatible tool, for example 7-Zip.
  3. Add to the MSYS path by copying commandline/bootloadHID.exe from the extracted archive to your MSYS2 installation, typically C:\\msys64\\usr\\bin.

For native Windows flashing, the bootloadHID.exe can be used outside of the MSYS2 environment.

Linux Manual Installation ​

  1. Install libusb development dependency:
    # This depends on OS - for Debian the following works\nsudo apt-get install libusb-dev
  2. Download the BootloadHID firmware package:
    wget https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz -O - | tar -xz -C /tmp
  3. Build the bootloadHID executable:
    cd /tmp/bootloadHID.2012-12-08/commandline/\nmake\nsudo cp bootloadHID /usr/local/bin

MacOS Manual Installation ​

  1. Install Homebrew by typing the following:
    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  2. Install the following packages:
    brew install --HEAD https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb
', 21); const _hoisted_22 = [ _hoisted_1 ]; function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) { return openBlock(), createElementBlock("div", null, _hoisted_22); } const flashing_bootloadhid = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render]]); export { __pageData, flashing_bootloadhid as default };