aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRyan <[email protected]>2024-06-18 05:23:45 +1000
committerGitHub <[email protected]>2024-06-17 20:23:45 +0100
commitbaa564bddfa0b1bfc7689bc42ec3d1cd7abb7a13 (patch)
tree414ddc80c660e260a42ded05e2e54b351338e971 /docs
parent3f44231d2d7889beb87f67035d884daae72eb6f5 (diff)
downloadqmk_firmware-baa564bddfa0b1bfc7689bc42ec3d1cd7abb7a13.tar.gz
qmk_firmware-baa564bddfa0b1bfc7689bc42ec3d1cd7abb7a13.zip
Remove references to bootloadHID flashing page in keyboard readmes (#23942)
* Remove references to bootloadHID flashing page in keyboard readmes * Remove bootloadHID flashing page
Diffstat (limited to 'docs')
-rw-r--r--docs/_aliases.json1
-rw-r--r--docs/_sidebar.json8
-rw-r--r--docs/flashing_bootloadhid.md74
3 files changed, 2 insertions, 81 deletions
diff --git a/docs/_aliases.json b/docs/_aliases.json
index a2224bd0d5..f06e032215 100644
--- a/docs/_aliases.json
+++ b/docs/_aliases.json
@@ -4,6 +4,7 @@
"/cli_dev_configuration": "/cli_configuration",
"/dynamic_macros": "/feature_dynamic_macros",
"/feature_common_shortcuts": "/feature_advanced_keycodes",
+ "/flashing_bootloadhid": "/flashing",
"/getting_started_build_tools": "/newbs_getting_started",
"/getting_started_getting_help": "/support",
"/glossary": "/reference_glossary",
diff --git a/docs/_sidebar.json b/docs/_sidebar.json
index 2f64607dea..5935865a7a 100644
--- a/docs/_sidebar.json
+++ b/docs/_sidebar.json
@@ -64,13 +64,7 @@
"text": "Development Environments",
"items": [{ "text": "Docker Guide", "link": "/getting_started_docker" }]
},
- {
- "text": "Flashing",
- "items": [
- { "text": "Flashing", "link": "/flashing" },
- { "text": "Flashing ATmega32A (ps2avrgb)", "link": "/flashing_bootloadhid" }
- ]
- },
+ { "text": "Flashing", "link": "/flashing" },
{
"text": "IDEs",
"items": [
diff --git a/docs/flashing_bootloadhid.md b/docs/flashing_bootloadhid.md
deleted file mode 100644
index 2d1696c6e7..0000000000
--- a/docs/flashing_bootloadhid.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# 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 `QK_BOOT` 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
-
-::: tip
-Using the QMK installation script, detailed [here](newbs_getting_started), 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](http://vusb.wikidot.com/project: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
- ```