Merge 3578fe5846 into fc55fcff3d

Co-authored-by: Moritz <moritz.plattner@gmx.net>

docs/data_driven_config.md

@@ -6,7 +6,7 @@ This page describes how QMK's data driven JSON configuration system works. It is
 
 Historically QMK has been configured through a combination of two mechanisms- `rules.mk` and `config.h`. While this worked well when QMK was only a handful of keyboards we've grown to encompass nearly 4000 supported keyboards. That extrapolates out to 6000 configuration files under `keyboards/` alone! The freeform nature of these files and the unique patterns people have used to avoid duplication have made ongoing maintenance a challenge, and a large number of our keyboards follow patterns that are outdated and sometimes harder to understand.
 
-We have also been working on bringing the power of QMK to people who aren't comformable with a CLI, and other projects such as VIA are working to make using QMK as easy as installing a program. These tools need information about how a keyboard is laid out or what pins and features are available so that users can take full advantage of QMK. We introduced `info.json` as a first step towards this. The QMK API is an effort to combine these 3 sources of information- `config.h`, `rules.mk`, and `info.json`- into a single source of truth that end-user tools can use.
+We have also been working on bringing the power of QMK to people who aren't comfortable with a CLI, and other projects such as VIA are working to make using QMK as easy as installing a program. These tools need information about how a keyboard is laid out or what pins and features are available so that users can take full advantage of QMK. We introduced `info.json` as a first step towards this. The QMK API is an effort to combine these 3 sources of information- `config.h`, `rules.mk`, and `info.json`- into a single source of truth that end-user tools can use.
 
 Now we have support for generating `rules.mk` and `config.h` values from `info.json`, allowing us to have a single source of truth. This will allow us to use automated tooling to maintain keyboards saving a lot of time and maintenance work.
 

keyboards/handwired/nerdboard/config.h

@@ -0,0 +1,35 @@
+/*
+Copyright 2023 Jon Hull
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+
+/* disable debug print */
+// #define NO_DEBUG
+
+/* disable print */
+// #define NO_PRINT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT
+
+#define SPLIT_POINTING_ENABLE
+#define POINTING_DEVICE_TASK_THROTTLE_MS 1
+
+#define SPLIT_TRANSACTION_IDS_KB RPC_ID_KB_CONFIG_SYNC

keyboards/handwired/nerdboard/info.json

@@ -0,0 +1,7 @@
+{
+    "manufacturer": "QMK Community",
+    "maintainer": "thelowprokill",
+    "usb": {
+        "vid": "0x44DD"
+    }
+}

keyboards/handwired/nerdboard/nerdboard.c

@@ -0,0 +1,378 @@
+/* Copyright 2023 Christopher Courtney <drashna@live.com> (@drashna)
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include "nerdboard.h"
+#include "transactions.h"
+#include <string.h>
+
+#ifdef CONSOLE_ENABLE
+#    include "print.h"
+#endif  // CONSOLE_ENABLE
+
+#ifdef POINTING_DEVICE_ENABLE
+#    ifndef CHARYBDIS_MINIMUM_DEFAULT_DPI
+#        define CHARYBDIS_MINIMUM_DEFAULT_DPI 400
+#    endif  // CHARYBDIS_MINIMUM_DEFAULT_DPI
+
+#    ifndef CHARYBDIS_DEFAULT_DPI_CONFIG_STEP
+#        define CHARYBDIS_DEFAULT_DPI_CONFIG_STEP 200
+#    endif  // CHARYBDIS_DEFAULT_DPI_CONFIG_STEP
+
+#    ifndef CHARYBDIS_MINIMUM_SNIPING_DPI
+#        define CHARYBDIS_MINIMUM_SNIPING_DPI 200
+#    endif  // CHARYBDIS_MINIMUM_SNIPER_MODE_DPI
+
+#    ifndef CHARYBDIS_SNIPING_DPI_CONFIG_STEP
+#        define CHARYBDIS_SNIPING_DPI_CONFIG_STEP 100
+#    endif  // CHARYBDIS_SNIPING_DPI_CONFIG_STEP
+
+// Fixed DPI for drag-scroll.
+#    ifndef CHARYBDIS_DRAGSCROLL_DPI
+#        define CHARYBDIS_DRAGSCROLL_DPI 100
+#    endif  // CHARYBDIS_DRAGSCROLL_DPI
+
+#    ifndef CHARYBDIS_DRAGSCROLL_BUFFER_SIZE
+#        define CHARYBDIS_DRAGSCROLL_BUFFER_SIZE 6
+#    endif  // !CHARYBDIS_DRAGSCROLL_BUFFER_SIZE
+
+#    ifndef CHARYBDIS_POINTER_ACCELERATION_FACTOR
+#        define CHARYBDIS_POINTER_ACCELERATION_FACTOR 24
+#    endif  // !CHARYBDIS_POINTER_ACCELERATION_FACTOR
+
+typedef union {
+    uint8_t raw;
+    struct {
+        uint8_t pointer_default_dpi : 4;  // 16 steps available.
+        uint8_t pointer_sniping_dpi : 2;  // 4 steps available.
+        bool    is_dragscroll_enabled : 1;
+        bool    is_sniping_enabled : 1;
+    } __attribute__((packed));
+} charybdis_config_t;
+
+static charybdis_config_t g_charybdis_config = {0};
+
+/**
+ * \brief Set the value of `config` from EEPROM.
+ *
+ * Note that `is_dragscroll_enabled` and `is_sniping_enabled` are purposefully
+ * ignored since we do not want to persist this state to memory.  In practice,
+ * this state is always written to maximize write-performances.  Therefore, we
+ * explicitly set them to `false` in this function.
+ */
+static void read_charybdis_config_from_eeprom(charybdis_config_t* config) {
+    config->raw                   = eeconfig_read_kb() & 0xff;
+    config->is_dragscroll_enabled = false;
+    config->is_sniping_enabled    = false;
+}
+
+/**
+ * \brief Save the value of `config` to eeprom.
+ *
+ * Note that all values are written verbatim, including whether drag-scroll
+ * and/or sniper mode are enabled.  `read_charybdis_config_from_eeprom(…)`
+ * resets these 2 values to `false` since it does not make sense to persist
+ * these across reboots of the board.
+ */
+static void write_charybdis_config_to_eeprom(charybdis_config_t* config) { eeconfig_update_kb(config->raw); }
+
+/** \brief Return the current value of the pointer's default DPI. */
+static uint16_t get_pointer_default_dpi(charybdis_config_t* config) { return (uint16_t)config->pointer_default_dpi * CHARYBDIS_DEFAULT_DPI_CONFIG_STEP + CHARYBDIS_MINIMUM_DEFAULT_DPI; }
+
+/** \brief Return the current value of the pointer's sniper-mode DPI. */
+static uint16_t get_pointer_sniping_dpi(charybdis_config_t* config) { return (uint16_t)config->pointer_sniping_dpi * CHARYBDIS_SNIPING_DPI_CONFIG_STEP + CHARYBDIS_MINIMUM_SNIPING_DPI; }
+
+/** \brief Set the appropriate DPI for the input config. */
+static void maybe_update_pointing_device_cpi(charybdis_config_t* config) {
+    if (config->is_dragscroll_enabled) {
+        pointing_device_set_cpi(CHARYBDIS_DRAGSCROLL_DPI);
+    } else if (config->is_sniping_enabled) {
+        pointing_device_set_cpi(get_pointer_sniping_dpi(config));
+    } else {
+        pointing_device_set_cpi(get_pointer_default_dpi(config));
+    }
+}
+
+/**
+ * \brief Update the pointer's default DPI to the next or previous step.
+ *
+ * Increases the DPI value if `forward` is `true`, decreases it otherwise.
+ * The increment/decrement steps are equal to CHARYBDIS_DEFAULT_DPI_CONFIG_STEP.
+ */
+static void step_pointer_default_dpi(charybdis_config_t* config, bool forward) {
+    config->pointer_default_dpi += forward ? 1 : -1;
+    maybe_update_pointing_device_cpi(config);
+}
+
+/**
+ * \brief Update the pointer's sniper-mode DPI to the next or previous step.
+ *
+ * Increases the DPI value if `forward` is `true`, decreases it otherwise.
+ * The increment/decrement steps are equal to CHARYBDIS_SNIPING_DPI_CONFIG_STEP.
+ */
+static void step_pointer_sniping_dpi(charybdis_config_t* config, bool forward) {
+    config->pointer_sniping_dpi += forward ? 1 : -1;
+    maybe_update_pointing_device_cpi(config);
+}
+
+uint16_t charybdis_get_pointer_default_dpi(void) { return get_pointer_default_dpi(&g_charybdis_config); }
+
+uint16_t charybdis_get_pointer_sniping_dpi(void) { return get_pointer_sniping_dpi(&g_charybdis_config); }
+
+void charybdis_cycle_pointer_default_dpi_noeeprom(bool forward) { step_pointer_default_dpi(&g_charybdis_config, forward); }
+
+void charybdis_cycle_pointer_default_dpi(bool forward) {
+    step_pointer_default_dpi(&g_charybdis_config, forward);
+    write_charybdis_config_to_eeprom(&g_charybdis_config);
+}
+
+void charybdis_cycle_pointer_sniping_dpi_noeeprom(bool forward) { step_pointer_sniping_dpi(&g_charybdis_config, forward); }
+
+void charybdis_cycle_pointer_sniping_dpi(bool forward) {
+    step_pointer_sniping_dpi(&g_charybdis_config, forward);
+    write_charybdis_config_to_eeprom(&g_charybdis_config);
+}
+
+bool charybdis_get_pointer_sniping_enabled(void) { return g_charybdis_config.is_sniping_enabled; }
+
+void charybdis_set_pointer_sniping_enabled(bool enable) {
+    g_charybdis_config.is_sniping_enabled = enable;
+    maybe_update_pointing_device_cpi(&g_charybdis_config);
+}
+
+bool charybdis_get_pointer_dragscroll_enabled(void) { return g_charybdis_config.is_dragscroll_enabled; }
+
+void charybdis_set_pointer_dragscroll_enabled(bool enable) {
+    g_charybdis_config.is_dragscroll_enabled = enable;
+    maybe_update_pointing_device_cpi(&g_charybdis_config);
+}
+
+#    ifndef CONSTRAIN_HID
+#        define CONSTRAIN_HID(value) ((value) < XY_REPORT_MIN ? XY_REPORT_MIN : ((value) > XY_REPORT_MAX ? XY_REPORT_MAX : (value)))
+#    endif  // !CONSTRAIN_HID
+
+/**
+ * \brief Add optional acceleration effect.
+ *
+ * If `CHARYBDIS_ENABLE_POINTER_ACCELERATION` is defined, add a simple and naive
+ * acceleration effect to the provided value.  Return the value unchanged
+ * otherwise.
+ */
+#    ifndef DISPLACEMENT_WITH_ACCELERATION
+#        ifdef CHARYBDIS_POINTER_ACCELERATION_ENABLE
+#            define DISPLACEMENT_WITH_ACCELERATION(d) (CONSTRAIN_HID(d > 0 ? d * d / CHARYBDIS_POINTER_ACCELERATION_FACTOR + d : -d * d / CHARYBDIS_POINTER_ACCELERATION_FACTOR + d))
+#        else  // !CHARYBDIS_POINTER_ACCELERATION_ENABLE
+#            define DISPLACEMENT_WITH_ACCELERATION(d) (d)
+#        endif  // CHARYBDIS_POINTER_ACCELERATION_ENABLE
+#    endif      // !DISPLACEMENT_WITH_ACCELERATION
+
+/**
+ * \brief Augment the pointing device behavior.
+ *
+ * Implement the Charybdis-specific features for pointing devices:
+ *   - Drag-scroll
+ *   - Sniping
+ *   - Acceleration
+ */
+static void pointing_device_task_charybdis(report_mouse_t* mouse_report) {
+    static int16_t scroll_buffer_x = 0;
+    static int16_t scroll_buffer_y = 0;
+    if (g_charybdis_config.is_dragscroll_enabled) {
+#    ifdef CHARYBDIS_DRAGSCROLL_REVERSE_X
+        scroll_buffer_x -= mouse_report->x;
+#    else
+        scroll_buffer_x += mouse_report->x;
+#    endif  // CHARYBDIS_DRAGSCROLL_REVERSE_X
+#    ifdef CHARYBDIS_DRAGSCROLL_REVERSE_Y
+        scroll_buffer_y -= mouse_report->y;
+#    else
+        scroll_buffer_y += mouse_report->y;
+#    endif  // CHARYBDIS_DRAGSCROLL_REVERSE_Y
+        mouse_report->x = 0;
+        mouse_report->y = 0;
+        if (abs(scroll_buffer_x) > CHARYBDIS_DRAGSCROLL_BUFFER_SIZE) {
+            mouse_report->h = scroll_buffer_x > 0 ? 1 : -1;
+            scroll_buffer_x = 0;
+        }
+        if (abs(scroll_buffer_y) > CHARYBDIS_DRAGSCROLL_BUFFER_SIZE) {
+            mouse_report->v = scroll_buffer_y > 0 ? 1 : -1;
+            scroll_buffer_y = 0;
+        }
+    } else if (!g_charybdis_config.is_sniping_enabled) {
+        mouse_report->x = DISPLACEMENT_WITH_ACCELERATION(mouse_report->x);
+        mouse_report->y = DISPLACEMENT_WITH_ACCELERATION(mouse_report->y);
+    }
+}
+
+report_mouse_t pointing_device_task_kb(report_mouse_t mouse_report) {
+    pointing_device_task_charybdis(&mouse_report);
+    mouse_report = pointing_device_task_user(mouse_report);
+
+    return mouse_report;
+}
+
+#    if defined(POINTING_DEVICE_ENABLE) && !defined(NO_CHARYBDIS_KEYCODES)
+/** \brief Whether SHIFT mod is enabled. */
+static bool has_shift_mod(void) {
+#        ifdef NO_ACTION_ONESHOT
+    return mod_config(get_mods()) & MOD_MASK_SHIFT;
+#        else
+    return mod_config(get_mods() | get_oneshot_mods()) & MOD_MASK_SHIFT;
+#        endif  // NO_ACTION_ONESHOT
+}
+#    endif  // POINTING_DEVICE_ENABLE && !NO_CHARYBDIS_KEYCODES
+
+/**
+ * \brief Outputs the Charybdis configuration to console.
+ *
+ * Prints the in-memory configuration structure to console, for debugging.
+ * Includes:
+ *   - raw value
+ *   - drag-scroll: on/off
+ *   - sniping: on/off
+ *   - default DPI: internal table index/actual DPI
+ *   - sniping DPI: internal table index/actual DPI
+ */
+__attribute__((unused)) static void debug_charybdis_config_to_console(charybdis_config_t* config) {
+#    ifdef CONSOLE_ENABLE
+    IGNORE_FORMAT_WARNING(dprintf("(charybdis) process_record_kb: config = {\n"
+                                  "\traw = 0x%04X,\n"
+                                  "\t{\n"
+                                  "\t\tis_dragscroll_enabled=%b\n"
+                                  "\t\tis_sniping_enabled=%b\n"
+                                  "\t\tdefault_dpi=0x%02X (%ld)\n"
+                                  "\t\tsniping_dpi=0x%01X (%ld)\n"
+                                  "\t}\n"
+                                  "}\n",
+                                  config->raw, config->is_dragscroll_enabled, config->is_sniping_enabled, config->pointer_default_dpi, get_pointer_default_dpi(config), config->pointer_sniping_dpi, get_pointer_sniping_dpi(config)));
+#    endif // CONSOLE_ENABLE
+}
+
+bool process_record_kb(uint16_t keycode, keyrecord_t* record) {
+    if (!process_record_user(keycode, record)) {
+        return false;
+    }
+#    ifndef NO_CHARYBDIS_KEYCODES
+    switch (keycode) {
+        case POINTER_DEFAULT_DPI_FORWARD:
+            if (record->event.pressed) {
+                // Step backward if shifted, forward otherwise.
+                charybdis_cycle_pointer_default_dpi(/* forward= */ !has_shift_mod());
+            }
+            break;
+        case POINTER_DEFAULT_DPI_REVERSE:
+            if (record->event.pressed) {
+                // Step forward if shifted, backward otherwise.
+                charybdis_cycle_pointer_default_dpi(/* forward= */ has_shift_mod());
+            }
+            break;
+        case POINTER_SNIPING_DPI_FORWARD:
+            if (record->event.pressed) {
+                // Step backward if shifted, forward otherwise.
+                charybdis_cycle_pointer_sniping_dpi(/* forward= */ !has_shift_mod());
+            }
+            break;
+        case POINTER_SNIPING_DPI_REVERSE:
+            if (record->event.pressed) {
+                // Step forward if shifted, backward otherwise.
+                charybdis_cycle_pointer_sniping_dpi(/* forward= */ has_shift_mod());
+            }
+            break;
+        case SNIPING_MODE:
+            charybdis_set_pointer_sniping_enabled(record->event.pressed);
+            break;
+        case SNIPING_MODE_TOGGLE:
+            if (record->event.pressed) {
+                charybdis_set_pointer_sniping_enabled(!charybdis_get_pointer_sniping_enabled());
+            }
+            break;
+        case DRAGSCROLL_MODE:
+            charybdis_set_pointer_dragscroll_enabled(record->event.pressed);
+            break;
+        case DRAGSCROLL_MODE_TOGGLE:
+            if (record->event.pressed) {
+                charybdis_set_pointer_dragscroll_enabled(!charybdis_get_pointer_dragscroll_enabled());
+            }
+            break;
+    }
+#    endif  // !NO_CHARYBDIS_KEYCODES
+    return true;
+}
+
+void eeconfig_init_kb(void) {
+    g_charybdis_config.raw = 0;
+    write_charybdis_config_to_eeprom(&g_charybdis_config);
+    maybe_update_pointing_device_cpi(&g_charybdis_config);
+    eeconfig_init_user();
+}
+
+void matrix_power_up(void) { pointing_device_task(); }
+
+void charybdis_config_sync_handler(uint8_t initiator2target_buffer_size, const void* initiator2target_buffer, uint8_t target2initiator_buffer_size, void* target2initiator_buffer) {
+    if (initiator2target_buffer_size == sizeof(g_charybdis_config)) {
+        memcpy(&g_charybdis_config, initiator2target_buffer, sizeof(g_charybdis_config));
+    }
+}
+
+void keyboard_post_init_kb(void) {
+    maybe_update_pointing_device_cpi(&g_charybdis_config);
+    transaction_register_rpc(RPC_ID_KB_CONFIG_SYNC, charybdis_config_sync_handler);
+
+    keyboard_post_init_user();
+}
+
+void housekeeping_task_kb(void) {
+    if (is_keyboard_master()) {
+        // Keep track of the last state, so that we can tell if we need to propagate to slave
+        static charybdis_config_t last_charybdis_config = {0};
+        static uint32_t           last_sync             = 0;
+        bool                      needs_sync            = false;
+
+        // Check if the state values are different
+        if (memcmp(&g_charybdis_config, &last_charybdis_config, sizeof(g_charybdis_config))) {
+            needs_sync = true;
+            memcpy(&last_charybdis_config, &g_charybdis_config, sizeof(g_charybdis_config));
+        }
+        // Send to slave every 500ms regardless of state change
+        if (timer_elapsed32(last_sync) > 500) {
+            needs_sync = true;
+        }
+
+        // Perform the sync if requested
+        if (needs_sync) {
+            if (transaction_rpc_send(RPC_ID_KB_CONFIG_SYNC, sizeof(g_charybdis_config), &g_charybdis_config)) {
+                last_sync = timer_read32();
+            }
+        }
+    }
+    // no need for user function, is called already
+}
+
+#endif  // POINTING_DEVICE_ENABLE
+
+__attribute__((weak)) void matrix_init_sub_kb(void) {}
+void                       matrix_init_kb(void) {
+#ifdef POINTING_DEVICE_ENABLE
+    read_charybdis_config_from_eeprom(&g_charybdis_config);
+#endif  // POINTING_DEVICE_ENABLE
+    matrix_init_sub_kb();
+    matrix_init_user();
+}
+
+__attribute__((weak)) void matrix_scan_sub_kb(void) {}
+void                       matrix_scan_kb(void) {
+    matrix_scan_sub_kb();
+    matrix_scan_user();
+}

keyboards/handwired/nerdboard/nerdboard.h

@@ -0,0 +1,115 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "quantum.h"
+
+#if defined(KEYBOARD_handwired_nerdboard_pro_micro_29)
+#    include "pro_micro_29.h"
+#elif defined(KEYBOARD_handwired_nerdboard_pro_micro_41)
+#    include "pro_micro_41.h"
+#endif
+
+enum charybdis_keycodes {
+    POINTER_DEFAULT_DPI_FORWARD = QK_KB_0,
+    POINTER_DEFAULT_DPI_REVERSE,
+    POINTER_SNIPING_DPI_FORWARD,
+    POINTER_SNIPING_DPI_REVERSE,
+    SNIPING_MODE,
+    SNIPING_MODE_TOGGLE,
+    DRAGSCROLL_MODE,
+    DRAGSCROLL_MODE_TOGGLE,
+};
+#        define DPI_MOD POINTER_DEFAULT_DPI_FORWARD
+#        define DPI_RMOD POINTER_DEFAULT_DPI_REVERSE
+#        define S_D_MOD POINTER_SNIPING_DPI_FORWARD
+#        define S_D_RMOD POINTER_SNIPING_DPI_REVERSE
+#        define SNIPING SNIPING_MODE
+#        define SNP_TOG SNIPING_MODE_TOGGLE
+#        define DRGSCRL DRAGSCROLL_MODE
+#        define DRG_TOG DRAGSCROLL_MODE_TOGGLE
+
+#ifdef POINTING_DEVICE_ENABLE
+/** \brief Return the current DPI value for the pointer's default mode. */
+uint16_t charybdis_get_pointer_default_dpi(void);
+
+/**
+ * \brief Update the pointer's default DPI to the next or previous step.
+ *
+ * Increases the DPI value if `forward` is `true`, decreases it otherwise.
+ * The increment/decrement steps are equal to CHARYBDIS_DEFAULT_DPI_CONFIG_STEP.
+ *
+ * The new value is persisted in EEPROM.
+ */
+void charybdis_cycle_pointer_default_dpi(bool forward);
+
+/**
+ * \brief Same as `charybdis_cycle_pointer_default_dpi`, but do not write to
+ * EEPROM.
+ *
+ * This means that reseting the board will revert the value to the last
+ * persisted one.
+ */
+void charybdis_cycle_pointer_default_dpi_noeeprom(bool forward);
+
+/** \brief Return the current DPI value for the pointer's sniper-mode. */
+uint16_t charybdis_get_pointer_sniping_dpi(void);
+
+/**
+ * \brief Update the pointer's sniper-mode DPI to the next or previous step.
+ *
+ * Increases the DPI value if `forward` is `true`, decreases it otherwise.
+ * The increment/decrement steps are equal to CHARYBDIS_SNIPING_DPI_CONFIG_STEP.
+ *
+ * The new value is persisted in EEPROM.
+ */
+void charybdis_cycle_pointer_sniping_dpi(bool forward);
+
+/**
+ * \brief Same as `charybdis_cycle_pointer_sniping_dpi`, but do not write to
+ * EEPROM.
+ *
+ * This means that reseting the board will revert the value to the last
+ * persisted one.
+ */
+void charybdis_cycle_pointer_sniping_dpi_noeeprom(bool forward);
+
+/** \brief Whether sniper-mode is enabled. */
+bool charybdis_get_pointer_sniping_enabled(void);
+
+/**
+ * \brief Enable/disable sniper mode.
+ *
+ * When sniper mode is enabled the dpi is reduced to slow down the pointer for
+ * more accurate movements.
+ */
+void charybdis_set_pointer_sniping_enabled(bool enable);
+
+/** \brief Whether drag-scroll is enabled. */
+bool charybdis_get_pointer_dragscroll_enabled(void);
+
+/**
+ * \brief Enable/disable drag-scroll mode.
+ *
+ * When drag-scroll mode is enabled, horizontal and vertical pointer movements
+ * are translated into horizontal and vertical scroll movements.
+ */
+void charybdis_set_pointer_dragscroll_enabled(bool enable);
+#endif  // POINTING_DEVICE_ENABLE
+
+void matrix_init_sub_kb(void);
+void matrix_scan_sub_kb(void);

keyboards/handwired/nerdboard/post_config.h

@@ -0,0 +1,96 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2015 Jack Humbert
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+// mouse config
+#ifdef MOUSEKEY_ENABLE
+#    ifndef MOUSEKEY_MOVE_DELTA
+#        ifndef MK_KINETIC_SPEED
+#            define MOUSEKEY_MOVE_DELTA 5
+#        else
+#            define MOUSEKEY_MOVE_DELTA 25
+#        endif
+#    endif
+#    ifndef MOUSEKEY_DELAY
+#        ifndef MK_KINETIC_SPEED
+#            define MOUSEKEY_DELAY 300
+#        else
+#            define MOUSEKEY_DELAY 8
+#        endif
+#    endif
+#    ifndef MOUSEKEY_INTERVAL
+#        ifndef MK_KINETIC_SPEED
+#            define MOUSEKEY_INTERVAL 50
+#        else
+#            define MOUSEKEY_INTERVAL 20
+#        endif
+#    endif
+#    ifndef MOUSEKEY_MAX_SPEED
+#        define MOUSEKEY_MAX_SPEED 7
+#    endif
+#    ifndef MOUSEKEY_TIME_TO_MAX
+#        define MOUSEKEY_TIME_TO_MAX 60
+#    endif
+#    ifndef MOUSEKEY_INITIAL_SPEED
+#        define MOUSEKEY_INITIAL_SPEED 100
+#    endif
+#    ifndef MOUSEKEY_BASE_SPEED
+#        define MOUSEKEY_BASE_SPEED 1000
+#    endif
+#    ifndef MOUSEKEY_DECELERATED_SPEED
+#        define MOUSEKEY_DECELERATED_SPEED 400
+#    endif
+#    ifndef MOUSEKEY_ACCELERATED_SPEED
+#        define MOUSEKEY_ACCELERATED_SPEED 3000
+#    endif
+
+// mouse scroll config
+#    ifndef MOUSEKEY_WHEEL_DELAY
+#        define MOUSEKEY_WHEEL_DELAY 15
+#    endif
+#    ifndef MOUSEKEY_WHEEL_DELTA
+#        define MOUSEKEY_WHEEL_DELTA 1
+#    endif
+#    ifndef MOUSEKEY_WHEEL_INTERVAL
+#        define MOUSEKEY_WHEEL_INTERVAL 50
+#    endif
+#    ifndef MOUSEKEY_WHEEL_MAX_SPEED
+#        define MOUSEKEY_WHEEL_MAX_SPEED 8
+#    endif
+#    ifndef MOUSEKEY_WHEEL_TIME_TO_MAX
+#        define MOUSEKEY_WHEEL_TIME_TO_MAX 80
+#    endif
+
+#    ifndef MOUSEKEY_WHEEL_INITIAL_MOVEMENTS
+#        define MOUSEKEY_WHEEL_INITIAL_MOVEMENTS 8
+#    endif
+#    ifndef MOUSEKEY_WHEEL_BASE_MOVEMENTS
+#        define MOUSEKEY_WHEEL_BASE_MOVEMENTS 48
+#    endif
+#    ifndef MOUSEKEY_WHEEL_ACCELERATED_MOVEMENTS
+#        define MOUSEKEY_WHEEL_ACCELERATED_MOVEMENTS 48
+#    endif
+#    ifndef MOUSEKEY_WHEEL_DECELERATED_MOVEMENTS
+#        define MOUSEKEY_WHEEL_DECELERATED_MOVEMENTS 8
+#    endif
+#endif
+
+#ifndef DEBOUNCE
+#    define DEBOUNCE 5
+#endif

keyboards/handwired/nerdboard/pro_micro_29/arduinomicro/arduinomicro.h

@@ -0,0 +1,19 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "pro_micro_29.h"

keyboards/handwired/nerdboard/pro_micro_29/arduinomicro/config.h

@@ -0,0 +1,35 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2015 Jack Humbert
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+#define MATRIX_COL_PINS { C6, D7, E6, B4, B5 }
+#define MATRIX_ROW_PINS { F4, F5, F6, F7 }
+
+#define DIODE_DIRECTION COL2ROW
+#define SOFT_SERIAL_PIN D3
+
+#undef USE_I2C
+
+#define MASTER_RIGHT
+//#define PMW3360_LIFTOFF_DISTANCE 0x04
+#define PMW3389_LIFTOFF_DISTANCE     0x00
+
+/* PMW3360 Settings */
+#define POINTING_DEVICE_CS_PIN B6
+

keyboards/handwired/nerdboard/pro_micro_29/arduinomicro/info.json

@@ -0,0 +1,8 @@
+{
+    "keyboard_name": "Tractyl Manuform(5x6) Arduino Micro (r)/ Pro Micro (l)",
+    "split": {
+        "soft_serial_pin": "D3"
+    },
+    "processor": "atmega32u4",
+    "bootloader": "caterina"
+}

keyboards/handwired/nerdboard/pro_micro_29/arduinomicro/rules.mk

@@ -0,0 +1,2 @@
+OLED_ENABLE = yes
+LTO_ENABLE  = yes

keyboards/handwired/nerdboard/pro_micro_29/config.h

@@ -0,0 +1,52 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2015 Jack Humbert
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+#define DIODE_DIRECTION             COL2ROW
+
+#define VERSION 63
+
+#if VERSION == 61
+  // version 6.1
+  #define ROTATIONAL_TRANSFORM_ANGLE  -15
+  #define POINTING_DEVICE_INVERT_Y
+  #define CHARYBDIS_DRAGSCROLL_REVERSE_Y
+#elif VERSION == 63
+  // version 6.3
+  #define ROTATIONAL_TRANSFORM_ANGLE  -15
+  #define POINTING_DEVICE_INVERT_Y
+  #define CHARYBDIS_DRAGSCROLL_REVERSE_Y
+#else
+  // version 6
+  #define VERSION 6
+  #define ROTATIONAL_TRANSFORM_ANGLE  -15
+  #define POINTING_DEVICE_INVERT_X
+  #define CHARYBDIS_DRAGSCROLL_REVERSE_Y
+#endif
+
+#define DYNAMIC_KEYMAP_LAYER_COUNT  16
+#define LAYER_STATE_16BIT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT
+
+#define POINTING_DEVICE_RIGHT
+#define CHARYBDIS_POINTER_ACCELERATION_FACTOR 24

keyboards/handwired/nerdboard/pro_micro_29/info.json

@@ -0,0 +1,48 @@
+{
+    "url": "",
+    "usb": {
+        "pid": "0x3536",
+        "device_version": "0.0.1"
+    },
+    "split": {
+        "bootmagic": {
+            "matrix": [5, 4]
+        }
+    },
+    "layouts": {
+        "LAYOUT": {
+            "layout": [
+                {"label":"L00", "x":0,  "y":0},
+                {"label":"L01", "x":1,  "y":0},
+                {"label":"L02", "x":2,  "y":0},
+                {"label":"L03", "x":3,  "y":0},
+                {"label":"R00", "x":11, "y":0},
+                {"label":"R01", "x":12, "y":0},
+                {"label":"R02", "x":13, "y":0},
+                {"label":"R03", "x":14, "y":0},
+                {"label":"L10", "x":0,  "y":1},
+                {"label":"L11", "x":1,  "y":1},
+                {"label":"L12", "x":2,  "y":1},
+                {"label":"L13", "x":3,  "y":1},
+                {"label":"R10", "x":11, "y":1},
+                {"label":"R11", "x":12, "y":1},
+                {"label":"R12", "x":13, "y":1},
+                {"label":"R13", "x":14, "y":1},
+                {"label":"L20", "x":0,  "y":2},
+                {"label":"L21", "x":1,  "y":2},
+                {"label":"L22", "x":2,  "y":2},
+                {"label":"L23", "x":3,  "y":2},
+                {"label":"R20", "x":11, "y":2},
+                {"label":"R21", "x":12, "y":2},
+                {"label":"R22", "x":13, "y":2},
+                {"label":"R23", "x":14, "y":2},
+
+                {"label":"L31", "x":1,  "y":3},
+                {"label":"L32", "x":2,  "y":3},
+                {"label":"L33", "x":3,  "y":3},
+                {"label":"R30", "x":11, "y":3},
+                {"label":"R31", "x":12, "y":3}
+            ]
+        }
+    }
+}

keyboards/handwired/nerdboard/pro_micro_29/keymaps/default/keymap.c

@@ -0,0 +1,180 @@
+/* Copyright 2025 Jon Hull, aka (@thelowprokill)
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include QMK_KEYBOARD_H
+
+enum custom_layers {
+    _GAME,
+    _JONMAK,
+    _JM_EXT,
+    _SYMBOL,
+    _MOUSE,
+    _FUNC
+};
+
+// layer keys
+#define JONMAK  TG(_JONMAK)
+#define GJONMAK MO(_JONMAK)
+#define JM_EXT  MO(_JM_EXT)
+#define MOUSE   MO(_MOUSE)
+#define SYMBOL  MO(_SYMBOL)
+#define MOUSE   MO(_MOUSE)
+#define T_GAME  TO(_GAME)
+#define FUNC    MO(_FUNC)
+
+// alternate keys
+#define L       KC_LEFT 
+#define D       KC_DOWN
+#define U       KC_UP 
+#define R       KC_RIGHT 
+#define TERM    LCA(KC_T)
+#define PLUS    LSFT(KC_EQL)
+#define STAR    LSFT(KC_8)
+#define WS_L    G(KC_PGUP)
+#define WS_R    G(KC_PGDN)
+#define T_TAB_L LCTL(KC_PGUP)
+#define T_TAB_R LCTL(KC_PGDN)
+#define T_TAB_N LSFT(LCTL(KC_T))
+#define T_TAB_C LSFT(LCTL(KC_W))
+
+// mod taps
+#define CTL_ENT CTL_T(KC_ENT)
+#define MT_A    SFT_T(KC_A)
+#define MT_R    CTL_T(KC_R)
+#define MT_S    ALT_T(KC_S)
+#define MT_T    SFT_T(KC_T)
+
+#define MTQ_A   SFT_T(KC_A)
+#define MTQ_S   CTL_T(KC_S)
+#define MTQ_D   ALT_T(KC_D)
+#define MTQ_F   SFT_T(KC_F)
+
+// layer tap
+#define MO_TAB LT(MOUSE, KC_TAB)
+#define SY_GRV LT(SYMBOL, KC_GRV)
+
+#ifdef OLED_ENABLE
+  #ifdef VERSION
+    #if VERSION == 61
+      char splash_screen[36] = "NerdBoard V6.1 29 Key\n\nBy: Jon Hull";
+    #elif VERSION == 63
+      char splash_screen[36] = "NerdBoard V6.3 29 Key\n\nBy: Jon Hull";
+    #else 
+      char splash_screen[34] = "NerdBoard V6 29 Key\n\nBy: Jon Hull";
+    #endif
+  #else
+    char splash_screen[34] = "NerdBoard V6 29 Key\n\nBy: Jon Hull";
+  #endif
+  uint32_t timer             = 0;
+  uint8_t  show_splash       = 1;
+  
+  
+  static void regular_use(void) {
+    oled_clear();
+    oled_set_cursor(0, 0);
+  
+    oled_write("Layer: ", false);
+    switch (get_highest_layer(layer_state)) {
+      case _GAME:
+        oled_write("GAME", false);
+        break;
+      case _JONMAK:
+        oled_write("Jon MAC 29", false);
+        break;
+      case _JM_EXT:
+        oled_write("Jon MAC Cont.", false);
+        break;
+      case _SYMBOL:
+        oled_write("SYMBOLS", false);
+        break;
+      case _MOUSE:
+        oled_write("MOUSE", false);
+        break;
+      case _FUNC:
+        oled_write("FUNCTION", false);
+        break;
+    }
+  
+    led_t led_state = host_keyboard_led_state();
+    oled_write("\n\nMods:", false);
+  
+    uint8_t mod = get_mods();
+  
+    if (led_state.caps_lock)  { oled_write(" CAP", false); }
+    if (mod & MOD_MASK_SHIFT) { oled_write(" SFT", false); }
+    if (mod & MOD_MASK_CTRL)  { oled_write(" CTL", false); }
+    if (mod & MOD_MASK_ALT)   { oled_write(" ALT", false); }
+    if (mod & MOD_MASK_GUI)   { oled_write(" GUI", false); }
+  
+    return;
+  }
+  
+  bool oled_task_user() {
+    if (timer > 100) { regular_use(); }
+    else { timer += 1; oled_write(splash_screen, false); }
+    return false;
+  }
+
+#endif
+
+void keyboard_pre_init_user(void) { layer_move(_JONMAK); }
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+
+  // needs a KC_R, and KC_F
+  [_GAME] = LAYOUT(
+    KC_TAB , KC_1  , KC_2  , KC_3  ,       KC_BTN3, KC_4  , KC_F  , JONMAK,
+    KC_LSFT, KC_A  , KC_W  , KC_D  ,       KC_BTN4,KC_BTN5, KC_R  , SYMBOL,
+    KC_LALT, KC_Q  , KC_S  , KC_E  ,       KC_BTN1,KC_BTN2,SNIPING,DRGSCRL,
+            KC_ESC ,KC_LCTL, KC_SPC,       SYMBOL ,GJONMAK
+  ),
+
+  // decide on having KC_ENT or KC_ESC here
+  [_JONMAK] = LAYOUT(
+    KC_D   , KC_W  , KC_F  , KC_P  ,       KC_M  , KC_U  , KC_Y  ,KC_SCLN,
+    MT_A   , MT_R  , MT_S  , MT_T  ,       KC_N  , KC_E  , KC_I  , KC_O  ,
+    KC_G   , KC_X  , KC_C  , KC_V  ,       KC_H  , KC_J  , KC_K  , KC_L  ,
+            CTL_ENT, MO_TAB, KC_SPC,       SY_GRV, JM_EXT
+  ),
+
+  [_JM_EXT] = LAYOUT(
+    _______,_______,_______,KC_LCBR,       KC_RCBR,_______,_______,_______,
+    KC_Z   , KC_Q  , KC_B  ,KC_LBRC,       KC_RBRC,KC_COMM, KC_DOT,KC_SLSH,
+    _______,_______,KC_BSLS,KC_LPRN,       KC_RPRN,_______,_______,_______,
+            KC_LCTL,KC_LSFT,KC_SPC ,       SYMBOL ,_______
+  ),
+
+  [_SYMBOL] = LAYOUT(
+    _______, KC_7  , KC_8  , KC_9  ,       KC_MINS, PLUS  , STAR  ,KC_SLSH,
+    KC_LSFT, KC_4  , KC_5  , KC_6  ,       KC_BSPC, KC_DEL,KC_QUOT,KC_DQUO,
+    KC_0   , KC_1  , KC_2  , KC_3  ,       L      , D     , U     , R     ,
+            KC_PEQL, FUNC  , KC_ESC,       FUNC   , FUNC
+  ),
+
+  [_MOUSE] = LAYOUT(
+    T_TAB_C,T_TAB_N,_______,G(KC_T),       KC_BTN3,_______,_______,_______,
+    T_TAB_L,T_TAB_R, WS_L  , WS_R  ,       KC_BTN4,KC_BTN5,KC_RCTL,_______,
+    KC_LSFT,KC_LCTL,KC_LALT,KC_LGUI,       KC_BTN1,KC_BTN2,SNIPING,DRGSCRL,
+            _______, FUNC  ,_______,       FUNC   ,_______
+  ),
+
+  [_FUNC] = LAYOUT(
+    QK_BOOT,KC_VOLU, KC_F5 ,G(KC_L),       KC_INS ,KC_PSCR,QK_BOOT, T_GAME,
+    KC_LSFT,KC_MUTE, KC_F11, TERM  ,       KC_LGUI,KC_MPRV,KC_MPLY,KC_MNXT,
+    KC_LSFT,KC_VOLD,KC_HOME, KC_END,       G(L)   , G(D)  , G(U)  , G(R)  ,
+            _______,_______,_______,       _______,_______
+  )
+};

keyboards/handwired/nerdboard/pro_micro_29/pro_micro_29.c

@@ -0,0 +1,39 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include "pro_micro_29.h"
+
+#ifdef SWAP_HANDS_ENABLE
+const keypos_t PROGMEM hand_swap_config[MATRIX_ROWS][MATRIX_COLS] = {
+    /* Left hand, matrix positions */
+    {{5, 6}, {4, 6}, {3, 6}, {2, 6}, {1, 6}},//, {0, 6}},
+    {{5, 7}, {4, 7}, {3, 7}, {2, 7}, {1, 7}},//, {0, 7}},
+    {{5, 8}, {4, 8}, {3, 8}, {2, 8}, {1, 8}},//, {0, 8}},
+    {{5, 9}, {4, 9}, {3, 9}, {2, 9}, {1, 9}},//, {0, 9}},
+    //{{5, 10}, {4, 10}, {3, 10}, {2, 10}, {1, 10}},//, {0, 10}},
+    //{{5, 11}, {4, 11}, {3, 11}, {2, 11}, {1, 11}},//, {0, 11}},
+    /* Right hand, matrix positions */
+    {{5, 0}, {4, 0}, {3, 0}, {2, 0}, {1, 0}},//, {0, 0}},
+    {{5, 1}, {4, 1}, {3, 1}, {2, 1}, {1, 1}},//, {0, 1}},
+    {{5, 2}, {4, 2}, {3, 2}, {2, 2}, {1, 2}},//, {0, 2}},
+    {{5, 3}, {4, 3}, {3, 3}, {2, 3}, {1, 3}}};//,//, {0, 3}},
+    //{{5, 4}, {4, 4}, {3, 4}, {2, 4}, {1, 4}}};//, {0, 4}},
+    //{{5, 5}, {4, 5}, {3, 5}, {2, 5}, {1, 5}},//, {0, 5}}};
+
+#    ifdef ENCODER_MAP_ENABLE
+const uint8_t PROGMEM encoder_hand_swap_config[NUM_ENCODERS] = {1, 0};
+#    endif
+#endif

keyboards/handwired/nerdboard/pro_micro_29/pro_micro_29.h

@@ -0,0 +1,43 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "nerdboard.h"
+#include "arduinomicro.h"
+#include "quantum.h"
+
+#define ___ KC_NO
+
+// clang-format off
+#define LAYOUT(\
+  L00, L01, L02, L03,                          R00, R01, R02, R03, \
+  L10, L11, L12, L13,                          R10, R11, R12, R13, \
+  L20, L21, L22, L23,                          R20, R21, R22, R23, \
+       L31, L32, L33,                          R30, R32            \
+  ) \
+  { \
+    { L00, L01, L02, L03 }, \
+    { L10, L11, L12, L13 }, \
+    { L20, L21, L22, L23 }, \
+    { ___, L31, L32, L33 }, \
+                            \
+    { R00, R01, R02, R03 }, \
+    { R10, R11, R12, R13 }, \
+    { R20, R21, R22, R23 }, \
+    { R30, R32, ___, ___ }  \
+}
+// clang-format on

keyboards/handwired/nerdboard/pro_micro_29/readme.md

@@ -0,0 +1,27 @@
+# Nerdboard
+
+![Nerdboard](https://imgur.com/a/96ViqlI)
+
+*Nerdboard is a custom 29 key split ergonomic keyboard with a built in mouse.*
+
+* Keyboard Maintainer: [Jon Hull](https://github.com/thelowprokill)
+* Hardware Supported: handwired Arduino Pro Micro
+* Hardware Availability: https://github.com/thelowprokill/nerdboard
+
+Make example for this keyboard (after setting up your build environment):
+
+    make nerdboard:default
+
+Flashing example for this keyboard:
+
+    make nerdboard: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

keyboards/handwired/nerdboard/pro_micro_29/rules.mk

@@ -0,0 +1,22 @@
+# Build Options
+#   change yes to no to disable
+#
+BOOTMAGIC_ENABLE = yes      # Enable Bootmagic Lite
+MOUSEKEY_ENABLE = yes       # Mouse keys
+EXTRAKEY_ENABLE = yes       # Audio control and System control
+CONSOLE_ENABLE = no         # Console for debug
+COMMAND_ENABLE = no         # Commands for debug and configuration
+NKRO_ENABLE = yes           # Enable N-Key Rollover
+BACKLIGHT_ENABLE = no       # Enable keyboard backlight functionality
+RGBLIGHT_ENABLE = no        # Enable keyboard RGB underglow
+AUDIO_ENABLE = no           # Audio output
+SWAP_HANDS_ENABLE = yes
+
+POINTING_DEVICE_ENABLE = yes
+#POINTING_DEVICE_DRIVER = pmw3389 # pmw3360
+POINTING_DEVICE_DRIVER = pmw3360
+MOUSE_SHARED_EP = yes
+
+SPLIT_KEYBOARD = yes
+
+DEFAULT_FOLDER = handwired/nerdboard/pro_micro_29/arduinomicro

keyboards/handwired/nerdboard/pro_micro_41/arduinomicro/arduinomicro.h

@@ -0,0 +1,19 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "pro_micro_41.h"

keyboards/handwired/nerdboard/pro_micro_41/arduinomicro/config.h

@@ -0,0 +1,34 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2015 Jack Humbert
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+#define MATRIX_COL_PINS { D4, C6, D7, E6, B4, B5 }
+#define MATRIX_ROW_PINS { F4, F5, F6, F7 }
+
+#define DIODE_DIRECTION COL2ROW
+#define SOFT_SERIAL_PIN D3
+
+#undef USE_I2C
+
+#define MASTER_RIGHT
+#define PMW3360_LIFTOFF_DISTANCE 0x40
+
+/* PMW3360 Settings */
+#define POINTING_DEVICE_CS_PIN B6
+

keyboards/handwired/nerdboard/pro_micro_41/arduinomicro/info.json

@@ -0,0 +1,8 @@
+{
+    "keyboard_name": "Tractyl Manuform(5x6) Arduino Micro (r)/ Pro Micro (l)",
+    "split": {
+        "soft_serial_pin": "D3"
+    },
+    "processor": "atmega32u4",
+    "bootloader": "caterina"
+}

keyboards/handwired/nerdboard/pro_micro_41/arduinomicro/rules.mk

@@ -0,0 +1,2 @@
+OLED_ENABLE = no
+LTO_ENABLE  = yes

keyboards/handwired/nerdboard/pro_micro_41/config.h

@@ -0,0 +1,47 @@
+/*
+Copyright 2012 Jun Wako <wakojun@gmail.com>
+Copyright 2015 Jack Humbert
+
+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 <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+#define DIODE_DIRECTION             COL2ROW
+
+#define VERSION 6
+
+#if VERSION == 61
+  // version 6.1
+  #define ROTATIONAL_TRANSFORM_ANGLE  -15
+  #define POINTING_DEVICE_INVERT_Y
+  #define CHARYBDIS_DRAGSCROLL_REVERSE_Y
+#else
+  // version 6
+  #define VERSION 6
+  #define ROTATIONAL_TRANSFORM_ANGLE  -15
+  #define POINTING_DEVICE_INVERT_X
+  #define CHARYBDIS_DRAGSCROLL_REVERSE_Y
+#endif
+
+#define DYNAMIC_KEYMAP_LAYER_COUNT  16
+#define LAYER_STATE_16BIT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT
+
+#define POINTING_DEVICE_RIGHT
+#define CHARYBDIS_POINTER_ACCELERATION_FACTOR 24

keyboards/handwired/nerdboard/pro_micro_41/info.json

@@ -0,0 +1,60 @@
+{
+    "url": "",
+    "usb": {
+        "pid": "0x3536",
+        "device_version": "0.0.1"
+    },
+    "split": {
+        "bootmagic": {
+            "matrix": [6, 4]
+        }
+    },
+    "layouts": {
+        "LAYOUT": {
+            "layout": [
+                {"label":"L00", "x":0,  "y":0},
+                {"label":"L01", "x":1,  "y":0},
+                {"label":"L02", "x":2,  "y":0},
+                {"label":"L03", "x":3,  "y":0},
+                {"label":"L04", "x":4,  "y":0},
+                {"label":"L05", "x":5,  "y":0},
+                {"label":"R00", "x":11, "y":0},
+                {"label":"R01", "x":12, "y":0},
+                {"label":"R02", "x":13, "y":0},
+                {"label":"R03", "x":14, "y":0},
+                {"label":"R04", "x":15, "y":0},
+                {"label":"R05", "x":16, "y":0},
+                {"label":"L10", "x":0,  "y":1},
+                {"label":"L11", "x":1,  "y":1},
+                {"label":"L12", "x":2,  "y":1},
+                {"label":"L13", "x":3,  "y":1},
+                {"label":"L14", "x":4,  "y":1},
+                {"label":"L15", "x":5,  "y":1},
+                {"label":"R10", "x":11, "y":1},
+                {"label":"R11", "x":12, "y":1},
+                {"label":"R12", "x":13, "y":1},
+                {"label":"R13", "x":14, "y":1},
+                {"label":"R14", "x":15, "y":1},
+                {"label":"R15", "x":16, "y":1},
+                {"label":"L20", "x":0,  "y":2},
+                {"label":"L21", "x":1,  "y":2},
+                {"label":"L22", "x":2,  "y":2},
+                {"label":"L23", "x":3,  "y":2},
+                {"label":"L24", "x":4,  "y":2},
+                {"label":"L25", "x":5,  "y":2},
+                {"label":"R20", "x":11, "y":2},
+                {"label":"R21", "x":12, "y":2},
+                {"label":"R22", "x":13, "y":2},
+                {"label":"R23", "x":14, "y":2},
+                {"label":"R24", "x":15, "y":2},
+                {"label":"R25", "x":16, "y":2},
+
+                {"label":"L33", "x":3,  "y":3},
+                {"label":"L34", "x":4,  "y":3},
+                {"label":"L35", "x":5,  "y":3},
+                {"label":"R30", "x":11, "y":3},
+                {"label":"R31", "x":12, "y":3}
+            ]
+        }
+    }
+}

keyboards/handwired/nerdboard/pro_micro_41/keymaps/default/keymap.c

@@ -0,0 +1,123 @@
+/* Copyright 2025 Jon Hull, aka (@thelowprokill)
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include QMK_KEYBOARD_H
+
+enum custom_layers {
+    _QUERTY,
+    _SYMBOL,
+    _MOUSE,
+    _FUNC
+};
+
+// layer keys
+#define MOUSE   MO(_MOUSE)
+#define SYMBOL  MO(_SYMBOL)
+#define FUNC    MO(_FUNC)
+
+// alternate keys
+#define L       KC_LEFT
+#define D       KC_DOWN
+#define U       KC_UP
+#define R       KC_RIGHT
+#define PLUS    LSFT(KC_EQL)
+#define STAR    LSFT(KC_8)
+#define WS_L    G(KC_PGUP)
+#define WS_R    G(KC_PGDN)
+#define T_TAB_L LCTL(KC_PGUP)
+#define T_TAB_R LCTL(KC_PGDN)
+#define T_TAB_N LSFT(LCTL(KC_T))
+#define T_TAB_C LSFT(LCTL(KC_W))
+
+// layer tap
+#define MO_TAB LT(MOUSE, KC_TAB)
+#define SY_GRV LT(SYMBOL, KC_GRV)
+
+#ifdef OLED_ENABLE
+  char     splash_screen[36] = "NerdBoard V7 41 Key\n\nBy: Jon Hull";
+  uint32_t timer             = 0;
+  uint8_t  show_splash       = 1;
+
+
+  static void regular_use(void) {
+    oled_clear();
+    oled_set_cursor(0, 0);
+
+    oled_write("Layer: ", false);
+    switch (get_highest_layer(layer_state)) {
+      case _QUERTY:
+        oled_write("QWERTY 41", false);
+        break;
+      case _SYMBOL:
+        oled_write("SYMBOLS", false);
+        break;
+      case _MOUSE:
+        oled_write("MOUSE", false);
+        break;
+      case _FUNC:
+        oled_write("FUNCTION", false);
+        break;
+    }
+
+    led_t led_state = host_keyboard_led_state();
+    oled_write("\n\nMods:", false);
+
+    uint8_t mod = get_mods();
+
+    if (led_state.caps_lock)  { oled_write(" CAP", false); }
+    if (mod & MOD_MASK_SHIFT) { oled_write(" SFT", false); }
+    if (mod & MOD_MASK_CTRL)  { oled_write(" CTL", false); }
+    if (mod & MOD_MASK_ALT)   { oled_write(" ALT", false); }
+    if (mod & MOD_MASK_GUI)   { oled_write(" GUI", false); }
+
+    return;
+  }
+
+  bool oled_task_user() {
+    if (timer > 100) { regular_use(); }
+    else { timer += 1; oled_write(splash_screen, false); }
+    return false;
+  }
+
+#endif
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+
+  [_QUERTY] = LAYOUT(
+    KC_TAB , KC_Q  , KC_W  , KC_E  , KC_R  , KC_T  ,       KC_Y   , KC_U  , KC_I  , KC_O  , KC_P  ,KC_BSPC,
+    KC_LSFT, KC_A  , KC_S  , KC_D  , KC_F  , KC_G  ,       KC_H   , KC_J  , KC_K  , KC_L  ,KC_SCLN,KC_RSFT,
+    KC_LALT, KC_Z  , KC_X  , KC_C  , KC_V  , KC_B  ,       KC_N   , KC_M  ,KC_COMM, KC_DOT,KC_SLSH,KC_LCTL,
+                             SYMBOL, MO_TAB, KC_SPC ,      SY_GRV , KC_ENT
+  ),
+  [_SYMBOL] = LAYOUT(
+    _______,_______, KC_7  , KC_8  , KC_9  ,KC_LCBR,       KC_RCBR,KC_MINS, PLUS  , STAR  ,KC_SLSH,_______,
+    KC_LSFT,_______, KC_4  , KC_5  , KC_6  ,KC_LBRC,       KC_RBRC,KC_BSPC, KC_DEL,KC_QUOT,KC_DQUO,KC_RSFT,
+    KC_LALT, KC_0  , KC_1  , KC_2  , KC_3  ,KC_LPRN,       KC_RPRN, L     , D     , U     , R     ,KC_LCTL,
+                             KC_EQL, FUNC  , KC_ESC,       FUNC   ,FUNC
+  ),
+  [_MOUSE] = LAYOUT(
+    _______,T_TAB_C,T_TAB_N,_______,_______,_______,       _______,KC_BTN3,_______,_______,_______,_______,
+    KC_LSFT,T_TAB_L,T_TAB_R, WS_L  , WS_R  ,_______,       _______,KC_BTN1,KC_BTN2,SNIPING,DRGSCRL,KC_RSFT,
+    KC_LALT,_______,_______,_______,_______,_______,       _______,KC_BTN4,KC_BTN5,_______,_______,KC_LCTL,
+                            _______, FUNC  ,_______,       FUNC   ,_______
+  ),
+  [_FUNC] = LAYOUT(
+    QK_BOOT,_______,KC_VOLU,_______,G(KC_L),_______,       _______, KC_INS,KC_PSCR,_______,_______,_______,
+    KC_LSFT,_______,KC_MUTE,_______,_______,_______,       _______,KC_LGUI,KC_MPRV,KC_MPLY,KC_MNXT,KC_RSFT,
+    KC_LALT,_______,KC_VOLD,KC_HOME, KC_END,_______,       _______, G(L)  , G(D)  , G(U)  , G(R)  ,KC_LCTL,
+                            _______,_______,_______,       _______,_______
+  )
+};

keyboards/handwired/nerdboard/pro_micro_41/pro_micro_41.c

@@ -0,0 +1,40 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#include "pro_micro_41.h"
+
+#ifdef SWAP_HANDS_ENABLE
+const keypos_t PROGMEM hand_swap_config[MATRIX_ROWS][MATRIX_COLS] = {
+    /* Left hand, matrix positions */
+    {{5, 6}, {4, 6}, {3, 6}, {2, 6}, {1, 6}, {0, 6}},
+    {{5, 7}, {4, 7}, {3, 7}, {2, 7}, {1, 7}, {0, 7}},
+    {{5, 8}, {4, 8}, {3, 8}, {2, 8}, {1, 8}, {0, 8}},
+    {{5, 9}, {4, 9}, {3, 9}, {2, 9}, {1, 9}, {0, 9}},
+    //{{5, 10}, {4, 10}, {3, 10}, {2, 10}, {1, 10}},//, {0, 10}},
+    //{{5, 11}, {4, 11}, {3, 11}, {2, 11}, {1, 11}},//, {0, 11}},
+    /* Right hand, matrix positions */
+    {{5, 0}, {4, 0}, {3, 0}, {2, 0}, {1, 0}, {0, 0}},
+    {{5, 1}, {4, 1}, {3, 1}, {2, 1}, {1, 1}, {0, 1}},
+    {{5, 2}, {4, 2}, {3, 2}, {2, 2}, {1, 2}, {0, 2}},
+    {{5, 3}, {4, 3}, {3, 3}, {2, 3}, {1, 3}, {0, 3}}
+    //{{5, 4}, {4, 4}, {3, 4}, {2, 4}, {1, 4}}};//, {0, 4}},
+    //{{5, 5}, {4, 5}, {3, 5}, {2, 5}, {1, 5}},//, {0, 5}}};
+};
+
+#    ifdef ENCODER_MAP_ENABLE
+const uint8_t PROGMEM encoder_hand_swap_config[NUM_ENCODERS] = {1, 0};
+#    endif
+#endif

keyboards/handwired/nerdboard/pro_micro_41/pro_micro_41.h

@@ -0,0 +1,43 @@
+/* Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "nerdboard.h"
+#include "arduinomicro.h"
+#include "quantum.h"
+
+#define ___ KC_NO
+
+// clang-format off
+#define LAYOUT(\
+  L00, L01, L02, L03, L04, L05,                          R00, R01, R02, R03, R04, R05, \
+  L10, L11, L12, L13, L14, L15,                          R10, R11, R12, R13, R14, R15, \
+  L20, L21, L22, L23, L24, L25,                          R20, R21, R22, R23, R24, R25, \
+                 L33, L34, L35,                          R30, R32                      \
+  ) \
+  { \
+    { L00, L01, L02, L03, L04, L05 }, \
+    { L10, L11, L12, L13, L14, L15 }, \
+    { L20, L21, L22, L23, L24, L25 }, \
+    { ___, ___, ___, L33, L34, L35 }, \
+                            \
+    { R00, R01, R02, R03, R04, R05 }, \
+    { R10, R11, R12, R13, R14, R15 }, \
+    { R20, R21, R22, R23, R24, R25 }, \
+    { R30, R32, ___, ___, ___, ___ }  \
+}
+// clang-format on

keyboards/handwired/nerdboard/pro_micro_41/readme.md

@@ -0,0 +1,27 @@
+# Nerdboard
+
+![Nerdboard](https://imgur.com/a/96ViqlI)
+
+*Nerdboard is a custom 29 key split ergonomic keyboard with a built in mouse.*
+
+* Keyboard Maintainer: [Jon Hull](https://github.com/thelowprokill)
+* Hardware Supported: handwired Arduino Pro Micro
+* Hardware Availability: https://github.com/thelowprokill/nerdboard
+
+Make example for this keyboard (after setting up your build environment):
+
+    make nerdboard:default
+
+Flashing example for this keyboard:
+
+    make nerdboard: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

keyboards/handwired/nerdboard/pro_micro_41/rules.mk

@@ -0,0 +1,21 @@
+# Build Options
+#   change yes to no to disable
+#
+BOOTMAGIC_ENABLE = yes      # Enable Bootmagic Lite
+MOUSEKEY_ENABLE = yes       # Mouse keys
+EXTRAKEY_ENABLE = yes       # Audio control and System control
+CONSOLE_ENABLE = no         # Console for debug
+COMMAND_ENABLE = no         # Commands for debug and configuration
+NKRO_ENABLE = yes           # Enable N-Key Rollover
+BACKLIGHT_ENABLE = no       # Enable keyboard backlight functionality
+RGBLIGHT_ENABLE = no        # Enable keyboard RGB underglow
+AUDIO_ENABLE = no           # Audio output
+SWAP_HANDS_ENABLE = yes
+
+POINTING_DEVICE_ENABLE = yes
+POINTING_DEVICE_DRIVER = pmw3389
+MOUSE_SHARED_EP = yes
+
+SPLIT_KEYBOARD = yes
+
+DEFAULT_FOLDER = handwired/nerdboard/pro_micro_41/arduinomicro

keyboards/handwired/nerdboard/readme.md

@@ -0,0 +1,27 @@
+# Nerdboard
+
+![Nerdboard](https://imgur.com/a/96ViqlI)
+
+*Nerdboard is a custom 29 key split ergonomic keyboard with a built in mouse.*
+
+* Keyboard Maintainer: [Jon Hull](https://github.com/thelowprokill)
+* Hardware Supported: handwired Arduino Pro Micro
+* Hardware Availability: https://github.com/thelowprokill/nerdboard
+
+Make example for this keyboard (after setting up your build environment):
+
+    make nerdboard:default
+
+Flashing example for this keyboard:
+
+    make nerdboard: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

keyboards/haverworks/theseus75/config.h

@@ -0,0 +1,33 @@
+// Copyright 2023 Moritz Plattner (@ebastler), Alex Havermale (@haversnail)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#pragma once
+
+/* Defines for configuring the serial driver for split comms (see https://docs.qmk.fm/drivers/serial) */
+#define SERIAL_USART_DRIVER SD3    // USART 3
+
+/* Defines for required pins */
+#define ID_PIN A13
+#define USBSW_PIN A14     // Switches the hub input/output with the MUXes
+#define PSW_PIN A15       // Turns the power routing to the USB-C port on/off
+#define BUS_B_PIN C13     // Tells the hub to be bus-powered or self-powered (which in turn tells the clients to use 100 mA or 500 mA)
+#define USB_VBUS_PIN C15  // Only the master side will have VBUS present at power-up (used to determine master/slave)
+#define USBPD_1_PIN F0
+#define USBPD_2_PIN F1
+
+/* Additional defines for managing power and state scross split */
+#define DISABLE_BUS_POWER_MODE TRUE
+#define KB_STATE_SYNC_INTERVAL 500
+#define USBPD_ALLOWANCE_CHECK_INTERVAL 100
+#define SPLIT_TRANSACTION_IDS_KB RPC_ID_KB_STATE
+
+/* Defines for the RGB matrix */
+#define INDICATOR_MAX_BRIGHTNESS 255
+#define CAPS_LOCK_LED_INDEX 0 // LED1 on PCB
+#define WS2812_EXTERNAL_PULLUP
+#define WS2812_PWM_DRIVER PWMD3
+#define WS2812_PWM_CHANNEL 4
+#define WS2812_PWM_PAL_MODE 10
+#define WS2812_DMA_STREAM STM32_DMA1_STREAM2
+#define WS2812_DMA_CHANNEL 2
+#define WS2812_DMAMUX_ID STM32_DMAMUX1_TIM3_UP

keyboards/haverworks/theseus75/halconf.h

@@ -0,0 +1,10 @@
+// Copyright 2023 Moritz Plattner (@ebastler)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#pragma once
+
+#define HAL_USE_SERIAL TRUE
+
+#define HAL_USE_PWM TRUE
+
+#include_next <halconf.h>

keyboards/haverworks/theseus75/keyboard.json

@@ -0,0 +1,456 @@
+{
+    "manufacturer": "Haverworks",
+    "keyboard_name": "Theseus75",
+    "maintainer": "ebastler",
+    "bootloader": "stm32-dfu",
+    "bootmagic": {
+        "matrix": [0, 1]
+    },
+    "diode_direction": "COL2ROW",
+    "encoder": {
+        "rotary": [
+            {"pin_a": "A8", "pin_b": "C6", "resolution": 2}
+        ]
+    },
+    "features": {
+        "bootmagic": true,
+        "encoder": true,
+        "extrakey": true,
+        "mousekey": true,
+        "nkro": true,
+        "rgb_matrix": true
+    },
+    "matrix_pins": {
+        "cols": ["B11", "C14", "B6", "B5", "B4", "B3", "C11", "C10", null],
+        "rows": ["A9", "A10", "B15", "B12", "B13", "B14"]
+    },
+    "processor": "STM32G431",
+    "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,
+            "dual_beacon": true,
+            "gradient_left_right": true,
+            "gradient_up_down": true,
+            "hue_breathing": true,
+            "hue_pendulum": true,
+            "hue_wave": true,
+            "jellybean_raindrops": true,
+            "pixel_flow": true,
+            "pixel_fractal": true,
+            "pixel_rain": true,
+            "rainbow_beacon": true,
+            "rainbow_moving_chevron": true,
+            "rainbow_pinwheels": true,
+            "raindrops": true
+        },
+        "driver": "ws2812",
+        "layout": [
+            {"matrix": [3, 1], "x": 32, "y": 34, "flags": 8},
+            {"x": 28, "y": 1, "flags": 2},
+            {"x": 43, "y": 1, "flags": 2},
+            {"x": 56, "y": 1, "flags": 2},
+            {"x": 69, "y": 1, "flags": 2},
+            {"x": 84, "y": 1, "flags": 2},
+            {"x": 99, "y": 1, "flags": 2},
+            {"x": 97, "y": 8, "flags": 2},
+            {"x": 91, "y": 19, "flags": 2},
+            {"x": 91, "y": 31, "flags": 2},
+            {"x": 92, "y": 42, "flags": 2},
+            {"x": 96, "y": 53, "flags": 2},
+            {"x": 97, "y": 64, "flags": 2},
+            {"x": 81, "y": 64, "flags": 2},
+            {"x": 66, "y": 64, "flags": 2},
+            {"x": 53, "y": 64, "flags": 2},
+            {"x": 40, "y": 64, "flags": 2},
+            {"x": 26, "y": 64, "flags": 2},
+            {"x": 13, "y": 64, "flags": 2},
+            {"x": 0, "y": 64, "flags": 2},
+            {"x": 0, "y": 53, "flags": 2},
+            {"x": 0, "y": 42, "flags": 2},
+            {"x": 0, "y": 31, "flags": 2},
+            {"x": 0, "y": 19, "flags": 2},
+            {"x": 0, "y": 9, "flags": 2},
+            {"x": 0, "y": 1, "flags": 2},
+            {"x": 13, "y": 1, "flags": 2},
+            {"x": 224, "y": 31, "flags": 2},
+            {"x": 224, "y": 42, "flags": 2},
+            {"x": 224, "y": 53, "flags": 2},
+            {"x": 224, "y": 64, "flags": 2},
+            {"x": 209, "y": 64, "flags": 2},
+            {"x": 194, "y": 64, "flags": 2},
+            {"x": 180, "y": 64, "flags": 2},
+            {"x": 165, "y": 64, "flags": 2},
+            {"x": 152, "y": 64, "flags": 2},
+            {"x": 138, "y": 64, "flags": 2},
+            {"x": 124, "y": 64, "flags": 2},
+            {"x": 124, "y": 53, "flags": 2},
+            {"x": 119, "y": 42, "flags": 2},
+            {"x": 114, "y": 31, "flags": 2},
+            {"x": 117, "y": 19, "flags": 2},
+            {"x": 122, "y": 8, "flags": 2},
+            {"x": 126, "y": 1, "flags": 2},
+            {"x": 140, "y": 1, "flags": 2},
+            {"x": 155, "y": 1, "flags": 2},
+            {"x": 168, "y": 1, "flags": 2},
+            {"x": 181, "y": 1, "flags": 2},
+            {"x": 196, "y": 1, "flags": 2},
+            {"x": 211, "y": 1, "flags": 2},
+            {"x": 224, "y": 1, "flags": 2},
+            {"x": 224, "y": 8, "flags": 2},
+            {"x": 224, "y": 19, "flags": 2}
+        ],
+        "max_brightness": 128,
+        "sleep": true,
+        "split_count": [27, 26]
+    },
+    "split": {
+        "bootmagic": {
+            "matrix": [6, 6]
+        },
+        "enabled": true,
+        "encoder": {
+            "right": {
+                "rotary": [
+                    {"pin_a": "B5", "pin_b": "B4", "resolution": 2}
+                ]
+            }
+        },
+        "handedness": {
+            "pin": "B9"
+        },
+        "matrix_pins": {
+            "right": {
+                "cols": ["A10", "A9", "A8", "C6", "B15", "B14", "B13", "B12", "C14"],
+                "rows": ["B3", "C10", "C11", "A1", "A0", "B6"]
+            }
+        },
+        "serial": {
+            "driver": "usart",
+            "pin": "B10"
+        },
+        "soft_serial_speed": 0,
+        "transport": {
+            "sync": {
+                "indicators": true,
+                "layer_state": true,
+                "matrix_state": true
+            },
+            "watchdog": true
+        }
+    },
+    "url": "https://haver.works/theseus75",
+    "usb": {
+        "device_version": "1.0.0",
+        "pid": "0x0001",
+        "vid": "0x6877"
+    },
+    "ws2812": {
+        "driver": "pwm",
+        "pin": "B7"
+    },
+    "layouts": {
+        "LAYOUT_all": {
+            "layout": [
+                {"label": "LENC", "matrix": [0, 0], "x": 0, "y": 0},
+                {"label": "ESC", "matrix": [0, 1], "x": 1.5, "y": 0},
+                {"label": "F1", "matrix": [0, 2], "x": 2.75, "y": 0},
+                {"label": "F2", "matrix": [0, 3], "x": 3.75, "y": 0},
+                {"label": "F3", "matrix": [0, 4], "x": 4.75, "y": 0},
+                {"label": "F4", "matrix": [0, 5], "x": 5.75, "y": 0},
+                {"label": "F5", "matrix": [0, 6], "x": 7, "y": 0},
+                {"label": "F6", "matrix": [0, 7], "x": 8, "y": 0},
+                {"label": "F7", "matrix": [6, 0], "x": 10, "y": 0},
+                {"label": "F8", "matrix": [6, 1], "x": 11, "y": 0},
+                {"label": "F9", "matrix": [6, 2], "x": 12.25, "y": 0},
+                {"label": "F10", "matrix": [6, 3], "x": 13.25, "y": 0},
+                {"label": "F11", "matrix": [6, 4], "x": 14.25, "y": 0},
+                {"label": "F12", "matrix": [6, 5], "x": 15.25, "y": 0},
+                {"label": "F13", "matrix": [6, 6], "x": 16.5, "y": 0},
+                {"label": "RENC", "matrix": [6, 8], "x": 18, "y": 0},
+                {"label": "M1", "matrix": [1, 0], "x": 0, "y": 1},
+                {"label": "GRAV", "matrix": [1, 1], "x": 1.5, "y": 1},
+                {"label": "1", "matrix": [1, 2], "x": 2.5, "y": 1},
+                {"label": "2", "matrix": [1, 3], "x": 3.5, "y": 1},
+                {"label": "3", "matrix": [1, 4], "x": 4.5, "y": 1},
+                {"label": "4", "matrix": [1, 5], "x": 5.5, "y": 1},
+                {"label": "5", "matrix": [1, 6], "x": 6.5, "y": 1},
+                {"label": "6", "matrix": [1, 7], "x": 7.5, "y": 1},
+                {"label": "7", "matrix": [7, 0], "x": 9.5, "y": 1},
+                {"label": "8", "matrix": [7, 1], "x": 10.5, "y": 1},
+                {"label": "9", "matrix": [7, 2], "x": 11.5, "y": 1},
+                {"label": "0", "matrix": [7, 3], "x": 12.5, "y": 1},
+                {"label": "-", "matrix": [7, 4], "x": 13.5, "y": 1},
+                {"label": "=", "matrix": [7, 5], "x": 14.5, "y": 1},
+                {"label": "Back", "matrix": [7, 6], "x": 15.5, "y": 1},
+                {"label": "Del", "matrix": [7, 7], "x": 16.5, "y": 1},
+                {"label": "Home", "matrix": [7, 8], "x": 18, "y": 1},
+                {"label": "M2", "matrix": [2, 0], "x": 0, "y": 2},
+                {"label": "Tab", "matrix": [2, 1], "x": 1.5, "y": 2, "w": 1.5},
+                {"label": "Q", "matrix": [2, 3], "x": 3, "y": 2},
+                {"label": "W", "matrix": [2, 4], "x": 4, "y": 2},
+                {"label": "E", "matrix": [2, 5], "x": 5, "y": 2},
+                {"label": "R", "matrix": [2, 6], "x": 6, "y": 2},
+                {"label": "T", "matrix": [2, 7], "x": 7, "y": 2},
+                {"label": "Y", "matrix": [8, 0], "x": 9, "y": 2},
+                {"label": "U", "matrix": [8, 1], "x": 10, "y": 2},
+                {"label": "I", "matrix": [8, 2], "x": 11, "y": 2},
+                {"label": "O", "matrix": [8, 3], "x": 12, "y": 2},
+                {"label": "P", "matrix": [8, 4], "x": 13, "y": 2},
+                {"label": "[", "matrix": [8, 5], "x": 14, "y": 2},
+                {"label": "]", "matrix": [8, 6], "x": 15, "y": 2},
+                {"label": "BSLS", "matrix": [8, 7], "x": 16, "y": 2, "w": 1.5},
+                {"label": "PgUp", "matrix": [8, 8], "x": 18, "y": 2},
+                {"label": "M3", "matrix": [3, 0], "x": 0, "y": 3},
+                {"label": "Caps", "matrix": [3, 1], "x": 1.5, "y": 3, "w": 1.75},
+                {"label": "A", "matrix": [3, 3], "x": 3.25, "y": 3},
+                {"label": "S", "matrix": [3, 4], "x": 4.25, "y": 3},
+                {"label": "D", "matrix": [3, 5], "x": 5.25, "y": 3},
+                {"label": "F", "matrix": [3, 6], "x": 6.25, "y": 3},
+                {"label": "G", "matrix": [3, 7], "x": 7.25, "y": 3},
+                {"label": "H", "matrix": [9, 0], "x": 9.25, "y": 3},
+                {"label": "J", "matrix": [9, 1], "x": 10.25, "y": 3},
+                {"label": "K", "matrix": [9, 2], "x": 11.25, "y": 3},
+                {"label": "L", "matrix": [9, 3], "x": 12.25, "y": 3},
+                {"label": ";", "matrix": [9, 4], "x": 13.25, "y": 3},
+                {"label": "'", "matrix": [9, 5], "x": 14.25, "y": 3},
+                {"label": "NUHS", "matrix": [9, 6], "x": 15.25, "y": 3},
+                {"label": "Enter", "matrix": [9, 7], "x": 16.25, "y": 3, "w": 1.25},
+                {"label": "PgDn", "matrix": [9, 8], "x": 18, "y": 3},
+                {"label": "M4", "matrix": [4, 0], "x": 0, "y": 4},
+                {"label": "Shift", "matrix": [4, 1], "x": 1.5, "y": 4, "w": 1.25},
+                {"label": "NUBS", "matrix": [4, 2], "x": 2.75, "y": 4},
+                {"label": "Z", "matrix": [4, 3], "x": 3.75, "y": 4},
+                {"label": "X", "matrix": [4, 4], "x": 4.75, "y": 4},
+                {"label": "C", "matrix": [4, 5], "x": 5.75, "y": 4},
+                {"label": "V", "matrix": [4, 6], "x": 6.75, "y": 4},
+                {"label": "B", "matrix": [4, 7], "x": 7.75, "y": 4},
+                {"label": "N", "matrix": [10, 0], "x": 9.75, "y": 4},
+                {"label": "M", "matrix": [10, 1], "x": 10.75, "y": 4},
+                {"label": ",", "matrix": [10, 2], "x": 11.75, "y": 4},
+                {"label": ".", "matrix": [10, 3], "x": 12.75, "y": 4},
+                {"label": "/", "matrix": [10, 4], "x": 13.75, "y": 4},
+                {"label": "Shift", "matrix": [10, 6], "x": 14.75, "y": 4, "w": 1.75},
+                {"label": "Up", "matrix": [10, 7], "x": 16.75, "y": 4},
+                {"label": "End", "matrix": [10, 8], "x": 18, "y": 4},
+                {"label": "M5", "matrix": [5, 0], "x": 0, "y": 5},
+                {"label": "Ctrl", "matrix": [5, 1], "x": 1.5, "y": 5, "w": 1.25},
+                {"label": "Gui", "matrix": [5, 2], "x": 2.75, "y": 5, "w": 1.25},
+                {"label": "Alt", "matrix": [5, 3], "x": 4, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [5, 4], "x": 5.25, "y": 5, "w": 2.25},
+                {"label": "FN", "matrix": [5, 7], "x": 7.5, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [11, 1], "x": 9.75, "y": 5, "w": 2.75},
+                {"label": "Alt", "matrix": [11, 3], "x": 12.5, "y": 5},
+                {"label": "Gui", "matrix": [11, 4], "x": 13.5, "y": 5},
+                {"label": "Ctrl", "matrix": [11, 5], "x": 14.5, "y": 5},
+                {"label": "Left", "matrix": [11, 6], "x": 15.75, "y": 5},
+                {"label": "Down", "matrix": [11, 7], "x": 16.75, "y": 5},
+                {"label": "Rght", "matrix": [11, 8], "x": 17.75, "y": 5}
+            ]
+        },
+        "LAYOUT_ansi": {
+            "layout": [
+                {"label": "LENC", "matrix": [0, 0], "x": 0, "y": 0},
+                {"label": "ESC", "matrix": [0, 1], "x": 1.5, "y": 0},
+                {"label": "F1", "matrix": [0, 2], "x": 2.75, "y": 0},
+                {"label": "F2", "matrix": [0, 3], "x": 3.75, "y": 0},
+                {"label": "F3", "matrix": [0, 4], "x": 4.75, "y": 0},
+                {"label": "F4", "matrix": [0, 5], "x": 5.75, "y": 0},
+                {"label": "F5", "matrix": [0, 6], "x": 7, "y": 0},
+                {"label": "F6", "matrix": [0, 7], "x": 8, "y": 0},
+                {"label": "F7", "matrix": [6, 0], "x": 10, "y": 0},
+                {"label": "F8", "matrix": [6, 1], "x": 11, "y": 0},
+                {"label": "F9", "matrix": [6, 2], "x": 12.25, "y": 0},
+                {"label": "F10", "matrix": [6, 3], "x": 13.25, "y": 0},
+                {"label": "F11", "matrix": [6, 4], "x": 14.25, "y": 0},
+                {"label": "F12", "matrix": [6, 5], "x": 15.25, "y": 0},
+                {"label": "F13", "matrix": [6, 6], "x": 16.5, "y": 0},
+                {"label": "RENC", "matrix": [6, 8], "x": 18, "y": 0},
+                {"label": "M1", "matrix": [1, 0], "x": 0, "y": 1},
+                {"label": "GRAV", "matrix": [1, 1], "x": 1.5, "y": 1},
+                {"label": "1", "matrix": [1, 2], "x": 2.5, "y": 1},
+                {"label": "2", "matrix": [1, 3], "x": 3.5, "y": 1},
+                {"label": "3", "matrix": [1, 4], "x": 4.5, "y": 1},
+                {"label": "4", "matrix": [1, 5], "x": 5.5, "y": 1},
+                {"label": "5", "matrix": [1, 6], "x": 6.5, "y": 1},
+                {"label": "6", "matrix": [1, 7], "x": 7.5, "y": 1},
+                {"label": "7", "matrix": [7, 0], "x": 9.5, "y": 1},
+                {"label": "8", "matrix": [7, 1], "x": 10.5, "y": 1},
+                {"label": "9", "matrix": [7, 2], "x": 11.5, "y": 1},
+                {"label": "0", "matrix": [7, 3], "x": 12.5, "y": 1},
+                {"label": "-", "matrix": [7, 4], "x": 13.5, "y": 1},
+                {"label": "=", "matrix": [7, 5], "x": 14.5, "y": 1},
+                {"label": "Back", "matrix": [7, 6], "x": 15.5, "y": 1, "w": 2},
+                {"label": "Home", "matrix": [7, 8], "x": 18, "y": 1},
+                {"label": "M2", "matrix": [2, 0], "x": 0, "y": 2},
+                {"label": "Tab", "matrix": [2, 1], "x": 1.5, "y": 2, "w": 1.5},
+                {"label": "Q", "matrix": [2, 3], "x": 3, "y": 2},
+                {"label": "W", "matrix": [2, 4], "x": 4, "y": 2},
+                {"label": "E", "matrix": [2, 5], "x": 5, "y": 2},
+                {"label": "R", "matrix": [2, 6], "x": 6, "y": 2},
+                {"label": "T", "matrix": [2, 7], "x": 7, "y": 2},
+                {"label": "Y", "matrix": [8, 0], "x": 9, "y": 2},
+                {"label": "U", "matrix": [8, 1], "x": 10, "y": 2},
+                {"label": "I", "matrix": [8, 2], "x": 11, "y": 2},
+                {"label": "O", "matrix": [8, 3], "x": 12, "y": 2},
+                {"label": "P", "matrix": [8, 4], "x": 13, "y": 2},
+                {"label": "[", "matrix": [8, 5], "x": 14, "y": 2},
+                {"label": "]", "matrix": [8, 6], "x": 15, "y": 2},
+                {"label": "BSLS", "matrix": [8, 7], "x": 16, "y": 2, "w": 1.5},
+                {"label": "PgUp", "matrix": [8, 8], "x": 18, "y": 2},
+                {"label": "M3", "matrix": [3, 0], "x": 0, "y": 3},
+                {"label": "Caps", "matrix": [3, 1], "x": 1.5, "y": 3, "w": 1.75},
+                {"label": "A", "matrix": [3, 3], "x": 3.25, "y": 3},
+                {"label": "S", "matrix": [3, 4], "x": 4.25, "y": 3},
+                {"label": "D", "matrix": [3, 5], "x": 5.25, "y": 3},
+                {"label": "F", "matrix": [3, 6], "x": 6.25, "y": 3},
+                {"label": "G", "matrix": [3, 7], "x": 7.25, "y": 3},
+                {"label": "H", "matrix": [9, 0], "x": 9.25, "y": 3},
+                {"label": "J", "matrix": [9, 1], "x": 10.25, "y": 3},
+                {"label": "K", "matrix": [9, 2], "x": 11.25, "y": 3},
+                {"label": "L", "matrix": [9, 3], "x": 12.25, "y": 3},
+                {"label": ";", "matrix": [9, 4], "x": 13.25, "y": 3},
+                {"label": "'", "matrix": [9, 5], "x": 14.25, "y": 3},
+                {"label": "Enter", "matrix": [9, 7], "x": 15.25, "y": 3, "w": 2.25},
+                {"label": "PgDn", "matrix": [9, 8], "x": 18, "y": 3},
+                {"label": "M4", "matrix": [4, 0], "x": 0, "y": 4},
+                {"label": "Shift", "matrix": [4, 1], "x": 1.5, "y": 4, "w": 2.25},
+                {"label": "Z", "matrix": [4, 3], "x": 3.75, "y": 4},
+                {"label": "X", "matrix": [4, 4], "x": 4.75, "y": 4},
+                {"label": "C", "matrix": [4, 5], "x": 5.75, "y": 4},
+                {"label": "V", "matrix": [4, 6], "x": 6.75, "y": 4},
+                {"label": "B", "matrix": [4, 7], "x": 7.75, "y": 4},
+                {"label": "N", "matrix": [10, 0], "x": 9.75, "y": 4},
+                {"label": "M", "matrix": [10, 1], "x": 10.75, "y": 4},
+                {"label": ",", "matrix": [10, 2], "x": 11.75, "y": 4},
+                {"label": ".", "matrix": [10, 3], "x": 12.75, "y": 4},
+                {"label": "/", "matrix": [10, 4], "x": 13.75, "y": 4},
+                {"label": "Shift", "matrix": [10, 6], "x": 14.75, "y": 4, "w": 1.75},
+                {"label": "Up", "matrix": [10, 7], "x": 16.75, "y": 4},
+                {"label": "End", "matrix": [10, 8], "x": 18, "y": 4},
+                {"label": "M5", "matrix": [5, 0], "x": 0, "y": 5},
+                {"label": "Ctrl", "matrix": [5, 1], "x": 1.5, "y": 5, "w": 1.25},
+                {"label": "Gui", "matrix": [5, 2], "x": 2.75, "y": 5, "w": 1.25},
+                {"label": "Alt", "matrix": [5, 3], "x": 4, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [5, 4], "x": 5.25, "y": 5, "w": 2.25},
+                {"label": "FN", "matrix": [5, 7], "x": 7.5, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [11, 1], "x": 9.75, "y": 5, "w": 2.75},
+                {"label": "Alt", "matrix": [11, 3], "x": 12.5, "y": 5},
+                {"label": "Gui", "matrix": [11, 4], "x": 13.5, "y": 5},
+                {"label": "Ctrl", "matrix": [11, 5], "x": 14.5, "y": 5},
+                {"label": "Left", "matrix": [11, 6], "x": 15.75, "y": 5},
+                {"label": "Down", "matrix": [11, 7], "x": 16.75, "y": 5},
+                {"label": "Rght", "matrix": [11, 8], "x": 17.75, "y": 5}
+            ]
+        },
+        "LAYOUT_iso": {
+            "layout": [
+                {"label": "LENC", "matrix": [0, 0], "x": 0, "y": 0},
+                {"label": "ESC", "matrix": [0, 1], "x": 1.5, "y": 0},
+                {"label": "F1", "matrix": [0, 2], "x": 2.75, "y": 0},
+                {"label": "F2", "matrix": [0, 3], "x": 3.75, "y": 0},
+                {"label": "F3", "matrix": [0, 4], "x": 4.75, "y": 0},
+                {"label": "F4", "matrix": [0, 5], "x": 5.75, "y": 0},
+                {"label": "F5", "matrix": [0, 6], "x": 7, "y": 0},
+                {"label": "F6", "matrix": [0, 7], "x": 8, "y": 0},
+                {"label": "F7", "matrix": [6, 0], "x": 10, "y": 0},
+                {"label": "F8", "matrix": [6, 1], "x": 11, "y": 0},
+                {"label": "F9", "matrix": [6, 2], "x": 12.25, "y": 0},
+                {"label": "F10", "matrix": [6, 3], "x": 13.25, "y": 0},
+                {"label": "F11", "matrix": [6, 4], "x": 14.25, "y": 0},
+                {"label": "F12", "matrix": [6, 5], "x": 15.25, "y": 0},
+                {"label": "F13", "matrix": [6, 6], "x": 16.5, "y": 0},
+                {"label": "RENC", "matrix": [6, 8], "x": 18, "y": 0},
+                {"label": "M1", "matrix": [1, 0], "x": 0, "y": 1},
+                {"label": "GRAV", "matrix": [1, 1], "x": 1.5, "y": 1},
+                {"label": "1", "matrix": [1, 2], "x": 2.5, "y": 1},
+                {"label": "2", "matrix": [1, 3], "x": 3.5, "y": 1},
+                {"label": "3", "matrix": [1, 4], "x": 4.5, "y": 1},
+                {"label": "4", "matrix": [1, 5], "x": 5.5, "y": 1},
+                {"label": "5", "matrix": [1, 6], "x": 6.5, "y": 1},
+                {"label": "6", "matrix": [1, 7], "x": 7.5, "y": 1},
+                {"label": "7", "matrix": [7, 0], "x": 9.5, "y": 1},
+                {"label": "8", "matrix": [7, 1], "x": 10.5, "y": 1},
+                {"label": "9", "matrix": [7, 2], "x": 11.5, "y": 1},
+                {"label": "0", "matrix": [7, 3], "x": 12.5, "y": 1},
+                {"label": "-", "matrix": [7, 4], "x": 13.5, "y": 1},
+                {"label": "=", "matrix": [7, 5], "x": 14.5, "y": 1},
+                {"label": "Back", "matrix": [7, 6], "x": 15.5, "y": 1, "w": 2},
+                {"label": "Home", "matrix": [7, 8], "x": 18, "y": 1},
+                {"label": "M2", "matrix": [2, 0], "x": 0, "y": 2},
+                {"label": "Tab", "matrix": [2, 1], "x": 1.5, "y": 2, "w": 1.5},
+                {"label": "Q", "matrix": [2, 3], "x": 3, "y": 2},
+                {"label": "W", "matrix": [2, 4], "x": 4, "y": 2},
+                {"label": "E", "matrix": [2, 5], "x": 5, "y": 2},
+                {"label": "R", "matrix": [2, 6], "x": 6, "y": 2},
+                {"label": "T", "matrix": [2, 7], "x": 7, "y": 2},
+                {"label": "Y", "matrix": [8, 0], "x": 9, "y": 2},
+                {"label": "U", "matrix": [8, 1], "x": 10, "y": 2},
+                {"label": "I", "matrix": [8, 2], "x": 11, "y": 2},
+                {"label": "O", "matrix": [8, 3], "x": 12, "y": 2},
+                {"label": "P", "matrix": [8, 4], "x": 13, "y": 2},
+                {"label": "[", "matrix": [8, 5], "x": 14, "y": 2},
+                {"label": "]", "matrix": [8, 6], "x": 15, "y": 2},
+                {"label": "PgUp", "matrix": [8, 8], "x": 18, "y": 2},
+                {"label": "M3", "matrix": [3, 0], "x": 0, "y": 3},
+                {"label": "Caps", "matrix": [3, 1], "x": 1.5, "y": 3, "w": 1.75},
+                {"label": "A", "matrix": [3, 3], "x": 3.25, "y": 3},
+                {"label": "S", "matrix": [3, 4], "x": 4.25, "y": 3},
+                {"label": "D", "matrix": [3, 5], "x": 5.25, "y": 3},
+                {"label": "F", "matrix": [3, 6], "x": 6.25, "y": 3},
+                {"label": "G", "matrix": [3, 7], "x": 7.25, "y": 3},
+                {"label": "H", "matrix": [9, 0], "x": 9.25, "y": 3},
+                {"label": "J", "matrix": [9, 1], "x": 10.25, "y": 3},
+                {"label": "K", "matrix": [9, 2], "x": 11.25, "y": 3},
+                {"label": "L", "matrix": [9, 3], "x": 12.25, "y": 3},
+                {"label": ";", "matrix": [9, 4], "x": 13.25, "y": 3},
+                {"label": "'", "matrix": [9, 5], "x": 14.25, "y": 3},
+                {"label": "NUHS", "matrix": [9, 6], "x": 15.25, "y": 3},
+                {"label": "Enter", "matrix": [9, 7], "x": 16.25, "y": 2, "w": 1.25, "h": 2},
+                {"label": "PgDn", "matrix": [9, 8], "x": 18, "y": 3},
+                {"label": "M4", "matrix": [4, 0], "x": 0, "y": 4},
+                {"label": "Shift", "matrix": [4, 1], "x": 1.5, "y": 4, "w": 1.25},
+                {"label": "NUBS", "matrix": [4, 2], "x": 2.75, "y": 4},
+                {"label": "Z", "matrix": [4, 3], "x": 3.75, "y": 4},
+                {"label": "X", "matrix": [4, 4], "x": 4.75, "y": 4},
+                {"label": "C", "matrix": [4, 5], "x": 5.75, "y": 4},
+                {"label": "V", "matrix": [4, 6], "x": 6.75, "y": 4},
+                {"label": "B", "matrix": [4, 7], "x": 7.75, "y": 4},
+                {"label": "N", "matrix": [10, 0], "x": 9.75, "y": 4},
+                {"label": "M", "matrix": [10, 1], "x": 10.75, "y": 4},
+                {"label": ",", "matrix": [10, 2], "x": 11.75, "y": 4},
+                {"label": ".", "matrix": [10, 3], "x": 12.75, "y": 4},
+                {"label": "/", "matrix": [10, 4], "x": 13.75, "y": 4},
+                {"label": "Shift", "matrix": [10, 6], "x": 14.75, "y": 4, "w": 1.75},
+                {"label": "Up", "matrix": [10, 7], "x": 16.75, "y": 4},
+                {"label": "End", "matrix": [10, 8], "x": 18, "y": 4},
+                {"label": "M5", "matrix": [5, 0], "x": 0, "y": 5},
+                {"label": "Ctrl", "matrix": [5, 1], "x": 1.5, "y": 5, "w": 1.25},
+                {"label": "Gui", "matrix": [5, 2], "x": 2.75, "y": 5, "w": 1.25},
+                {"label": "Alt", "matrix": [5, 3], "x": 4, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [5, 4], "x": 5.25, "y": 5, "w": 2.25},
+                {"label": "FN", "matrix": [5, 7], "x": 7.5, "y": 5, "w": 1.25},
+                {"label": "Space", "matrix": [11, 1], "x": 9.75, "y": 5, "w": 2.75},
+                {"label": "Alt", "matrix": [11, 3], "x": 12.5, "y": 5},
+                {"label": "Gui", "matrix": [11, 4], "x": 13.5, "y": 5},
+                {"label": "Ctrl", "matrix": [11, 5], "x": 14.5, "y": 5},
+                {"label": "Left", "matrix": [11, 6], "x": 15.75, "y": 5},
+                {"label": "Down", "matrix": [11, 7], "x": 16.75, "y": 5},
+                {"label": "Rght", "matrix": [11, 8], "x": 17.75, "y": 5}
+            ]
+        }
+    }
+}

keyboards/haverworks/theseus75/keymaps/ansi/keymap.c

@@ -0,0 +1,31 @@
+// Copyright 2023 Moritz Plattner (@ebastler), Alex Havermale (@haversnail)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#include QMK_KEYBOARD_H
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+
+    [0] = LAYOUT_ansi(
+        RM_TOGG, KC_ESC,  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_PSCR,          KC_MUTE,
+        KC_F13,  KC_GRV,  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_F14,  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_F15,  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_F16,  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_F17,  KC_LCTL, KC_LGUI, KC_LALT,                   KC_SPC,  MO(1),   KC_SPC,                    KC_RALT, KC_RGUI, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT
+    ),
+    [1] = LAYOUT_ansi(
+        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_MPLY,
+        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_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, 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,          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, 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
+    )
+};
+
+#ifdef ENCODER_MAP_ENABLE
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
+    [0] = { ENCODER_CCW_CW(RM_VALD, RM_VALU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU) },
+    [1] = { ENCODER_CCW_CW(RM_PREV, RM_NEXT), ENCODER_CCW_CW(KC_MPRV, KC_MNXT) },
+};
+#endif

keyboards/haverworks/theseus75/keymaps/ansi/rules.mk

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

keyboards/haverworks/theseus75/keymaps/default/keymap.c

@@ -0,0 +1,31 @@
+// Copyright 2023 Moritz Plattner (@ebastler), Alex Havermale (@haversnail)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#include QMK_KEYBOARD_H
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+
+    [0] = LAYOUT_all(
+        RM_TOGG, KC_ESC,  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_PSCR,          KC_MUTE,
+        KC_F13,  KC_GRV,  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_DEL,  KC_HOME,
+        KC_F14,  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_F15,  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_NUHS, KC_ENT,           KC_PGDN,
+        KC_F16,  KC_LSFT, KC_NUBS, 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_F17,  KC_LCTL, KC_LGUI, KC_LALT,                   KC_SPC,  MO(1),   KC_SPC,                    KC_RALT, KC_RGUI, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT
+    ),
+    [1] = LAYOUT_all(
+        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_MPLY,
+        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, 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,          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,          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, 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
+    )
+};
+
+#ifdef ENCODER_MAP_ENABLE
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
+    [0] = { ENCODER_CCW_CW(RM_VALD, RM_VALU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU) },
+    [1] = { ENCODER_CCW_CW(RM_PREV, RM_NEXT), ENCODER_CCW_CW(KC_MPRV, KC_MNXT) },
+};
+#endif

keyboards/haverworks/theseus75/keymaps/default/rules.mk

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

keyboards/haverworks/theseus75/keymaps/iso/keymap.c

@@ -0,0 +1,31 @@
+// Copyright 2023 Moritz Plattner (@ebastler), Alex Havermale (@haversnail)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#include QMK_KEYBOARD_H
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+
+    [0] = LAYOUT_iso(
+        RM_TOGG, KC_ESC,  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_PSCR,          KC_MUTE,
+        KC_F13,  KC_GRV,  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_F14,  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_PGUP,
+        KC_F15,  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_NUHS, KC_ENT,           KC_PGDN,
+        KC_F16,  KC_LSFT, KC_NUBS, 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_F17,  KC_LCTL, KC_LGUI, KC_LALT,                   KC_SPC,  MO(1),   KC_SPC,                    KC_RALT, KC_RGUI, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT
+    ),
+    [1] = LAYOUT_iso(
+        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_MPLY,
+        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_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, 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, 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, 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
+    )
+};
+
+#ifdef ENCODER_MAP_ENABLE
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] = {
+    [0] = { ENCODER_CCW_CW(RM_VALD, RM_VALU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU) },
+    [1] = { ENCODER_CCW_CW(RM_PREV, RM_NEXT), ENCODER_CCW_CW(KC_MPRV, KC_MNXT) },
+};
+#endif

keyboards/haverworks/theseus75/keymaps/iso/rules.mk

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

keyboards/haverworks/theseus75/mcuconf.h

@@ -0,0 +1,14 @@
+// Copyright 2023 Moritz Plattner (@ebastler)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#pragma once
+
+#include_next <mcuconf.h>
+
+/* enable USART3, used for split comms */
+#undef STM32_SERIAL_USE_USART3
+#define STM32_SERIAL_USE_USART3 TRUE
+
+/* enable TIM3, used for Underglow PWM driver */
+#undef STM32_PWM_USE_TIM3
+#define STM32_PWM_USE_TIM3 TRUE

keyboards/haverworks/theseus75/readme.md

@@ -0,0 +1,31 @@
+# Haverworks Theseus75
+
+![Theseus75 v1 PCB](https://imgur.com/N81LsCO.png)
+
+The Theseus75 is a 75% row-staggered split keyboard with a macro column and rotary encoders on both sides. Each half features a dual-role USB-C port and integrated USB hub, allowing the unused port to act as a USB-C 2.0 High-Speed host for connecting a numpad, mouse, flash drive, security key, mobile phone, or similar device.
+
+> [!NOTE]
+> Up to 5V at 1.5A can be supplied, depending on negotiations with the host.
+
+* Keyboard Maintainers: [Moritz Plattner](https://github.com/ebastler), [Alex Havermale](https://github.com/haversnail)
+* Hardware Supported: Haverworks Theseus75 v1 PCBs (hot-swap and solder)
+* Hardware Availability: [Group buy](https://haver.works/theseus75)
+
+Make example for this keyboard (after setting up your build environment):
+
+    make haverworks/theseus75:default
+
+Flashing example for this keyboard:
+
+    make haverworks/theseus75: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 two ways:
+
+* **Physical reset button**: Hold the <kbd>Reset</kbd>/<kbd>Flash</kbd> button on the back of the PCB for approximately one second (instructions are also included on the PCB)
+* **Bootmagic reset**:
+    * **Left half**: Hold down the first key to the right of the encoder (<kbd>Esc</kbd> by default) and plug in the keyboard
+    * **Right half**: Hold down the first key to the left of the encoder (<kbd>Print Screen</kbd> by default) and plug in the keyboard

keyboards/haverworks/theseus75/theseus75.c

@@ -0,0 +1,214 @@
+// Copyright 2023 Moritz Plattner (@ebastler), Alex Havermale (@haversnail)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
+#include "quantum.h"
+#include "transactions.h"
+#include <stdio.h>
+#include "print.h"
+#include "split_util.h"
+#include "usbpd.h"
+
+typedef struct _kb_state_t {
+    usbpd_allowance_t allowance;
+} kb_state_t;
+
+kb_state_t kb_state;
+
+const char* usbpd_str(usbpd_allowance_t allowance) {
+    switch (allowance) {
+        case USBPD_500MA:
+            return "500mA";
+        case USBPD_1500MA:
+            return "1500mA";
+        case USBPD_3000MA:
+            return "3000mA";
+        default:
+            dprintf("Encountered unknown allowance enum value: %d\n", allowance);
+            return "UNKNOWN";
+    }
+}
+
+void kb_state_slave_handler(uint8_t m2s_size, const void* m2s_buffer, uint8_t s2m_size, void* s2m_buffer) {
+    if (m2s_size == sizeof(kb_state_t)) {
+        memcpy(&kb_state, m2s_buffer, sizeof(kb_state_t));
+    } else {
+        dprintf("Unexpected response in slave handler\n"); // TODO: add split debug logging
+    }
+}
+
+void keyboard_pre_init_kb(void) {
+    // Disable the PD peripheral in pre-init because its pins are being used in the matrix:
+    PWR->CR3 |= PWR_CR3_UCPD_DBDIS;
+    // Call the corresponding _user() function (see https://docs.qmk.fm/#/custom_quantum_functions)
+    keyboard_pre_init_user();
+}
+
+void keyboard_post_init_kb(void) {
+    // Register keyboard state transaction:
+    transaction_register_rpc(RPC_ID_KB_STATE, kb_state_slave_handler);
+
+    // Set default state values:
+    kb_state.allowance = USBPD_500MA;
+
+    // If the keyboard is master,
+    if (is_keyboard_master()) {
+        // Turn on power to the split half and to underglow LEDs:
+        gpio_set_pin_output(PSW_PIN);
+        gpio_write_pin_high(PSW_PIN);
+
+        // Enable inputs used for current negotiation:
+        gpio_set_pin_input_high(USBPD_1_PIN);
+        gpio_set_pin_input_high(USBPD_2_PIN);
+
+        // Not needed in this mode (always high-Z with pull-up on PCB if port controller is sink)
+        gpio_set_pin_input_high(ID_PIN);
+    } else {
+        // Prepare output to enable power for USB output after negotiation:
+        gpio_set_pin_output(PSW_PIN);
+
+        // Switch the USB MUXes between hub and ports:
+        gpio_set_pin_output(USBSW_PIN);
+        gpio_write_pin_high(USBSW_PIN);
+
+        // Enable outputs used for current negotiation and default to 500mA:
+        gpio_set_pin_output(USBPD_1_PIN);
+        gpio_write_pin_high(USBPD_1_PIN);
+        gpio_set_pin_output(USBPD_2_PIN);
+        gpio_write_pin_high(USBPD_2_PIN);
+
+        // Use ID pin to check if client is detected (if low: USB source port powered):
+        gpio_set_pin_input_high(ID_PIN);
+
+        // Indicate that the hub is either self-powered or bus-powered based on whether the bus-power mode flag is enabled
+        // (configurable for users who would rather always have their device connect, regardless of whether they meet the specs):
+        gpio_set_pin_output(BUS_B_PIN);
+        if (DISABLE_BUS_POWER_MODE == TRUE) {
+            gpio_write_pin_high(BUS_B_PIN);
+        } else {
+            gpio_write_pin_low(BUS_B_PIN);
+        }
+    }
+    // Call the corresponding _user() function (see https://docs.qmk.fm/#/custom_quantum_functions)
+    keyboard_post_init_user();
+}
+
+void housekeeping_task_kb(void) {
+    // Update any shared kb state to send to slave:
+    static uint32_t last_usbpd_allowance_check_time = 0;
+    if (timer_elapsed32(last_usbpd_allowance_check_time) > USBPD_ALLOWANCE_CHECK_INTERVAL) {
+        // On master side: check USBPD_1_PIN and USBPD_2_PIN to determine current negotiated with host
+        // (Can't use the usbpd_get_allowance() function, as this uses this uses the native CC PD interface
+        // of the G series MCU, while we're using dedicated port controllers instead):
+        if (is_keyboard_master()) {
+            usbpd_allowance_t allowance;
+
+            if (gpio_read_pin(USBPD_1_PIN)) {
+                allowance = USBPD_500MA;
+            } else if (gpio_read_pin(USBPD_2_PIN)) {
+                allowance = USBPD_1500MA;
+            } else {
+                allowance = USBPD_3000MA;
+            }
+
+            if (kb_state.allowance != allowance) {
+                printf("Host negotiated current: %s -> %s\n", usbpd_str(kb_state.allowance), usbpd_str(allowance));
+                kb_state.allowance = allowance;
+            }
+        } else {
+            // On peripheral side - If ID_PIN is low: USB client negotiated 5V successfully -> enable power routing
+            // Check if PSW_PIN is not already high to avoid wasting time
+            if (!gpio_read_pin(ID_PIN) && !gpio_read_pin(PSW_PIN)) {
+                gpio_write_pin_high(PSW_PIN);
+                dprintf("USB downstream device connected\n"); // TODO: add split debug logging
+            } else if (gpio_read_pin(ID_PIN) && gpio_read_pin(PSW_PIN)) {
+                gpio_write_pin_low(PSW_PIN);
+                dprintf("USB downstream device disconnected\n"); // TODO: add split debug logging
+            }
+        };
+        last_usbpd_allowance_check_time = timer_read32();
+    };
+
+    // Sync state from master to slave:
+    if (is_keyboard_master() && is_transport_connected()) {
+        bool              needs_sync = false;
+        static uint32_t   last_kb_state_sync_time;
+        static kb_state_t last_kb_state;
+
+        // Check if the state values are different:
+        if (memcmp(&kb_state, &last_kb_state, sizeof(kb_state_t))) {
+            needs_sync = true;
+            memcpy(&last_kb_state, &kb_state, sizeof(kb_state_t));
+        }
+
+        // Sync state every so often regardless:
+        if (timer_elapsed32(last_kb_state_sync_time) > KB_STATE_SYNC_INTERVAL) {
+            needs_sync = true;
+        }
+
+        if (needs_sync) {
+            bool did_sync = transaction_rpc_send(RPC_ID_KB_STATE, sizeof(kb_state_t), &kb_state);
+            if (did_sync) {
+                dprintf("Synced to slave\n");
+                last_kb_state_sync_time = timer_read32();
+            } else {
+                dprintf("Failed to sync state\n");
+            }
+        }
+    }
+
+    // Update the USBPD output pins on slave half whenever allowance has changed:
+    if (!is_keyboard_master()) {
+        static usbpd_allowance_t last_allowance;
+
+        if (last_allowance != kb_state.allowance) {
+            last_allowance = kb_state.allowance;
+
+            printf("Setting USB-PD output to %s (%s-powered)\n", usbpd_str(kb_state.allowance), kb_state.allowance == USBPD_500MA ? "bus" : "self"); // TODO: add split debug logging
+
+            switch (kb_state.allowance) {
+                default:
+                case USBPD_500MA:
+                    // Set USBPD output to 500 mA:
+                    gpio_write_pin_high(USBPD_1_PIN);
+                    gpio_write_pin_high(USBPD_2_PIN);
+                    if (DISABLE_BUS_POWER_MODE == TRUE) {
+                        // Indicate hub is self-powered and devices can try to connect or fast charge:
+                        gpio_write_pin_high(BUS_B_PIN);
+                    } else {
+                        // Indicate hub is bus-powered and devices should not try to connect or fast charge:
+                        gpio_write_pin_low(BUS_B_PIN);
+                    }
+                    break;
+                case USBPD_1500MA:
+                    // Set USBPD output to 500 mA:
+                    gpio_write_pin_high(USBPD_1_PIN);
+                    gpio_write_pin_high(USBPD_2_PIN);
+                    // Indicate hub is self-powered and devices can try to connect or fast charge:
+                    gpio_write_pin_high(BUS_B_PIN);
+                    break;
+                case USBPD_3000MA:
+                    // Set USBPD output to 1500 mA:
+                    gpio_write_pin_low(USBPD_1_PIN);
+                    gpio_write_pin_high(USBPD_2_PIN);
+                    // Indicate hub is self-powered and devices can try to connect or fast charge:
+                    gpio_write_pin_high(BUS_B_PIN);
+                    break;
+            }
+        }
+    }
+}
+
+#ifdef RGB_MATRIX_ENABLE
+bool rgb_matrix_indicators_kb(void) {
+    if (!rgb_matrix_indicators_user()) {
+        return false;
+    }
+
+    if (host_keyboard_led_state().caps_lock) {
+        rgb_matrix_set_color(CAPS_LOCK_LED_INDEX, INDICATOR_MAX_BRIGHTNESS, INDICATOR_MAX_BRIGHTNESS, INDICATOR_MAX_BRIGHTNESS);
+    } else {
+        rgb_matrix_set_color(CAPS_LOCK_LED_INDEX, 0, 0, 0);
+    }
+    return true;
+}
+#endif