mirror of
https://github.com/qmk/qmk_firmware.git
synced 2025-02-27 01:56:43 +00:00
16 lines
20 KiB
JavaScript
16 lines
20 KiB
JavaScript
|
import { _ as _export_sfc, c as createElementBlock, o as openBlock, a8 as createStaticVNode } from "./chunks/framework.B9AX-CPi.js";
|
|||
|
|
const __pageData = JSON.parse('{"title":"Converters","description":"","frontmatter":{},"headers":[],"relativePath":"feature_converters.md","filePath":"feature_converters.md","lastUpdated":null}');
|
|||
|
|
const _sfc_main = { name: "feature_converters.md" };
|
|||
|
|
const _hoisted_1 = /* @__PURE__ */ createStaticVNode('<h1 id="converters" tabindex="-1">Converters <a class="header-anchor" href="#converters" aria-label="Permalink to "Converters""></a></h1><p>This page documents the automated process for converting keyboards to use drop-in replacement controllers. This process is designed to be easy to use and can be completed in a few simple steps.</p><h2 id="supported-converters" tabindex="-1">Supported Converters <a class="header-anchor" href="#supported-converters" aria-label="Permalink to "Supported Converters""></a></h2><p>The following converters are available at this time:</p><table><thead><tr><th>From</th><th>To</th></tr></thead><tbody><tr><td><code>promicro</code></td><td><code>proton_c</code></td></tr><tr><td><code>promicro</code></td><td><code>kb2040</code></td></tr><tr><td><code>promicro</code></td><td><code>sparkfun_pm2040</code></td></tr><tr><td><code>promicro</code></td><td><code>blok</code></td></tr><tr><td><code>promicro</code></td><td><code>bit_c_pro</code></td></tr><tr><td><code>promicro</code></td><td><code>stemcell</code></td></tr><tr><td><code>promicro</code></td><td><code>bonsai_c4</code></td></tr><tr><td><code>promicro</code></td><td><code>rp2040_ce</code></td></tr><tr><td><code>promicro</code></td><td><code>elite_pi</code></td></tr><tr><td><code>promicro</code></td><td><code>helios</code></td></tr><tr><td><code>promicro</code></td><td><code>liatris</code></td></tr><tr><td><code>promicro</code></td><td><code>imera</code></td></tr><tr><td><code>promicro</code></td><td><code>michi</code></td></tr><tr><td><code>promicro</code></td><td><code>svlinky</code></td></tr><tr><td><code>elite_c</code></td><td><code>stemcell</code></td></tr><tr><td><code>elite_c</code></td><td><code>rp2040_ce</code></td></tr><tr><td><code>elite_c</code></td><td><code>elite_pi</code></td></tr><tr><td><code>elite_c</code></td><td><code>helios</code></td></tr><tr><td><code>elite_c</code></td><td><code>liatris</code></td></tr></tbody></table><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to "Overview""></a></h2><p>Each converter category is broken down by its declared <code>pin compatibility</code>. This ensures that only valid combinations are attempted. You can generate the firmware by appending <code>-e CONVERT_TO=<target></code> to your compile/flash command. For example:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">qmk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> flash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -c</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -kb</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> keebio/bdn9/rev1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -km</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> default</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -e</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> CONVERT_TO=proton_c</span></span></code></pre></div><p>You can also add the same <code>CONVERT_TO=<target></code> to your keymap's <code>rules.mk</code>, which will accomplish the same thing.</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>If you get errors about <code>PORTB/DDRB</code>, etc not being defined, you'll need to convert the keyboard's code to use the <a href="./drivers/gpio">GPIO Controls</a> that will work for both ARM and AVR. This shouldn't affect the AVR builds at all.</p></div><h3 id="conditional-configuration" tabindex="-1">Conditional Configuration <a class="header-anchor" href="#conditional-configuration" aria-label="Permalink to "Conditional Configuration""></a></h3><p>Once a converter is enabled, it exposes the <code
|
|||
|
|
const _hoisted_55 = [
|
|||
|
|
_hoisted_1
|
|||
|
|
];
|
|||
|
|
function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
|
|||
|
|
return openBlock(), createElementBlock("div", null, _hoisted_55);
|
|||
|
|
}
|
|||
|
|
const feature_converters = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render]]);
|
|||
|
|
export {
|
|||
|
|
__pageData,
|
|||
|
|
feature_converters as default
|
|||
|
|
};
|