Add Macroflow Original macropad firmware (#24538)

* Adding Macroflow Macropad

* Macroflow_Macropad

* Macroflow_Macropad

* Adding My Macropad

* Adding Macroflow Macropad

* Adding Macroflow Macropad

* Adding Macroflow Macropad

* Adding Macroflow Macropad

* Adding Macroflow Macropad

* Added License Headers

* Updated code for merge

* Added License Header

* Added Encoder Map

* Updated Files

* Fixed Matrix

* Update keyboards/macroflow_original/keyboard.json

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

* Update keyboards/macroflow_original/keymaps/default/keymap.c

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

* Update keyboards/macroflow_original/keymaps/default/keymap.c

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

* Update keyboards/macroflow_original/keymaps/default/rules.mk

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

* Update keyboards/macroflow_original/macroflow_original.c

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

---------

Co-authored-by: Drashna Jaelre <drashna@live.com>
This commit is contained in:
Patrickemm 2024-12-06 00:43:35 -05:00 committed by GitHub
parent 09fdabf37c
commit 03937e0c86
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
5 changed files with 381 additions and 0 deletions

View File

@ -0,0 +1,52 @@
{
"manufacturer": "Customacros",
"keyboard_name": "Macroflow Original",
"maintainer": "Patrickemm",
"diode_direction": "COL2ROW",
"features": {
"bootmagic": true,
"extrakey": true,
"mousekey": true,
"nkro": true,
"encoder": true,
"oled": true
},
"matrix_pins": {
"cols": ["B1", "B3", "B2", "F7"],
"rows": ["E6", "B4", "B5"]
},
"development_board": "promicro",
"url": "https://github.com/Patrickemm",
"usb": {
"device_version": "1.0.0",
"pid": "0x0002",
"vid": "0x504D"
},
"dynamic_keymap": {
"layer_count": 8
},
"layouts": {
"LAYOUT": {
"layout": [
{"matrix": [0, 0], "x": 0, "y": 0},
{"matrix": [0, 3], "x": 3, "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": [2, 0], "x": 0, "y": 2},
{"matrix": [2, 1], "x": 1, "y": 2},
{"matrix": [2, 2], "x": 2, "y": 2},
{"matrix": [2, 3], "x": 3, "y": 2}
]
}
},
"encoder": {
"rotary": [
{"pin_b": "F5", "pin_a": "F4"}
]
}
}

View File

@ -0,0 +1,101 @@
// Copyright 2024 Patrick Mathern (@Patrickemm)
// SPDX-License-Identifier: GPL-2.0-or-later
#include QMK_KEYBOARD_H
// Define the keycode, `QK_USER` avoids collisions with existing keycodes
enum keycodes {
KC_CYCLE_LAYERS = QK_USER,
};
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
[0] = LAYOUT(
KC_0, KC_CYCLE_LAYERS,
KC_1, KC_2, KC_3, KC_4,
KC_5, KC_6, KC_7, KC_8
),
[1] = LAYOUT(
KC_9, KC_CYCLE_LAYERS,
KC_A, KC_B, KC_C, KC_D,
KC_E, KC_F, KC_G, KC_H
),
[2] = LAYOUT(
KC_I, KC_CYCLE_LAYERS,
KC_J, KC_K, KC_L, KC_M,
KC_N, KC_O, KC_P, KC_Q
),
[3] = LAYOUT(
KC_R, KC_CYCLE_LAYERS,
KC_S, KC_T, KC_U, KC_V,
KC_W, KC_X, KC_Y, KC_Z
),
[4] = LAYOUT(
KC_TRNS, KC_CYCLE_LAYERS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS
),
[5] = LAYOUT(
KC_TRNS, KC_CYCLE_LAYERS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS
),
[6] = LAYOUT(
KC_TRNS, KC_CYCLE_LAYERS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS
),
[7] = LAYOUT(
KC_TRNS, KC_CYCLE_LAYERS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS
)
};
// 1st layer on the cycle
#define LAYER_CYCLE_START 0
// Last layer on the cycle
#define LAYER_CYCLE_END 7
// Add the behaviour of this new keycode
bool process_record_user(uint16_t keycode, keyrecord_t *record) {
switch (keycode) {
case KC_CYCLE_LAYERS:
// Our logic will happen on presses, nothing is done on releases
if (!record->event.pressed) {
// We've already handled the keycode (doing nothing), let QMK know so no further code is run unnecessarily
return false;
}
uint8_t current_layer = get_highest_layer(layer_state);
// Check if we are within the range, if not quit
if (current_layer > LAYER_CYCLE_END || current_layer < LAYER_CYCLE_START) {
return false;
}
uint8_t next_layer = current_layer + 1;
if (next_layer > LAYER_CYCLE_END) {
next_layer = LAYER_CYCLE_START;
}
layer_move(next_layer);
return false;
// Process other keycodes normally
default:
return true;
}
}
#if defined(ENCODER_MAP_ENABLE)
const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
[0] = { ENCODER_CCW_CW(KC_MS_WH_UP, KC_MS_WH_DOWN) },
[1] = { ENCODER_CCW_CW(_______, _______) },
[2] = { ENCODER_CCW_CW(_______, _______) },
[3] = { ENCODER_CCW_CW(_______, _______) },
[4] = { ENCODER_CCW_CW(_______, _______) },
[5] = { ENCODER_CCW_CW(_______, _______) },
[6] = { ENCODER_CCW_CW(_______, _______) },
[7] = { ENCODER_CCW_CW(_______, _______) }
};
#endif

View File

@ -0,0 +1 @@
ENCODER_MAP_ENABLE = yes

View File

@ -0,0 +1,200 @@
// Copyright 2024 Patrick Mathern (@Patrickemm)
// SPDX-License-Identifier: GPL-2.0-or-later
#include "quantum.h"
static uint16_t oled_logo_timer = 0;
static bool has_startup_ran = false;
#ifndef SHOW_LOGO
# define SHOW_LOGO 2500
#endif
enum layer_names {
one,
two,
three,
four,
five,
six,
seven,
eight
};
oled_rotation_t oled_init_kb(oled_rotation_t rotation) {
return OLED_ROTATION_180;
}
bool oled_task_kb(void) {
if (!oled_task_user()) {
return false;
}
if (!has_startup_ran) {
static const char startUp [] PROGMEM = {
// 'startUp', 128x32px
0, 0, 0,128,192,192,128,128, 0, 0,192,192, 0, 0, 0,192,192, 0, 0,128,128,192,192,128, 0, 0,192,192,192,192,192,192,192, 0, 0,128,128,192,192,128, 0, 0, 0,192,192,128, 0, 0, 0, 0,192,192,128, 0, 0, 0,128,192,192, 0, 0, 0, 0, 0,128,128,192,192,128, 0, 0,128,192,192,192,192,128,128, 0, 0, 0,128,192,192,192,128, 0, 0, 0,128,128,192,192,128, 0, 0, 0, 0, 0, 0, 0,128,192,192,128, 0, 0, 0, 0,128,192,192,128,128, 0, 0,192,192,192, 0, 0, 0, 0,128,192,192, 0,0,
0, 0,255,255, 1, 1, 1, 31, 30, 0,255,255, 0, 0, 0,255,255, 0, 30,127,241,193,129, 7, 15, 0, 1, 1, 1,255,255, 1, 1, 0,254,255, 1, 1, 1,255,255, 0, 0,255, 63,255,224, 0,128,254, 63,255,255, 0, 0,224,255, 15,127,255,192, 0, 0,254,255, 1, 1, 1, 31, 31, 0,255,255,129,129,129,255,127, 0, 0,255,255, 1, 1, 1,255,255, 0, 30,127,241,193,129, 7, 15, 0, 0, 0, 0,252,255, 3, 1, 1, 3, 31, 30, 0,255,255, 1, 1, 1,255,254, 0,255,255,127,252, 0, 0,240,255,255,255, 0, 0, 0, 0,255,255,128,128,192,252, 60, 0,127,255,128,128,128,255,127, 0,120,248,128,129,131,255,254, 0, 0, 0, 0,255,255, 0, 0, 0,127,255,128,128,128,255,255, 0, 0,255, 0, 3,255,248,255, 15, 0,255,255, 0,248,255, 27, 24, 24, 63,255,224, 0,127,255,128,128,128,252,124, 0,255,255, 3, 1, 3,127,254,240, 0,127,255,128,128,128,255,127, 0,120,248,128,129,131,255,254, 0,128,128, 0, 63,255,192,128,128,224,252, 60, 0,255,255,128,128,128,255,127, 0,255,255, 0, 31,255,252,127, 1,255,255, 0, 0,0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 1, 1, 0, 1, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 0, 0
};
oled_write_raw_P(startUp, sizeof(startUp));
if (timer_elapsed(oled_logo_timer) >= SHOW_LOGO) {
has_startup_ran = true;
oled_clear();
}
} else {
static const char PROGMEM layerImage[4][67+1] = {
{ 224,224,224,224, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,224,224,224,224,224, 0, 0, 0, 0, 0,224,224,224,128, 0, 0, 0, 0,128,224,224,224, 0, 0, 0,224,224,224,224,224,224,224,224,224,224,224, 0, 0,224,224,224,224,224,224,224,224,224,192,128, 0 },
{ 255,255,255,255, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,240,255,255,127, 15,127,255,255,240, 0, 0, 0, 0, 3, 15,127,252,240,240,252,127, 15, 3, 0, 0, 0, 0,255,255,255,255,192,192,192,192,192, 0, 0, 0, 0,255,255,255,255,192,192,192,225,255,255,255,127 },
{ 255,255,255,255,192,192,192,192,192,192,192, 0, 0,192,254,255,255,127, 28, 28, 28,127,255,255,254,192, 0, 0, 0, 0, 0,255,255,255,255, 0, 0, 0, 0, 0, 0, 0,255,255,255,255,129,129,129,129,129,128,128, 0, 0,255,255,255,255, 1, 1, 7,127,255,255,248,192 },
{ 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 0, 0, 3, 3, 3, 3, 0, 0, 0, 0, 0, 3, 3, 3, 3, 0, 0, 0, 0, 0, 3, 3, 3, 3, 0, 0, 0, 0, 0, 0, 0, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 0, 0, 3, 3, 3, 3, 0, 0, 0, 0, 3, 3, 3, 3 },
};
static const char PROGMEM layer1[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,248,120,120, 56, 56, 24, 24, 24,248,248,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,255,252,252,252, 0, 0, 0, 0,255,255,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,255,255,255,255, 0, 0, 0, 0,255,255,255,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 31, 31, 31, 28, 28, 28, 28, 31, 31, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer2[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,120, 56, 24, 24, 24, 24, 24, 24, 56,120,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,248,248,248,254,255, 63, 6, 0,128,224,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255, 63, 15, 7, 1, 64,112,120,126,127,127,255,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer3[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,120, 56, 24, 24, 24, 24, 24, 24, 56,120,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,248,248,248, 62, 63, 63, 30, 0,128,192,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255, 31, 31, 31,126,254,254,124, 0, 0, 1,255,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 30, 28, 24, 24, 24, 24, 24, 24, 28, 30, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer4[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,248,248,248,248,120, 24, 24, 24, 24,248,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,255, 63, 7, 1,192,240, 0, 0, 0,255,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,192,192,192,194,195,195, 0, 0, 0,195,195,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 31, 31, 31, 31, 31, 28, 28, 28, 31, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer5[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255, 0, 0, 0, 0,143,143,143, 15, 15, 31,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,142, 14, 14, 30,127,127,127, 0, 0, 0,224,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 30, 28, 28, 28, 28, 28, 28, 30, 31, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer6[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,248, 56, 24, 24, 24, 24, 24, 24, 24, 56,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255, 0, 0, 0, 0, 31, 31, 31, 24, 24, 56,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,128, 0, 0, 0,127,127,127, 0, 0, 0,128,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 30, 28, 28, 28, 28, 28, 28, 28, 30, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer7[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, 31, 3, 0,128,248,255,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,255,255,127, 15, 1, 0,192,252,255,255,255,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 31, 28, 28, 28, 28, 31, 31, 31, 31, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
static const char PROGMEM layer8[4][30+1] = {
{ 128,224,240,240,248,248,248,248,248,248,248, 56, 24, 24, 24, 24, 24, 24, 24, 56,248,248,248,248,248,248,240,240,224,128 },
{ 255,255,255,255,255,255,255,255,255,255,224,128, 0, 0, 31, 31, 31, 0, 0,128,224,255,255,255,255,255,255,255,255,255 },
{ 255,255,255,255,255,255,255,255,255,255,129, 0, 0, 0,126,126,126, 0, 0, 0,129,255,255,255,255,255,255,255,255,255 },
{ 1, 7, 15, 15, 31, 31, 31, 31, 31, 31, 31, 30, 28, 28, 28, 28, 28, 28, 28, 30, 31, 31, 31, 31, 31, 31, 15, 15, 7, 1 }
};
oled_set_cursor(1, 0); // start pos
oled_write_raw_P(layerImage[0], sizeof(layerImage[0]));
oled_set_cursor(1, 1); // move to next line
oled_write_raw_P(layerImage[1], sizeof(layerImage[1]));
oled_set_cursor(1, 2); // move to next line
oled_write_raw_P(layerImage[2], sizeof(layerImage[2]));
oled_set_cursor(1, 3); // move to next line
oled_write_raw_P(layerImage[3], sizeof(layerImage[3]));
switch (get_highest_layer(layer_state)) {
case one :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer1[0], sizeof(layer1[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer1[1], sizeof(layer1[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer1[2], sizeof(layer1[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer1[3], sizeof(layer1[3]));
break;
case two :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer2[0], sizeof(layer2[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer2[1], sizeof(layer2[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer2[2], sizeof(layer2[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer2[3], sizeof(layer2[3]));
break;
case three :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer3[0], sizeof(layer3[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer3[1], sizeof(layer3[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer3[2], sizeof(layer3[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer3[3], sizeof(layer3[3]));
break;
case four :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer4[0], sizeof(layer4[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer4[1], sizeof(layer4[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer4[2], sizeof(layer4[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer4[3], sizeof(layer4[3]));
break;
case five :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer5[0], sizeof(layer5[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer5[1], sizeof(layer5[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer5[2], sizeof(layer5[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer5[3], sizeof(layer5[3]));
break;
case six :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer6[0], sizeof(layer6[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer6[1], sizeof(layer6[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer6[2], sizeof(layer6[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer6[3], sizeof(layer6[3]));
break;
case seven :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer7[0], sizeof(layer7[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer7[1], sizeof(layer7[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer7[2], sizeof(layer7[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer7[3], sizeof(layer7[3]));
break;
case eight :
oled_set_cursor(16, 0); // move 20 columns out
oled_write_raw_P(layer8[0], sizeof(layer8[0]));
oled_set_cursor(16, 1); // move 20 columns out
oled_write_raw_P(layer8[1], sizeof(layer8[1]));
oled_set_cursor(16, 2); // move 20 columns out
oled_write_raw_P(layer8[2], sizeof(layer8[2]));
oled_set_cursor(16, 3); // move 20 columns out
oled_write_raw_P(layer8[3], sizeof(layer8[3]));
break;
}
}
return false;
}

View File

@ -0,0 +1,27 @@
# macroflow_original
![Imgur](https://i.imgur.com/hIytJTl.png)
*A 2x4 macropad with a built in encoder and OLED screen*
* Keyboard Maintainer: [Patrickemm](https://github.com/Patrickemm)
* Hardware Supported: *Pro Micro compatible development board*
* Hardware Availability: *https://www.ebay.com/usr/handycache*
Make example for this keyboard (after setting up your build environment):
make macroflow_original:default
Flashing example for this keyboard:
make macroflow_original: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**: Briefly press the button on the back of the PCB - some may have pads you must short instead
* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available