1 # BootloadHID Flashing Instructions and Bootloader Information
3 ps2avr(GB) boards use an ATmega32A microcontroller and a different bootloader. It is not flashable using the regular QMK methods.
5 General flashing sequence:
7 1. Enter the bootloader using any of the following methods:
8 * Tap the `RESET` keycode (may not work on all devices)
9 * Hold the salt key while plugging the keyboard in (usually documented within keyboard readme)
10 2. Wait for the OS to detect the device
12 4. Reset the device into application mode (may be done automatically)
14 ## bootloadHID Flashing Target
16 Using the QMK installation script, detailed [here](newbs_getting_started.md), the required bootloadHID tools should be automatically installed.
18 To flash via the command line, use the target `:bootloadHID` by executing the following command:
20 make <keyboard>:<keymap>:bootloadHID
25 1. Download [HIDBootFlash](http://vusb.wikidot.com/project:hidbootflash).
26 2. Place your keyboard into reset.
27 3. Ensure the configured VendorID is `16c0` and ProductID is `05df`
28 4. Press the `Find Device` button and ensure that your keyboard is found.
29 5. Press the `Open .hex File` button and locate the `.hex` file you created.
30 6. Press the `Flash Device` button and wait for the process to complete.
32 ## Command Line Flashing
34 1. Place your keyboard into reset.
35 2. Flash the board by typing `bootloadHID -r` followed by the path to your `.hex` file.
37 ### Windows Manual Installation
39 1. Download the BootloadHID firmware package from https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz.
40 2. Extract contents using a compatible tool, for example 7-Zip.
41 3. Add to the MSYS path by copying `commandline/bootloadHID.exe` from the extracted archive to your MSYS2 installation, typically `C:\msys64\usr\bin`.
43 For native Windows flashing, the `bootloadHID.exe` can be used outside of the MSYS2 environment.
45 ### Linux Manual Installation
46 1. Install libusb development dependency:
48 # This depends on OS - for Debian the following works
49 sudo apt-get install libusb-dev
51 2. Download the BootloadHID firmware package:
53 wget https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz -O - | tar -xz -C /tmp
55 3. Build the bootloadHID executable:
57 cd /tmp/bootloadHID.2012-12-08/commandline/
59 sudo cp bootloadHID /usr/local/bin
62 ### MacOS Manual Installation
63 1. Install Homebrew by typing the following:
65 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
67 2. Install the following packages:
69 brew install --HEAD https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb