jlj-qmk/docs/flashing_bootloadhid.md
Joel Challis 51bcadf38c Add 'bootloadHID' flash target (#5587)
* Add 'bootloadHID' flash target

* Prep for flash target

* Add :flash support

* Align bootloader wait messages

Co-Authored-By: Drashna Jaelre <drashna@live.com>

* Update template to suggest use of :flash
2019-08-24 08:35:11 -07:00

2.7 KiB

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:
    • Tap the RESET keycode (may not work on all devices)
    • Hold the salt key while plugging the keyboard in (usually documented within keyboard readme)
  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

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
    sudo 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/
    make
    sudo 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