20210529.html 134 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. <!DOCTYPE html>
  2. <html lang="en-US" dir="ltr">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <title>QMK Breaking Changes - 2021 May 29 Changelog | QMK Firmware</title>
  7. <meta name="description" content="Documentation for QMK Firmware">
  8. <meta name="generator" content="VitePress v1.6.4">
  9. <link rel="preload stylesheet" href="/assets/style.DXtMBPge.css" as="style">
  10. <link rel="preload stylesheet" href="/vp-icons.css" as="style">
  11. <script type="module" src="/assets/app.B9kYxhU1.js"></script>
  12. <link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
  13. <link rel="modulepreload" href="/assets/chunks/theme.DpmcBuy-.js">
  14. <link rel="modulepreload" href="/assets/chunks/framework.8zKZLKO7.js">
  15. <link rel="modulepreload" href="/assets/ChangeLog_20210529.md.CWpDbllD.lean.js">
  16. <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
  17. <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
  18. </head>
  19. <body>
  20. <div id="app"><div class="Layout" data-v-5d98c3a5><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0b0ada53></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0b0ada53>Skip to content</a><!--]--><!----><header class="VPNav" data-v-5d98c3a5 data-v-ae24b3ad><div class="VPNavBar" data-v-ae24b3ad data-v-6aa21345><div class="wrapper" data-v-6aa21345><div class="container" data-v-6aa21345><div class="title" data-v-6aa21345><div class="VPNavBarTitle has-sidebar" data-v-6aa21345 data-v-1168a8e4><a class="title" href="/" data-v-1168a8e4><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/qmk-logo-dark.svg" alt data-v-8426fc1a><!--]--><!--[--><img class="VPImage light logo" src="/qmk-logo-light.svg" alt data-v-8426fc1a><!--]--><!--]--><!--]--><span data-v-1168a8e4>QMK Firmware</span><!--[--><!--]--></a></div></div><div class="content" data-v-6aa21345><div class="content-body" data-v-6aa21345><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6aa21345><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6aa21345 data-v-dc692963><span id="main-nav-aria-label" class="visually-hidden" data-v-dc692963> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>Home</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6aa21345 data-v-6c893767><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6c893767 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-6aa21345 data-v-0394ad82 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://reddit.com/r/olkb" aria-label target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50" width="50px" height="50px"><path d="M 29 3 C 28.0625 3 27.164063 3.382813 26.5 4 C 25.835938 4.617188 25.363281 5.433594 25 6.40625 C 24.355469 8.140625 24.085938 10.394531 24.03125 13.03125 C 19.234375 13.179688 14.820313 14.421875 11.28125 16.46875 C 10.214844 15.46875 8.855469 14.96875 7.5 14.96875 C 6.089844 14.96875 4.675781 15.511719 3.59375 16.59375 C 1.425781 18.761719 1.425781 22.238281 3.59375 24.40625 L 3.84375 24.65625 C 3.3125 26.035156 3 27.488281 3 29 C 3 33.527344 5.566406 37.585938 9.5625 40.4375 C 13.558594 43.289063 19.007813 45 25 45 C 30.992188 45 36.441406 43.289063 40.4375 40.4375 C 44.433594 37.585938 47 33.527344 47 29 C 47 27.488281 46.6875 26.035156 46.15625 24.65625 L 46.40625 24.40625 C 48.574219 22.238281 48.574219 18.761719 46.40625 16.59375 C 45.324219 15.511719 43.910156 14.96875 42.5 14.96875 C 41.144531 14.96875 39.785156 15.46875 38.71875 16.46875 C 35.195313 14.433594 30.800781 13.191406 26.03125 13.03125 C 26.09375 10.546875 26.363281 8.46875 26.875 7.09375 C 27.164063 6.316406 27.527344 5.757813 27.875 5.4375 C 28.222656 5.117188 28.539063 5 29 5 C 29.460938 5 29.683594 5.125 30.03125 5.40625 C 30.378906 5.6875 30.785156 6.148438 31.3125 6.6875 C 32.253906 7.652344 33.695313 8.714844 36.09375 8.9375 C 36.539063 11.238281 38.574219 13 41 13 C 43.75 13 46 10.75 46 8 C 46 5.25 43.75 3 41 3 C 38.605469 3 36.574219 4.710938 36.09375 6.96875 C 34.3125 6.796875 33.527344 6.109375 32.75 5.3125 C 32.300781 4.851563 31.886719 4.3125 31.3125 3.84375 C 30.738281 3.375 29.9375 3 29 3 Z M 41 5 C 42.667969 5 44 6.332031 44 8 C 44 9.667969 42.667969 11 41 11 C 39.332031 11 38 9.667969 38 8 C 38 6.332031 39.332031 5 41 5 Z M 25 15 C 30.609375 15 35.675781 16.613281 39.28125 19.1875 C 42.886719 21.761719 45 25.226563 45 29 C 45 32.773438 42.886719 36.238281 39.28125 38.8125 C 35.675781 41.386719 30.609375 43 25 43 C 19.390625 43 14.324219 41.386719 10.71875 38.8125 C 7.113281 36.238281 5 32.773438 5 29 C 5 25.226563 7.113281 21.761719 10.71875 19.1875 C 14.324219 16.613281 19.390625 15 25 15 Z M 7.5 16.9375 C 8.203125 16.9375 8.914063 17.148438 9.53125 17.59375 C 7.527344 19.03125 5.886719 20.769531 4.75 22.71875 C 3.582031 21.296875 3.660156 19.339844 5 18 C 5.714844 17.285156 6.609375 16.9375 7.5 16.9375 Z M 42.5 16.9375 C 43.390625 16.9375 44.285156 17.285156 45 18 C 46.339844 19.339844 46.417969 21.296875 45.25 22.71875 C 44.113281 20.769531 42.472656 19.03125 40.46875 17.59375 C 41.085938 17.148438 41.796875 16.9375 42.5 16.9375 Z M 17 22 C 14.800781 22 13 23.800781 13 26 C 13 28.199219 14.800781 30 17 30 C 19.199219 30 21 28.199219 21 26 C 21 23.800781 19.199219 22 17 22 Z M 33 22 C 30.800781 22 29 23.800781 29 26 C 29 28.199219 30.800781 30 33 30 C 35.199219 30 37 28.199219 37 26 C 37 23.800781 35.199219 22 33 22 Z M 17 24 C 18.117188 24 19 24.882813 19 26 C 19 27.117188 18.117188 28 17 28 C 15.882813 28 15 27.117188 15 26 C 15 24.882813 15.882813 24 17 24 Z M 33 24 C 34.117188 24 35 24.882813 35 26 C 35 27.117188 34.117188 28 33 28 C 31.882813 28 31 27.117188 31 26 C 31 24.882813 31.882813 24 33 24 Z M 34.15625 33.84375 C 34.101563 33.851563 34.050781 33.859375 34 33.875 C 33.683594 33.9375 33.417969 34.144531 33.28125 34.4375 C 33.28125 34.4375 32.757813 35.164063 31.4375 36 C 30.117188 36.835938 28.058594 37.6875 25 37.6875 C 21.941406 37.6875 19.882813 36.835938 18.5625 36 C 17.242188 35.164063 16.71875 34.4375 16.71875 34.4375 C 16.492188 34.082031 16.066406 33.90625 15.65625 34 C 15.332031 34.082031 15.070313 34.316406 14.957031 34.632813 C 14.84375 34.945313 14.894531 35.292969 15.09375 35.5625 C 15.09375 35.5625 15.863281 36.671875 17.46875 37.6875 C 19.074219 38.703125 21.558594 39.6875 25 39.6875 C 28.441406 39.6875 30.925781 38.703125 32.53125 37.6875 C 34.136719 36.671875 34.90625 35.5625 34.90625 35.5625 C 35.207031 35.273438 35.296875 34.824219 35.128906 34.441406 C 34.960938 34.058594 34.574219 33.820313 34.15625 33.84375 Z"/></svg></a><a class="VPSocialLink no-icon" href="https://discord.gg/qmk" aria-label="discord" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-discord"></span></a><a class="VPSocialLink no-icon" href="https://github.com/qmk/qmk_firmware" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-6aa21345 data-v-bb2aa2f0 data-v-cf11d7a2><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-cf11d7a2><span class="vpi-more-horizontal icon" data-v-cf11d7a2></span></button><div class="menu" data-v-cf11d7a2><div class="VPMenu" data-v-cf11d7a2 data-v-b98bc113><!----><!--[--><!--[--><!----><div class="group" data-v-bb2aa2f0><div class="item appearance" data-v-bb2aa2f0><p class="label" data-v-bb2aa2f0>Appearance</p><div class="appearance-action" data-v-bb2aa2f0><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bb2aa2f0 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div></div></div><div class="group" data-v-bb2aa2f0><div class="item social-links" data-v-bb2aa2f0><div class="VPSocialLinks social-links-list" data-v-bb2aa2f0 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://reddit.com/r/olkb" aria-label target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50" width="50px" height="50px"><path d="M 29 3 C 28.0625 3 27.164063 3.382813 26.5 4 C 25.835938 4.617188 25.363281 5.433594 25 6.40625 C 24.355469 8.140625 24.085938 10.394531 24.03125 13.03125 C 19.234375 13.179688 14.820313 14.421875 11.28125 16.46875 C 10.214844 15.46875 8.855469 14.96875 7.5 14.96875 C 6.089844 14.96875 4.675781 15.511719 3.59375 16.59375 C 1.425781 18.761719 1.425781 22.238281 3.59375 24.40625 L 3.84375 24.65625 C 3.3125 26.035156 3 27.488281 3 29 C 3 33.527344 5.566406 37.585938 9.5625 40.4375 C 13.558594 43.289063 19.007813 45 25 45 C 30.992188 45 36.441406 43.289063 40.4375 40.4375 C 44.433594 37.585938 47 33.527344 47 29 C 47 27.488281 46.6875 26.035156 46.15625 24.65625 L 46.40625 24.40625 C 48.574219 22.238281 48.574219 18.761719 46.40625 16.59375 C 45.324219 15.511719 43.910156 14.96875 42.5 14.96875 C 41.144531 14.96875 39.785156 15.46875 38.71875 16.46875 C 35.195313 14.433594 30.800781 13.191406 26.03125 13.03125 C 26.09375 10.546875 26.363281 8.46875 26.875 7.09375 C 27.164063 6.316406 27.527344 5.757813 27.875 5.4375 C 28.222656 5.117188 28.539063 5 29 5 C 29.460938 5 29.683594 5.125 30.03125 5.40625 C 30.378906 5.6875 30.785156 6.148438 31.3125 6.6875 C 32.253906 7.652344 33.695313 8.714844 36.09375 8.9375 C 36.539063 11.238281 38.574219 13 41 13 C 43.75 13 46 10.75 46 8 C 46 5.25 43.75 3 41 3 C 38.605469 3 36.574219 4.710938 36.09375 6.96875 C 34.3125 6.796875 33.527344 6.109375 32.75 5.3125 C 32.300781 4.851563 31.886719 4.3125 31.3125 3.84375 C 30.738281 3.375 29.9375 3 29 3 Z M 41 5 C 42.667969 5 44 6.332031 44 8 C 44 9.667969 42.667969 11 41 11 C 39.332031 11 38 9.667969 38 8 C 38 6.332031 39.332031 5 41 5 Z M 25 15 C 30.609375 15 35.675781 16.613281 39.28125 19.1875 C 42.886719 21.761719 45 25.226563 45 29 C 45 32.773438 42.886719 36.238281 39.28125 38.8125 C 35.675781 41.386719 30.609375 43 25 43 C 19.390625 43 14.324219 41.386719 10.71875 38.8125 C 7.113281 36.238281 5 32.773438 5 29 C 5 25.226563 7.113281 21.761719 10.71875 19.1875 C 14.324219 16.613281 19.390625 15 25 15 Z M 7.5 16.9375 C 8.203125 16.9375 8.914063 17.148438 9.53125 17.59375 C 7.527344 19.03125 5.886719 20.769531 4.75 22.71875 C 3.582031 21.296875 3.660156 19.339844 5 18 C 5.714844 17.285156 6.609375 16.9375 7.5 16.9375 Z M 42.5 16.9375 C 43.390625 16.9375 44.285156 17.285156 45 18 C 46.339844 19.339844 46.417969 21.296875 45.25 22.71875 C 44.113281 20.769531 42.472656 19.03125 40.46875 17.59375 C 41.085938 17.148438 41.796875 16.9375 42.5 16.9375 Z M 17 22 C 14.800781 22 13 23.800781 13 26 C 13 28.199219 14.800781 30 17 30 C 19.199219 30 21 28.199219 21 26 C 21 23.800781 19.199219 22 17 22 Z M 33 22 C 30.800781 22 29 23.800781 29 26 C 29 28.199219 30.800781 30 33 30 C 35.199219 30 37 28.199219 37 26 C 37 23.800781 35.199219 22 33 22 Z M 17 24 C 18.117188 24 19 24.882813 19 26 C 19 27.117188 18.117188 28 17 28 C 15.882813 28 15 27.117188 15 26 C 15 24.882813 15.882813 24 17 24 Z M 33 24 C 34.117188 24 35 24.882813 35 26 C 35 27.117188 34.117188 28 33 28 C 31.882813 28 31 27.117188 31 26 C 31 24.882813 31.882813 24 33 24 Z M 34.15625 33.84375 C 34.101563 33.851563 34.050781 33.859375 34 33.875 C 33.683594 33.9375 33.417969 34.144531 33.28125 34.4375 C 33.28125 34.4375 32.757813 35.164063 31.4375 36 C 30.117188 36.835938 28.058594 37.6875 25 37.6875 C 21.941406 37.6875 19.882813 36.835938 18.5625 36 C 17.242188 35.164063 16.71875 34.4375 16.71875 34.4375 C 16.492188 34.082031 16.066406 33.90625 15.65625 34 C 15.332031 34.082031 15.070313 34.316406 14.957031 34.632813 C 14.84375 34.945313 14.894531 35.292969 15.09375 35.5625 C 15.09375 35.5625 15.863281 36.671875 17.46875 37.6875 C 19.074219 38.703125 21.558594 39.6875 25 39.6875 C 28.441406 39.6875 30.925781 38.703125 32.53125 37.6875 C 34.136719 36.671875 34.90625 35.5625 34.90625 35.5625 C 35.207031 35.273438 35.296875 34.824219 35.128906 34.441406 C 34.960938 34.058594 34.574219 33.820313 34.15625 33.84375 Z"/></svg></a><a class="VPSocialLink no-icon" href="https://discord.gg/qmk" aria-label="discord" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-discord"></span></a><a class="VPSocialLink no-icon" href="https://github.com/qmk/qmk_firmware" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6aa21345 data-v-e5dd9c1c><span class="container" data-v-e5dd9c1c><span class="top" data-v-e5dd9c1c></span><span class="middle" data-v-e5dd9c1c></span><span class="bottom" data-v-e5dd9c1c></span></span></button></div></div></div></div><div class="divider" data-v-6aa21345><div class="divider-line" data-v-6aa21345></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-5d98c3a5 data-v-a6f0e41e><div class="container" data-v-a6f0e41e><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-a6f0e41e><span class="vpi-align-left menu-icon" data-v-a6f0e41e></span><span class="menu-text" data-v-a6f0e41e>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-a6f0e41e data-v-8a42e2b4><button data-v-8a42e2b4>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-5d98c3a5 data-v-319d5ca6><div class="curtain" data-v-319d5ca6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-319d5ca6><span class="visually-hidden" id="sidebar-aria-label" data-v-319d5ca6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>Tutorial</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Introduction</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_getting_started" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_building_firmware" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Building Your First Firmware</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_flashing" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Flashing Firmware</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/support" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Getting Help/Support</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_external_userspace" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>External Userspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_learn_more_resources" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Other Resources</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/syllabus" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Syllabus</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>FAQs</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/faq_general" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>General FAQ</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/faq_build" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Build/Compile QMK</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/faq_misc" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Troubleshooting QMK</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/faq_debug" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Debugging QMK</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/faq_keymap" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Keymap FAQ</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/squeezing_avr" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Squeezing Space from AVR</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/reference_glossary" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Glossary</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>Licensing</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/license_violations" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>License Violations</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/proprietary_libs" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Proprietary Libraries</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>Configurator</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_building_firmware_configurator" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/configurator_step_by_step" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Step by Step</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/configurator_troubleshooting" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Troubleshooting</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/configurator_architecture" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Architecture</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>QMK API</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/api_overview" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/api_docs" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>API Documentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/reference_configurator_support" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Keyboard Support</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/configurator_default_keymaps" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Adding Default Keymaps</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>CLI</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/cli" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/cli_configuration" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/cli_commands" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Commands</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/cli_tab_complete" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Tab Completion</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>Using QMK</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Guides</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/custom_quantum_functions" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Customizing Functionality</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/driver_installation_zadig" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Driver Installation with Zadig</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/community_modules" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Community Modules</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/keymap" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Keymap Overview</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>Development Environments</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/getting_started_docker" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Docker Guide</p><!--]--></a><!----></div><!----></div><!--]--></div></section><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/flashing" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Flashing</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>IDEs</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/other_eclipse" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Using Eclipse with QMK</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/other_vscode" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Using VSCode with QMK</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>Git Best Practices</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_git_best_practices" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Introduction</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_git_using_your_master_branch" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Your Fork</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_git_resolving_merge_conflicts" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Merge Conflicts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/newbs_git_resynchronize_a_branch" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Fixing Your Branch</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Simple Keycodes</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/keycodes" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Full List</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/keycodes_basic" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Basic Keycodes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/reference_keymap_extras" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Language-Specific Keycodes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_advanced_keycodes" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Modifier Keys</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/quantum_keycodes" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Quantum Keycodes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/keycodes_magic" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Magic Keycodes</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Advanced Keycodes</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/command" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Command</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/dynamic_macros" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Dynamic Macros</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/grave_esc" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Grave Escape</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/leader_key" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Leader Key</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/mod_tap" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Mod-Tap</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_macros" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Macros</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/mouse_keys" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Mouse Keys</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/programmable_button" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Programmable Button</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/repeat_key" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Repeat Key</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/space_cadet" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Space Cadet Shift</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/keycodes_us_ansi_shifted" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>US ANSI Shifted Keys</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Software Features</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/auto_shift" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Auto Shift</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/autocorrect" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Autocorrect</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/caps_word" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Caps Word</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/combo" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Combos</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_debounce_type" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Debounce API</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/digitizer" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Digitizer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_eeprom" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>EEPROM</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/key_lock" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Key Lock</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/key_overrides" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Key Overrides</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_layers" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Layers</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/layer_lock" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Layer Lock</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/one_shot_keys" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>One Shot Keys</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/os_detection" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>OS Detection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/rawhid" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Raw HID</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/secure" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Secure</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/send_string" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Send String</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/sequencer" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Sequencer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/swap_hands" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Swap Hands</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/tap_dance" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Tap Dance</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/tap_hold" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Tap-Hold Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/tri_layer" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Tri Layer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/unicode" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Unicode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_userspace" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Userspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/wpm" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>WPM Calculation</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Hardware Features</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>Displays</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><section class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/quantum_painter" data-v-b3fd67f8><!--[--><h5 class="text" data-v-b3fd67f8>Quantum Painter</h5><!--]--></a><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-4 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/quantum_painter_lvgl" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Quantum Painter LVGL Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/hd44780" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>HD44780 LCD Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/st7565" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>ST7565 LCD Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/oled_driver" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>OLED Driver</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>Lighting</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/backlight" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Backlight</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/led_matrix" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>LED Matrix</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/rgblight" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>RGB Lighting</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/rgb_matrix" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>RGB Matrix</p><!--]--></a><!----></div><!----></div><!--]--></div></section><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/audio" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Audio</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/battery" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Battery</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/bootmagic" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Bootmagic</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_converters" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Converters</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/custom_matrix" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Custom Matrix</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/dip_switch" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>DIP Switch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/encoders" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Encoders</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/haptic_feedback" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Haptic Feedback</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/joystick" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Joystick</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/led_indicators" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>LED Indicators</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/midi" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>MIDI</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/pointing_device" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Pointing Device</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/ps2_mouse" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>PS/2 Mouse</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/split_keyboard" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Split Keyboard</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/stenography" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Stenography</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/features/wireless" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Wireless</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Keyboard Building</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/easy_maker" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Easy Maker for One Offs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/porting_your_keyboard_to_qmk" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Porting Keyboards</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/hand_wire" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Hand Wiring Guide</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/isp_flashing_guide" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>ISP Flashing Guide</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>Developing QMK</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/pr_checklist" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>PR Checklist</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Breaking Changes</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/breaking_changes" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/breaking_changes_instructions" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>My Pull Request Was Flagged</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/ChangeLog/20260531" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Most Recent ChangeLog</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/breaking_changes_history" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Past Breaking Changes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/support_deprecation_policy" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Deprecation Policy</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>C Development</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/arm_debugging" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>ARM Debugging Guide</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/coding_conventions_c" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Coding Conventions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/compatible_microcontrollers" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Compatible Microcontrollers</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/hardware_drivers" data-v-b3fd67f8><!--[--><h4 class="text" data-v-b3fd67f8>Drivers</h4><!--]--></a><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/adc" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>ADC Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/apa102" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>APA102 Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/audio" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Audio Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/battery" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Battery Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/eeprom" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>EEPROM Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/flash" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Flash Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/i2c" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>I2C Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/serial" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>'serial' Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/spi" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>SPI Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/uart" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>UART Driver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/ws2812" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>WS2812 Driver</p><!--]--></a><!----></div><!----></div><!--]--></div></section><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/drivers/gpio" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>GPIO Controls</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/hardware_keyboard_guidelines" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Keyboard Guidelines</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Python Development</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/coding_conventions_python" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Coding Conventions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/cli_development" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>QMK CLI Development</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Configurator Development</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>QMK API</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/api_development_environment" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Development Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/api_development_overview" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Architecture Overview</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>Hardware Platform Development</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><section class="VPSidebarItem level-2" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h4 class="text" data-v-b3fd67f8>Arm/ChibiOS</h4><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/platformdev_selecting_arm_mcu" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Selecting an MCU</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/platformdev_chibios_earlyinit" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Early initialization</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/platformdev_rp2040" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Raspberry Pi RP2040</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/platformdev_proton_c" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Proton C</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-3 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/platformdev_blackpill_f4x1" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>WeAct Blackpill F4x1</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>QMK Reference</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/contributing" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Contributing to QMK</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/config_options" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Config Options</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/data_driven_config" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Data Driven Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/getting_started_make_guide" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Make Documentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/documentation_best_practices" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Documentation Best Practices</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/documentation_templates" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Documentation Templates</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/feature_layouts" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Community Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/unit_testing" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Unit Testing</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/ref_functions" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Useful Functions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/reference_info_json" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>info.json Format</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h3 class="text" data-v-b3fd67f8>For a Deeper Understanding</h3><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/how_keyboards_work" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>How Keyboards Work</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/how_a_matrix_works" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>How a Matrix Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/understanding_qmk" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>Understanding QMK</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-5d98c3a5 data-v-1428d186><div class="VPDoc has-sidebar has-aside" data-v-1428d186 data-v-39a288b8><!--[--><!--]--><div class="container" data-v-39a288b8><div class="aside" data-v-39a288b8><div class="aside-curtain" data-v-39a288b8></div><div class="aside-container" data-v-39a288b8><div class="aside-content" data-v-39a288b8><div class="VPDocAside" data-v-39a288b8 data-v-3f215769><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-3f215769 data-v-a5bbad30><div class="content" data-v-a5bbad30><div class="outline-marker" data-v-a5bbad30></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-a5bbad30>On this page</div><ul class="VPDocOutlineItem root" data-v-a5bbad30 data-v-b933a997><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-3f215769></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-39a288b8><div class="content-container" data-v-39a288b8><!--[--><!--]--><main class="main" data-v-39a288b8><div style="position:relative;" class="vp-doc _ChangeLog_20210529 external-link-icon-enabled" data-v-39a288b8><div><h1 id="qmk-breaking-changes-2021-may-29-changelog" tabindex="-1">QMK Breaking Changes - 2021 May 29 Changelog <a class="header-anchor" href="#qmk-breaking-changes-2021-may-29-changelog" aria-label="Permalink to &quot;QMK Breaking Changes - 2021 May 29 Changelog&quot;">​</a></h1><h2 id="notable-changes" tabindex="-1">Notable Changes <a class="header-anchor" href="#notable-changes" aria-label="Permalink to &quot;Notable Changes {#notable-changes}&quot;">​</a></h2><h3 id="rgb-matrix-split-common" tabindex="-1">RGB Matrix support for split common (<a href="https://github.com/qmk/qmk_firmware/pull/11055" target="_blank" rel="noreferrer">#11055</a>) <a class="header-anchor" href="#rgb-matrix-split-common" aria-label="Permalink to &quot;RGB Matrix support for split common ([#11055](https://github.com/qmk/qmk_firmware/pull/11055)) {#rgb-matrix-split-common}&quot;">​</a></h3><p>Split boards can now use RGB Matrix without defining a custom matrix.</p><h3 id="teensy-3-6-support" tabindex="-1">Teensy 3.6 support (<a href="https://github.com/qmk/qmk_firmware/pull/12258" target="_blank" rel="noreferrer">#12258</a>) <a class="header-anchor" href="#teensy-3-6-support" aria-label="Permalink to &quot;Teensy 3.6 support ([#12258](https://github.com/qmk/qmk_firmware/pull/12258)) {#teensy-3-6-support}&quot;">​</a></h3><p>Added support for MK66F18 (Teensy 3.6) microcontroller.</p><h3 id="new-command-qmk-console" tabindex="-1">New command: qmk console (<a href="https://github.com/qmk/qmk_firmware/pull/12828" target="_blank" rel="noreferrer">#12828</a>) <a class="header-anchor" href="#new-command-qmk-console" aria-label="Permalink to &quot;New command: qmk console ([#12828](https://github.com/qmk/qmk_firmware/pull/12828)) {#new-command-qmk-console}&quot;">​</a></h3><p>A new <code>qmk console</code> command has been added for attaching to your keyboard&#39;s console. It operates similarly to QMK Toolbox by allowing you to connect to one or more keyboard consoles to display debugging messages.</p><h3 id="improve-command-qmk-config" tabindex="-1">Improved command: qmk config <a class="header-anchor" href="#improve-command-qmk-config" aria-label="Permalink to &quot;Improved command: qmk config {#improve-command-qmk-config}&quot;">​</a></h3><p>We&#39;ve updated the <code>qmk config</code> command to show only the configuration items you have actually set. You can now display (almost) all of the available configuration options, along with their default values, using <code>qmk config -a</code>.</p><h3 id="led-matrix-improvements" tabindex="-1">LED Matrix Improvements (<a href="https://github.com/qmk/qmk_firmware/pull/12509" target="_blank" rel="noreferrer">#12509</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12580" target="_blank" rel="noreferrer">#12580</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12588" target="_blank" rel="noreferrer">#12588</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12633" target="_blank" rel="noreferrer">#12633</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12651" target="_blank" rel="noreferrer">#12651</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12685" target="_blank" rel="noreferrer">#12685</a>) <a class="header-anchor" href="#led-matrix-improvements" aria-label="Permalink to &quot;LED Matrix Improvements ([#12509](https://github.com/qmk/qmk_firmware/pull/12509), [#12580](https://github.com/qmk/qmk_firmware/pull/12580), [#12588](https://github.com/qmk/qmk_firmware/pull/12588), [#12633](https://github.com/qmk/qmk_firmware/pull/12633), [#12651](https://github.com/qmk/qmk_firmware/pull/12651), [#12685](https://github.com/qmk/qmk_firmware/pull/12685)) {#led-matrix-improvements}&quot;">​</a></h3><p>LED Matrix has been improved with effects, CIE1931 curves, and a task system.</p><h2 id="changes-requiring-user-action" tabindex="-1">Changes Requiring User Action <a class="header-anchor" href="#changes-requiring-user-action" aria-label="Permalink to &quot;Changes Requiring User Action {#changes-requiring-user-action}&quot;">​</a></h2><h3 id="updated-keyboard-codebases" tabindex="-1">Updated Keyboard Codebases <a class="header-anchor" href="#updated-keyboard-codebases" aria-label="Permalink to &quot;Updated Keyboard Codebases {#updated-keyboard-codebases}&quot;">​</a></h3><ul><li>Durgod keyboard refactor in preparation for adding additional durgod keyboards (<a href="https://github.com/qmk/qmk_firmware/pull/11978" target="_blank" rel="noreferrer">#11978</a>)</li><li>Updated Function96 with V2 files and removed chconf.h and halconf.h (<a href="https://github.com/qmk/qmk_firmware/pull/12613" target="_blank" rel="noreferrer">#12613</a>)</li><li>[Keyboard] updated a vendor name / fixed minor keymap issues (<a href="https://github.com/qmk/qmk_firmware/pull/12881" target="_blank" rel="noreferrer">#12881</a>)</li><li>[Keyboard] Corne - Remove legacy revision support (<a href="https://github.com/qmk/qmk_firmware/pull/12226" target="_blank" rel="noreferrer">#12226</a>)</li></ul><p>The following keyboards have had their source moved within QMK:</p><table tabindex="0"><thead><tr><th style="text-align:left;">Old Keyboard Name</th><th style="text-align:left;">New Keyboard Name</th></tr></thead><tbody><tr><td style="text-align:left;">crkbd/rev1/common</td><td style="text-align:left;">crkbd/rev1</td></tr><tr><td style="text-align:left;">function96</td><td style="text-align:left;">function96/v1</td></tr><tr><td style="text-align:left;">nckiibs/flatbread60</td><td style="text-align:left;">delikeeb/flatbread60</td></tr><tr><td style="text-align:left;">nckiibs/vaguettelite</td><td style="text-align:left;">delikeeb/vaguettelite</td></tr><tr><td style="text-align:left;">nckiibs/vanana/rev1</td><td style="text-align:left;">delikeeb/vanana/rev1</td></tr><tr><td style="text-align:left;">nckiibs/vanana/rev2</td><td style="text-align:left;">delikeeb/vanana/rev2</td></tr><tr><td style="text-align:left;">nckiibs/vaneela</td><td style="text-align:left;">delikeeb/vaneela</td></tr><tr><td style="text-align:left;">nckiibs/vaneelaex</td><td style="text-align:left;">delikeeb/vaneelaex</td></tr><tr><td style="text-align:left;">nckiibs/waaffle/rev3/elite_c</td><td style="text-align:left;">delikeeb/waaffle/rev3/elite_c</td></tr><tr><td style="text-align:left;">nckiibs/waaffle/rev3/pro_micro</td><td style="text-align:left;">delikeeb/waaffle/rev3/pro_micro</td></tr></tbody></table><p>The <a href="https://github.com/qmk/qmk_firmware/tree/0.13.0/keyboards/function96/v2" target="_blank" rel="noreferrer">Function96 V2</a> has also been added as part of these changes.</p><p>The codebase for the <a href="https://github.com/qmk/qmk_firmware/tree/0.13.0/keyboards/durgod/k320" target="_blank" rel="noreferrer">Durgod K320</a> has been reworked in anticipation of additional Durgod keyboards gaining QMK support.</p><p>Additionally, the <code>crkbd/rev1/legacy</code> keyboard has been removed.</p><h3 id="bootmagic-deprecation-and-refactor" tabindex="-1">Bootmagic Deprecation and Refactor (<a href="https://github.com/qmk/qmk_firmware/pull/12172" target="_blank" rel="noreferrer">#12172</a>) <a class="header-anchor" href="#bootmagic-deprecation-and-refactor" aria-label="Permalink to &quot;Bootmagic Deprecation and Refactor ([#12172](https://github.com/qmk/qmk_firmware/pull/12172)) {#bootmagic-deprecation-and-refactor}&quot;">​</a></h3><p>QMK has decided to deprecate the full Bootmagic feature and leave Bootmagic Lite as the only remaining option.</p><p>This pull request changes the behavior of <code>BOOTMAGIC_ENABLE</code> such that specifying <code>BOOTMAGIC_ENABLE = yes</code> enables Bootmagic Lite instead of full Bootmagic.</p><p>If attempts to use Bootmagic functionality result in unexpected behavior, check your <code>rules.mk</code> file and change the <code>BOOTMAGIC_ENABLE</code> setting to specify either <code>lite</code> or <code>full</code>.</p><h4 id="tentative-deprecation-schedule" tabindex="-1">Tentative Deprecation Schedule <a class="header-anchor" href="#tentative-deprecation-schedule" aria-label="Permalink to &quot;Tentative Deprecation Schedule&quot;">​</a></h4><p>This is the current planned roadmap for the behavior of <code>BOOTMAGIC_ENABLE</code>:</p><ul><li>From 2021 May 29, setting <code>BOOTMAGIC_ENABLE = yes</code> will enable Bootmagic Lite instead of full Bootmagic.</li><li>From 2021 Aug 28, <code>BOOTMAGIC_ENABLE</code> must be either <code>yes</code>, <code>lite</code>, or <code>no</code> – setting <code>BOOTMAGIC_ENABLE = full</code> will cause compilation to fail.</li><li>From 2021 Nov 27, <code>BOOTMAGIC_ENABLE</code> must be either <code>yes</code> or <code>no</code> – setting <code>BOOTMAGIC_ENABLE = lite</code> will cause compilation to fail.</li></ul><h3 id="removal-of-layout-kc" tabindex="-1">Removal of LAYOUT_kc (<a href="https://github.com/qmk/qmk_firmware/pull/12160" target="_blank" rel="noreferrer">#12160</a>) <a class="header-anchor" href="#removal-of-layout-kc" aria-label="Permalink to &quot;Removal of LAYOUT_kc ([#12160](https://github.com/qmk/qmk_firmware/pull/12160)) {#removal-of-layout-kc}&quot;">​</a></h3><p>We&#39;ve removed support for <code>LAYOUT_kc</code> macros, if your keymap uses one you will need to update it use a regular <code>LAYOUT</code> macro.</p><h3 id="encoder-callback-boolean" tabindex="-1">Encoder callbacks are now boolean (<a href="https://github.com/qmk/qmk_firmware/pull/12805" target="_blank" rel="noreferrer">#12805</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12985" target="_blank" rel="noreferrer">#12985</a>) <a class="header-anchor" href="#encoder-callback-boolean" aria-label="Permalink to &quot;Encoder callbacks are now boolean ([#12805](https://github.com/qmk/qmk_firmware/pull/12805), [#12985](https://github.com/qmk/qmk_firmware/pull/12985)) {#encoder-callback-boolean}&quot;">​</a></h3><p>To allow for keyboards to override (or not) keymap level code the <code>encoder_update_kb</code> function has been changed from <code>void</code> to <code>bool</code>. You will need to update your function definition to reflect this and ensure that you return a <code>true</code> or <code>false</code> value.</p><p>Example code before change:</p><div class="language-c vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">c</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">void</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_kb</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint8_t</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> index</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> clockwise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
  21. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_user</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(index, clockwise);</span></span>
  22. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
  23. <span class="line"></span>
  24. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">void</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_user</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint8_t</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> index</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> clockwise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
  25. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (index </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* First encoder */</span></span>
  26. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (clockwise) {</span></span>
  27. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_PGDN);</span></span>
  28. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
  29. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_PGUP);</span></span>
  30. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  31. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (index </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* Second encoder */</span></span>
  32. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (clockwise) {</span></span>
  33. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_DOWN);</span></span>
  34. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
  35. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_UP);</span></span>
  36. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  37. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  38. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>Example code after change:</p><div class="language-c vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">c</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_kb</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint8_t</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> index</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> clockwise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
  39. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_user</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(index, clockwise);</span></span>
  40. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
  41. <span class="line"></span>
  42. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> encoder_update_user</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">uint8_t</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> index</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">bool</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> clockwise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
  43. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (index </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* First encoder */</span></span>
  44. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (clockwise) {</span></span>
  45. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_PGDN);</span></span>
  46. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
  47. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_PGUP);</span></span>
  48. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  49. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (index </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* Second encoder */</span></span>
  50. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (clockwise) {</span></span>
  51. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_DOWN);</span></span>
  52. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">else</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
  53. <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tap_code</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(KC_UP);</span></span>
  54. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  55. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
  56. <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
  57. <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // If you return true, this will allow the keyboard level code to run, as well.</span></span>
  58. <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> //Returning false will override the keyboard level code. Depending on how the keyboard level function is set up.</span></span>
  59. <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="core-changes" tabindex="-1">Core Changes <a class="header-anchor" href="#core-changes" aria-label="Permalink to &quot;Core Changes {#core-changes}&quot;">​</a></h2><h3 id="core-fixes" tabindex="-1">Fixes <a class="header-anchor" href="#core-fixes" aria-label="Permalink to &quot;Fixes {#core-fixes}&quot;">​</a></h3><ul><li>Fix connection issue in split keyboards when slave and OLED display are connected via I2C (fixes #9335) (<a href="https://github.com/qmk/qmk_firmware/pull/11487" target="_blank" rel="noreferrer">#11487</a>)</li><li>Terrazzo: Fix wrong LED Matrix function names (<a href="https://github.com/qmk/qmk_firmware/pull/12561" target="_blank" rel="noreferrer">#12561</a>)</li><li>Apply the &quot;NO_LIMITED_CONTROLLER_CONNECT&quot; fix to atmega16u2 (<a href="https://github.com/qmk/qmk_firmware/pull/12482" target="_blank" rel="noreferrer">#12482</a>)</li><li>Fix comment parsing (<a href="https://github.com/qmk/qmk_firmware/pull/12750" target="_blank" rel="noreferrer">#12750</a>)</li><li>Turn OLED off on suspend in soundmonster Corne keymap (<a href="https://github.com/qmk/qmk_firmware/pull/10419" target="_blank" rel="noreferrer">#10419</a>)</li><li>Fixup build errors on <code>develop</code> branch. (<a href="https://github.com/qmk/qmk_firmware/pull/12723" target="_blank" rel="noreferrer">#12723</a>)</li><li>Fix syntax error when compiling for ARM (<a href="https://github.com/qmk/qmk_firmware/pull/12866" target="_blank" rel="noreferrer">#12866</a>)</li><li>Add missing LED Matrix suspend code to suspend.c (<a href="https://github.com/qmk/qmk_firmware/pull/12878" target="_blank" rel="noreferrer">#12878</a>)</li><li>Fix spelling mistake regarding LED Matrix in split_common. (<a href="https://github.com/qmk/qmk_firmware/pull/12888" target="_blank" rel="noreferrer">#12888</a>)</li><li>[Keymap] Fix QWERTY/DVORAK status output for kzar keymap (<a href="https://github.com/qmk/qmk_firmware/pull/12895" target="_blank" rel="noreferrer">#12895</a>)</li><li>Fixup housekeeping from being invoked twice per loop. (<a href="https://github.com/qmk/qmk_firmware/pull/12933" target="_blank" rel="noreferrer">#12933</a>)</li><li>wait for matrix row signal to go HIGH for every row (<a href="https://github.com/qmk/qmk_firmware/pull/12945" target="_blank" rel="noreferrer">#12945</a>)</li><li>ensure we do not conflict with existing keymap aliases (<a href="https://github.com/qmk/qmk_firmware/pull/12976" target="_blank" rel="noreferrer">#12976</a>)</li><li>[Keyboard] Fix Terrazzo build failure (<a href="https://github.com/qmk/qmk_firmware/pull/12977" target="_blank" rel="noreferrer">#12977</a>)</li><li>Do not hard set config in CPTC files (<a href="https://github.com/qmk/qmk_firmware/pull/11864" target="_blank" rel="noreferrer">#11864</a>)</li></ul><h3 id="core-additions" tabindex="-1">Additions and Enhancements <a class="header-anchor" href="#core-additions" aria-label="Permalink to &quot;Additions and Enhancements {#core-additions}&quot;">​</a></h3><ul><li>ARM - Refactor SLEEP_LED to support more platforms (<a href="https://github.com/qmk/qmk_firmware/pull/8403" target="_blank" rel="noreferrer">#8403</a>)</li><li>Add ability to toggle One Shot functionality (<a href="https://github.com/qmk/qmk_firmware/pull/4198" target="_blank" rel="noreferrer">#4198</a>)</li><li>Add RGB Matrix support to Split Common (<a href="https://github.com/qmk/qmk_firmware/pull/11055" target="_blank" rel="noreferrer">#11055</a>)</li><li>Add support for complementary outputs to the ChibiOS WS2812 PWM driver (<a href="https://github.com/qmk/qmk_firmware/pull/11988" target="_blank" rel="noreferrer">#11988</a>)</li><li>Enable RGB Matrix for Corne (<a href="https://github.com/qmk/qmk_firmware/pull/12091" target="_blank" rel="noreferrer">#12091</a>)</li><li>Set default OLED Update Interval for Split Keyboards to improve matrix scan performance (<a href="https://github.com/qmk/qmk_firmware/pull/12107" target="_blank" rel="noreferrer">#12107</a>)</li><li>Add support for MK66F18 (Teensy 3.6) micro controller (<a href="https://github.com/qmk/qmk_firmware/pull/12258" target="_blank" rel="noreferrer">#12258</a>)</li><li>Split RGB Matrix support for RGBKB Zygomorph (<a href="https://github.com/qmk/qmk_firmware/pull/11083" target="_blank" rel="noreferrer">#11083</a>)</li><li>Add baudrate and circular buffer to ARM WS2812 SPI config (<a href="https://github.com/qmk/qmk_firmware/pull/12216" target="_blank" rel="noreferrer">#12216</a>)</li><li>Add keyboard level weak function for slave matrix scan (<a href="https://github.com/qmk/qmk_firmware/pull/12317" target="_blank" rel="noreferrer">#12317</a>)</li><li>Add link to schematic on EasyEDA for XD60 (<a href="https://github.com/qmk/qmk_firmware/pull/12018" target="_blank" rel="noreferrer">#12018</a>)</li><li>Add Config functions for LED Matrix (<a href="https://github.com/qmk/qmk_firmware/pull/12361" target="_blank" rel="noreferrer">#12361</a>)</li><li>Add pin definitions for MK66F18 (<a href="https://github.com/qmk/qmk_firmware/pull/12419" target="_blank" rel="noreferrer">#12419</a>)</li><li>add kinesis/kint36 keyboard (<a href="https://github.com/qmk/qmk_firmware/pull/10171" target="_blank" rel="noreferrer">#10171</a>)</li><li>Add support for producing UF2-format binaries. (<a href="https://github.com/qmk/qmk_firmware/pull/12435" target="_blank" rel="noreferrer">#12435</a>)</li><li>Implement CIE1931 curve for LED Matrix (<a href="https://github.com/qmk/qmk_firmware/pull/12417" target="_blank" rel="noreferrer">#12417</a>)</li><li>Change <code>BOOTMAGIC_ENABLE=yes</code> to use Bootmagic Lite (<a href="https://github.com/qmk/qmk_firmware/pull/12172" target="_blank" rel="noreferrer">#12172</a>)</li><li>Add kzar keymap for Kinesis Advantage (<a href="https://github.com/qmk/qmk_firmware/pull/12444" target="_blank" rel="noreferrer">#12444</a>)</li><li>LED Matrix: suspend code (<a href="https://github.com/qmk/qmk_firmware/pull/12509" target="_blank" rel="noreferrer">#12509</a>)</li><li>LED Matrix: Task system (<a href="https://github.com/qmk/qmk_firmware/pull/12580" target="_blank" rel="noreferrer">#12580</a>)</li><li>Add missing RGB_MODE_TWINKLE / RGB_M_TW keycodes (<a href="https://github.com/qmk/qmk_firmware/pull/11935" target="_blank" rel="noreferrer">#11935</a>)</li><li>Enhancement of WPM feature (<a href="https://github.com/qmk/qmk_firmware/pull/11727" target="_blank" rel="noreferrer">#11727</a>)</li><li>Add Per Key functionality for AutoShift (<a href="https://github.com/qmk/qmk_firmware/pull/11536" target="_blank" rel="noreferrer">#11536</a>)</li><li>LED Matrix: Reactive effect buffers &amp; advanced indicators (<a href="https://github.com/qmk/qmk_firmware/pull/12588" target="_blank" rel="noreferrer">#12588</a>)</li><li>LED Matrix: support for Split keyboards (<a href="https://github.com/qmk/qmk_firmware/pull/12633" target="_blank" rel="noreferrer">#12633</a>)</li><li>add setting to enable infinite timeout for leader key (<a href="https://github.com/qmk/qmk_firmware/pull/6580" target="_blank" rel="noreferrer">#6580</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12721" title="Fix bad PR merge for #6580" target="_blank" rel="noreferrer">#12721</a>)</li><li>Update ADC driver for STM32F1xx, STM32F3xx, STM32F4xx (<a href="https://github.com/qmk/qmk_firmware/pull/12403" target="_blank" rel="noreferrer">#12403</a>)</li><li>Add initial support for tinyuf2 bootloader (when hosted on F411 blackpill) (<a href="https://github.com/qmk/qmk_firmware/pull/12600" target="_blank" rel="noreferrer">#12600</a>)</li><li>Add support for STM32F446 MCU (<a href="https://github.com/qmk/qmk_firmware/pull/12619" target="_blank" rel="noreferrer">#12619</a>)</li><li>Add STM32L433 and L443 support (<a href="https://github.com/qmk/qmk_firmware/pull/12063" target="_blank" rel="noreferrer">#12063</a>)</li><li>Added OLED fade out support (<a href="https://github.com/qmk/qmk_firmware/pull/12086" target="_blank" rel="noreferrer">#12086</a>)</li><li>New command: <code>qmk console</code> (<a href="https://github.com/qmk/qmk_firmware/pull/12828" target="_blank" rel="noreferrer">#12828</a>)</li><li>LED Matrix: Effects! (<a href="https://github.com/qmk/qmk_firmware/pull/12651" target="_blank" rel="noreferrer">#12651</a>)</li><li>Add setup, clone, and env to the list of commands we allow even with broken modules (<a href="https://github.com/qmk/qmk_firmware/pull/12868" target="_blank" rel="noreferrer">#12868</a>)</li><li>LED Matrix: Documentation (<a href="https://github.com/qmk/qmk_firmware/pull/12685" target="_blank" rel="noreferrer">#12685</a>)</li><li>Add function to allow repeated blinking of one layer (<a href="https://github.com/qmk/qmk_firmware/pull/12237" target="_blank" rel="noreferrer">#12237</a>)</li><li>Add support for up to 4 IS31FL3733 drivers (<a href="https://github.com/qmk/qmk_firmware/pull/12342" target="_blank" rel="noreferrer">#12342</a>)</li><li>Convert Encoder callbacks to be boolean functions (<a href="https://github.com/qmk/qmk_firmware/pull/12805" target="_blank" rel="noreferrer">#12805</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12985" target="_blank" rel="noreferrer">#12985</a>)</li><li>[Keymap] Update to Drashna keymap and user code (based on develop) (<a href="https://github.com/qmk/qmk_firmware/pull/12936" target="_blank" rel="noreferrer">#12936</a>)</li><li>Add Full-duplex serial driver for ARM boards (<a href="https://github.com/qmk/qmk_firmware/pull/9842" target="_blank" rel="noreferrer">#9842</a>)</li><li>Document LED_MATRIX_FRAMEBUFFER_EFFECTS (<a href="https://github.com/qmk/qmk_firmware/pull/12987" target="_blank" rel="noreferrer">#12987</a>)</li><li>Backlight: add defines for default level and breathing state (<a href="https://github.com/qmk/qmk_firmware/pull/12560" target="_blank" rel="noreferrer">#12560</a>, <a href="https://github.com/qmk/qmk_firmware/pull/13024" target="_blank" rel="noreferrer">#13024</a>)</li><li>Add dire message about LUFA mass storage bootloader (<a href="https://github.com/qmk/qmk_firmware/pull/13014" target="_blank" rel="noreferrer">#13014</a>)</li></ul><h3 id="core-optimizations" tabindex="-1">Clean-ups and Optimizations <a class="header-anchor" href="#core-optimizations" aria-label="Permalink to &quot;Clean-ups and Optimizations {#core-optimizations}&quot;">​</a></h3><ul><li>Overhaul bootmagic logic to have single entrypoint (<a href="https://github.com/qmk/qmk_firmware/pull/8532" target="_blank" rel="noreferrer">#8532</a>)</li><li>Refactor of USB code within split_common (<a href="https://github.com/qmk/qmk_firmware/pull/11890" target="_blank" rel="noreferrer">#11890</a>)</li><li>Begin the process of deprecating <code>bin/qmk</code> in favor of the global CLI (<a href="https://github.com/qmk/qmk_firmware/pull/12109" target="_blank" rel="noreferrer">#12109</a>)</li><li>LED Matrix: decouple from Backlight (<a href="https://github.com/qmk/qmk_firmware/pull/12054" target="_blank" rel="noreferrer">#12054</a>)</li><li>Remove <code>FUNC()</code> (<a href="https://github.com/qmk/qmk_firmware/pull/12161" target="_blank" rel="noreferrer">#12161</a>)</li><li>Move gpio wait logic to wait.h (<a href="https://github.com/qmk/qmk_firmware/pull/12067" target="_blank" rel="noreferrer">#12067</a>)</li><li>LED Matrix: Clean up includes (<a href="https://github.com/qmk/qmk_firmware/pull/12197" target="_blank" rel="noreferrer">#12197</a>)</li><li>Consistently use bin/qmk when that script is called (<a href="https://github.com/qmk/qmk_firmware/pull/12286" target="_blank" rel="noreferrer">#12286</a>)</li><li>LED Matrix: Additional common_features.mk tweaks (<a href="https://github.com/qmk/qmk_firmware/pull/12187" target="_blank" rel="noreferrer">#12187</a>)</li><li>LED Matrix: Fix up eeconfig code (<a href="https://github.com/qmk/qmk_firmware/pull/12327" target="_blank" rel="noreferrer">#12327</a>)</li><li>Big quantum_keycodes cleanup (<a href="https://github.com/qmk/qmk_firmware/pull/12249" target="_blank" rel="noreferrer">#12249</a>)</li><li>Fix up builds that are now too big for <code>develop</code> branch. (<a href="https://github.com/qmk/qmk_firmware/pull/12495" target="_blank" rel="noreferrer">#12495</a>)</li><li>[Keyboard] kint36: switch to sym_eager_pk debouncing (<a href="https://github.com/qmk/qmk_firmware/pull/12626" target="_blank" rel="noreferrer">#12626</a>)</li><li>[Keyboard] kint2pp: reduce input latency by ≈10ms (<a href="https://github.com/qmk/qmk_firmware/pull/12625" target="_blank" rel="noreferrer">#12625</a>)</li><li>eeprom driver: Refactor where eeprom driver initialisation (and EEPROM emulation initialisation) occurs to make it non-target-specific. (<a href="https://github.com/qmk/qmk_firmware/pull/12671" target="_blank" rel="noreferrer">#12671</a>)</li><li>Change RGB/LED Matrix to use a simple define for USB suspend (<a href="https://github.com/qmk/qmk_firmware/pull/12697" target="_blank" rel="noreferrer">#12697</a>, <a href="https://github.com/qmk/qmk_firmware/pull/12770" title="Fixing transport&#39;s led/rgb matrix suspend state logic" target="_blank" rel="noreferrer">#12770</a>)</li><li>Remove pointless SERIAL_LINK_ENABLE rules (<a href="https://github.com/qmk/qmk_firmware/pull/12846" target="_blank" rel="noreferrer">#12846</a>)</li><li>Make Swap Hands use PROGMEM (<a href="https://github.com/qmk/qmk_firmware/pull/12284" target="_blank" rel="noreferrer">#12284</a>)</li><li>Remove KEYMAP and LAYOUT_kc (<a href="https://github.com/qmk/qmk_firmware/pull/12160" target="_blank" rel="noreferrer">#12160</a>)</li><li>Rename <code>point_t</code> -&gt; <code>led_point_t</code> (<a href="https://github.com/qmk/qmk_firmware/pull/12864" target="_blank" rel="noreferrer">#12864</a>)</li><li>Deprecate <code>send_unicode_hex_string()</code> (<a href="https://github.com/qmk/qmk_firmware/pull/12602" target="_blank" rel="noreferrer">#12602</a>)</li><li>[Keyboard] Remove redundant legacy and common headers for crkbd (<a href="https://github.com/qmk/qmk_firmware/pull/13023" target="_blank" rel="noreferrer">#13023</a>)</li></ul><h3 id="qmk-internals" tabindex="-1">QMK Infrastructure and Internals <a class="header-anchor" href="#qmk-internals" aria-label="Permalink to &quot;QMK Infrastructure and Internals {#qmk-internals}&quot;">​</a></h3><ul><li>trivial change to trigger api update (<a href="https://github.com/qmk/qmk_firmware/commit/b15288fb87" target="_blank" rel="noreferrer"><code>b15288fb87</code></a>)</li><li>fix some references to bin/qmk that slipped in (<a href="https://github.com/qmk/qmk_firmware/pull/12832" target="_blank" rel="noreferrer">#12832</a>)</li><li>Resolve a number of warnings in <code>qmk generate-api</code> (<a href="https://github.com/qmk/qmk_firmware/pull/12833" target="_blank" rel="noreferrer">#12833</a>)</li><li>Fix another bin/qmk reference (<a href="https://github.com/qmk/qmk_firmware/pull/12856" target="_blank" rel="noreferrer">#12856</a>)</li><li>Use milc.subcommand.config instead of qmk.cli.config (<a href="https://github.com/qmk/qmk_firmware/pull/12915" target="_blank" rel="noreferrer">#12915</a>)</li></ul></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/qmk/qmk_firmware/edit/master/docs/ChangeLog/20210529.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> Edit this page<!--]--></a></div><!----></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/newbs" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>Introduction</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
  60. <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_development_environment.md\":\"wNYXToe7\",\"api_development_overview.md\":\"CzbJJDNw\",\"api_docs.md\":\"C2yn8IjW\",\"api_overview.md\":\"DkBx64VD\",\"arm_debugging.md\":\"BVKHYCY3\",\"breaking_changes.md\":\"BJZxbNQ8\",\"breaking_changes_history.md\":\"CE5EMOAr\",\"breaking_changes_instructions.md\":\"YfjQwyDT\",\"capabilities.md\":\"B8T3JCyt\",\"capabilities_inc.md\":\"Sa8st2B_\",\"changelog_20190830.md\":\"CBfckQOX\",\"changelog_20200229.md\":\"DiinV84l\",\"changelog_20200530.md\":\"BH8FWHkm\",\"changelog_20200829.md\":\"DznAG4nm\",\"changelog_20201128.md\":\"-2Dfbq7k\",\"changelog_20210227.md\":\"vgsezX7T\",\"changelog_20210529.md\":\"CWpDbllD\",\"changelog_20210828.md\":\"X4_BluTJ\",\"changelog_20211127.md\":\"B9B6h84a\",\"changelog_20220226.md\":\"DIw57r5h\",\"changelog_20220528.md\":\"Aq5MEXya\",\"changelog_20220827.md\":\"Cr63IlPG\",\"changelog_20221126.md\":\"C2ha4Hg9\",\"changelog_20230226.md\":\"De4T2dUZ\",\"changelog_20230528.md\":\"BacADocV\",\"changelog_20230827.md\":\"Ccy4AdJq\",\"changelog_20231126.md\":\"Q4Va56-o\",\"changelog_20240225.md\":\"DSuQVEc0\",\"changelog_20240526.md\":\"ElUUrYcx\",\"changelog_20240825.md\":\"N1RvMy9r\",\"changelog_20241124.md\":\"Dy8bwJzG\",\"changelog_20250223.md\":\"B72dUS3J\",\"changelog_20250525.md\":\"a1xu4dA3\",\"changelog_20250831.md\":\"BO33XxfI\",\"changelog_20251130.md\":\"DtPMFMHL\",\"changelog_20260222.md\":\"CATMKVaN\",\"changelog_20260531.md\":\"DHtZDh3f\",\"chibios_upgrade_instructions.md\":\"CtaRRXpJ\",\"cli.md\":\"BSe0mfRY\",\"cli_commands.md\":\"CgJfYMV3\",\"cli_configuration.md\":\"BKXYakFu\",\"cli_development.md\":\"BBW4icmD\",\"cli_tab_complete.md\":\"CnVMEiZf\",\"coding_conventions_c.md\":\"CLEvGoZQ\",\"coding_conventions_python.md\":\"C39VQP0z\",\"compatible_microcontrollers.md\":\"DWG8qdEA\",\"config_options.md\":\"BvppuDuW\",\"configurator_architecture.md\":\"oiNBnJec\",\"configurator_default_keymaps.md\":\"DnKCtKHc\",\"configurator_step_by_step.md\":\"DDwpDY58\",\"configurator_troubleshooting.md\":\"C2ghw8vC\",\"contributing.md\":\"BchykJ1W\",\"custom_matrix.md\":\"BpQrge8p\",\"custom_quantum_functions.md\":\"DlfwiyHe\",\"data_driven_config.md\":\"CnG_3O32\",\"documentation_best_practices.md\":\"CywuRS8R\",\"documentation_templates.md\":\"8Tmv7rFN\",\"driver_installation_zadig.md\":\"Dopii2Qg\",\"drivers_adc.md\":\"4lcxwuNF\",\"drivers_apa102.md\":\"BoVkQMrw\",\"drivers_audio.md\":\"vEWzc-nE\",\"drivers_aw20216s.md\":\"DmQVa7iu\",\"drivers_battery.md\":\"4AI78ASf\",\"drivers_eeprom.md\":\"BlurGiKn\",\"drivers_flash.md\":\"DaShF64Z\",\"drivers_gpio.md\":\"frhwWZT1\",\"drivers_i2c.md\":\"C32oejbt\",\"drivers_is31fl3218.md\":\"Boj71vTc\",\"drivers_is31fl3236.md\":\"CItbpifZ\",\"drivers_is31fl3729.md\":\"mDVSZ3C7\",\"drivers_is31fl3731.md\":\"CxEgviPy\",\"drivers_is31fl3733.md\":\"B-6AcIwY\",\"drivers_is31fl3736.md\":\"GDTnntSt\",\"drivers_is31fl3737.md\":\"D-aRCkbW\",\"drivers_is31fl3741.md\":\"Dlb-h25I\",\"drivers_is31fl3742a.md\":\"Cj8IJj4G\",\"drivers_is31fl3743a.md\":\"BiLEsQ8L\",\"drivers_is31fl3745.md\":\"Bs5pX8zD\",\"drivers_is31fl3746a.md\":\"r4Yz0yI2\",\"drivers_serial.md\":\"BaT67xXa\",\"drivers_snled27351.md\":\"BZ-74IBQ\",\"drivers_spi.md\":\"B4YX8ACu\",\"drivers_uart.md\":\"BzqycL-H\",\"drivers_ws2812.md\":\"NEo2sQbr\",\"easy_maker.md\":\"6n7dVTYS\",\"faq_build.md\":\"DZNHN8-D\",\"faq_debug.md\":\"vx_0_u9_\",\"faq_general.md\":\"D0EG2y83\",\"faq_keymap.md\":\"HQK7yaN_\",\"faq_misc.md\":\"CILFeSvN\",\"feature_advanced_keycodes.md\":\"BFCS9PZn\",\"feature_converters.md\":\"D6KzN6T3\",\"feature_debounce_type.md\":\"B4btv3zl\",\"feature_eeprom.md\":\"D_bqLEFa\",\"feature_layers.md\":\"CENkIDP3\",\"feature_layouts.md\":\"BogzTuHR\",\"feature_macros.md\":\"BlMWaiqJ\",\"feature_userspace.md\":\"Bf5gmiAY\",\"features_audio.md\":\"B0WDeKTO\",\"features_auto_shift.md\":\"DLSDpq9k\",\"features_autocorrect.md\":\"Y0LgzJas\",\"features_backlight.md\":\"RsZYALDB\",\"features_battery.md\":\"B6Ab94Jc\",\"features_bootmagic.md\":\"C_5K311x\",\"features_caps_word.md\":\"CIDaBP-l\",\"features_combo.md\":\"Dax9EotR\",\"features_command.md\":\"DWbb2ZHf\",\"features_community_modules.md\":\"BKB3EQD6\",\"features_digitizer.md\":\"BM6Nxg-j\",\"features_dip_switch.md\":\"BkvqWk2A\",\"features_dynamic_macros.md\":\"DaLBt-80\",\"features_encoders.md\":\"BkuwcHCp\",\"features_grave_esc.md\":\"CLdz56iw\",\"features_haptic_feedback.md\":\"B-ioEYF3\",\"features_hd44780.md\":\"DpvS25NL\",\"features_joystick.md\":\"B4D1xgy3\",\"features_key_lock.md\":\"Cu61mSCj\",\"features_key_overrides.md\":\"V4FVUQJE\",\"features_layer_lock.md\":\"Z90Yt_DL\",\"features_leader_key.md\":\"B47rYW2D\",\"features_led_indicators.md\":\"B-a_9KJt\",\"features_led_matrix.md\":\"CAcICmoN\",\"features_midi.md\":\"DBHZcct-\",\"features_mouse_keys.md\":\"9KGsb6t8\",\"features_oled_driver.md\":\"DYIJCwT3\",\"features_os_detection.md\":\"DaeYZhGC\",\"features_pointing_device.md\":\"Bs_a83Jz\",\"features_programmable_button.md\":\"B4W0QrV3\",\"features_ps2_mouse.md\":\"DkKbg0HB\",\"features_rawhid.md\":\"Cgf8SrBw\",\"features_repeat_key.md\":\"DQiZBEg0\",\"features_rgb_matrix.md\":\"rWDHSc7o\",\"features_rgblight.md\":\"BEL-EV8Z\",\"features_secure.md\":\"DWJXxMMA\",\"features_send_string.md\":\"DxT8iR_p\",\"features_sequencer.md\":\"DFoKQ0TL\",\"features_space_cadet.md\":\"DB0y0-h8\",\"features_split_keyboard.md\":\"CdeMXa87\",\"features_st7565.md\":\"xq_DcRr1\",\"features_stenography.md\":\"C9XRyFjT\",\"features_swap_hands.md\":\"De2lhBOi\",\"features_tap_dance.md\":\"DEInXfWx\",\"features_tri_layer.md\":\"C_6wFQ5v\",\"features_unicode.md\":\"BOggbpE5\",\"features_wireless.md\":\"B3qwab2e\",\"features_wpm.md\":\"BpdrOIEu\",\"flashing.md\":\"C_N9qmvk\",\"getting_started_docker.md\":\"DU9mSHtV\",\"getting_started_github.md\":\"BFmZeNj_\",\"getting_started_introduction.md\":\"1_zQTAKR\",\"getting_started_make_guide.md\":\"B89Bjq5W\",\"hand_wire.md\":\"C4wUtrFL\",\"hardware_drivers.md\":\"C6vlSLCV\",\"hardware_keyboard_guidelines.md\":\"Iwx9-_MM\",\"how_a_matrix_works.md\":\"DuLy3fYm\",\"how_keyboards_work.md\":\"Kqz2eMw-\",\"index.md\":\"su9L9OiU\",\"isp_flashing_guide.md\":\"KLb4YKDZ\",\"keycodes.md\":\"C3FCIw8j\",\"keycodes_basic.md\":\"CU34_bpC\",\"keycodes_magic.md\":\"BMOu_KA0\",\"keycodes_us_ansi_shifted.md\":\"BuLWPsJ7\",\"keymap.md\":\"mONRk0bh\",\"license_violations.md\":\"BDYMotOh\",\"mod_tap.md\":\"BaxFg-Rs\",\"newbs.md\":\"DK0F0hz3\",\"newbs_building_firmware.md\":\"BacztC1l\",\"newbs_building_firmware_configurator.md\":\"CcGaQsSJ\",\"newbs_building_firmware_workflow.md\":\"DJFZn_sg\",\"newbs_external_userspace.md\":\"p0BK6C70\",\"newbs_flashing.md\":\"BAqEj3y-\",\"newbs_getting_started.md\":\"Cm1TQTfg\",\"newbs_git_best_practices.md\":\"CWQUgz_s\",\"newbs_git_resolving_merge_conflicts.md\":\"CY7BwXek\",\"newbs_git_resynchronize_a_branch.md\":\"BrxafOHM\",\"newbs_git_using_your_master_branch.md\":\"Bf4LKnsw\",\"newbs_learn_more_resources.md\":\"DTxLu81-\",\"newbs_testing_debugging.md\":\"D941n7-l\",\"one_shot_keys.md\":\"Dno09Hp_\",\"other_eclipse.md\":\"BEiZBPaS\",\"other_vscode.md\":\"Ddu5wbwi\",\"platformdev_blackpill_f4x1.md\":\"srCds2d5\",\"platformdev_chibios_earlyinit.md\":\"DeU_QvW8\",\"platformdev_proton_c.md\":\"CpRo5RCH\",\"platformdev_rp2040.md\":\"DFezYYEC\",\"platformdev_selecting_arm_mcu.md\":\"CJom15Xw\",\"porting_your_keyboard_to_qmk.md\":\"Diniu5iP\",\"pr_checklist.md\":\"Dngwy_uC\",\"proprietary_libs.md\":\"D4Bh0qxV\",\"quantum_keycodes.md\":\"DAEibZwV\",\"quantum_painter.md\":\"C4xi4nLC\",\"quantum_painter_lvgl.md\":\"-hrqCJME\",\"quantum_painter_qff.md\":\"KXPWPCR-\",\"quantum_painter_qgf.md\":\"4jcFdZf1\",\"quantum_painter_rle.md\":\"CP6A5xOl\",\"ref_functions.md\":\"n3k29tKJ\",\"reference_configurator_support.md\":\"7XJjzI54\",\"reference_glossary.md\":\"CIwm4raE\",\"reference_info_json.md\":\"BIc7hvpx\",\"reference_keymap_extras.md\":\"F0wC7lQo\",\"squeezing_avr.md\":\"BmvINcV0\",\"support.md\":\"zKsJE92C\",\"support_deprecation_policy.md\":\"CZ4IhETi\",\"syllabus.md\":\"QTALDIRy\",\"tap_hold.md\":\"CV7RBz1O\",\"understanding_qmk.md\":\"BGTp2EVQ\",\"unit_testing.md\":\"D0ysJBhz\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QMK Firmware\",\"description\":\"Documentation for QMK Firmware\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/qmk-logo-light.svg\",\"dark\":\"/qmk-logo-dark.svg\"},\"title\":\"QMK Firmware\",\"nav\":[{\"text\":\"Home\",\"link\":\"/\"}],\"search\":{\"provider\":\"local\"},\"editLink\":{\"pattern\":\"https://github.com/qmk/qmk_firmware/edit/master/docs/:path\"},\"lastUpdated\":true,\"sidebar\":[{\"text\":\"Tutorial\",\"items\":[{\"text\":\"Introduction\",\"link\":\"/newbs\"},{\"text\":\"Setup\",\"link\":\"/newbs_getting_started\"},{\"text\":\"Building Your First Firmware\",\"link\":\"/newbs_building_firmware\"},{\"text\":\"Flashing Firmware\",\"link\":\"/newbs_flashing\"},{\"text\":\"Getting Help/Support\",\"link\":\"/support\"},{\"text\":\"External Userspace\",\"link\":\"/newbs_external_userspace\"},{\"text\":\"Other Resources\",\"link\":\"/newbs_learn_more_resources\"},{\"text\":\"Syllabus\",\"link\":\"/syllabus\"}]},{\"text\":\"FAQs\",\"items\":[{\"text\":\"General FAQ\",\"link\":\"/faq_general\"},{\"text\":\"Build/Compile QMK\",\"link\":\"/faq_build\"},{\"text\":\"Troubleshooting QMK\",\"link\":\"/faq_misc\"},{\"text\":\"Debugging QMK\",\"link\":\"/faq_debug\"},{\"text\":\"Keymap FAQ\",\"link\":\"/faq_keymap\"},{\"text\":\"Squeezing Space from AVR\",\"link\":\"/squeezing_avr\"},{\"text\":\"Glossary\",\"link\":\"/reference_glossary\"}]},{\"text\":\"Licensing\",\"items\":[{\"text\":\"License Violations\",\"link\":\"/license_violations\"},{\"text\":\"Proprietary Libraries\",\"link\":\"/proprietary_libs\"}]},{\"text\":\"Configurator\",\"items\":[{\"text\":\"Overview\",\"link\":\"/newbs_building_firmware_configurator\"},{\"text\":\"Step by Step\",\"link\":\"/configurator_step_by_step\"},{\"text\":\"Troubleshooting\",\"link\":\"/configurator_troubleshooting\"},{\"text\":\"Architecture\",\"link\":\"/configurator_architecture\"},{\"text\":\"QMK API\",\"items\":[{\"text\":\"Overview\",\"link\":\"/api_overview\"},{\"text\":\"API Documentation\",\"link\":\"/api_docs\"},{\"text\":\"Keyboard Support\",\"link\":\"/reference_configurator_support\"},{\"text\":\"Adding Default Keymaps\",\"link\":\"/configurator_default_keymaps\"}]}]},{\"text\":\"CLI\",\"items\":[{\"text\":\"Overview\",\"link\":\"/cli\"},{\"text\":\"Configuration\",\"link\":\"/cli_configuration\"},{\"text\":\"Commands\",\"link\":\"/cli_commands\"},{\"text\":\"Tab Completion\",\"link\":\"/cli_tab_complete\"}]},{\"text\":\"Using QMK\",\"items\":[{\"text\":\"Guides\",\"items\":[{\"text\":\"Customizing Functionality\",\"link\":\"/custom_quantum_functions\"},{\"text\":\"Driver Installation with Zadig\",\"link\":\"/driver_installation_zadig\"},{\"text\":\"Community Modules\",\"link\":\"/features/community_modules\"},{\"text\":\"Keymap Overview\",\"link\":\"/keymap\"},{\"text\":\"Development Environments\",\"items\":[{\"text\":\"Docker Guide\",\"link\":\"/getting_started_docker\"}]},{\"text\":\"Flashing\",\"link\":\"/flashing\"},{\"text\":\"IDEs\",\"items\":[{\"text\":\"Using Eclipse with QMK\",\"link\":\"/other_eclipse\"},{\"text\":\"Using VSCode with QMK\",\"link\":\"/other_vscode\"}]},{\"text\":\"Git Best Practices\",\"items\":[{\"text\":\"Introduction\",\"link\":\"/newbs_git_best_practices\"},{\"text\":\"Your Fork\",\"link\":\"/newbs_git_using_your_master_branch\"},{\"text\":\"Merge Conflicts\",\"link\":\"/newbs_git_resolving_merge_conflicts\"},{\"text\":\"Fixing Your Branch\",\"link\":\"/newbs_git_resynchronize_a_branch\"}]}]},{\"text\":\"Simple Keycodes\",\"items\":[{\"text\":\"Full List\",\"link\":\"/keycodes\"},{\"text\":\"Basic Keycodes\",\"link\":\"/keycodes_basic\"},{\"text\":\"Language-Specific Keycodes\",\"link\":\"/reference_keymap_extras\"},{\"text\":\"Modifier Keys\",\"link\":\"/feature_advanced_keycodes\"},{\"text\":\"Quantum Keycodes\",\"link\":\"/quantum_keycodes\"},{\"text\":\"Magic Keycodes\",\"link\":\"/keycodes_magic\"}]},{\"text\":\"Advanced Keycodes\",\"items\":[{\"text\":\"Command\",\"link\":\"/features/command\"},{\"text\":\"Dynamic Macros\",\"link\":\"/features/dynamic_macros\"},{\"text\":\"Grave Escape\",\"link\":\"/features/grave_esc\"},{\"text\":\"Leader Key\",\"link\":\"/features/leader_key\"},{\"text\":\"Mod-Tap\",\"link\":\"/mod_tap\"},{\"text\":\"Macros\",\"link\":\"/feature_macros\"},{\"text\":\"Mouse Keys\",\"link\":\"/features/mouse_keys\"},{\"text\":\"Programmable Button\",\"link\":\"/features/programmable_button\"},{\"text\":\"Repeat Key\",\"link\":\"/features/repeat_key\"},{\"text\":\"Space Cadet Shift\",\"link\":\"/features/space_cadet\"},{\"text\":\"US ANSI Shifted Keys\",\"link\":\"/keycodes_us_ansi_shifted\"}]},{\"text\":\"Software Features\",\"items\":[{\"text\":\"Auto Shift\",\"link\":\"/features/auto_shift\"},{\"text\":\"Autocorrect\",\"link\":\"/features/autocorrect\"},{\"text\":\"Caps Word\",\"link\":\"/features/caps_word\"},{\"text\":\"Combos\",\"link\":\"/features/combo\"},{\"text\":\"Debounce API\",\"link\":\"/feature_debounce_type\"},{\"text\":\"Digitizer\",\"link\":\"/features/digitizer\"},{\"text\":\"EEPROM\",\"link\":\"/feature_eeprom\"},{\"text\":\"Key Lock\",\"link\":\"/features/key_lock\"},{\"text\":\"Key Overrides\",\"link\":\"/features/key_overrides\"},{\"text\":\"Layers\",\"link\":\"/feature_layers\"},{\"text\":\"Layer Lock\",\"link\":\"/features/layer_lock\"},{\"text\":\"One Shot Keys\",\"link\":\"/one_shot_keys\"},{\"text\":\"OS Detection\",\"link\":\"/features/os_detection\"},{\"text\":\"Raw HID\",\"link\":\"/features/rawhid\"},{\"text\":\"Secure\",\"link\":\"/features/secure\"},{\"text\":\"Send String\",\"link\":\"/features/send_string\"},{\"text\":\"Sequencer\",\"link\":\"/features/sequencer\"},{\"text\":\"Swap Hands\",\"link\":\"/features/swap_hands\"},{\"text\":\"Tap Dance\",\"link\":\"/features/tap_dance\"},{\"text\":\"Tap-Hold Configuration\",\"link\":\"/tap_hold\"},{\"text\":\"Tri Layer\",\"link\":\"/features/tri_layer\"},{\"text\":\"Unicode\",\"link\":\"/features/unicode\"},{\"text\":\"Userspace\",\"link\":\"/feature_userspace\"},{\"text\":\"WPM Calculation\",\"link\":\"/features/wpm\"}]},{\"text\":\"Hardware Features\",\"items\":[{\"text\":\"Displays\",\"items\":[{\"text\":\"Quantum Painter\",\"link\":\"quantum_painter\",\"items\":[{\"text\":\"Quantum Painter LVGL Integration\",\"link\":\"/quantum_painter_lvgl\"}]},{\"text\":\"HD44780 LCD Driver\",\"link\":\"/features/hd44780\"},{\"text\":\"ST7565 LCD Driver\",\"link\":\"/features/st7565\"},{\"text\":\"OLED Driver\",\"link\":\"/features/oled_driver\"}]},{\"text\":\"Lighting\",\"items\":[{\"text\":\"Backlight\",\"link\":\"/features/backlight\"},{\"text\":\"LED Matrix\",\"link\":\"/features/led_matrix\"},{\"text\":\"RGB Lighting\",\"link\":\"/features/rgblight\"},{\"text\":\"RGB Matrix\",\"link\":\"/features/rgb_matrix\"}]},{\"text\":\"Audio\",\"link\":\"/features/audio\"},{\"text\":\"Battery\",\"link\":\"/features/battery\"},{\"text\":\"Bootmagic\",\"link\":\"/features/bootmagic\"},{\"text\":\"Converters\",\"link\":\"/feature_converters\"},{\"text\":\"Custom Matrix\",\"link\":\"/custom_matrix\"},{\"text\":\"DIP Switch\",\"link\":\"/features/dip_switch\"},{\"text\":\"Encoders\",\"link\":\"/features/encoders\"},{\"text\":\"Haptic Feedback\",\"link\":\"/features/haptic_feedback\"},{\"text\":\"Joystick\",\"link\":\"/features/joystick\"},{\"text\":\"LED Indicators\",\"link\":\"/features/led_indicators\"},{\"text\":\"MIDI\",\"link\":\"/features/midi\"},{\"text\":\"Pointing Device\",\"link\":\"/features/pointing_device\"},{\"text\":\"PS/2 Mouse\",\"link\":\"/features/ps2_mouse\"},{\"text\":\"Split Keyboard\",\"link\":\"/features/split_keyboard\"},{\"text\":\"Stenography\",\"link\":\"/features/stenography\"},{\"text\":\"Wireless\",\"link\":\"/features/wireless\"}]},{\"text\":\"Keyboard Building\",\"items\":[{\"text\":\"Easy Maker for One Offs\",\"link\":\"/easy_maker\"},{\"text\":\"Porting Keyboards\",\"link\":\"/porting_your_keyboard_to_qmk\"},{\"text\":\"Hand Wiring Guide\",\"link\":\"/hand_wire\"},{\"text\":\"ISP Flashing Guide\",\"link\":\"/isp_flashing_guide\"}]}]},{\"text\":\"Developing QMK\",\"items\":[{\"text\":\"PR Checklist\",\"link\":\"/pr_checklist\"},{\"text\":\"Breaking Changes\",\"items\":[{\"text\":\"Overview\",\"link\":\"/breaking_changes\"},{\"text\":\"My Pull Request Was Flagged\",\"link\":\"/breaking_changes_instructions\"},{\"text\":\"Most Recent ChangeLog\",\"link\":\"/ChangeLog/20260531\"},{\"text\":\"Past Breaking Changes\",\"link\":\"/breaking_changes_history\"},{\"text\":\"Deprecation Policy\",\"link\":\"/support_deprecation_policy\"}]},{\"text\":\"C Development\",\"items\":[{\"text\":\"ARM Debugging Guide\",\"link\":\"/arm_debugging\"},{\"text\":\"Coding Conventions\",\"link\":\"/coding_conventions_c\"},{\"text\":\"Compatible Microcontrollers\",\"link\":\"/compatible_microcontrollers\"},{\"text\":\"Drivers\",\"link\":\"hardware_drivers\",\"items\":[{\"text\":\"ADC Driver\",\"link\":\"/drivers/adc\"},{\"text\":\"APA102 Driver\",\"link\":\"/drivers/apa102\"},{\"text\":\"Audio Driver\",\"link\":\"/drivers/audio\"},{\"text\":\"Battery Driver\",\"link\":\"/drivers/battery\"},{\"text\":\"EEPROM Driver\",\"link\":\"/drivers/eeprom\"},{\"text\":\"Flash Driver\",\"link\":\"/drivers/flash\"},{\"text\":\"I2C Driver\",\"link\":\"/drivers/i2c\"},{\"text\":\"'serial' Driver\",\"link\":\"/drivers/serial\"},{\"text\":\"SPI Driver\",\"link\":\"/drivers/spi\"},{\"text\":\"UART Driver\",\"link\":\"/drivers/uart\"},{\"text\":\"WS2812 Driver\",\"link\":\"/drivers/ws2812\"}]},{\"text\":\"GPIO Controls\",\"link\":\"/drivers/gpio\"},{\"text\":\"Keyboard Guidelines\",\"link\":\"/hardware_keyboard_guidelines\"}]},{\"text\":\"Python Development\",\"items\":[{\"text\":\"Coding Conventions\",\"link\":\"/coding_conventions_python\"},{\"text\":\"QMK CLI Development\",\"link\":\"/cli_development\"}]},{\"text\":\"Configurator Development\",\"items\":[{\"text\":\"QMK API\",\"items\":[{\"text\":\"Development Environment\",\"link\":\"/api_development_environment\"},{\"text\":\"Architecture Overview\",\"link\":\"/api_development_overview\"}]}]},{\"text\":\"Hardware Platform Development\",\"items\":[{\"text\":\"Arm/ChibiOS\",\"items\":[{\"text\":\"Selecting an MCU\",\"link\":\"/platformdev_selecting_arm_mcu\"},{\"text\":\"Early initialization\",\"link\":\"/platformdev_chibios_earlyinit\"},{\"text\":\"Raspberry Pi RP2040\",\"link\":\"/platformdev_rp2040\"},{\"text\":\"Proton C\",\"link\":\"/platformdev_proton_c\"},{\"text\":\"WeAct Blackpill F4x1\",\"link\":\"/platformdev_blackpill_f4x1\"}]}]},{\"text\":\"QMK Reference\",\"items\":[{\"text\":\"Contributing to QMK\",\"link\":\"/contributing\"},{\"text\":\"Config Options\",\"link\":\"/config_options\"},{\"text\":\"Data Driven Configuration\",\"link\":\"/data_driven_config\"},{\"text\":\"Make Documentation\",\"link\":\"/getting_started_make_guide\"},{\"text\":\"Documentation Best Practices\",\"link\":\"/documentation_best_practices\"},{\"text\":\"Documentation Templates\",\"link\":\"/documentation_templates\"},{\"text\":\"Community Layouts\",\"link\":\"/feature_layouts\"},{\"text\":\"Unit Testing\",\"link\":\"/unit_testing\"},{\"text\":\"Useful Functions\",\"link\":\"/ref_functions\"},{\"text\":\"info.json Format\",\"link\":\"/reference_info_json\"}]},{\"text\":\"For a Deeper Understanding\",\"items\":[{\"text\":\"How Keyboards Work\",\"link\":\"/how_keyboards_work\"},{\"text\":\"How a Matrix Works\",\"link\":\"/how_a_matrix_works\"},{\"text\":\"Understanding QMK\",\"link\":\"/understanding_qmk\"}]}]}],\"externalLinkIcon\":true,\"socialLinks\":[{\"icon\":{\"svg\":\"<svg xmlns=\\\"http://www.w3.org/2000/svg\\\" viewBox=\\\"0 0 50 50\\\" width=\\\"50px\\\" height=\\\"50px\\\"><path d=\\\"M 29 3 C 28.0625 3 27.164063 3.382813 26.5 4 C 25.835938 4.617188 25.363281 5.433594 25 6.40625 C 24.355469 8.140625 24.085938 10.394531 24.03125 13.03125 C 19.234375 13.179688 14.820313 14.421875 11.28125 16.46875 C 10.214844 15.46875 8.855469 14.96875 7.5 14.96875 C 6.089844 14.96875 4.675781 15.511719 3.59375 16.59375 C 1.425781 18.761719 1.425781 22.238281 3.59375 24.40625 L 3.84375 24.65625 C 3.3125 26.035156 3 27.488281 3 29 C 3 33.527344 5.566406 37.585938 9.5625 40.4375 C 13.558594 43.289063 19.007813 45 25 45 C 30.992188 45 36.441406 43.289063 40.4375 40.4375 C 44.433594 37.585938 47 33.527344 47 29 C 47 27.488281 46.6875 26.035156 46.15625 24.65625 L 46.40625 24.40625 C 48.574219 22.238281 48.574219 18.761719 46.40625 16.59375 C 45.324219 15.511719 43.910156 14.96875 42.5 14.96875 C 41.144531 14.96875 39.785156 15.46875 38.71875 16.46875 C 35.195313 14.433594 30.800781 13.191406 26.03125 13.03125 C 26.09375 10.546875 26.363281 8.46875 26.875 7.09375 C 27.164063 6.316406 27.527344 5.757813 27.875 5.4375 C 28.222656 5.117188 28.539063 5 29 5 C 29.460938 5 29.683594 5.125 30.03125 5.40625 C 30.378906 5.6875 30.785156 6.148438 31.3125 6.6875 C 32.253906 7.652344 33.695313 8.714844 36.09375 8.9375 C 36.539063 11.238281 38.574219 13 41 13 C 43.75 13 46 10.75 46 8 C 46 5.25 43.75 3 41 3 C 38.605469 3 36.574219 4.710938 36.09375 6.96875 C 34.3125 6.796875 33.527344 6.109375 32.75 5.3125 C 32.300781 4.851563 31.886719 4.3125 31.3125 3.84375 C 30.738281 3.375 29.9375 3 29 3 Z M 41 5 C 42.667969 5 44 6.332031 44 8 C 44 9.667969 42.667969 11 41 11 C 39.332031 11 38 9.667969 38 8 C 38 6.332031 39.332031 5 41 5 Z M 25 15 C 30.609375 15 35.675781 16.613281 39.28125 19.1875 C 42.886719 21.761719 45 25.226563 45 29 C 45 32.773438 42.886719 36.238281 39.28125 38.8125 C 35.675781 41.386719 30.609375 43 25 43 C 19.390625 43 14.324219 41.386719 10.71875 38.8125 C 7.113281 36.238281 5 32.773438 5 29 C 5 25.226563 7.113281 21.761719 10.71875 19.1875 C 14.324219 16.613281 19.390625 15 25 15 Z M 7.5 16.9375 C 8.203125 16.9375 8.914063 17.148438 9.53125 17.59375 C 7.527344 19.03125 5.886719 20.769531 4.75 22.71875 C 3.582031 21.296875 3.660156 19.339844 5 18 C 5.714844 17.285156 6.609375 16.9375 7.5 16.9375 Z M 42.5 16.9375 C 43.390625 16.9375 44.285156 17.285156 45 18 C 46.339844 19.339844 46.417969 21.296875 45.25 22.71875 C 44.113281 20.769531 42.472656 19.03125 40.46875 17.59375 C 41.085938 17.148438 41.796875 16.9375 42.5 16.9375 Z M 17 22 C 14.800781 22 13 23.800781 13 26 C 13 28.199219 14.800781 30 17 30 C 19.199219 30 21 28.199219 21 26 C 21 23.800781 19.199219 22 17 22 Z M 33 22 C 30.800781 22 29 23.800781 29 26 C 29 28.199219 30.800781 30 33 30 C 35.199219 30 37 28.199219 37 26 C 37 23.800781 35.199219 22 33 22 Z M 17 24 C 18.117188 24 19 24.882813 19 26 C 19 27.117188 18.117188 28 17 28 C 15.882813 28 15 27.117188 15 26 C 15 24.882813 15.882813 24 17 24 Z M 33 24 C 34.117188 24 35 24.882813 35 26 C 35 27.117188 34.117188 28 33 28 C 31.882813 28 31 27.117188 31 26 C 31 24.882813 31.882813 24 33 24 Z M 34.15625 33.84375 C 34.101563 33.851563 34.050781 33.859375 34 33.875 C 33.683594 33.9375 33.417969 34.144531 33.28125 34.4375 C 33.28125 34.4375 32.757813 35.164063 31.4375 36 C 30.117188 36.835938 28.058594 37.6875 25 37.6875 C 21.941406 37.6875 19.882813 36.835938 18.5625 36 C 17.242188 35.164063 16.71875 34.4375 16.71875 34.4375 C 16.492188 34.082031 16.066406 33.90625 15.65625 34 C 15.332031 34.082031 15.070313 34.316406 14.957031 34.632813 C 14.84375 34.945313 14.894531 35.292969 15.09375 35.5625 C 15.09375 35.5625 15.863281 36.671875 17.46875 37.6875 C 19.074219 38.703125 21.558594 39.6875 25 39.6875 C 28.441406 39.6875 30.925781 38.703125 32.53125 37.6875 C 34.136719 36.671875 34.90625 35.5625 34.90625 35.5625 C 35.207031 35.273438 35.296875 34.824219 35.128906 34.441406 C 34.960938 34.058594 34.574219 33.820313 34.15625 33.84375 Z\\\"/></svg>\"},\"link\":\"https://reddit.com/r/olkb\"},{\"icon\":\"discord\",\"link\":\"https://discord.gg/qmk\"},{\"icon\":\"github\",\"link\":\"https://github.com/qmk/qmk_firmware\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
  61. </body>
  62. </html>