diff --git a/keyboards/htx_studio/one_handed_keyboard/config.h b/keyboards/htx_studio/one_handed_keyboard/config.h new file mode 100644 index 00000000000..3aae0ddf059 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/config.h @@ -0,0 +1,39 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#pragma once + +#define SPI_DRIVER SPID1 +#define SPI_SCK_PIN A5 +#define SPI_MISO_PIN A6 +#define SPI_MOSI_PIN A7 + +#define POINTING_DEVICE_CS_PIN A4 +#define POINTING_DEVICE_MOTION_PIN A3 +#define POINTING_DEVICE_TASK_THROTTLE_MS 1 +#define POINTING_DEVICE_INVERT_X 1 + +#define ENCODER_RESOLUTION 2 + +#ifdef RGB_MATRIX_ENABLE + +#define WS2812_PWM_DRIVER PWMD3 +#define WS2812_PWM_CHANNEL 1 +#define WS2812_DMA_STREAM STM32_DMA1_STREAM1 +#define WS2812_DMA_CHANNEL 1 +#define WS2812_DMAMUX_ID STM32_DMAMUX1_TIM3_UP + +#endif diff --git a/keyboards/htx_studio/one_handed_keyboard/halconf.h b/keyboards/htx_studio/one_handed_keyboard/halconf.h new file mode 100644 index 00000000000..2a2e3eb2093 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/halconf.h @@ -0,0 +1,25 @@ +/* Copyright 2020 QMK + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + + #pragma once + + #define HAL_USE_PWM TRUE + #define HAL_USE_SPI TRUE + #define SPI_USE_WAIT TRUE + #define SPI_SELECT_MODE SPI_SELECT_MODE_PAD + + #include_next + \ No newline at end of file diff --git a/keyboards/htx_studio/one_handed_keyboard/info.json b/keyboards/htx_studio/one_handed_keyboard/info.json new file mode 100644 index 00000000000..cc1e79ca309 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/info.json @@ -0,0 +1,25 @@ +{ + "manufacturer": "HTXStudio", + "maintainer": "HTXStudio", + "bootloader": "stm32-dfu", + "diode_direction": "ROW2COL", + "encoder": { + "rotary": [ + {"pin_a": "A9", "pin_b": "A10"} + ] + }, + "features": { + "bootmagic": true, + "encoder": true, + "extrakey": true, + "mousekey": true, + "nkro": true, + "pointing_device": true + }, + "matrix_pins": { + "cols": ["A0", "A1", "A2", "C4", "B0", "B1", "B2", "B7", "B5", "B3", "B10", "C11", "C10", "A15"], + "rows": ["B12", "B15", "C6", "B13", "B14", "A8"] + }, + "processor": "STM32G431", + "url": "https://github.com/htx-studio" +} diff --git a/keyboards/htx_studio/one_handed_keyboard/mcuconf.h b/keyboards/htx_studio/one_handed_keyboard/mcuconf.h new file mode 100644 index 00000000000..bf00e666145 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mcuconf.h @@ -0,0 +1,26 @@ +/* Copyright 2020 QMK + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + + #pragma once + + #include_next + +#undef STM32_SPI_USE_SPI1 +#define STM32_SPI_USE_SPI1 TRUE + +/* enable TIM3, used for RGB LED PWM driver */ +#undef STM32_PWM_USE_TIM3 +#define STM32_PWM_USE_TIM3 TRUE diff --git a/keyboards/htx_studio/one_handed_keyboard/ml/keyboard.json b/keyboards/htx_studio/one_handed_keyboard/ml/keyboard.json new file mode 100644 index 00000000000..5c50ad6f8a2 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/ml/keyboard.json @@ -0,0 +1,196 @@ +{ + "keyboard_name": "One-Handed_Keyboard_ML", + "features": { + "rgb_matrix": true + }, + "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, 0], "x": 0, "y": 0, "flags": 4}, + {"matrix": [0, 1], "x": 17, "y": 0, "flags": 4}, + {"matrix": [0, 2], "x": 34, "y": 0, "flags": 4}, + {"matrix": [0, 3], "x": 51, "y": 0, "flags": 4}, + {"matrix": [0, 4], "x": 68, "y": 0, "flags": 4}, + {"matrix": [0, 5], "x": 85, "y": 0, "flags": 4}, + {"matrix": [0, 6], "x": 102, "y": 0, "flags": 4}, + {"matrix": [0, 7], "x": 119, "y": 0, "flags": 4}, + {"matrix": [0, 8], "x": 136, "y": 0, "flags": 4}, + {"matrix": [0, 9], "x": 153, "y": 0, "flags": 4}, + {"matrix": [0, 10], "x": 170, "y": 0, "flags": 4}, + {"matrix": [0, 11], "x": 187, "y": 0, "flags": 4}, + {"matrix": [0, 12], "x": 204, "y": 0, "flags": 4}, + {"matrix": [0, 13], "x": 221, "y": 0, "flags": 4}, + {"matrix": [1, 0], "x": 0, "y": 16, "flags": 4}, + {"matrix": [1, 1], "x": 17, "y": 16, "flags": 4}, + {"matrix": [1, 2], "x": 34, "y": 16, "flags": 4}, + {"matrix": [1, 3], "x": 51, "y": 16, "flags": 4}, + {"matrix": [1, 4], "x": 68, "y": 16, "flags": 4}, + {"matrix": [1, 5], "x": 85, "y": 16, "flags": 4}, + {"matrix": [1, 6], "x": 102, "y": 16, "flags": 4}, + {"matrix": [1, 7], "x": 119, "y": 16, "flags": 4}, + {"matrix": [1, 8], "x": 136, "y": 16, "flags": 4}, + {"matrix": [1, 9], "x": 153, "y": 16, "flags": 4}, + {"matrix": [1, 10], "x": 170, "y": 16, "flags": 4}, + {"matrix": [1, 11], "x": 187, "y": 16, "flags": 4}, + {"matrix": [1, 12], "x": 204, "y": 16, "flags": 4}, + {"matrix": [1, 13], "x": 221, "y": 16, "flags": 4}, + {"matrix": [2, 0], "x": 3, "y": 32, "flags": 4}, + {"matrix": [2, 2], "x": 23, "y": 32, "flags": 4}, + {"matrix": [2, 3], "x": 40, "y": 32, "flags": 4}, + {"matrix": [2, 4], "x": 57, "y": 32, "flags": 4}, + {"matrix": [2, 5], "x": 74, "y": 32, "flags": 4}, + {"matrix": [2, 6], "x": 91, "y": 32, "flags": 4}, + {"matrix": [2, 7], "x": 108, "y": 32, "flags": 4}, + {"matrix": [2, 8], "x": 125, "y": 32, "flags": 4}, + {"matrix": [2, 9], "x": 142, "y": 32, "flags": 4}, + {"matrix": [2, 10], "x": 159, "y": 32, "flags": 4}, + {"matrix": [2, 12], "x": 176, "y": 32, "flags": 4}, + {"matrix": [2, 13], "x": 200, "y": 32, "flags": 4}, + {"matrix": [3, 0], "x": 6, "y": 48, "flags": 4}, + {"matrix": [3, 3], "x": 31, "y": 48, "flags": 4}, + {"matrix": [3, 4], "x": 50, "y": 48, "flags": 4}, + {"matrix": [3, 5], "x": 69, "y": 48, "flags": 4}, + {"matrix": [3, 6], "x": 88, "y": 48, "flags": 4}, + {"matrix": [3, 7], "x": 107, "y": 48, "flags": 4}, + {"matrix": [3, 8], "x": 126, "y": 48, "flags": 4}, + {"matrix": [3, 9], "x": 145, "y": 48, "flags": 4}, + {"matrix": [3, 10], "x": 180, "y": 48, "flags": 4}, + {"matrix": [3, 13], "x": 215, "y": 48, "flags": 4}, + {"matrix": [4, 0], "x": 22, "y": 64, "flags": 4}, + {"matrix": [4, 3], "x": 43, "y": 64, "flags": 4}, + {"matrix": [4, 4], "x": 64, "y": 64, "flags": 4}, + {"matrix": [4, 5], "x": 95, "y": 64, "flags": 4}, + {"matrix": [4, 6], "x": 116, "y": 64, "flags": 4}, + {"matrix": [4, 7], "x": 137, "y": 64, "flags": 4}, + {"matrix": [4, 9], "x": 158, "y": 64, "flags": 4}, + {"matrix": [4, 12], "x": 179, "y": 64, "flags": 4}, + {"matrix": [4, 13], "x": 221, "y": 64, "flags": 4} + ], + "max_brightness": 110, + "sleep": true + }, + "usb": { + "device_version": "3.1.0", + "pid": "0x03AF", + "vid": "0x475D" + }, + "ws2812": { + "driver": "pwm", + "pin": "B4" + }, + "layouts": { + "LAYOUT": { + "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}, + {"matrix": [1, 0], "x": 0, "y": 1}, + {"matrix": [1, 1], "x": 1, "y": 1}, + {"matrix": [1, 2], "x": 2, "y": 1}, + {"matrix": [1, 3], "x": 3, "y": 1}, + {"matrix": [1, 4], "x": 4, "y": 1}, + {"matrix": [1, 5], "x": 5, "y": 1}, + {"matrix": [1, 6], "x": 6, "y": 1}, + {"matrix": [1, 7], "x": 7, "y": 1}, + {"matrix": [1, 8], "x": 8, "y": 1}, + {"matrix": [1, 9], "x": 9, "y": 1}, + {"matrix": [1, 10], "x": 10, "y": 1}, + {"matrix": [1, 11], "x": 11, "y": 1}, + {"matrix": [1, 12], "x": 12, "y": 1}, + {"matrix": [1, 13], "x": 13, "y": 1}, + {"matrix": [2, 0], "x": 0.5, "y": 2, "w": 1.5}, + {"matrix": [2, 2], "x": 2, "y": 2}, + {"matrix": [2, 3], "x": 3, "y": 2}, + {"matrix": [2, 4], "x": 4, "y": 2}, + {"matrix": [2, 5], "x": 5, "y": 2}, + {"matrix": [2, 6], "x": 6, "y": 2}, + {"matrix": [2, 7], "x": 7, "y": 2}, + {"matrix": [2, 8], "x": 8, "y": 2}, + {"matrix": [2, 9], "x": 9, "y": 2}, + {"matrix": [2, 10], "x": 10, "y": 2}, + {"matrix": [2, 12], "x": 11, "y": 2, "w": 1.5}, + {"matrix": [2, 13], "x": 12.5, "y": 2}, + {"matrix": [3, 0], "x": 1, "y": 3, "w": 2}, + {"matrix": [3, 3], "x": 3, "y": 3}, + {"matrix": [3, 4], "x": 4, "y": 3}, + {"matrix": [3, 5], "x": 5, "y": 3}, + {"matrix": [3, 6], "x": 6, "y": 3}, + {"matrix": [3, 7], "x": 7, "y": 3}, + {"matrix": [3, 8], "x": 8, "y": 3}, + {"matrix": [3, 9], "x": 9, "y": 3}, + {"matrix": [3, 10], "x": 10, "y": 3, "w": 2}, + {"matrix": [3, 13], "x": 12, "y": 3, "w": 2}, + {"matrix": [4, 0], "x": 1.25, "y": 4, "w": 1.25}, + {"matrix": [4, 3], "x": 2.5, "y": 4, "w": 1.25}, + {"matrix": [4, 4], "x": 3.75, "y": 4, "w": 1.25}, + {"matrix": [4, 5], "x": 5, "y": 4, "w": 1.25}, + {"matrix": [4, 6], "x": 6.25, "y": 4, "w": 1.25}, + {"matrix": [4, 7], "x": 7.5, "y": 4, "w": 1.25}, + {"matrix": [4, 9], "x": 8.75, "y": 4, "w": 1.25}, + {"matrix": [4, 12], "x": 10.75, "y": 4, "w": 2}, + {"matrix": [4, 13], "x": 12, "y": 4, "w": 1.25}, + {"matrix": [5, 0], "x": 0, "y": 5}, + {"matrix": [5, 3], "x": 3, "y": 5}, + {"matrix": [5, 4], "x": 4, "y": 5}, + {"matrix": [5, 5], "x": 5, "y": 5}, + {"matrix": [5, 6], "x": 6, "y": 5} + ] + } + } +} diff --git a/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/keymap.c b/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/keymap.c new file mode 100644 index 00000000000..dcf2cb1b0fa --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/keymap.c @@ -0,0 +1,108 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include QMK_KEYBOARD_H +#include "one_handed_keyboard.h" + +enum my_keycodes { + DPI_UP = SAFE_RANGE, + DPI_DOWN +}; + +const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + +// ┏━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┓ +// ┃ ESC ┃ 1 ┃ 2 ┃ 3 ┃ 4 ┃ 5 ┃ 6 ┃ 7 ┃ 8 ┃ 9 ┃ 0 ┃ -_ ┃ += ┃ `~ ┃ +// ┣━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┫ +// ┃ TAB ┃ Q ┃ W ┃ E ┃ R ┃ T ┃ Y ┃ U ┃ I ┃ O ┃ P ┃ [{ ┃ ]} ┃ :; ┃ +// ┗━━━┳━━━┻━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┻━━━┳━━━┛ +// ┃ CAPSLOCK ┃ A ┃ S ┃ D ┃ F ┃ G ┃ H ┃ J ┃ K ┃ L ┃ '" ┃ ENTER ┃ +// ┗━━━┳━━━━━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━━━━━┻━┳━━━━━┻━━━━━━━┳━━━┛ +// ┃ SHIFT ┃ Z ┃ X ┃ C ┃ V ┃ B ┃ N ┃ M ┃ MOUSE1 ┃ MOUSE2 ┃ +// ┗━━━┳━━━━━━━┻┳━━━━━━┻━┳━━━━━┻━━┳━━━━┻━━━┳━━━┻━━━━┳━━┻━━━━━┳━┻━━━━━━┳┻━━━━━━━━━━━━━┻┳━━━━━━━━┳━━━┛ +// ┃ CTRL ┃ LGUI ┃ LALT ┃ ,< ┃ .> ┃ /? ┃ Fn ┃ SPC ┃ BACK ┃ +// ┗━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━━━━━━━━┻━━━━━━━━┛ +// ┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓ +// ┃ MOUSE3 ┃ → ┃ ↓ ┃ ← ┃ ↑ ┃ +// ┗━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┛ + + [0] = LAYOUT( + KC_ESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINUS, KC_EQUAL, KC_GRAVE, + KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LEFT_BRACKET, KC_RIGHT_BRACKET, KC_SEMICOLON, + KC_CAPS_LOCK, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_QUOTE, KC_ENTER, + KC_LEFT_SHIFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, QK_MOUSE_BUTTON_1, QK_MOUSE_BUTTON_2, + KC_LEFT_CTRL, KC_LEFT_GUI, KC_LEFT_ALT, KC_COMMA, KC_DOT, KC_SLASH, MO(1), KC_SPC, KC_BACKSPACE, + + QK_MOUSE_BUTTON_3, KC_RIGHT, KC_DOWN, KC_LEFT, KC_UP + ), + +// ┏━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┓ +// ┃ ┃ F1 ┃ F2 ┃ F3 ┃ F4 ┃ F5 ┃ F6 ┃ F7 ┃ F8 ┃ F9 ┃ F10 ┃ F11 ┃ F12 ┃ ┃ +// ┣━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┫ +// ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃RM_HUED┃RM_HUEU┃ ┃ DPI_DO┃ DPI_UP┃ ┃ +// ┗━━━┳━━━┻━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┻━━━┳━━━┛ +// ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃RM_SATD┃RM_SATU┃ ┃ ┃ ┃ +// ┗━━━┳━━━━━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━━━━━┻━┳━━━━━┻━━━━━━━┳━━━┛ +// ┃ ┃ ┃ ┃ ┃ ┃ ┃RM_SPDD┃RM_SPDU┃ MOUSE1 ┃ MOUSE2 ┃ +// ┗━━━┳━━━━━━━┻┳━━━━━━┻━┳━━━━━┻━━┳━━━━┻━━━┳━━━┻━━━━┳━━┻━━━━━┳━┻━━━━━━┳┻━━━━━━━━━━━━━┻┳━━━━━━━━┳━━━┛ +// ┃ ┃ ┃ ┃ ┃ ┃ \| ┃ ┃ RM_TOGG ┃ DEL ┃ +// ┗━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━━━━━━━━┻━━━━━━━━┛ +// ┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓ +// ┃ MOUSE3 ┃ RM_PREV ┃ RM_VALD ┃ RM_NEXT ┃ RM_VALU ┃ +// ┗━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┛ + + + [1] = LAYOUT( + _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, + _______, _______, _______, _______, _______, _______, _______, _______, RM_HUED, RM_HUEU, _______, DPI_DOWN, DPI_UP, _______, + _______, _______, _______, _______, _______, _______, _______, RM_SATD, RM_SATU, _______, _______, _______, + _______, _______, _______, _______, _______, _______, RM_SPDD, RM_SPDU, QK_MOUSE_BUTTON_1, QK_MOUSE_BUTTON_2, + _______, _______, _______, _______, _______, KC_BSLS, _______, RM_TOGG, KC_DEL, + + QK_MOUSE_BUTTON_3, RM_PREV, RM_VALD, RM_NEXT, RM_VALU + ), +}; + +#if defined(ENCODER_MAP_ENABLE) +const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = { + [0] = {ENCODER_CCW_CW(MS_WHLU, MS_WHLD)}, + [1] = {ENCODER_CCW_CW(MS_WHLD, MS_WHLU)} +}; +#endif + +// ADNS9800. The CPI range is 800-8200, in increments of 200. +bool process_record_user(uint16_t keycode, keyrecord_t *record) { + switch (keycode) { + case DPI_UP: { + if (record->event.pressed) { + pointing_adns9800_cpi_up(); + } + break; + } + case DPI_DOWN: { + if (record->event.pressed) { + pointing_adns9800_cpi_down(); + } + break; + } + default: break; + } + return true; +} + +void eeconfig_init_user(void) { + pointing_adns9800_reset(); +} diff --git a/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/rules.mk b/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/rules.mk new file mode 100644 index 00000000000..737257c5d8d --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/ml/keymaps/default/rules.mk @@ -0,0 +1,7 @@ +SPI_DRIVER_REQUIRED = yes +ENCODER_MAP_ENABLE = yes +RGB_MATRIX_ENABLE = yes +WS2812_DRIVER = pwm + +POINTING_DEVICE_ENABLE = yes +POINTING_DEVICE_DRIVER = adns9800 diff --git a/keyboards/htx_studio/one_handed_keyboard/ml/ml.c b/keyboards/htx_studio/one_handed_keyboard/ml/ml.c new file mode 100644 index 00000000000..6deb797a4ab --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/ml/ml.c @@ -0,0 +1,27 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include "rgb_matrix.h" +#include "host.h" + +bool rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max) { + if (host_keyboard_led_state().caps_lock) { + RGB_MATRIX_INDICATOR_SET_COLOR(28, 255, 255, 255); // assuming caps lock is at led #5 + } else { + RGB_MATRIX_INDICATOR_SET_COLOR(28, 0, 0, 0); + } + return false; +} diff --git a/keyboards/htx_studio/one_handed_keyboard/ml/readme.md b/keyboards/htx_studio/one_handed_keyboard/ml/readme.md new file mode 100644 index 00000000000..dd49d41133a --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/ml/readme.md @@ -0,0 +1,29 @@ +# One-Handed_Keyboard_ML + +![左手大键盘](https://imgur.com/QjQSxhP.jpg) + +This is a keyboard with a fan-shaped layout and 59 keys.The commonly used buttons are placed near the thumb. + +* Keyboard Maintainer:[HTX Studio](https://github.com/htx-studio) +* Hardware Supported:HTX_STUDIO_ONE-HANDEN_KEYBOARD_ML PCB +* Hardware Availability:[One-Handed-Keyboard](https://github.com/htx-studio/One-Handed-Keyboard/tree/main/Hardware) + +## How to compile + +Make example for this keyboard (after setting up your build environment): + + `make htx_studio/one_handed_keyboard/ml:default` + +Flashing example for this keyboard: + + `make htx_studio/one_handed_keyboard/ml: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 3 ways: + +* **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard +* **Physical reset button**: Hold the "B" button on the back of the PCB (the one closest to the MCU) and briefly press the "R" button on the back of the PCB +* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available diff --git a/keyboards/htx_studio/one_handed_keyboard/mr/keyboard.json b/keyboards/htx_studio/one_handed_keyboard/mr/keyboard.json new file mode 100644 index 00000000000..c543b1643b1 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mr/keyboard.json @@ -0,0 +1,196 @@ +{ + "keyboard_name": "One-Handed_Keyboard_MR", + "features": { + "rgb_matrix": true + }, + "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, 0], "x": 0, "y": 0, "flags": 4}, + {"matrix": [0, 1], "x": 17, "y": 0, "flags": 4}, + {"matrix": [0, 2], "x": 34, "y": 0, "flags": 4}, + {"matrix": [0, 3], "x": 51, "y": 0, "flags": 4}, + {"matrix": [0, 4], "x": 68, "y": 0, "flags": 4}, + {"matrix": [0, 5], "x": 85, "y": 0, "flags": 4}, + {"matrix": [0, 6], "x": 102, "y": 0, "flags": 4}, + {"matrix": [0, 7], "x": 119, "y": 0, "flags": 4}, + {"matrix": [0, 8], "x": 136, "y": 0, "flags": 4}, + {"matrix": [0, 9], "x": 153, "y": 0, "flags": 4}, + {"matrix": [0, 10], "x": 170, "y": 0, "flags": 4}, + {"matrix": [0, 11], "x": 187, "y": 0, "flags": 4}, + {"matrix": [0, 12], "x": 204, "y": 0, "flags": 4}, + {"matrix": [0, 13], "x": 221, "y": 0, "flags": 4}, + {"matrix": [1, 0], "x": 0, "y": 16, "flags": 4}, + {"matrix": [1, 1], "x": 17, "y": 16, "flags": 4}, + {"matrix": [1, 2], "x": 34, "y": 16, "flags": 4}, + {"matrix": [1, 3], "x": 51, "y": 16, "flags": 4}, + {"matrix": [1, 4], "x": 68, "y": 16, "flags": 4}, + {"matrix": [1, 5], "x": 85, "y": 16, "flags": 4}, + {"matrix": [1, 6], "x": 102, "y": 16, "flags": 4}, + {"matrix": [1, 7], "x": 119, "y": 16, "flags": 4}, + {"matrix": [1, 8], "x": 136, "y": 16, "flags": 4}, + {"matrix": [1, 9], "x": 153, "y": 16, "flags": 4}, + {"matrix": [1, 10], "x": 170, "y": 16, "flags": 4}, + {"matrix": [1, 11], "x": 187, "y": 16, "flags": 4}, + {"matrix": [1, 12], "x": 204, "y": 16, "flags": 4}, + {"matrix": [1, 13], "x": 221, "y": 16, "flags": 4}, + {"matrix": [2, 0], "x": 3, "y": 32, "flags": 4}, + {"matrix": [2, 1], "x": 23, "y": 32, "flags": 4}, + {"matrix": [2, 2], "x": 40, "y": 32, "flags": 4}, + {"matrix": [2, 3], "x": 57, "y": 32, "flags": 4}, + {"matrix": [2, 5], "x": 74, "y": 32, "flags": 4}, + {"matrix": [2, 6], "x": 91, "y": 32, "flags": 4}, + {"matrix": [2, 7], "x": 108, "y": 32, "flags": 4}, + {"matrix": [2, 8], "x": 125, "y": 32, "flags": 4}, + {"matrix": [2, 9], "x": 142, "y": 32, "flags": 4}, + {"matrix": [2, 10], "x": 159, "y": 32, "flags": 4}, + {"matrix": [2, 11], "x": 176, "y": 32, "flags": 4}, + {"matrix": [2, 13], "x": 200, "y": 32, "flags": 4}, + {"matrix": [3, 0], "x": 21, "y": 48, "flags": 4}, + {"matrix": [3, 2], "x": 42, "y": 48, "flags": 4}, + {"matrix": [3, 3], "x": 62, "y": 48, "flags": 4}, + {"matrix": [3, 5], "x": 81, "y": 48, "flags": 4}, + {"matrix": [3, 6], "x": 100, "y": 48, "flags": 4}, + {"matrix": [3, 7], "x": 119, "y": 48, "flags": 4}, + {"matrix": [3, 9], "x": 138, "y": 48, "flags": 4}, + {"matrix": [3, 10], "x": 157, "y": 48, "flags": 4}, + {"matrix": [3, 11], "x": 176, "y": 48, "flags": 4}, + {"matrix": [3, 13], "x": 200, "y": 48, "flags": 4}, + {"matrix": [4, 0], "x": 24, "y": 64, "flags": 4}, + {"matrix": [4, 2], "x": 64, "y": 64, "flags": 4}, + {"matrix": [4, 3], "x": 95, "y": 64, "flags": 4}, + {"matrix": [4, 5], "x": 116, "y": 64, "flags": 4}, + {"matrix": [4, 7], "x": 137, "y": 64, "flags": 4}, + {"matrix": [4, 9], "x": 158, "y": 64, "flags": 4}, + {"matrix": [4, 10], "x": 179, "y": 64, "flags": 4}, + {"matrix": [4, 12], "x": 200, "y": 64, "flags": 4}, + {"matrix": [4, 13], "x": 221, "y": 64, "flags": 4} + ], + "max_brightness": 110, + "sleep": true + }, + "usb": { + "device_version": "3.1.0", + "pid": "0x03BF", + "vid": "0x475D" + }, + "ws2812": { + "driver": "pwm", + "pin": "B4" + }, + "layouts": { + "LAYOUT": { + "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}, + {"matrix": [1, 0], "x": 0, "y": 1}, + {"matrix": [1, 1], "x": 1, "y": 1}, + {"matrix": [1, 2], "x": 2, "y": 1}, + {"matrix": [1, 3], "x": 3, "y": 1}, + {"matrix": [1, 4], "x": 4, "y": 1}, + {"matrix": [1, 5], "x": 5, "y": 1}, + {"matrix": [1, 6], "x": 6, "y": 1}, + {"matrix": [1, 7], "x": 7, "y": 1}, + {"matrix": [1, 8], "x": 8, "y": 1}, + {"matrix": [1, 9], "x": 9, "y": 1}, + {"matrix": [1, 10], "x": 10, "y": 1}, + {"matrix": [1, 11], "x": 11, "y": 1}, + {"matrix": [1, 12], "x": 12, "y": 1}, + {"matrix": [1, 13], "x": 13, "y": 1}, + {"matrix": [2, 0], "x": 0.5, "y": 2, "w": 1.5}, + {"matrix": [2, 1], "x": 2, "y": 2}, + {"matrix": [2, 2], "x": 3, "y": 2}, + {"matrix": [2, 3], "x": 4, "y": 2}, + {"matrix": [2, 5], "x": 5, "y": 2}, + {"matrix": [2, 6], "x": 6, "y": 2}, + {"matrix": [2, 7], "x": 7, "y": 2}, + {"matrix": [2, 8], "x": 8, "y": 2}, + {"matrix": [2, 9], "x": 9, "y": 2}, + {"matrix": [2, 10], "x": 10, "y": 2}, + {"matrix": [2, 11], "x": 11, "y": 2, "w": 1.5}, + {"matrix": [2, 13], "x": 12.5, "y": 2}, + {"matrix": [3, 0], "x": 1, "y": 3, "w": 2}, + {"matrix": [3, 2], "x": 3, "y": 3}, + {"matrix": [3, 3], "x": 4, "y": 3}, + {"matrix": [3, 5], "x": 5, "y": 3}, + {"matrix": [3, 6], "x": 6, "y": 3}, + {"matrix": [3, 7], "x": 7, "y": 3}, + {"matrix": [3, 9], "x": 8, "y": 3}, + {"matrix": [3, 10], "x": 9, "y": 3}, + {"matrix": [3, 11], "x": 10, "y": 3, "w": 2}, + {"matrix": [3, 13], "x": 12, "y": 3, "w": 2}, + {"matrix": [4, 0], "x": 1.25, "y": 4, "w": 1.25}, + {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25}, + {"matrix": [4, 3], "x": 3.75, "y": 4, "w": 1.25}, + {"matrix": [4, 5], "x": 5, "y": 4, "w": 1.25}, + {"matrix": [4, 7], "x": 6.25, "y": 4, "w": 1.25}, + {"matrix": [4, 9], "x": 7.5, "y": 4, "w": 1.25}, + {"matrix": [4, 10], "x": 8.75, "y": 4, "w": 1.25}, + {"matrix": [4, 12], "x": 10.75, "y": 4, "w": 2}, + {"matrix": [4, 13], "x": 12, "y": 4, "w": 1.25}, + {"matrix": [5, 0], "x": 0, "y": 5}, + {"matrix": [5, 3], "x": 3, "y": 5}, + {"matrix": [5, 4], "x": 4, "y": 5}, + {"matrix": [5, 5], "x": 5, "y": 5}, + {"matrix": [5, 6], "x": 6, "y": 5} + ] + } + } +} diff --git a/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/keymap.c b/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/keymap.c new file mode 100644 index 00000000000..de1ac56bd74 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/keymap.c @@ -0,0 +1,105 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include QMK_KEYBOARD_H +#include "one_handed_keyboard.h" + +enum my_keycodes { + DPI_UP = SAFE_RANGE, + DPI_DOWN +}; + +const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + +// ┏━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┓ +// ┃ ESC ┃ `~ ┃ 1 ┃ 2 ┃ 3 ┃ 4 ┃ 5 ┃ 6 ┃ 7 ┃ 8 ┃ 9 ┃ 0 ┃ - ┃ + ┃ +// ┣━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┫ +// ┃ TAB ┃ ;: ┃ Q ┃ W ┃ E ┃ R ┃ T ┃ Y ┃ U ┃ I ┃ O ┃ P ┃ [ ┃ ] ┃ +// ┗━━━┳━━━┻━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┻━━━┳━━━┛ +// ┃ CAPSLOCK ┃ '" ┃ A ┃ S ┃ D ┃ F ┃ G ┃ H ┃ J ┃ K ┃ L ┃ ENTER ┃ +// ┗━━━┳━━━━━━━┻━━┳━━━━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━━━┻━━━━━━━┳━━━┛ +// ┃ MOUSE1 ┃ MOUSE2 ┃ Z ┃ X ┃ C ┃ V ┃ B ┃ N ┃ M ┃ SHIFT ┃ +// ┗━━━┳━━━━━━┻━┳━━━━━━━━┻━━━━━━┳┻━━━━━━━╋━━━━━━━┻┳━━━━━━┻━┳━━━━━┻━━┳━━━━┻━━━┳━━━┻━━━━┳━━━━━━━━┳━━━┛ +// ┃ BSPC ┃ SPC ┃ MO(1) ┃ <, ┃ >. ┃ ?/ ┃ LGUI ┃ LALT ┃ CTRL ┃ +// ┗━━━━━━━━┻━━━━━━━━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┛ +// ┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓ +// ┃ MOUSE3 ┃ → ┃ ↓ ┃ ← ┃ ↑ ┃ +// ┗━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┛ + + [0] = LAYOUT( + KC_ESC, KC_GRAVE, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINUS, KC_EQUAL, + KC_TAB, KC_SEMICOLON, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LEFT_BRACKET, KC_RIGHT_BRACKET, + KC_CAPS_LOCK, KC_QUOTE, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_ENTER, + QK_MOUSE_BUTTON_1, QK_MOUSE_BUTTON_2, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_LEFT_SHIFT, + KC_BSPC, KC_SPC, MO(1), KC_COMMA, KC_DOT, KC_SLASH, KC_LEFT_GUI, KC_LEFT_ALT, KC_LEFT_CTRL, + QK_MOUSE_BUTTON_3, KC_RIGHT, KC_DOWN, KC_LEFT, KC_UP + ), + +// ┏━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┓ +// ┃ ┃ ┃ F1 ┃ F2 ┃ F3 ┃ F4 ┃ F5 ┃ F6 ┃ F7 ┃ F8 ┃ F9 ┃ F10 ┃ F11 ┃ F12 ┃ +// ┣━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┫ +// ┃ ┃ ┃ ┃RM_HUEU┃RM_HUED┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ DPI_DO┃ DPI_UP┃ +// ┗━━━┳━━━┻━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┻━━━┳━━━┛ +// ┃ ┃ ┃ ┃RM_SATU┃RM_SATD┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ +// ┗━━━┳━━━━━━━┻━━┳━━━━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━┳━┻━━━━━━━┻━━━━━━━┳━━━┛ +// ┃ MOUSE1 ┃ MOUSE2 ┃RM_SPDU┃RM_SPDD┃ ┃ ┃ ┃ ┃ ┃ ┃ +// ┗━━━┳━━━━━━┻━┳━━━━━━━━┻━━━━━━┳┻━━━━━━━╋━━━━━━━┻┳━━━━━━┻━┳━━━━━┻━━┳━━━━┻━━━┳━━━┻━━━━┳━━━━━━━━┳━━━┛ +// ┃ DEL ┃ RM_TOGG ┃ ┃ ┃ ┃ \| ┃ ┃ ┃ ┃ +// ┗━━━━━━━━┻━━━━━━━━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┛ +// ┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓ +// ┃ MOUSE3 ┃ RM_PREV ┃ RM_VALD ┃ RM_NEXT ┃ RM_VALU ┃ +// ┗━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┛ + + [1] = LAYOUT( + _______, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, + _______, _______, _______, RM_HUEU, RM_HUED, _______, _______, _______, _______, _______, _______, _______, DPI_DOWN, DPI_UP, + _______, _______, _______, RM_SATU, RM_SATD, _______, _______, _______, _______, _______, _______, _______, + QK_MOUSE_BUTTON_1, QK_MOUSE_BUTTON_2, RM_SPDU, RM_SPDD, _______, _______, _______, _______, _______, _______, + KC_DEL, RM_TOGG, _______, _______, _______, KC_BSLS, _______, _______, _______, + QK_MOUSE_BUTTON_3, RM_PREV, RM_VALD, RM_NEXT, RM_VALU + ), +}; + +#if defined(ENCODER_MAP_ENABLE) +const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = { + [0] = {ENCODER_CCW_CW(MS_WHLD, MS_WHLU)}, + [1] = {ENCODER_CCW_CW(MS_WHLU, MS_WHLD)} +}; +#endif + +// ADNS9800. The CPI range is 800-8200, in increments of 200. +bool process_record_user(uint16_t keycode, keyrecord_t *record) { + switch (keycode) { + case DPI_UP: { + if (record->event.pressed) { + pointing_adns9800_cpi_up(); + } + break; + } + case DPI_DOWN: { + if (record->event.pressed) { + pointing_adns9800_cpi_down(); + } + break; + } + default: break; + } + return true; +} + +void eeconfig_init_user(void) { + pointing_adns9800_reset(); +} diff --git a/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/rules.mk b/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/rules.mk new file mode 100644 index 00000000000..737257c5d8d --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mr/keymaps/default/rules.mk @@ -0,0 +1,7 @@ +SPI_DRIVER_REQUIRED = yes +ENCODER_MAP_ENABLE = yes +RGB_MATRIX_ENABLE = yes +WS2812_DRIVER = pwm + +POINTING_DEVICE_ENABLE = yes +POINTING_DEVICE_DRIVER = adns9800 diff --git a/keyboards/htx_studio/one_handed_keyboard/mr/mr.c b/keyboards/htx_studio/one_handed_keyboard/mr/mr.c new file mode 100644 index 00000000000..6deb797a4ab --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mr/mr.c @@ -0,0 +1,27 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include "rgb_matrix.h" +#include "host.h" + +bool rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max) { + if (host_keyboard_led_state().caps_lock) { + RGB_MATRIX_INDICATOR_SET_COLOR(28, 255, 255, 255); // assuming caps lock is at led #5 + } else { + RGB_MATRIX_INDICATOR_SET_COLOR(28, 0, 0, 0); + } + return false; +} diff --git a/keyboards/htx_studio/one_handed_keyboard/mr/readme.md b/keyboards/htx_studio/one_handed_keyboard/mr/readme.md new file mode 100644 index 00000000000..19c85dcc9de --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/mr/readme.md @@ -0,0 +1,29 @@ +# One-Handed_Keyboard_MR + +![右手大键盘](https://imgur.com/y5O0E2E.jpg) + +This is a keyboard with a fan-shaped layout and 59 keys.The commonly used buttons are placed near the thumb. + +* Keyboard Maintainer:[HTX Studio](https://github.com/htx-studio) +* Hardware Supported:HTX_STUDIO_ONE-HANDEN_KEYBOARD_MR PCB +* Hardware Availability:[One-Handed-Keyboard](https://github.com/htx-studio/One-Handed-Keyboard/tree/main/Hardware) + +## How to compile + +Make example for this keyboard (after setting up your build environment): + + `make htx_studio/one_handed_keyboard/mr:default` + +Flashing example for this keyboard: + + `make htx_studio/one_handed_keyboard/mr: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 3 ways: + +* **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard +* **Physical reset button**: Hold the "B" button on the back of the PCB (the one closest to the MCU) and briefly press the "R" button on the back of the PCB +* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available diff --git a/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.c b/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.c new file mode 100644 index 00000000000..83ab44968ad --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.c @@ -0,0 +1,61 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include "wait.h" +#include "eeconfig.h" +#include "pointing_device.h" +#include "one_handed_keyboard.h" + +#define TRACKBALL_DPI_MIN 1000 +#define TRACKBALL_DPI_MAX 8000 +#define TRACKBALL_DPI_DEFAULT 3000 +#define TRACKBALL_DPI_STEP 1000 + +user_config_t user_config; + +void pointing_device_init_kb(void) { + wait_ms(10); + user_config.TrackballDPI = eeconfig_read_user(); + wait_ms(10); + adns9800_init(); + wait_ms(10); + pointing_device_set_cpi(user_config.TrackballDPI); +} + +void pointing_adns9800_cpi_up(void) { + user_config.TrackballDPI += TRACKBALL_DPI_STEP; + if(user_config.TrackballDPI > TRACKBALL_DPI_MAX) { + user_config.TrackballDPI = TRACKBALL_DPI_MAX; + } + eeconfig_update_user(user_config.TrackballDPI); + pointing_device_set_cpi(user_config.TrackballDPI); +} + +void pointing_adns9800_cpi_down(void) { + user_config.TrackballDPI -= TRACKBALL_DPI_STEP; + if(user_config.TrackballDPI < TRACKBALL_DPI_MIN) { + user_config.TrackballDPI = TRACKBALL_DPI_MIN; + } + eeconfig_update_user(user_config.TrackballDPI); + pointing_device_set_cpi(user_config.TrackballDPI); +} + +void pointing_adns9800_reset(void) { + user_config.TrackballDPI = TRACKBALL_DPI_DEFAULT; + wait_ms(10); + eeconfig_update_user(user_config.TrackballDPI); + pointing_device_set_cpi(user_config.TrackballDPI); +} diff --git a/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.h b/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.h new file mode 100644 index 00000000000..8acc36782a3 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/one_handed_keyboard.h @@ -0,0 +1,30 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#ifndef ONE_HANDED_KEYBOARD_H +#define ONE_HANDED_KEYBOARD_H + +#include "quantum.h" + +typedef union { + uint16_t TrackballDPI; +} user_config_t; + +void pointing_adns9800_cpi_up(void); +void pointing_adns9800_cpi_down(void); +void pointing_adns9800_reset(void); + +#endif // ONE_HANDED_KEYBOARD_H diff --git a/keyboards/htx_studio/one_handed_keyboard/sl/keyboard.json b/keyboards/htx_studio/one_handed_keyboard/sl/keyboard.json new file mode 100644 index 00000000000..1cec49bf020 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/sl/keyboard.json @@ -0,0 +1,78 @@ +{ + "keyboard_name": "One-Handed_Keyboard_SL", + "usb": { + "device_version": "3.1.0", + "pid": "0x03BE", + "vid": "0x475D" + }, + "layouts": { + "LAYOUT": { + "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}, + {"matrix": [1, 0], "x": 0, "y": 1}, + {"matrix": [1, 1], "x": 1, "y": 1}, + {"matrix": [1, 2], "x": 2, "y": 1}, + {"matrix": [1, 3], "x": 3, "y": 1}, + {"matrix": [1, 4], "x": 4, "y": 1}, + {"matrix": [1, 5], "x": 5, "y": 1}, + {"matrix": [1, 6], "x": 6, "y": 1}, + {"matrix": [1, 7], "x": 7, "y": 1}, + {"matrix": [1, 8], "x": 8, "y": 1}, + {"matrix": [1, 9], "x": 9, "y": 1}, + {"matrix": [1, 10], "x": 10, "y": 1}, + {"matrix": [1, 11], "x": 11, "y": 1}, + {"matrix": [1, 12], "x": 12, "y": 1}, + {"matrix": [1, 13], "x": 13, "y": 1}, + {"matrix": [2, 0], "x": 0.5, "y": 2, "w": 1.5}, + {"matrix": [2, 2], "x": 2, "y": 2}, + {"matrix": [2, 3], "x": 3, "y": 2}, + {"matrix": [2, 4], "x": 4, "y": 2}, + {"matrix": [2, 5], "x": 5, "y": 2}, + {"matrix": [2, 6], "x": 6, "y": 2}, + {"matrix": [2, 7], "x": 7, "y": 2}, + {"matrix": [2, 8], "x": 8, "y": 2}, + {"matrix": [2, 9], "x": 9, "y": 2}, + {"matrix": [2, 10], "x": 10, "y": 2}, + {"matrix": [2, 12], "x": 11, "y": 2, "w": 1.5}, + {"matrix": [2, 13], "x": 12.5, "y": 2}, + {"matrix": [3, 0], "x": 1, "y": 3, "w": 2}, + {"matrix": [3, 3], "x": 3, "y": 3}, + {"matrix": [3, 4], "x": 4, "y": 3}, + {"matrix": [3, 5], "x": 5, "y": 3}, + {"matrix": [3, 6], "x": 6, "y": 3}, + {"matrix": [3, 7], "x": 7, "y": 3}, + {"matrix": [3, 8], "x": 8, "y": 3}, + {"matrix": [3, 9], "x": 9, "y": 3}, + {"matrix": [3, 10], "x": 10, "y": 3, "w": 2}, + {"matrix": [3, 13], "x": 12, "y": 3, "w": 2}, + {"matrix": [4, 0], "x": 1.25, "y": 4, "w": 1.25}, + {"matrix": [4, 3], "x": 2.5, "y": 4, "w": 1.25}, + {"matrix": [4, 4], "x": 3.75, "y": 4, "w": 1.25}, + {"matrix": [4, 5], "x": 5, "y": 4, "w": 1.25}, + {"matrix": [4, 6], "x": 6.25, "y": 4, "w": 1.25}, + {"matrix": [4, 7], "x": 7.5, "y": 4, "w": 1.25}, + {"matrix": [4, 9], "x": 8.75, "y": 4, "w": 1.25}, + {"matrix": [4, 12], "x": 10.75, "y": 4, "w": 2}, + {"matrix": [4, 13], "x": 12, "y": 4, "w": 1.25}, + {"matrix": [5, 0], "x": 0, "y": 5}, + {"matrix": [5, 3], "x": 3, "y": 5}, + {"matrix": [5, 4], "x": 4, "y": 5}, + {"matrix": [5, 5], "x": 5, "y": 5}, + {"matrix": [5, 6], "x": 6, "y": 5} + ] + } + } +} diff --git a/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/keymap.c b/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/keymap.c new file mode 100644 index 00000000000..e47400517ec --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/keymap.c @@ -0,0 +1,88 @@ +/* Copyright 2025 htx-studio (@https://github.com/htx-studio) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include QMK_KEYBOARD_H +#include "one_handed_keyboard.h" + +enum my_keycodes { + DPI_UP = SAFE_RANGE, + DPI_DOWN +}; + +const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + + +// ┏━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━┓ +// ┃ ESC ┃ 1 ┃ 2 ┃ 3 ┃ 4 ┃ 5 ┃ 6 ┃ 7 ┃ 8 ┃ 9 ┃ 0 ┃ -_ ┃ += ┃ `~ ┃ +// ┣━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┫ +// ┃ TAB ┃ Q ┃ W ┃ E ┃ R ┃ T ┃ Y ┃ U ┃ I ┃ O ┃ P ┃ [{ ┃ ]} ┃ '" ┃ +// ┗━━━┳━━━┻━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━╋━━━━━━━┻━━┳━━━━┻━━━┳━━━┛ +// ┃ CAPSLOCK ┃ A ┃ S ┃ D ┃ F ┃ G ┃ H ┃ J ┃ K ┃ L ┃ ENTER ┃ ;: ┃ +// ┗━━━┳━━━━━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━┳━━━┻━━━━━━━┻━┳━━━━━━━━┻━━━━┳━━━┛ +// ┃ SHIFT ┃ Z ┃ X ┃ C ┃ V ┃ B ┃ N ┃ M ┃ MOUSE1 ┃ MOUSE2 ┃ +// ┗━━━┳━━━━━━━┻┳━━━━━━┻━┳━━━━━┻━━┳━━━━┻━━━┳━━━┻━━━━┳━━┻━━━━━┳━┻━━━━━━┳┻━━━━━━━━━━━━━┻┳━━━━━━━━┳━━━┛ +// ┃ CTRL ┃ LGUI ┃ LALT ┃ ,< ┃ .> ┃ /? ┃ \| ┃ SPC ┃ BACK ┃ +// ┗━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━┻━━━━━━━━━━━━━━━┻━━━━━━━━┛ +// ┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓ +// ┃ MOUSE3 ┃ → ┃ ↓ ┃ ← ┃ ↑ ┃ +// ┗━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┻━━━━━━━━━┛ + + + [0] = LAYOUT( + // ESC 1 2 3 4 5 6 7 8 9 0 - = ` + KC_ESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINUS, KC_EQUAL, KC_GRAVE, + // TAB Q W E R T Y U I O P [ ] ' + KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LEFT_BRACKET, KC_RIGHT_BRACKET, KC_QUOTE, + // CAPS A S D F G H J K L ; ENTER + KC_CAPS_LOCK, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_ENTER, KC_SEMICOLON, + // LSHIFT Z X C V B N M MOUSE1 MOUSE2 + KC_LEFT_SHIFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, QK_MOUSE_BUTTON_1, QK_MOUSE_BUTTON_2, + // LCTRL LGUI LALT , . / \ SPC BACKSPACE + KC_LEFT_CTRL, KC_LEFT_GUI, KC_LEFT_ALT, KC_COMMA, KC_DOT, KC_SCLN, KC_BSLS, KC_SPC, KC_BACKSPACE, + // MOUSE3 → ↓ ← ↑ + QK_MOUSE_BUTTON_3, KC_RIGHT, KC_DOWN, KC_LEFT, KC_UP) + }; + +#if defined(ENCODER_MAP_ENABLE) +const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = { + // Encoders: Left, Right, Big + [0] = {ENCODER_CCW_CW(MS_WHLU, MS_WHLD)} +}; +#endif + +// ADNS9800. The CPI range is 800-8200, in increments of 200. +bool process_record_user(uint16_t keycode, keyrecord_t *record) { + switch (keycode) { + case DPI_UP: { + if (record->event.pressed) { + pointing_adns9800_cpi_up(); + } + break; + } + case DPI_DOWN: { + if (record->event.pressed) { + pointing_adns9800_cpi_down(); + } + break; + } + default: break; + } + return true; +} + +void eeconfig_init_user(void) { + pointing_adns9800_reset(); +} diff --git a/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/rules.mk b/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/rules.mk new file mode 100644 index 00000000000..0309523fc35 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/sl/keymaps/default/rules.mk @@ -0,0 +1,5 @@ +SPI_DRIVER_REQUIRED = yes +ENCODER_MAP_ENABLE = yes + +POINTING_DEVICE_ENABLE = yes +POINTING_DEVICE_DRIVER = adns9800 diff --git a/keyboards/htx_studio/one_handed_keyboard/sl/readme.md b/keyboards/htx_studio/one_handed_keyboard/sl/readme.md new file mode 100644 index 00000000000..b27b4adb954 --- /dev/null +++ b/keyboards/htx_studio/one_handed_keyboard/sl/readme.md @@ -0,0 +1,29 @@ +# One-Handed_Keyboard_SL + +![左手小键盘](https://imgur.com/eaDoxL4.jpg) + +This is a keyboard with a fan-shaped layout and 59 keys.The commonly used buttons are placed near the thumb. + +* Keyboard Maintainer:[HTX Studio](https://github.com/htx-studio) +* Hardware Supported:HTX_STUDIO_ONE-HANDEN_KEYBOARD_SL PCB +* Hardware Availability:[One-Handed-Keyboard](https://github.com/htx-studio/One-Handed-Keyboard/tree/main/Hardware) + +## How to compile + +Make example for this keyboard (after setting up your build environment): + + `make htx_studio/one_handed_keyboard/sl:default` + +Flashing example for this keyboard: + + `make htx_studio/one_handed_keyboard/sl: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 3 ways: + +* **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard +* **Physical reset button**: Hold the "B" button on the back of the PCB (the one closest to the MCU) and briefly press the "R" button on the back of the PCB +* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available