mirror of
https://github.com/qmk/qmk_firmware.git
synced 2025-02-27 01:56:43 +00:00
16 lines
7.0 KiB
JavaScript
16 lines
7.0 KiB
JavaScript
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('<h1 id="bootloadhid-flashing-instructions-and-bootloader-information" tabindex="-1">BootloadHID Flashing Instructions and Bootloader Information <a class="header-anchor" href="#bootloadhid-flashing-instructions-and-bootloader-information" aria-label="Permalink to "BootloadHID Flashing Instructions and Bootloader Information""></a></h1><p>ps2avr(GB) boards use an ATmega32A microcontroller and a different bootloader. It is not flashable using the regular QMK methods.</p><p>General flashing sequence:</p><ol><li>Enter the bootloader using any of the following methods: <ul><li>Tap the <code>QK_BOOT</code> keycode (may not work on all devices)</li><li>Hold the salt key while plugging the keyboard in (usually documented within keyboard readme)</li></ul></li><li>Wait for the OS to detect the device</li><li>Flash a .hex file</li><li>Reset the device into application mode (may be done automatically)</li></ol><h2 id="bootloadhid-flashing-target" tabindex="-1">bootloadHID Flashing Target <a class="header-anchor" href="#bootloadhid-flashing-target" aria-label="Permalink to "bootloadHID Flashing Target""></a></h2><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>Using the QMK installation script, detailed <a href="./newbs_getting_started">here</a>, the required bootloadHID tools should be automatically installed.</p></div><p>To flash via the command line, use the target <code>:bootloadhid</code> by executing the following command:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>make <keyboard>:<keymap>:bootloadhid</span></span></code></pre></div><h2 id="gui-flashing" tabindex="-1">GUI Flashing <a class="header-anchor" href="#gui-flashing" aria-label="Permalink to "GUI Flashing""></a></h2><h3 id="windows" tabindex="-1">Windows <a class="header-anchor" href="#windows" aria-label="Permalink to "Windows""></a></h3><ol><li>Download <a href="http://vusb.wikidot.com/project:hidbootflash" target="_blank" rel="noreferrer">HIDBootFlash</a>.</li><li>Place your keyboard into reset.</li><li>Ensure the configured VendorID is <code>16c0</code> and ProductID is <code>05df</code></li><li>Press the <code>Find Device</code> button and ensure that your keyboard is found.</li><li>Press the <code>Open .hex File</code> button and locate the <code>.hex</code> file you created.</li><li>Press the <code>Flash Device</code> button and wait for the process to complete.</li></ol><h2 id="command-line-flashing" tabindex="-1">Command Line Flashing <a class="header-anchor" href="#command-line-flashing" aria-label="Permalink to "Command Line Flashing""></a></h2><ol><li>Place your keyboard into reset.</li><li>Flash the board by typing <code>bootloadHID -r</code> followed by the path to your <code>.hex</code> file.</li></ol><h3 id="windows-manual-installation" tabindex="-1">Windows Manual Installation <a class="header-anchor" href="#windows-manual-installation" aria-label="Permalink to "Windows Manual Installation""></a></h3><p>For MSYS2:</p><ol><li>Download the BootloadHID firmware package from <a href="https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz" target="_blank" rel="noreferrer">https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz</a>.</li><li>Extract contents using a compatible tool, for example 7-Zip.</li><li>Add to the MSYS path by copying <code>commandline/bootloadHID.exe</code> from the extracted archive to your MSYS2 installation, typically <code>C:\\msys64\\usr\\bin</code>.</li></ol><p>For native Windows flashing, the <code>bootloadHID.exe</code> can be used outside of the MSYS2 environment.</p><h3 id="linux-manual-installation" tabindex="-1">Linux Manual Installation <a class="header-anchor" href="#linux-manual-installation" aria-label="Permalink to "Linux Manual Installation""></a></h3><ol><li>Install libusb development dependency:<div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span># This depends on OS - for Debian the following works</span></span>\n<span class="line"><span>sudo apt-get install libusb-dev</span></span></code></pre></div></li><li>Download the BootloadHID firmware package:<div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>wget https://www.obdev.at/downloads/vusb/bootloadHID.2012-12-08.tar.gz -O - | tar -xz -C /tmp</span></span></code></pre></div></li><li>Build the bootloadHID executable:<div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>cd /tmp/bootloadHID.2012-12-08/commandline/</span></span>\n<span class="line"><span>make</span></span>\n<span class="line"><span>sudo cp bootloadHID /usr/local/bin</span></span></code></pre></div></li></ol><h3 id="macos-manual-installation" tabindex="-1">MacOS Manual Installation <a class="header-anchor" href="#macos-manual-installation" aria-label="Permalink to "MacOS Manual Installation""></a></h3><ol><li>Install Homebrew by typing the following:<div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"</span></span></code></pre></div></li><li>Install the following packages:<div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span>brew install --HEAD https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb</span></span></code></pre></div></li></ol>', 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
|
||
};
|