Compare commits

...
15 Commits
Author SHA1 Message Date
Linn f0e090f67a Update emerge-webrsync to emaint sync (#26352)
Gentoo users using git to sync cannot use `emerge-webrsync` command, but it seems like `emaint sync` still works with the webrsync method. Furthermore, running the version with `emerge-webrsync` on my Gentoo computer, which syncs with git, seemed to break syncing until manually fixed (by deleting and reinstalling the gentoo repository)
2026-07-24 02:30:34 +01:00
dependabot[bot]anddependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> 3ef9860ee1 Bump actions/labeler from 6 to 7 (#26351)
Bumps [actions/labeler](https://github.com/actions/labeler) from 6 to 7.
- [Release notes](https://github.com/actions/labeler/releases)
- [Commits](https://github.com/actions/labeler/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/labeler
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-07-22 00:41:55 +01:00
Joel Challis 95b9016a3b Fix STM32G0B1 not booting after ChibiOS update (#26342) 2026-07-19 21:55:20 +01:00
dbd9b0a379 NK65 Gen2 Keyboard (#26334)
* Initial commit

* Cleanup

* Update keyboards/novelkeys/nk65_gen2/keymaps/default/keymap.c

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/config.h

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/mcuconf.h

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/readme.md

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/halconf.h

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/keymaps/default/keymap.c

Co-authored-by: Joel Challis <git@zvecr.com>

* Simplify RGB matrix color settings in keymap.c

* Update keyboards/novelkeys/nk65_gen2/readme.md

Co-authored-by: Joel Challis <git@zvecr.com>

* Update keyboards/novelkeys/nk65_gen2/readme.md

Co-authored-by: Joel Challis <git@zvecr.com>

---------

Co-authored-by: yiancar <yiancar@gmail.com>
Co-authored-by: Joel Challis <git@zvecr.com>
2026-07-18 20:54:32 -07:00
Joel Challis b8bf40eb96 Avoid computing _get_default_distrib_path when QMK_DISTRIB_DIR is set (#26339) 2026-07-18 10:06:00 +10:00
yi chen a738fad372 [Docs] Clarify Python HID package name in Raw HID docs (#26318)
The PyPI package for the Python HID library used here is called `hid`
(https://pypi.org/project/hid/), but the docs called it "pyhidapi" while
linking to the `hid` package page. There is also a separate, unrelated,
unmaintained package literally named `pyhidapi` on PyPI, so a reader
following the doc text as written can end up installing the wrong package.

Update the library list and prose to say `hid`, and add a short tip
covering the install/import command and calling out the package to avoid.

Fixes #26047
2026-07-11 06:32:34 +01:00
Assem Mohamed 99b8f3bf4e Add handwired keyboard "handwired/tnx_corne_f401" (#26032) 2026-07-11 06:19:17 +01:00
Alexis "Horgix" Chotard 2dc5e39798 docs(features): Add missing inline code syntax for KC_ESC (#26314) 2026-07-07 23:14:50 +01:00
Harry CuttsandJoel Challis 7a15cd2482 Add "handwired" TwentyPad macro pad (#26264)
* Add "handwired" TwentyPad macro pad

TwentyPad is 20-key macro pad I created as a hobby project. Its
configuration is based on ez_maker/directpins/teensy_2, with the
bootloader and layout changed.

* Host the image on Imgur

Co-authored-by: Joel Challis <git@zvecr.com>

---------

Co-authored-by: Joel Challis <git@zvecr.com>
2026-07-06 13:08:39 -07:00
Pascal GetreuerandDrashna Jaelre cf93bbb78f [Docs] Tap-hold doc improvements and suggest an HRMs starter recipe (#26284)
* Enhance tap-hold docs.

* Minor edits.

* Move note on Quick Tap to a sub bullet for visibility.

Co-authored-by: Drashna Jaelre <drashna@live.com>

---------

Co-authored-by: Drashna Jaelre <drashna@live.com>
2026-07-03 11:48:28 +08:00
Trent Piepho b1093e9da5 Fix VERBOSE make flag (#26289)
The docs say set this to true to enable verbose output, but setting it to
anything, even "false", would enable verbose mode.

The qmk python build program actually does this, supplying "VERBOSE=false"
to make, which turns verbose mode on, not off!  The reason it's not verbose
is that the wrapper also adds the "-s" switch that has the same effect as
turning verbose mode back off.

After fixing the flag, there's no reason to add the "-s", so remove that code.
2026-06-26 14:20:10 +01:00
dependabot[bot]anddependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> 0cb6461c6a Bump actions/cache from 5 to 6 (#26293)
Bumps [actions/cache](https://github.com/actions/cache) from 5 to 6.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v5...v6)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-23 21:30:44 +01:00
Benoit Brummer 198026cf27 ploopyco: fix bitwise typos in opt_encoder_tiny state definitions (#26288)
Fixes a bug in the state machine definitions within `opt_encoder_tiny.c` that caused severely delayed or unresponsive scrolling.
2026-06-22 18:28:13 +01:00
dependabot[bot]anddependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> c638100030 Bump actions/checkout from 6 to 7 (#26274)
Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-19 17:30:08 +01:00
Nick Brassel 85886db43b Fixup make format-core, make pytest, make format-and-pytest. (#26259) 2026-06-13 22:19:43 +01:00
46 changed files with 718 additions and 48 deletions
+1 -1
View File
@@ -25,7 +25,7 @@ jobs:
if: github.repository == 'qmk/qmk_firmware'
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 1
persist-credentials: false
+1 -1
View File
@@ -28,7 +28,7 @@ jobs:
if: github.repository == 'qmk/qmk_firmware'
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 0
+4 -4
View File
@@ -99,7 +99,7 @@ jobs:
zypper --non-interactive install sudo git shadow findutils tar # findutils=xargs
;;
*gentoo*)
emerge-webrsync
emaint sync
emerge --noreplace --ask=n sudo dev-vcs/git shadow findutils # findutils=xargs
;;
*archlinux*|*cachyos*|*manjaro*)
@@ -123,7 +123,7 @@ jobs:
echo 'Defaults secure_path="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"' >> /etc/sudoers
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
fetch-depth: 1
submodules: recursive
@@ -201,7 +201,7 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
fetch-depth: 1
submodules: recursive
@@ -258,7 +258,7 @@ jobs:
git:
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
fetch-depth: 1
submodules: recursive
+2 -2
View File
@@ -41,7 +41,7 @@ jobs:
git config --global --add safe.directory '*'
- name: Checkout QMK Firmware
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Install dependencies
run: pip3 install -r requirements-dev.txt
@@ -89,7 +89,7 @@ jobs:
git config --global --add safe.directory '*'
- name: Checkout QMK Firmware
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
fetch-depth: 0
@@ -32,7 +32,7 @@ jobs:
git config --global --add safe.directory '*'
- name: Checkout QMK Firmware
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Install dependencies
run: pip3 install -r requirements-dev.txt
@@ -86,7 +86,7 @@ jobs:
git config --global --add safe.directory '*'
- name: Checkout QMK Firmware
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
submodules: recursive
@@ -105,7 +105,7 @@ jobs:
- name: Restore Cache
id: cache
uses: actions/cache/restore@v5
uses: actions/cache/restore@v6
with:
path: ${{ env.CCACHE_CONFIGPATH }}
key: compile-${{ inputs.keymap }}-${{ matrix.target }}
@@ -136,7 +136,7 @@ jobs:
fi
- name: Save Cache
uses: actions/cache/save@v5
uses: actions/cache/save@v6
with:
path: ${{ env.CCACHE_CONFIGPATH }}
key: compile-${{ inputs.keymap }}-${{ matrix.target }}
@@ -166,7 +166,7 @@ jobs:
steps:
- name: Checkout QMK Firmware
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Download firmwares
uses: actions/download-artifact@v8
+1 -1
View File
@@ -24,7 +24,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
submodules: recursive
+1 -1
View File
@@ -15,7 +15,7 @@ jobs:
if: github.repository == 'qmk/qmk_firmware'
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
token: ${{ secrets.QMK_BOT_TOKEN }}
fetch-depth: 0
+1 -1
View File
@@ -30,7 +30,7 @@ jobs:
container: ghcr.io/qmk/qmk_cli
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 1
+1 -1
View File
@@ -21,7 +21,7 @@ jobs:
- riot
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
token: ${{ secrets.QMK_BOT_TOKEN }}
fetch-depth: 0
+1 -1
View File
@@ -26,7 +26,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 0
+1 -1
View File
@@ -19,7 +19,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 0
+1 -1
View File
@@ -10,4 +10,4 @@ jobs:
pull-requests: write
runs-on: ubuntu-latest
steps:
- uses: actions/labeler@v6
- uses: actions/labeler@v7
+1 -1
View File
@@ -18,7 +18,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
fetch-depth: 0
+1 -1
View File
@@ -22,7 +22,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
- name: Install dependencies
run: pip3 install -r requirements-dev.txt
+1 -1
View File
@@ -19,7 +19,7 @@ jobs:
- name: Disable safe.directory check
run : git config --global --add safe.directory '*'
- uses: actions/checkout@v6
- uses: actions/checkout@v7
- name: Install dependencies
run: pip3 install -r requirements-dev.txt
+1 -1
View File
@@ -27,7 +27,7 @@ jobs:
container: ghcr.io/qmk/qmk_cli
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
with:
submodules: recursive
+8 -7
View File
@@ -1,4 +1,4 @@
ifndef VERBOSE
ifneq ($(VERBOSE),true)
.SILENT:
endif
@@ -118,7 +118,7 @@ endef
TRY_TO_MATCH_RULE_FROM_LIST = $(eval $(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER,$1))$(RULE_FOUND)
# As TRY_TO_MATCH_RULE_FROM_LIST_HELPER, but with additional
# resolution of keyboard_aliases.hjson for provided rule
# resolution of keyboard_aliases.hjson for provided rule
define TRY_TO_MATCH_RULE_FROM_LIST_HELPER_KB
# Split on ":", padding with empty strings to avoid indexing issues
TOKEN1:=$$(shell python3 -c "import sys; print((sys.argv[1].split(':',1)+[''])[0])" $$(RULE))
@@ -452,16 +452,17 @@ distclean_userspace: clean
endif
# Extra targets for formatting and/or pytest, running within the qmk/qmk_cli container to match GHA.
CONTAINER_PREAMBLE := export HOME="/tmp"; export PATH="/tmp/.local/bin:\$$PATH"; python3 -m pip install --upgrade pip; python3 -m pip install -r requirements-dev.txt
.PHONY: format-core
format-core:
RUNTIME=docker ./util/docker_cmd.sh bash -lic "$(CONTAINER_PREAMBLE); qmk format-c --core-only -a && qmk format-python -a"
RUNTIME=docker ./util/docker_cmd.sh qmk format-c --core-only -a
RUNTIME=docker ./util/docker_cmd.sh qmk format-python -a
.PHONY: pytest
pytest:
RUNTIME=docker ./util/docker_cmd.sh bash -lic "$(CONTAINER_PREAMBLE); qmk pytest"
RUNTIME=docker ./util/docker_cmd.sh qmk pytest
.PHONY: format-and-pytest
format-and-pytest:
RUNTIME=docker ./util/docker_cmd.sh bash -lic "$(CONTAINER_PREAMBLE); qmk format-c --core-only -a && qmk format-python -a && qmk pytest"
RUNTIME=docker ./util/docker_cmd.sh qmk format-c --core-only -a
RUNTIME=docker ./util/docker_cmd.sh qmk format-python -a
RUNTIME=docker ./util/docker_cmd.sh qmk pytest
+1 -1
View File
@@ -4,7 +4,7 @@
# responsible for determining which folder is being used and doing the
# corresponding environment setup.
ifndef VERBOSE
ifneq ($(VERBOSE),true)
.SILENT:
endif
+1 -1
View File
@@ -1,4 +1,4 @@
ifndef VERBOSE
ifneq ($(VERBOSE),true)
.SILENT:
endif
+2 -1
View File
@@ -16,7 +16,8 @@ These functions allow you to activate layers in various ways. Note that layers a
* `OSL(layer)` - momentarily activates *layer* until the next key is pressed. See [One Shot Keys](one_shot_keys) for details and additional functionality.
* `TG(layer)` - toggles *layer*, activating it if it's inactive and vice versa
* `TO(layer)` - activates *layer* and de-activates all other layers (except your default layer). This function is special, because instead of just adding/removing one layer to your active layer stack, it will completely replace your current active layers, uniquely allowing you to replace higher layers with a lower one. This is activated on keydown (as soon as the key is pressed).
* `TT(layer)` - Layer Tap-Toggle. If you hold the key down, *layer* is activated, and then is de-activated when you let go (like `MO`). If you repeatedly tap it, the layer will be toggled on or off (like `TG`). It needs 5 taps by default, but you can change this by defining `TAPPING_TOGGLE` -- for example, `#define TAPPING_TOGGLE 2` to toggle on just two taps.
* `TT(layer)` - Layer Tap-Toggle. If you hold the key down, *layer* is activated, and then is de-activated when you let go (like `MO`). If you repeatedly tap it, the layer will be toggled on or off (like `TG`). It needs 5 taps by default, but you can change this by defining `TAPPING_TOGGLE` -- for example, `#define TAPPING_TOGGLE 2` to toggle on just two taps.
* Note: toggling behavior requires that [Quick Tap](tap_hold#quick-tap-term) is enabled (`QUICK_TAP_TERM` not set to `0`), or if `QUICK_TAP_TERM_PER_KEY` is defined, that `get_quick_tap_term()` returns a non-zero value for the `TT` key.
See also the [Layer Lock key](features/layer_lock), which locks the highest
active layer until pressed again.
+1 -1
View File
@@ -8,7 +8,7 @@ Replace the `KC_GRV` key in your keymap (usually to the left of the `1` key) wit
## What Your OS Sees
If Mary presses `QK_GESC` on her keyboard, the OS will see an KC_ESC character. Now if Mary holds Shift down and presses `QK_GESC` it will output `~`, or a shifted backtick. Now if she holds GUI/CMD/WIN, it will output a simple <code>&#96;</code> character.
If Mary presses `QK_GESC` on her keyboard, the OS will see an `KC_ESC` character. Now if Mary holds Shift down and presses `QK_GESC` it will output `~`, or a shifted backtick. Now if she holds GUI/CMD/WIN, it will output a simple <code>&#96;</code> character.
## Keycodes
+6 -2
View File
@@ -28,10 +28,14 @@ To send data to the keyboard, you must first find a library for communicating wi
* **Node.js:** [node-hid](https://github.com/node-hid/node-hid)
* **C/C++:** [hidapi](https://github.com/libusb/hidapi)
* **Java:** [purejavahidapi](https://github.com/nyholku/purejavahidapi) and [hid4java](https://github.com/gary-rowe/hid4java)
* **Python:** [pyhidapi](https://pypi.org/project/hid/) and [pywinusb](https://pypi.org/project/pywinusb)
* **Python:** [hid](https://pypi.org/project/hid/) and [pywinusb](https://pypi.org/project/pywinusb)
Please refer to these libraries' own documentation for instructions on usage. Remember to close the device once you are finished with it!
::: tip
The `hid` package is installed with `pip install hid` and imported as `import hid`. Avoid installing the unrelated `pyhidapi` package from PyPI, which is a different, unmaintained project despite the similar name.
:::
Next, you will need to know the USB Vendor and Product IDs of the device. These can easily be found by looking at your keyboard's `info.json`, under the `usb` object (alternatively, you can also use Device Manager on Windows, System Information on macOS, or `lsusb` on Linux). For example, the Vendor ID for the Planck Rev 6 is `0x03A8`, and the Product ID is `0xA4F9`.
It's also a good idea to narrow down the list of potential HID devices the library may give you by filtering on the usage page and usage ID, to avoid accidentally opening the interface on the same device for the keyboard, or mouse, or media keys, etc.
@@ -72,7 +76,7 @@ void raw_hid_receive(uint8_t *data, uint8_t length) {
}
```
On the host side (here we are using Python and the `pyhidapi` library), the HID device is opened by enumerating the interfaces on the USB device, then filtering on the usage page and usage ID. Then, a report containing a single ASCII "A" (hex `0x41`) is constructed and sent.
On the host side (here we are using Python and the `hid` package), the HID device is opened by enumerating the interfaces on the USB device, then filtering on the usage page and usage ID. Then, a report containing a single ASCII "A" (hex `0x41`) is constructed and sent.
For demonstration purposes, the manufacturer and product strings of the device, along with the request and response, are also printed.
+4
View File
@@ -375,6 +375,10 @@ In this configuration "hold" takes place **after** tap dance timeout. To achieve
Tap dance can be used to emulate `MT()` and `LT()` behavior when the tapped code is not a basic keycode. This is useful to send tapped keycodes that normally require `Shift`, such as parentheses or curly braces—or other modified keycodes, such as `Control + X`.
::: tip
For simply sending a non-basic keycode on tap while functioning as a modifier or layer switch on hold, a simpler (and often superior) alternative is to use a Mod-Tap or Layer-Tap key and intercept its tap function in `process_record_user()`. This avoids the complexity of Tap Dance, and allows the key to benefit from advanced Tap-Hold options. See [Intercepting Mod-Taps](../mod_tap#intercepting-mod-taps) for details.
:::
Below your layers and custom keycodes, add the following:
```c
+3 -1
View File
@@ -72,9 +72,11 @@ It can also be mitigated by increasing [`TAP_CODE_DELAY`](config_options#behavio
## Intercepting Mod-Taps
This technique works for both Mod-Tap (`MT`) and Layer-Tap (`LT`) keys.
### Changing tap function
The basic keycode limitation with Mod-Tap can be worked around by intercepting it in `process_record_user`. For example, shifted keycode `KC_DQUO` cannot be used with `MT()` because it is a 16-bit keycode alias of `LSFT(KC_QUOT)`. Modifiers on `KC_DQUO` will be masked by `MT()`. But the following custom code can be used to intercept the "tap" function to manually send `KC_DQUO`:
The basic keycode limitation with Mod-Tap and Layer-Tap can be worked around by intercepting it in `process_record_user`. For example, shifted keycode `KC_DQUO` cannot be used with `MT()` because it is a 16-bit keycode alias of `LSFT(KC_QUOT)`. Modifiers on `KC_DQUO` will be masked by `MT()`. But the following custom code can be used to intercept the "tap" function to manually send `KC_DQUO`:
```c
bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+25 -2
View File
@@ -1,8 +1,12 @@
# Tap-Hold Configuration Options
These options let you modify the behavior of the tap-hold keys, applying primarily to Mod-Tap `MT` and Layer-Tap `LT` keys. They also affect layer tap-toggle `TT`, one-shot `OSM`, `OSL`, and Swap Hands `SH_T`, `SH_TT` keys.
While Tap-Hold options are fantastic, they are not without their issues. We have tried to configure them with reasonable defaults, but that may still cause issues for some people.
These options let you modify the behavior of the tap-hold keys.
::: info
Besides the tapping term, tap-hold options do **not** apply to Tap Dance keys. Tap Dance implements a separate, simpler decision logic to track when keys are tapped vs. held, and it does not support advanced tap-hold configurations like Permissive Hold, Chordal Hold, etc.
:::
## Tapping Term
@@ -148,6 +152,25 @@ uint16_t get_tapping_term(uint16_t keycode, keyrecord_t *record) {
The reason is that `TAPPING_TERM` is a macro that expands to a constant integer and thus cannot be changed at runtime, whereas `g_tapping_term` is a variable whose value can be changed at runtime. If you want, you can temporarily enable `DYNAMIC_TAPPING_TERM_ENABLE` to find a suitable tapping term value and then disable that feature and revert back to using the classic syntax for per-key tapping term settings. In case you need to access the tapping term from elsewhere in your code, you can use the `GET_TAPPING_TERM(keycode, record)` macro. This macro will expand to whatever is the appropriate access pattern given the current configuration.
## Configuring Home Row Mods
"Home row mods" (HRMs) is a popular layout technique where modifiers are placed as Mod-Tap keys on the home row (<kbd>A</kbd>, <kbd>S</kbd>, <kbd>D</kbd>, <kbd>F</kbd> and <kbd>J</kbd>, <kbd>K</kbd>, <kbd>L</kbd>, <kbd>;</kbd>, supposing QWERTY layout). This reduces hand movement and can increase comfort. However, because these keys are also used for fast typing, they are prone to accidental modifier triggers (when rolling keys) or accidental typed letters (when trying to use a modifier).
There is no single perfect configuration for home row mods, as it depends heavily on your typing speed and habits. However, a good starting point in QMK is (added in your `config.h`):
```c
#define TAPPING_TERM 250
#define PERMISSIVE_HOLD // Triggers mod if you tap another key while holding.
#define CHORDAL_HOLD // Constrains holds to opposite-hand combinations.
// Consider also:
// #define FLOW_TAP_TERM 150 // Disables holds when typing quickly.
```
See [Permissive Hold](#permissive-hold), [Chordal Hold](#chordal-hold), and [Flow Tap](#flow-tap) below for details on what they do and how to fine-tune them.
Additionally, [Speculative Hold](#speculative-hold) is useful to eliminate lag when combining a home row mod with mouse clicks (e.g., Shift + Click), as standard mod-tap keys do not send the modifier until the tap-hold decision is finalized.
## Tap-Or-Hold Decision Modes
The code which decides between the tap and hold actions of dual-role keys supports three different modes, in increasing order of preference for the hold action:
@@ -824,7 +847,7 @@ bool get_speculative_hold(uint16_t keycode, keyrecord_t* record) {
}
```
Some operating systems or applications assign actions to tapping a modifier key by itself, e.g., tapping GUI to open a start menu. Because Speculative Hold sometimes sends a lone modifier key press, it can falsely trigger these actions (known as the "flashing mods" problem). How such an input is handled depends on the OS and application, so unfortunately, there is no universal solution.
Some operating systems or applications assign actions to tapping a modifier key by itself, e.g., tapping GUI to open a start menu. Because Speculative Hold sends a lone modifier key press in some cases, it can falsely trigger these actions (known as the "flashing mods" problem). How such an input is handled depends on the OS and application, so unfortunately, there is no universal solution.
To mitigate this issue, you can set `DUMMY_MOD_NEUTRALIZER_KEYCODE` (and optionally `MODS_TO_NEUTRALIZE`) in your `config.h`, as described above for [Retro Tapping](#retro-tapping).
@@ -0,0 +1,12 @@
// Copyright 2026 ToYoNiX <toyonix.assemmohamed.2005@gmail.com>
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
// Split configuration
#define SPLIT_HAND_PIN_LOW_IS_LEFT
// Enable full duplex operation mode
#define SERIAL_USART_FULL_DUPLEX
#define SERIAL_USART_TX_PIN B6
#define SERIAL_USART_RX_PIN B7
@@ -0,0 +1,9 @@
// Copyright 2024 zvecr <git@zvecr.com>
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#define HAL_USE_SERIAL TRUE
#define SERIAL_USB_BUFFERS_SIZE 256
#include_next <halconf.h>
@@ -0,0 +1,102 @@
{
"manufacturer": "Assem Mohamed",
"keyboard_name": "handwired/tnx_corne_f401",
"maintainer": "ToYoNiX",
"development_board": "blackpill_f401",
"bootloader": "tinyuf2",
"diode_direction": "COL2ROW",
"encoder": {
"rotary": [
{"pin_a": "B9", "pin_b": "B8", "resolution": 2}
]
},
"split": {
"enabled": true,
"handedness": {
"pin": "C13"
},
"serial": {
"driver": "usart"
},
"transport": {
"watchdog": true
},
"encoder": {
"right": {
"rotary": [
{"pin_a": "B9", "pin_b": "B8", "resolution": 2}
]
}
}
},
"features": {
"bootmagic": true,
"extrakey": true,
"encoder": true,
"mousekey": true,
"nkro": true
},
"host": {
"default": {
"nkro": true
}
},
"matrix_pins": {
"cols": ["A8", "B15", "B14", "B13", "B12"],
"rows": ["B0", "A5", "A4", "A3"]
},
"usb": {
"device_version": "1.0.0",
"pid": "0x544E",
"vid": "0x4B42"
},
"layouts": {
"LAYOUT_split_3x5_3": {
"layout": [
{"matrix": [0, 0], "x": 0, "y": 0.3},
{"matrix": [0, 1], "x": 1, "y": 0.1},
{"matrix": [0, 2], "x": 2, "y": 0},
{"matrix": [0, 3], "x": 3, "y": 0.1},
{"matrix": [0, 4], "x": 4, "y": 0.2},
{"matrix": [4, 4], "x": 8, "y": 0.2},
{"matrix": [4, 3], "x": 9, "y": 0.1},
{"matrix": [4, 2], "x": 10, "y": 0},
{"matrix": [4, 1], "x": 11, "y": 0.1},
{"matrix": [4, 0], "x": 12, "y": 0.3},
{"matrix": [1, 0], "x": 0, "y": 1.3},
{"matrix": [1, 1], "x": 1, "y": 1.1},
{"matrix": [1, 2], "x": 2, "y": 1},
{"matrix": [1, 3], "x": 3, "y": 1.1},
{"matrix": [1, 4], "x": 4, "y": 1.2},
{"matrix": [5, 4], "x": 8, "y": 1.2},
{"matrix": [5, 3], "x": 9, "y": 1.1},
{"matrix": [5, 2], "x": 10, "y": 1},
{"matrix": [5, 1], "x": 11, "y": 1.1},
{"matrix": [5, 0], "x": 12, "y": 1.3},
{"matrix": [2, 0], "x": 0, "y": 2.3},
{"matrix": [2, 1], "x": 1, "y": 2.1},
{"matrix": [2, 2], "x": 2, "y": 2},
{"matrix": [2, 3], "x": 3, "y": 2.1},
{"matrix": [2, 4], "x": 4, "y": 2.2},
{"matrix": [6, 4], "x": 8, "y": 2.2},
{"matrix": [6, 3], "x": 9, "y": 2.1},
{"matrix": [6, 2], "x": 10, "y": 2},
{"matrix": [6, 1], "x": 11, "y": 2.1},
{"matrix": [6, 0], "x": 12, "y": 2.3},
{"matrix": [3, 2], "x": 3, "y": 3.7},
{"matrix": [3, 3], "x": 4, "y": 3.7},
{"matrix": [3, 4], "x": 5, "y": 3.2, "h": 1.5},
{"matrix": [7, 4], "x": 7, "y": 3.2, "h": 1.5},
{"matrix": [7, 3], "x": 8, "y": 3.7},
{"matrix": [7, 2], "x": 9, "y": 3.7}
]
}
}
}
@@ -0,0 +1,64 @@
// Copyright 2026 ToYoNiX <toyonix.assemmohamed.2005@gmail.com>
// SPDX-License-Identifier: GPL-2.0-or-later
#include QMK_KEYBOARD_H
// Home Row Mods - custom modifier order
#define HM_A LSFT_T(KC_A) // Shift
#define HM_S LCTL_T(KC_S) // Ctrl
#define HM_D LGUI_T(KC_D) // Win/GUI
#define HM_F LALT_T(KC_F) // Alt
#define HM_J LALT_T(KC_J) // Alt
#define HM_K LGUI_T(KC_K) // Win/GUI
#define HM_L LCTL_T(KC_L) // Ctrl
#define HM_SCLN RSFT_T(KC_SCLN) // Shift
// Keymap
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
/* BASE Layer: QWERTY */
[0] = LAYOUT_split_3x5_3(
//A8 B15 B14 B13 B12 B12 B13 B14 B15 A8
KC_Q, KC_W, KC_E, KC_R, KC_T, /*B0*/ KC_Y, KC_U, KC_I, KC_O, KC_P,
HM_A, HM_S, HM_D, HM_F, KC_G, /*A5*/ KC_H, HM_J, HM_K, HM_L, HM_SCLN,
KC_Z, KC_X, KC_C, KC_V, KC_B, /*A4*/ KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH,
KC_ESC, KC_SPC, MO(1), /*A3*/ MO(2), KC_BSPC, KC_ENT
),
[1] = LAYOUT_split_3x5_3(
KC_TAB, KC_7, KC_8, KC_9, KC_0, KC_GRV, KC_QUOT, KC_MINS, KC_EQL, KC_NO,
KC_LSFT, KC_4, KC_5, KC_6, KC_PSCR, KC_HOME, KC_LBRC, KC_RBRC, KC_BSLS, KC_RSFT,
KC_LGUI, KC_1, KC_2, KC_3, KC_DEL, KC_END, KC_COMM, KC_DOT, KC_SLSH, KC_NO,
_______, _______, _______, _______, _______, _______
),
[2] = LAYOUT_split_3x5_3(
QK_BOOT, KC_F7, KC_F8, KC_F9, KC_F10, TO(3), KC_NO, KC_NO, KC_NO, KC_NO,
KC_NO, KC_F4, KC_F5, KC_F6, KC_F11, KC_NO, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT,
QK_RBT, KC_F1, KC_F2, KC_F3, KC_F12, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO,
_______, _______, _______, _______, _______, _______
),
// Gaming Layers
[3] = LAYOUT_split_3x5_3(
KC_TAB, KC_Q, KC_W, KC_E, KC_R, TO(0), KC_NO, KC_NO, KC_NO, KC_NO,
KC_LSFT, KC_A, KC_S, KC_D, KC_F, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO,
KC_LCTL, KC_Z, KC_X, KC_C, KC_V, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO,
KC_ESC, KC_SPC, LT(4, KC_LGUI), KC_NO, KC_NO, KC_NO
),
[4] = LAYOUT_split_3x5_3(
KC_NO, KC_7, KC_8, KC_9, KC_0, TO(0), KC_NO, KC_NO, KC_NO, KC_NO,
KC_M, KC_4, KC_5, KC_6, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO,
KC_B, KC_1, KC_2, KC_3, KC_F3, KC_NO, KC_NO, KC_NO, KC_NO, KC_NO,
_______, _______, _______, KC_NO, KC_NO, KC_NO
)
};
// Encoders
#if defined(ENCODER_MAP_ENABLE)
const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
[0] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(MS_WHLD, MS_WHLU) },
[1] = { ENCODER_CCW_CW(KC_NO, KC_NO), ENCODER_CCW_CW(KC_BRIU, KC_BRID) },
[2] = { ENCODER_CCW_CW(KC_PGUP, KC_PGDN), ENCODER_CCW_CW(KC_NO, KC_NO) },
[3] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(KC_NO, KC_NO) },
[4] = { ENCODER_CCW_CW(KC_NO, KC_NO), ENCODER_CCW_CW(KC_NO, KC_NO) },
// Encoder 1 Encoder 2
};
#endif
@@ -0,0 +1 @@
ENCODER_MAP_ENABLE = yes
@@ -0,0 +1,8 @@
// Copyright 2024 zvecr <git@zvecr.com>
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#include_next <mcuconf.h>
#undef STM32_SERIAL_USE_USART1
#define STM32_SERIAL_USE_USART1 TRUE
@@ -0,0 +1,26 @@
# handwired/tnx_corne_f401
![handwired/tnx_corne_f401](https://i.imgur.com/rHiwS60.jpeg)
*A handwired Corne keyboard using STM32 microcontrollers, with encoder support.*
* Keyboard Maintainer: [Assem Mohamed](https://github.com/ToYoNiX)
* Hardware Supported: STM32F401, STM32F411, or STM32F103 development boards with USB HID support
* Hardware Availability: Commonly available Blackpill F401 and Bluepill F103 boards, plus EC11 encoders and a TRRS cable
Make example for this keyboard (after setting up your build environment):
make handwired/tnx_corne_f401:default
Flashing example for this keyboard:
make handwired/tnx_corne_f401:default:flash
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
## Bootloader
Enter the bootloader in 2 ways:
* **Physical reset button**: Double-press the reset button on the dev board to enter DFU mode
* **Keycode in layout**: Press the key mapped to `QK_BOOT`
@@ -0,0 +1,54 @@
{
"manufacturer": "Harry Cutts",
"keyboard_name": "TwentyPad",
"maintainer": "HarryCutts",
"bootloader": "atmel-dfu",
"features": {
"bootmagic": true,
"extrakey": true,
"mousekey": true
},
"matrix_pins": {
"direct": [
["B7", "D5", "B5", "F6"],
["B3", "D3", "B4", "F7"],
["B2", "D2", "D7", "C7"],
["B1", "D1", "D6", "C6"],
["B0", "D0", "D4", "B6"]
]
},
"processor": "atmega32u4",
"url": "https://github.com/HarryCutts/twentypad/",
"usb": {
"device_version": "1.0.0",
"pid": "0x209D",
"vid": "0xFEED"
},
"community_layouts": ["ortho_5x4"],
"layouts": {
"LAYOUT_ortho_5x4": {
"layout": [
{"label": "B7", "matrix": [0, 0], "x": 0, "y": 0},
{"label": "D5", "matrix": [0, 1], "x": 1, "y": 0},
{"label": "B5", "matrix": [0, 2], "x": 2, "y": 0},
{"label": "F6", "matrix": [0, 3], "x": 3, "y": 0},
{"label": "B3", "matrix": [1, 0], "x": 0, "y": 1},
{"label": "D3", "matrix": [1, 1], "x": 1, "y": 1},
{"label": "B4", "matrix": [1, 2], "x": 2, "y": 1},
{"label": "F7", "matrix": [1, 3], "x": 3, "y": 1},
{"label": "B2", "matrix": [2, 0], "x": 0, "y": 2},
{"label": "D2", "matrix": [2, 1], "x": 1, "y": 2},
{"label": "D7", "matrix": [2, 2], "x": 2, "y": 2},
{"label": "C7", "matrix": [2, 3], "x": 3, "y": 2},
{"label": "B1", "matrix": [3, 0], "x": 0, "y": 3},
{"label": "D1", "matrix": [3, 1], "x": 1, "y": 3},
{"label": "D6", "matrix": [3, 2], "x": 2, "y": 3},
{"label": "C6", "matrix": [3, 3], "x": 3, "y": 3},
{"label": "B0", "matrix": [4, 0], "x": 0, "y": 4},
{"label": "D0", "matrix": [4, 1], "x": 1, "y": 4},
{"label": "D4", "matrix": [4, 2], "x": 2, "y": 4},
{"label": "B6", "matrix": [4, 3], "x": 3, "y": 4}
]
}
}
}
@@ -0,0 +1,14 @@
{
"keyboard": "handwired/twentypad",
"keymap": "default",
"layout": "LAYOUT_ortho_5x4",
"layers": [
[
"KC_CALCULATOR", "KC_KP_SLASH", "KC_KP_ASTERISK", "KC_KP_MINUS",
"KC_KP_7", "KC_KP_8", "KC_KP_9", "KC_KP_PLUS",
"KC_KP_4", "KC_KP_5", "KC_KP_6", "KC_LEFT_PAREN",
"KC_KP_1", "KC_KP_2", "KC_KP_3", "KC_RIGHT_PAREN",
"KC_KP_0", "KC_KP_DOT", "KC_KP_EQUAL", "KC_KP_ENTER"
]
]
}
+26
View File
@@ -0,0 +1,26 @@
# TwentyPad
![TwentyPad](https://i.imgur.com/e1Bsg1M.jpeg)
A simple twenty-key macro pad, built to learn PCB design.
* Keyboard Maintainer: [Harry Cutts](https://github.com/HarryCutts)
* Hardware Supported: ATMEGA32U4 on a [custom PCB](https://github.com/HarryCutts/twentypad/)
Make example for this keyboard (after setting up your build environment):
qmk compile -kb handwired/twentypad -km default
Flashing example for this keyboard:
qmk flash -kb handwired/twentypad -km default
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
## Bootloader
Enter the bootloader in 3 ways:
* **Bootmagic reset**: Hold down the key at (0,0) in the matrix (the top left key) and plug in the keyboard
* **Physical reset button**: Press the button marked `SWR1` in the top-left of the PCB
* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available
+10
View File
@@ -0,0 +1,10 @@
// Copyright 2026 Yiancar
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#define WS2812_PWM_DRIVER PWMD3
#define WS2812_PWM_CHANNEL 3
#define WS2812_PWM_PAL_MODE 1
#define WS2812_PWM_DMA_STREAM STM32_DMA1_STREAM3
#define WS2812_PWM_DMA_CHANNEL 3
+8
View File
@@ -0,0 +1,8 @@
// Copyright 2026 Yiancar
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#define HAL_USE_PWM TRUE
#include_next <halconf.h>
+228
View File
@@ -0,0 +1,228 @@
{
"keyboard_name": "NK65 Gen2",
"manufacturer": "Yiancar-Designs",
"url": "www.yiancar-designs.com",
"maintainer": "Yiancar",
"usb": {
"vid": "0x8968",
"pid": "0x4E56",
"device_version": "0.0.1"
},
"features": {
"bootmagic": true,
"extrakey": true,
"mousekey": true,
"nkro": true,
"rgb_matrix": true
},
"ws2812": {
"pin": "B0",
"driver": "pwm"
},
"rgb_matrix": {
"animations": {
"alphas_mods": true,
"band_pinwheel_sat": true,
"band_pinwheel_val": true,
"band_sat": true,
"band_spiral_sat": true,
"band_spiral_val": true,
"band_val": true,
"breathing": true,
"cycle_all": true,
"cycle_left_right": true,
"cycle_out_in": true,
"cycle_out_in_dual": true,
"cycle_pinwheel": true,
"cycle_spiral": true,
"cycle_up_down": true,
"digital_rain": true,
"dual_beacon": true,
"gradient_left_right": true,
"gradient_up_down": true,
"hue_breathing": true,
"hue_pendulum": true,
"hue_wave": true,
"jellybean_raindrops": true,
"multisplash": true,
"pixel_flow": true,
"pixel_fractal": true,
"pixel_rain": true,
"rainbow_beacon": true,
"rainbow_moving_chevron": true,
"rainbow_pinwheels": true,
"raindrops": true,
"solid_multisplash": true,
"solid_reactive": true,
"solid_reactive_cross": true,
"solid_reactive_multicross": true,
"solid_reactive_multinexus": true,
"solid_reactive_multiwide": true,
"solid_reactive_nexus": true,
"solid_reactive_simple": true,
"solid_reactive_wide": true,
"solid_splash": true,
"splash": true,
"typing_heatmap": true
},
"driver": "ws2812",
"layout": [
{"matrix": [0,14], "flags":1, "x":224, "y":0},
{"matrix": [0,13], "flags":1, "x":202, "y":0},
{"matrix": [0,12], "flags":4, "x":179, "y":0},
{"matrix": [0,11], "flags":4, "x":164, "y":0},
{"matrix": [0,10], "flags":4, "x":149, "y":0},
{"matrix": [0,9], "flags":4, "x":134, "y":0},
{"matrix": [0,8], "flags":4, "x":119, "y":0},
{"matrix": [0,7], "flags":4, "x":105, "y":0},
{"matrix": [0,6], "flags":4, "x":90, "y":0},
{"matrix": [0,5], "flags":4, "x":75, "y":0},
{"matrix": [0,4], "flags":4, "x":60, "y":0},
{"matrix": [0,3], "flags":4, "x":45, "y":0},
{"matrix": [0,2], "flags":4, "x":30, "y":0},
{"matrix": [0,1], "flags":4, "x":15, "y":0},
{"matrix": [0,0], "flags":1, "x":0, "y":0},
{"matrix": [1,0], "flags":1, "x":4, "y":16},
{"matrix": [1,1], "flags":4, "x":22, "y":16},
{"matrix": [1,2], "flags":4, "x":37, "y":16},
{"matrix": [1,3], "flags":4, "x":52, "y":16},
{"matrix": [1,4], "flags":4, "x":67, "y":16},
{"matrix": [1,5], "flags":4, "x":82, "y":16},
{"matrix": [1,6], "flags":4, "x":97, "y":16},
{"matrix": [1,7], "flags":4, "x":112, "y":16},
{"matrix": [1,8], "flags":4, "x":127, "y":16},
{"matrix": [1,9], "flags":4, "x":142, "y":16},
{"matrix": [1,10], "flags":4, "x":157, "y":16},
{"matrix": [1,11], "flags":4, "x":172, "y":16},
{"matrix": [1,12], "flags":4, "x":187, "y":16},
{"matrix": [2,12], "flags":4, "x":205, "y":16},
{"matrix": [1,14], "flags":1, "x":224, "y":16},
{"matrix": [2,14], "flags":1, "x":224, "y":32},
{"matrix": [2,13], "flags":1, "x":200, "y":32},
{"matrix": [2,11], "flags":4, "x":175, "y":32},
{"matrix": [2,10], "flags":4, "x":161, "y":32},
{"matrix": [2,9], "flags":4, "x":146, "y":32},
{"matrix": [2,8], "flags":4, "x":131, "y":32},
{"matrix": [2,7], "flags":4, "x":116, "y":32},
{"matrix": [2,6], "flags":4, "x":101, "y":32},
{"matrix": [2,5], "flags":4, "x":86, "y":32},
{"matrix": [2,4], "flags":4, "x":71, "y":32},
{"matrix": [2,3], "flags":4, "x":56, "y":32},
{"matrix": [2,2], "flags":4, "x":41, "y":32},
{"matrix": [2,1], "flags":4, "x":26, "y":32},
{"matrix": [2,0], "flags":1, "x":11, "y":24},
{"matrix": [3,0], "flags":1, "x":9, "y":48},
{"matrix": [3,2], "flags":4, "x":34, "y":48},
{"matrix": [3,3], "flags":4, "x":49, "y":48},
{"matrix": [3,4], "flags":4, "x":63, "y":48},
{"matrix": [3,5], "flags":4, "x":78, "y":48},
{"matrix": [3,6], "flags":4, "x":93, "y":48},
{"matrix": [3,7], "flags":4, "x":108, "y":48},
{"matrix": [3,8], "flags":4, "x":123, "y":48},
{"matrix": [3,9], "flags":4, "x":138, "y":48},
{"matrix": [3,10], "flags":4, "x":153, "y":48},
{"matrix": [3,11], "flags":4, "x":168, "y":48},
{"matrix": [3,12], "flags":1, "x":189, "y":48},
{"matrix": [3,13], "flags":1, "x":209, "y":48},
{"matrix": [3,14], "flags":1, "x":224, "y":48},
{"matrix": [4,14], "flags":1, "x":224, "y":64},
{"matrix": [4,13], "flags":1, "x":209, "y":64},
{"matrix": [4,12], "flags":1, "x":194, "y":64},
{"matrix": [4,11], "flags":1, "x":168, "y":64},
{"matrix": [4,6], "flags":4, "x":105, "y":64},
{"matrix": [4,2], "flags":1, "x":41, "y":64},
{"matrix": [4,1], "flags":1, "x":22, "y":64},
{"matrix": [4,0], "flags":1, "x":4, "y":64},
{"matrix": [4,0], "flags":8, "x":0, "y":0},
{"matrix": [4,0], "flags":8, "x":0, "y":0}
],
"max_brightness": 130,
"sleep": true
},
"matrix_pins": {
"cols": ["B12", "B13", "B14", "B15", "A8", "A10", "A14", "A15", "B3", "B4", "B5", "B6", "B7", "B8", "B9"],
"rows": ["B10", "B2", "B1", "A9", "A5"]
},
"diode_direction": "COL2ROW",
"processor": "STM32F072",
"bootloader": "stm32-dfu",
"layout_aliases": {
"LAYOUT": "LAYOUT_65_ansi_blocker_tsangan"
},
"layouts": {
"LAYOUT_65_ansi_blocker_tsangan": {
"layout": [
{"matrix": [0, 0], "x": 0, "y": 0},
{"matrix": [0, 1], "x": 1, "y": 0},
{"matrix": [0, 2], "x": 2, "y": 0},
{"matrix": [0, 3], "x": 3, "y": 0},
{"matrix": [0, 4], "x": 4, "y": 0},
{"matrix": [0, 5], "x": 5, "y": 0},
{"matrix": [0, 6], "x": 6, "y": 0},
{"matrix": [0, 7], "x": 7, "y": 0},
{"matrix": [0, 8], "x": 8, "y": 0},
{"matrix": [0, 9], "x": 9, "y": 0},
{"matrix": [0, 10], "x": 10, "y": 0},
{"matrix": [0, 11], "x": 11, "y": 0},
{"matrix": [0, 12], "x": 12, "y": 0},
{"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
{"matrix": [0, 14], "x": 15, "y": 0},
{"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
{"matrix": [1, 1], "x": 1.5, "y": 1},
{"matrix": [1, 2], "x": 2.5, "y": 1},
{"matrix": [1, 3], "x": 3.5, "y": 1},
{"matrix": [1, 4], "x": 4.5, "y": 1},
{"matrix": [1, 5], "x": 5.5, "y": 1},
{"matrix": [1, 6], "x": 6.5, "y": 1},
{"matrix": [1, 7], "x": 7.5, "y": 1},
{"matrix": [1, 8], "x": 8.5, "y": 1},
{"matrix": [1, 9], "x": 9.5, "y": 1},
{"matrix": [1, 10], "x": 10.5, "y": 1},
{"matrix": [1, 11], "x": 11.5, "y": 1},
{"matrix": [1, 12], "x": 12.5, "y": 1},
{"matrix": [2, 12], "x": 13.5, "y": 1, "w": 1.5},
{"matrix": [1, 14], "x": 15, "y": 1},
{"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
{"matrix": [2, 1], "x": 1.75, "y": 2},
{"matrix": [2, 2], "x": 2.75, "y": 2},
{"matrix": [2, 3], "x": 3.75, "y": 2},
{"matrix": [2, 4], "x": 4.75, "y": 2},
{"matrix": [2, 5], "x": 5.75, "y": 2},
{"matrix": [2, 6], "x": 6.75, "y": 2},
{"matrix": [2, 7], "x": 7.75, "y": 2},
{"matrix": [2, 8], "x": 8.75, "y": 2},
{"matrix": [2, 9], "x": 9.75, "y": 2},
{"matrix": [2, 10], "x": 10.75, "y": 2},
{"matrix": [2, 11], "x": 11.75, "y": 2},
{"matrix": [2, 13], "x": 12.75, "y": 2, "w": 2.25},
{"matrix": [2, 14], "x": 15, "y": 2},
{"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
{"matrix": [3, 2], "x": 2.25, "y": 3},
{"matrix": [3, 3], "x": 3.25, "y": 3},
{"matrix": [3, 4], "x": 4.25, "y": 3},
{"matrix": [3, 5], "x": 5.25, "y": 3},
{"matrix": [3, 6], "x": 6.25, "y": 3},
{"matrix": [3, 7], "x": 7.25, "y": 3},
{"matrix": [3, 8], "x": 8.25, "y": 3},
{"matrix": [3, 9], "x": 9.25, "y": 3},
{"matrix": [3, 10], "x": 10.25, "y": 3},
{"matrix": [3, 11], "x": 11.25, "y": 3},
{"matrix": [3, 12], "x": 12.25, "y": 3, "w": 1.75},
{"matrix": [3, 13], "x": 14, "y": 3},
{"matrix": [3, 14], "x": 15, "y": 3},
{"matrix": [4, 0], "x": 0, "y": 4, "w": 1.5},
{"matrix": [4, 1], "x": 1.5, "y": 4, "w": 1},
{"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.5},
{"matrix": [4, 6], "x": 4, "y": 4, "w": 7},
{"matrix": [4, 11], "x": 11, "y": 4, "w": 1.5},
{"matrix": [4, 12], "x": 13, "y": 4},
{"matrix": [4, 13], "x": 14, "y": 4},
{"matrix": [4, 14], "x": 15, "y": 4}
]
}
}
}
+35
View File
@@ -0,0 +1,35 @@
// Copyright 2026 Yiancar
// SPDX-License-Identifier: GPL-2.0-or-later
#include QMK_KEYBOARD_H
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
[0] = LAYOUT_65_ansi_blocker_tsangan( /* Base */
QK_GESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_BSPC, KC_HOME,
KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS, KC_PGUP,
KC_CAPS, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_ENT, KC_PGDN,
KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, MO(1), KC_LEFT, KC_DOWN, KC_RGHT),
[1] = LAYOUT_65_ansi_blocker_tsangan( /* FN */
KC_GRV, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, KC_DEL, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, QK_BOOT, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
KC_TRNS, RM_TOGG, RM_NEXT, RM_HUED, RM_HUEU, RM_SATD, RM_SATU, RM_VALD, RM_VALU, RM_SPDD, RM_SPDU, KC_TRNS, KC_TRNS, KC_TRNS,
KC_VOLU, KC_VOLD, KC_MUTE, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
};
bool rgb_matrix_indicators_user(void) {
if (host_keyboard_led_state().caps_lock) {
rgb_matrix_set_color(66, 5, 2, 1);
} else {
rgb_matrix_set_color(66, 0, 0, 0);
}
if (get_highest_layer(layer_state|default_layer_state) == 1) {
rgb_matrix_set_color(67, 3, 1, 5);
} else {
rgb_matrix_set_color(67, 0, 0, 0);
}
return false;
}
+9
View File
@@ -0,0 +1,9 @@
// Copyright 2026 Yiancar
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#include_next <mcuconf.h>
#undef STM32_PWM_USE_TIM3
#define STM32_PWM_USE_TIM3 TRUE
+32
View File
@@ -0,0 +1,32 @@
# NK66 Gen2
This is a tsangan fixed layout 65% PCB. It supports full per-key RGB.
* Keyboard Maintainer: [Yiancar](http://yiancar-designs.com/) and on [GitHub](https://github.com/yiancar)
* Hardware Supported: A 65% keyboard with STM32F072CB
* Hardware Availability: https://novelkeys.com/
Make example for this keyboard (after setting up your build environment):
make novelkeys/nk65_gen2:default
Flashing example for this keyboard:
make novelkeys/nk65_gen2:default:flash
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
### Reset
- Unplug
- Hold Escape
- Plug In
- Unplug
- Release Escape
### Flash
- Unplug
- Hold Escape
- Plug In
- Flash using QMK Toolbox or CLI (`make novelkeys/nk65_gen2:<keymap>:flash`)
+2 -2
View File
@@ -78,9 +78,9 @@ typedef enum {
UP_BEGIN_MID,
STATE_MASK = 0xf, /* 0b1111 */
EMIT_UP = 0x10,
EMIT_UP_MID = EMIT_UP & START_MID,
EMIT_UP_MID = EMIT_UP | START_MID,
EMIT_DOWN = 0x80,
EMIT_DOWN_MID = EMIT_DOWN & START_MID,
EMIT_DOWN_MID = EMIT_DOWN | START_MID,
EMIT_MASK = 0xf0
} encoder_state_t;
-3
View File
@@ -113,9 +113,6 @@ class BuildTarget:
'builddefs/build_keyboard.mk',
]
if not cli.config.general.verbose:
compile_args.append('-s')
verbose = 'true' if cli.config.general.verbose else 'false'
color = 'true' if cli.config.general.color else 'false'
+1 -1
View File
@@ -28,7 +28,7 @@ def _get_default_distrib_path():
# Ensure the QMK distribution is on the `$PATH` if present. This must be kept in sync with qmk/qmk_cli.
QMK_DISTRIB_DIR = Path(os.environ.get('QMK_DISTRIB_DIR', _get_default_distrib_path()))
QMK_DISTRIB_DIR = Path(os.environ['QMK_DISTRIB_DIR'] if 'QMK_DISTRIB_DIR' in os.environ else _get_default_distrib_path())
if QMK_DISTRIB_DIR.exists():
os.environ['PATH'] = str(QMK_DISTRIB_DIR / 'bin') + os.pathsep + os.environ['PATH']
@@ -41,7 +41,7 @@
#define STM32_NO_INIT FALSE
#define STM32_CLOCK_DYNAMIC TRUE
#define STM32_VOS STM32_VOS_RANGE1
#define STM32_PWR_CR2 (STM32_PVDRT_LEV0 | STM32_PVDFT_LEV0 | STM32_PVDE_DISABLED)
#define STM32_PWR_CR2 PWR_CR2_PVMEN_USB
#define STM32_PWR_CR3 (PWR_CR3_EIWUL)
#define STM32_PWR_CR4 (0U)
#define STM32_PWR_PUCRA (0U)
+1 -1
View File
@@ -359,7 +359,7 @@ __EOT__
*gentoo*)
echo "It will also install the following system packages using 'emerge':" >&2
print_package_manager_deps_and_delay
$(nsudo) emerge-webrsync
$(nsudo) emaint sync
$(nsudo) emerge --noreplace --ask=n $(get_package_manager_deps | tr ' ' '\n') || signal_execution_failure
exit_if_execution_failed
;;